Connecting Telegram to Albato: Integration options

Connecting Telegram to Albato: Integration options
Telegram
·
5/25/2022
·
6 min. read

Now you can use not only the Albato Telegram bot, but also create your own. You can start an automation when the bot receives a message, and when a message has been sent in the group with the bot as well.

When you connect your Telegram bot to Albato, you enter the Albato webhook in its settings to send all the events to Albato. This means that if your bot is connected to another system and uses third-party functionality, it will be disconnected and will only use Albato functionality.

How to create a bot and get the API key

Create a bot and connect it to Albato or choose the one you have created before from @BotFather.

If you have a bot, follow these steps:

  • Send a /start command in a message to the Bot.
  • Send a /mybots command in a message if you have a bot and you need to receive its API key.
  • Select the bot from the list and request the API key you need to connect.

Telegram 1.png

If you need to create a bot, follow these steps:

  • send a /newbot command in a message
  • send a name of your bot. It will be public.
  • specify the user name. It will be displayed after @ symbol and should end with “bot”. For example: youNamebot or youName_bot.

When you get an API key for a new bot, you can connect it to Albato.

Telegram 2.png

How to create a connection

Open the Apps section, click the Add a connection button, select Telegram.

Telegram.png

Set the name for your connection.

Enter the API key copied from @BotFather.

Click the Continue button.

Telegram (1).png

The connection is ready!

Telegram (2).png

How to use Bot

Once you've connected the Bot, any user who sends the /start message will be added to the list of chat IDs. If you send this command to a group chat with your Bot, it'll parse the ID of the current group/channel.

To send a message to Telegram, you need to know the chat ID where the message will be sent. You can't use a login or a phone number according to the rules of the Telegram API.

So, if you want to send a message to a user or a group, the bot in the right chat needs to get a message with the /start command. Once it has the chat ID, you can select it from the list and use it in the Send message action.

How the “Incoming Message” trigger works

The "Incoming message" trigger will run every time any user sends a message to your Bot, or a new message appears in a group/channel with the connected Bot. Any commands that begin with the “/” symbol (e.g., /start) are ignored by the trigger and do not start an automation, even if there is a text after a command.

But you can enable some commands for trigger. To do this, open the trigger settings:

Telegram (3).png

Here you can list the allowed commands:

Telegram (4).png

As a result, if the bot receives a message with allowed command and text, it will also run a trigger. For example, it will pass the text /yourCommand Hello to the automation.

The trigger, together with a message text, receives other data too. Example: the name and ID of the user who sent the message and the chat ID where the message came from.

Telegram (5).png

Thus, you can set up additionally the trigger filters to run the automation:

  • from a certain text;
  • when a certain user in the group sends a message.
  • when it receives messages from a particular chat.

Click on the Filter icon to set up the conditions.

Telegram (7).png

In the Value drop-down list you can find From and Chat values. The "From" values show who sent the message. We suggest using it when you're getting messages from a group. The "Chat" values are for the chat info (private chat with bot/group/channel).

Telegram (8).png

Just a heads-up: if your bot is going to be in multiple chats, make sure you use filters.

Read more about filter settings in this tutorial.

How the "Send Message" action works

The "Send Message" action allows you to send a message to the selected chat using any Albato trigger. The functionality is similar to our bot described here.

The difference is that a certain chat is no longer linked to a specific connection, it must be selected from the list in the action field.

Telegram (9).png

Next, you can select the markup type.

Telegram (10).png

You can also create a small text format, such as HTML, with pictures and links.

You can use this action with the Table lookup tool. For instance, you can choose which managers to notify about a new CRM deal. This will help you avoid including everyone in one channel.

It will work like this:

  • You receive a new Kommo event (e.g. the "New task" trigger).
  • Using the Table lookup tool, Albato checks the name of the responsible user and replaces that name with the chat ID.
  • This responsible manager receives a notification in Telegram.

Telegram (11).png

Then set up the action. Select the result of the Albto Table lookup tool in the Chat ID field.

Telegram (12).png

Automation scenario examples

Let’s suppose you need to create a task in YouTrack. Send a message to the bot and it will create a task automatically.

Ex (14).png

Let’s say you need to find out who’s sending a certain phrase. To do this, just set up a filter on the "Text" field with the "Contains" condition and specify the desired phrase.

Telegram (14).png

This filter is great for use with an action that creates a lead or a deal in a CRM system, as well as a record in Google Sheets. This way, you won't miss a single message, even if there's a lot of spam from users.


Telegram