{"_id":"59551122cb31f200158a2c7d","project":"54eb50e5615ffc1900305a16","version":{"_id":"54eb63b859b1172100334fae","project":"54eb50e5615ffc1900305a16","forked_from":"54eb63a1867e1917009b711d","__v":28,"createdAt":"2015-02-23T17:30:32.501Z","releaseDate":"2015-02-23T17:30:32.501Z","categories":["54eb63b959b1172100334faf","54eb63b959b1172100334fb0","54eb63b959b1172100334fb1","54eb63b959b1172100334fb2","54ed8dd4ab373e2300f50eae","54ed99b2ab373e2300f50ede","55153a6de68daa2f00cff838","551546edbc466623002afe72","5515472ac28d6125001b8884","55154749c28d6125001b8885","555d9b4106dfec0d00d38ea7","5613e06e433e5735007c7708","5624bbb785a31117001c5403","56669e857cc81e0d00253f8e","568b8d837a42220d00498311","56a632277ef6620d00e2f18a","56d8147c3eb4dd0b00201aac","57a9ce2fac6db30e000d7efd","57a9cf4e944ea60e00dc3f74","58172386715dce0f00da4aa0","582dc59ee1b8692300c0dd03","589b19b4fec2730f0082e040","58b04a023529383900a759b5","58b92d1598157a0f004869bf","592e7685c58275000f20174f","59392839e376d4002f8a0474","59393064e376d4002f8a05a1","5947ae0d4005e2000f3a4fec","594a74df1d1de5001ab3517a","5954bc387a147f001b918915","59b8eeeb707542001076d3b6"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"category":{"_id":"5954bc387a147f001b918915","project":"54eb50e5615ffc1900305a16","version":"54eb63b859b1172100334fae","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-06-29T08:37:12.853Z","from_sync":false,"order":7,"slug":"omni-chat","title":"OMNI Chat"},"user":"57a98d832242630e00cc8df7","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-06-29T14:39:30.062Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":5,"body":"Released in 2013, it has over 100 million users and it’s 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.\n\nAvailable 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.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Creating your Telegram Bot\"\n}\n[/block]\nThe first step in communicating with your users over Telegram is creating a **Telegram Bot**.\nBots 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](doc:omni-chat-send-message) and [Receive message](doc:omni-chat-receive-message).\n\nTo 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.\nFor more details on how to create a Telegram Bot please click [here](https://core.telegram.org/bots#3-how-do-i-create-a-bot).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3b363d9-telegram_token.PNG\",\n        \"telegram_token.PNG\",\n        640,\n        1136,\n        \"#e7e8ed\"\n      ]\n    }\n  ]\n}\n[/block]\nOnce you've created a Bot and received your **Authorization Token**, you can proceed and register your Bot on Infobip's platform.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Integration setup\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/99ef118-integration.png\",\n        \"integration.png\",\n        320,\n        98,\n        \"#e4dcd5\"\n      ]\n    }\n  ]\n}\n[/block]\nTo start sending messages over Telegram, first you need to register it on Infobip's platform. This is done by adding the Telegram integration to the application you have already created [here](/docs/omni-chat-application). Use **Authorization Token** from the previous step as a value of `authenticationToken` parameter.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Copy and save your **Authorization Token** somewhere convenient as you will need it in the next steps.\",\n  \"title\": \"Authorization Token\"\n}\n[/block]\n###Request example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /omnichat/1/applications/0F3C3F29829FAB88714BA205BEC6D28F/integrations/telegram HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\n\\n{\\n  \\\"bot\\\": {\\n    \\\"authenticationToken\\\": \\\"...\\\"\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n###Response\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"bot\\\": {\\n    \\\"authenticationToken\\\":\\\"...\\\",\\n    \\\"id\\\": 1234,\\n    \\\"firstName\\\": \\\"First name\\\",\\n    \\\"lastName\\\": \\\"Last name\\\",\\n    \\\"username\\\": \\\"Username\\\"\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n**That's it!** You are now ready to send test messages by using ['Send chat message API' method](/docs/omni-chat-send-message).\n\nEvery message we receive from your subscriber will be forwarded to the URL you provided and is described in more details in the [Receive message](/docs/omni-chat-receive-message) section.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"How can my organization contact people over Telegram?\",\n  \"body\": \"Bots can’t initiate conversations with users. A user must send them a message first.\\nPeople can use **telegram.me/<bot_username>** links or username search to find your bot. Bot usernames always end in ‘bot’ (e.g. :::at:::TriviaBot, @GitHub_bot).\\nTo optin, make sure to click on start in telegram application.\"\n}\n[/block]","excerpt":"","slug":"omni-chat-telegram-integration","type":"basic","title":"Telegram integration"}

Telegram integration


Released in 2013, it has over 100 million users and it’s 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. [block:api-header] { "type": "basic", "title": "Creating your Telegram Bot" } [/block] 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](doc:omni-chat-send-message) and [Receive message](doc:omni-chat-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](https://core.telegram.org/bots#3-how-do-i-create-a-bot). [block:image] { "images": [ { "image": [ "https://files.readme.io/3b363d9-telegram_token.PNG", "telegram_token.PNG", 640, 1136, "#e7e8ed" ] } ] } [/block] Once you've created a Bot and received your **Authorization Token**, you can proceed and register your Bot on Infobip's platform. [block:api-header] { "type": "basic", "title": "Integration setup" } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/99ef118-integration.png", "integration.png", 320, 98, "#e4dcd5" ] } ] } [/block] To start sending messages over Telegram, first you need to register it on Infobip's platform. This is done by adding the Telegram integration to the application you have already created [here](/docs/omni-chat-application). Use **Authorization Token** from the previous step as a value of `authenticationToken` parameter. [block:callout] { "type": "warning", "body": "Copy and save your **Authorization Token** somewhere convenient as you will need it in the next steps.", "title": "Authorization Token" } [/block] ###Request example [block:code] { "codes": [ { "code": "POST /omnichat/1/applications/0F3C3F29829FAB88714BA205BEC6D28F/integrations/telegram HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\n\n{\n \"bot\": {\n \"authenticationToken\": \"...\"\n }\n}", "language": "json" } ] } [/block] ###Response [block:code] { "codes": [ { "code": "{\n \"bot\": {\n \"authenticationToken\":\"...\",\n \"id\": 1234,\n \"firstName\": \"First name\",\n \"lastName\": \"Last name\",\n \"username\": \"Username\"\n }\n}", "language": "json" } ] } [/block] **That's it!** You are now ready to send test messages by using ['Send chat message API' method](/docs/omni-chat-send-message). Every message we receive from your subscriber will be forwarded to the URL you provided and is described in more details in the [Receive message](/docs/omni-chat-receive-message) section. [block:callout] { "type": "info", "title": "How can my organization contact people over Telegram?", "body": "Bots can’t initiate conversations with users. A user must send them a message first.\nPeople can use **telegram.me/<bot_username>** links or username search to find your bot. Bot usernames always end in ‘bot’ (e.g. @TriviaBot, @GitHub_bot).\nTo optin, make sure to click on start in telegram application." } [/block]