Working with a Telegram bot in Integromat

This article covers what you can do by linking Integromat and Telegram, how to connect them, and a description of the triggers.

With Integromat you can perform various actions in your groups and channels, for example:

  • Send form answers to a group.

  • Notify the whole admin team about a new user, a payment, a started dialog, a published post and more.

  • Pin or unpin messages in resources.

  • Run housekeeping operations in a group (granting or revoking admin rights, deleting a message and so on).

  • Send any messages (and media) to resources.

  • And more…

How to do it

  1. Connect the webhook.

  2. Do a preliminary run.

  3. Get your data from the form (the small circle is an indicator with the number 1).

  4. Add the Telegram Bot module to the scenario.

  5. Invite your bot to the group/channel and grant it administrator rights (Warning: this group must be confirmed in your puzzlebot account, otherwise the bot will leave it on its own).

  6. Next, depending on the task, use the appropriate function (see Description of Telegram triggers below) — (we will try to pin a message from our form — Pin a Message).

  7. To pin a message, you first need to get that message into the group:
    Move the data you received (in step 3) into the Telegram Bot — Send a Text Message or a Reply module.

    • Chat ID: the address of your group (copy and paste it — @group_name).

    • Text: move the answer function here, that is, the message FROM the form that you will pin in the group. The final result looks like 1. forms [1]: answer (if you hover the mouse pointer over this item, you can choose a different sequence number of your form answer).

    • Disable Notifications: turns notifications for members on or off.

    • Disable Link Previews: turns the preview of your link on or off.
      Save — OK

  8. Add one more module, Telegram Bot — Pin a Message (it will pin the message you received):

    • Chat ID: move the function of the same name from the module window.

    • Message ID: move the function of the same name from the module window.

    • Disable Notifications: turns notifications for members on or off.
      Save — OK

  9. Done.

Description of Telegram triggers

Triggers in Integromat are modular pieces of functionality, for example sending a message or deleting that message.

To avoid repetition, here are the main settings:

  • Chat ID — the group id (the Chat tab)

  • User ID — the subscriber id (the From tab)

  • Parse Mode — the syntax to use: HTML or Markdown

  • Disable Notifications — turns notifications for members on or off.

  • Disable Link Previews — turns the preview of your link on or off.

  • Text — a text field whose contents will be sent to all subscribers (you can move in user answers from input forms, and add math formulas and variables from other modules).

  • Message ID — the id of the message you want to do something with (delete, edit, pin). Usually, every module that has this field must come right after the Send a Text Message or a Reply trigger. In other words, to work with a message, you need to know which message you are working with (its id).

Message actions:

  • Send a Text Message or a Reply — sends a message or a reply to a message.

  • Edit a Text Message — edits a text message.

  • Forward a Message forwards messages of any kind (this trigger can be used to forward messages only within Telegram). From Chat ID — enter the unique identifier of the chat the original message was sent to (or the channel address in the format @channel_name).

  • Delete a Message — deletes a message (a message can be deleted only if it was sent less than 48 hours ago).

  • Pin a Message — pins a message.

  • Unpin a Message — unpins a message.

Media actions:

  • Send an Audio File — sends an audio file.

  • Send a Document/Image — sends a document/image.

  • Send an Album (Media Group) — sends an album (media group).

  • Send a Photo — sends a photo.

  • Send a Sticker — sends a sticker.

  • Send a Video — sends a video.

  • Send a Video Note — sends a video note.

  • Send a Voice Message — sends a voice message.

  • Send Media by URL or ID — sends a file by an HTTP URL or by an ID that exists on the Telegram servers.

  • Download a File — downloads a file from the Telegram server.

Chat actions:

  • List Updates

  • List Chats

Subscriber actions:

  • List Administrators in a Chat — the number of admins in the chat + their privileges (the module only collects the result. To send the data to the chat, add one more module: Send a Text Message or a Reply)

  • Get the Number of Members is a Chat — the number of subscribers in the chat (the module only collects the result. To send the data to the chat, add one more module: Send a Text Message or a Reply)

  • Kick a Chat Member — removes a subscriber from the chat + blacklists them

    • Until Date: blacklists the subscriber until a specific date (format: 20.6.2016 17:26:44 GMT+03:00)

  • Restrict a Chat Member — makes a subscriber an administrator

    • Until Date: grants the rights until a specific date (format: 20.6.2016 17:26:44 GMT+03:00)

    • Set if the User Can Send Messages: whether the admin can send messages

    • Can Send Media Messages: whether the admin can send media

    • Can send Other Messages: whether the admin can send other messages (stickers, games, inline commands of third-party services)

    • Can Add Web Page Previews: whether the admin can enable link previews

  • Promote a Chat Member — grants privileges to an administrator

    • Change Info: whether the admin can edit the chat title, photo and other settings.

    • Create Channel Posts: create posts in the channel [a setting for channels]

    • Can Edit Messages: edit messages

    • Can Delete Messages: delete messages

    • Can Invite Users: invite people to the chat

    • Can Restrict Members: grant admin rights

    • Can Pin Messages: pin/unpin messages

    • Can Promote Members: grant privileges to subscribers

Other:

  • Make an API Call

Was this page helpful?