Telegram integration

Learn how to integrate Telegram.

Released in 2013, Telegram has over 100 million users and is the most popular messaging app in Russia, Iran, and Brazil. Around 85% of Telegram users are on Android devices. Telegram is known for its highly secure messaging standards.

Available for use on different devices, Telegram is focused on speed - it delivers messages throughout different channels no matter what type of file you are sending - text-based messages, photos, audio, video and any other file type; including doc, zip, mp3 and more — up to 1.5 GB each.

Creating your Telegram Bot

The first step in communicating with your users over Telegram is creating a Telegram Bot. Bots are third-party applications that run inside Telegram. Users can interact with bots by sending them messages. You control your Bots using our API methods; Send message and Receive message.

To create new Bots and manage existing ones, use the Telegram’s BotFather Bot and follow a few simple steps. You can find the BotFather Bot by searching for it in the Telegram Messenger App. For more details on how to create a Telegram Bot please click here.

Once you’ve created a Bot and received your Authorization Token, you can proceed and register your Bot on Infobip’s platform.

Integration setup

To start sending messages over Telegram, you first need to register it on Infobip’s platform. This is done by adding the Telegram integration to the application you have already created here. Use the Authorization Token from the previous step as a value of the authenticationToken parameter.

Authorization Token

Copy and save your Authorization Token somewhere convenient as you will need it during the next steps.

Request example

POST /omnichat/1/applications/0F3C3F29829FAB88714BA205BEC6D28F/integrations/telegram HTTP/1.1
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json

  "bot": {
    "authenticationToken": "..."


  "bot": {
    "id": 1234,
    "firstName": "First name",
    "lastName": "Last name",
    "username": "Username"

That’s it!

You are now ready to send test messages by using the ‘Send chat message API’ method.

Every message we receive from your subscribers will be forwarded to the URL you provided and is described in more details in the Receive message section.

How can my organization contact people over Telegram?

Bots can’t initiate conversations with users. A user must send them a message first. People can use links or username search to find your bot. Bot usernames always end in ‘bot’ (e.g. @TriviaBot, @GitHub_bot). To opt in, make sure to click on start in the Telegram application.