BSD-3-Clause licensed by Nickolay Kudasov
This version can be pinned in stack with:telegram-bot-simple-0.14.4@sha256:2f9cc06e9b45e72ef46a0847cdebc439845b82b0d41f8f63f2e50aeb7359a621,5644

telegram-bot-simple

Hackage Stackage LTS Stackage Nightly

Easy to use library for building Telegram bots in Haskell.

LambdaConf 2018 workshop

This library was featured in a LambdaConf 2018 workshop. The supplementary materials for the workshop is available at https://github.com/fizruk/lambdaconf-2018-workshop.

Examples

See bot examples here: https://github.com/fizruk/telegram-bot-simple/tree/master/telegram-bot-simple/examples

Use cabal build all -fexamples to build it. If you are building with stack then use stack build --flag telegram-bot-simple:examples.

Contributing

Contributions are welcome! Feel free to ping me on GitHub, file an issue or submit a PR :)

Compatibility

telegram-bot-api telegram-bot-simple
0.10 6.5
0.11.1 6.5.1
0.12 6.7
0.13 7.0
0.14 7.3
0.14.2 7.4
0.14.3 7.4.2
0.14.4 7.4.3

Nick

Changes

0.14.4 – 2024-11-07

  • Print failures from telegram-bot-api thrown in bot action handlers (see #197).
  • Support telegram-bot-api-.7.4.3.

0.14.3 – 2024-10-20

  • Support telegram-bot-api-7.4.1.

0.14.2 – 2024-08-26

  • Fix ExceptionInLinkedThread (see #189).

0.14.1 – 2024-05-26

  • Support telegram-bot-api == 7.3.1.

0.14 – 2024-05-25

  • Drop support GHC 8.10, 9.0, add support GHC 9.8, 9.10 (see #182).
  • Support telegram-bot-api == 7.3.
  • Ignore updates that produces parsing errors (see #175).

0.13 – 2024-02-06

  • Support GHC 9.6 (see #163).
  • Support telegram-bot-api == 7.0.
  • Fix bot hanging via rethrowing exceptions (see #170).

0.12 – 2023-04-29

  • Add support for testing WebApps (see #148);

  • Add nix flake (see #149);

  • Improve documentation for callbackQueryDataRead (see #153);

  • Support telegram-bot-api == 6.7 (breaking changes included).

  • Migration guide:

    1. Provide InlineQueryResultGeneric (see defInlineQueryResultGeneric).
    2. Provide InlineQueryResultGenericThumbnail (see defInlineQueryResultGenericThumbnail).
    3. Specify your own InlineQueryResult (see helpers for each data constructor).

0.11.1

  • Add RunTG instances for newly added methods in 6.5.1.

0.11

  • Add default implementations to all requests (see #138);
  • Add RunTG that simplifies making requests (see #139);

0.10

  • Compilation time reduced by splitting types and methods (see #136);

  • All Telegram.Bot.API.* modules moved to telegram-bot-api package (see #137);

  • Telegram.Bot.Simple.Webhook module added;

  • Migration guide:

    1. In the most cases you need to add telegram-bot-api package in project dependency list;
    2. If you are using webhooks then you also need to import Telegram.Bot.Simple.Webhook from telegram-bot-simple;

0.9

  • Make package complaint with Telegram Bot API 6.5 (breaking changes included) (see #135):

    • KeyboardButton extended with request_user and request_chat fields;
    • KeyboardButtonRequestUser and KeyboardButtonRequestChat types added;
    • Message extended with user_shared and chat_shared fields;
    • ChatMember and ChatPermissions: can_send_media_messages replaced with following fields:
      • can_send_audios;
      • can_send_documents;
      • can_send_photos;
      • can_send_videos;
      • can_send_video_notes;
      • can_send_voice_notes;
    • use_independent_chat_permissions field added to setChatPermissions and restrictChatMember methods;
    • ChatJoinRequest extended with user_chat_id field.
    • Update type fixed and aligned with the spec.

0.8

  • Make package complaint with Telegram Bot API 6.4 (breaking changes included) (see #134):

    • ReplyKeyboardMarkup extended with is_persistent;
    • Message extended with has_media_spoiler;
    • Chat extended with has_hidden_members and has_aggressive_anti_spam_enabled;
    • editForumTopic method: fields name and icon_custom_emoji_id become optional;
    • has_spoiler field added to:
      • data constructors: InputMediaPhoto, InputMediaVideo and InputMediaAnimation;
      • method: sendPhoto, sendVideo and sendAnimation;
    • Following message events added ForumTopicEdited, GeneralForumTopicHidden and GeneralForumTopicUnhidden;
    • General topic forum management, i.e. added following functions: editGeneralForumTopic, closeGeneralForumTopic, reopenGeneralForumTopic, hideGeneralForumTopic and unhideGeneralForumTopic;

0.7

  • Make package complaint with Telegram Bot API 6.3 (breaking changes included) (see #133):

    • Chat extended with is_forum, active_usernames and emoji_status_custom_emoji_id;
    • Message extended with forum_topic_created, forum_topic_closed and forum_topic_reopened;
    • Following message events added ForumTopicCreated, ForumTopicClosed and ForumTopicReopened;
    • can_manage_topics field added to ChatAdministratorRights, ChatPermissions and ChatMember data types;
    • PromoteChatMemberRequest extended with can_manage_topics too;
    • message_thread_id field added to following methods requests: sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage and forwardMessage;
    • Forum management, i.e. added following functions: createForumTopic, editForumTopic, closeForumTopic, reopenForumTopic, deleteForumTopic, unpinAllForumTopicMessages and getForumTopicIconStickers;

0.6.2

  • Fix decoding for VideoChatStarted (see #132);

0.6.1

  • Fix response parsing in UpdatingMessages (see #131);
  • Move from short polling to long polling (see #129);

0.6

  • Fix newlines unexpected removing in UpdateParser module (see #124);

  • Add WebHooks support (see #127);

  • Fix parse_mode encoding in sendPhoto, sendDocument, sendVideo and sendAnimation methods (see #123 and 5ee5289);

  • Make package complaint with Telegram Bot API 6.2 (breaking changes included) (see fab1aee):

    • Added createInvoiceLink method;
    • Added getCustomEmojiStickers method;
    • User extended with is_premium and added_to_attachment_menu;
    • Chat extended with has_restricted_voice_and_video_messages, join_to_send_messages, join_by_request;
    • MessageEntityType extended with custom_emoji; file_size field for Animation, Audio, Document, Video, VideoNote Voice, File changed from Int to Integer;
    • SticketSet modified: contains_masks is optional now and becoming a subject of further deprecation in a future, type added;
    • Added StickerSetType: could be regular, mask and custom_emoji.

0.5.2

  • Helpers from UpdateParser module fixed, commandWithBotName added (see #121);

0.5.1

  • Fix inconsistency around ParseMode (see #114);
  • Fix copyMessage method (see #116);
  • Add CI via GitHub Actions (see #119);
  • Fix GHC 9.0 compilation regression (see #120);

0.5

  • Add MarkdownV2 to ParseMode haddock suggestion (see #110);

  • Make package complaint with Telegram Bot API 6.0 (breaking changes included) (see #112):

    • WebAppInfo data type added. KeyboardButton, InlineKeyboardButton extended with web_app record.
    • SentWebAppMessage data type added. answerWebAppQuery method added.
    • MenuButton data type added. setChatMenuButton, getChatMenuButton methods added.
    • ChatAdministratorRights data type added. setMyDefaultAdministratorRights, getMyDefaultAdministratorRights methods added.
    • :warning: ChatMember records changed: can_manage_voice_chats renamed to can_manage_video_chat.
    • :warning: PromoteChatMemberRequest records changed: can_manage_voice_chats renamed to can_manage_video_chats.
    • :warning: Message records changed: voice_chat_scheduled, voice_chat_started, voice_chat_ended, and voice_chat_participants_invited renamed to video_chat_scheduled, video_chat_started, video_chat_ended, and video_chat_participants_invited correspondingly.

0.4.5

  • Fix UpdateId overflow exception (see #108);
  • Hide examples under flag examples (see #109);

0.4.4

  • Fix build on Windows (see #107);

0.4.3

  • Add support spoiler message type and protect_content field for various methods (see #103);

0.4.2

  • Fix GHC 9.0 compilation (see #102 );

0.4.1

  • Game improvements (see #99 );
  • Aeson >= 2.0 support (see #100 );

0.4

  • Add Payments methods (see #93);
  • Add Passport methods (see #90);
  • Resolve discrepancies with Bot API 5.5 (see #87, #88)
  • Make startPolling polymorphic (see #86);
  • Add Updating messages methods (see #85) ;
  • Add missing methods (see #83, #84);
  • Add GameBot (see #82, #95);
  • Allow return different types in BotM (see #79, #98);
  • Fix UserId integer overflow (see #78);
  • Upgrade EchoBot example with sticker replies (see #77);
  • Refactor file uploads (see #76);
  • Add Stickers methods (see #72, #73, #74 and #75);
  • Refactor FileInfo (see #71);
  • Add Game methods (see #70);
  • Fix MessageId integer overflow (see #69);
  • Add missing types (see #66, #81);

0.3.8

  • Fix notification disable mechanism in sendDocument function (see #54);
  • Implement getFile and sendPhoto API methods (see #49);

0.3.7

  • Add inline mode support (see #45);

0.3.6

  • Remove extra spaces, restore Tested-with (see #48);
  • Add support of ghc 9 (see #47);

0.3.5

  • Restore backward compatibility with older GHCs (see #40);

0.3.4

  • Fix cron job, restrict dependency on cron (see #38, #39);

0.3.3

  • Derive Hashable for MessageId (see #36);

0.3.2

  • Implement forwardMessage API method (see #35);
  • Add MarkdownV2 parse mode (see #33);

0.3.1

  • Implement sendDocument function support. (see #31);
  • Add Travis CI (see #32);
  • Add MonadFail instance for UpdateParser (see #27);

0.3.0

  • Add underline and strikethrough MessageEntityTypes (see #25);
  • Fix for Stack 15 (see #24);
  • Fix installation after breaking change in servant-0.16 (see #21);
  • Add phonenumber type (see #23);
  • Add cashtag message entity type (close #19) (see #20);
  • Feat/kick chat member (see #17);
  • Feat/delete message method (see #16);
  • Fix startBotAsync, add processActionsIndefinitely (see #12);
  • Add some badges to README (Hackage/Stackage/Travis) (see 11f13f3);
  • Remove temporary files/scripts from repo (see 6bc9f48);
  • Add info about LambdaConf 2018 workshop and contributing (see 1ba4d95);
  • Add Data.Monoid import to fix builds on GHC 8.2 (see c798001);

0.2.0

  • Major changes:

  • Minor changes:

    • Add getEnvToken helper (see ce7d1f7);
    • Add IsString instance for Telegram.Token (see f105bb9);
    • Print Servant errors when getUpdates fails (see bc7c5bb);
    • Split Telegram.Bot.Simple into several submodules (see 8ed2783);
    • Add withEffect helper in Telegram.Bot.Simple.Eff (see aebba52);
    • More Haddock documentation;
  • Fixes:

    • Resolve #7 (see #8);
    • Fix undefined in startBotAsync and add more documentation (see 7879066);
    • Fix inline buttons issue (see #10);