{"_id":"58b04eaa3529383900a759d1","parentDoc":null,"user":"57c6d393bd38ec0e00facdd9","__v":0,"category":{"_id":"58b04a023529383900a759b5","__v":0,"version":"54eb63b859b1172100334fae","project":"54eb50e5615ffc1900305a16","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2017-02-24T14:58:10.723Z","from_sync":false,"order":18,"slug":"telegram-messaging","title":"Telegram messaging"},"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"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2017-02-24T15:18:02.348Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"Creating an application on Infobip's platform is the first step in using the Telegram over Infobip API. Setup process starts with the application setup (on Telegram and Infobip platforms) and continues with the Configuration and Action setup (for receiving messages).\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0be37f1-fb1.PNG\",\n        \"fb1.PNG\",\n        491,\n        87,\n        \"#dfd5d6\"\n      ],\n      \"caption\": \"Setup process\"\n    }\n  ]\n}\n[/block]\nOn this page, you will find the instructions on how to:\n* [Crate a new Infobip application over an API](#create-a-new-application)\n* [List all your applications over an API](#list-all-applications)\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Info\",\n  \"body\": \"After you finish with the application setup, you can continue with configuration and action setup.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"post\",\n  \"title\": \"Create a new application\"\n}\n[/block]\nThis method allows you to create a new application\n\n```\nhttps://api.infobip.com/telegram/1/applications\n```\n\n##Body parameters\n\n|Parameter|Type|Default value|Description|\n|-|-|-|\n|[telegram](#section-telegram-object)|object|-|Telegram object|\n\n#### Telegram object\n\n|Parameter|Type|Default value|Description|\n|-|-|-|\n|[bot](#section-bot-object)|object|-|Bot object|\n\n#### Bot object\n\n|Parameter|Type|Default value|Description|\n|-|-|-|\n|authenticationToken|string|-|Telegram authentication token|\n\n###Request example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"POST /telegram/1/applications HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\\nContent-Type: application/json\\n\\n{\\n  \\\"telegram\\\": {\\n    \\\"bot\\\": {\\n      \\\"authenticationToken\\\": \\\"...\\\"\\n    }\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n###Response\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"key\\\": \\\"8F0792F86035A9F4290821F1EE6BC06A\\\",\\n  \\\"telegram\\\": {\\n    \\\"authenticationToken\\\":\\\"...\\\",\\n    \\\"bot\\\": {\\n      \\\"id\\\": 1234,\\n      \\\"firstName\\\": \\\"First name\\\",\\n      \\\"lastName\\\": \\\"Last name\\\",\\n      \\\"username\\\": \\\"Username\\\"\\n    }\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nOn success, the response header HTTP status code will be `200 OK`. \n\n|Parameter|Type|Default value|Description|\n|-|-|-|\n|key|string|-|Infobip application key|\n|telegram|object|-|Telegram object|\n\n#### Telegram object\n\n|Parameter|Type|Default value|Description|\n|-|-|-|\n|authenticationToken|string|-|Telegram authentication token|\n|bot|object|-|Bot object|\n\n#### Bot object\n\n|Parameter|Type|Default value|Description|\n|-|-|-|\n|id|int|-|Unique bot ID|\n|firstName|string|-|Bot's first name|\n|lastName|string|-|Bot's last name|\n|username|string|-|Bot's username|\n\nOn error, you will receive an [error response status code](/docs/response-codes#section-chat-error-codes). If you try to create an application without the user’s authorization, you will receive a `401` Unauthorized error.\n[block:api-header]\n{\n  \"type\": \"get\",\n  \"title\": \"List all applications\"\n}\n[/block]\nUse this method to retrieve all of your applications\n\n```\nhttps://api.infobip.com/telegram/1/applications\n```\n\n###Request example\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"GET /telegram/1/applications HTTP/1.1\\nHost: api.infobip.com\\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n###Response\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"applications\\\": [\\n    {\\n      \\\"key\\\": \\\"8F0792F86035A9F4290821F1EE6BC06A\\\",\\n      \\\"telegram\\\": {\\n        \\\"authenticationToken\\\":\\\"...\\\",\\n        \\\"bot\\\": {\\n          \\\"id\\\": 1234,\\n          \\\"firstName\\\": \\\"First name\\\",\\n          \\\"lastName\\\": \\\"Last name\\\",\\n          \\\"username\\\": \\\"Username\\\"\\n        }\\n      }\\n    }\\n  ]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nOn success, the response header HTTP status code will be `200 OK`. \nOn error, you will receive an [error response status code](doc:2fa-status-codes-and-error-details) in the header and the response body will contain an [error object](doc:2fa-status-codes-and-error-details). If you try to create an application without the user’s authorization, you will receive a `401` Unauthorized error.","excerpt":"Manage Telegram application on Infobip platform","slug":"telegram-application","type":"basic","title":"Application"}

Application

Manage Telegram application on Infobip platform

Creating an application on Infobip's platform is the first step in using the Telegram over Infobip API. Setup process starts with the application setup (on Telegram and Infobip platforms) and continues with the Configuration and Action setup (for receiving messages). [block:image] { "images": [ { "image": [ "https://files.readme.io/0be37f1-fb1.PNG", "fb1.PNG", 491, 87, "#dfd5d6" ], "caption": "Setup process" } ] } [/block] On this page, you will find the instructions on how to: * [Crate a new Infobip application over an API](#create-a-new-application) * [List all your applications over an API](#list-all-applications) [block:callout] { "type": "info", "title": "Info", "body": "After you finish with the application setup, you can continue with configuration and action setup." } [/block] [block:api-header] { "type": "post", "title": "Create a new application" } [/block] This method allows you to create a new application ``` https://api.infobip.com/telegram/1/applications ``` ##Body parameters |Parameter|Type|Default value|Description| |-|-|-| |[telegram](#section-telegram-object)|object|-|Telegram object| #### Telegram object |Parameter|Type|Default value|Description| |-|-|-| |[bot](#section-bot-object)|object|-|Bot object| #### Bot object |Parameter|Type|Default value|Description| |-|-|-| |authenticationToken|string|-|Telegram authentication token| ###Request example [block:code] { "codes": [ { "code": "POST /telegram/1/applications HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==\nContent-Type: application/json\n\n{\n \"telegram\": {\n \"bot\": {\n \"authenticationToken\": \"...\"\n }\n }\n}", "language": "json" } ] } [/block] ###Response [block:code] { "codes": [ { "code": "{\n \"key\": \"8F0792F86035A9F4290821F1EE6BC06A\",\n \"telegram\": {\n \"authenticationToken\":\"...\",\n \"bot\": {\n \"id\": 1234,\n \"firstName\": \"First name\",\n \"lastName\": \"Last name\",\n \"username\": \"Username\"\n }\n }\n}", "language": "json" } ] } [/block] On success, the response header HTTP status code will be `200 OK`. |Parameter|Type|Default value|Description| |-|-|-| |key|string|-|Infobip application key| |telegram|object|-|Telegram object| #### Telegram object |Parameter|Type|Default value|Description| |-|-|-| |authenticationToken|string|-|Telegram authentication token| |bot|object|-|Bot object| #### Bot object |Parameter|Type|Default value|Description| |-|-|-| |id|int|-|Unique bot ID| |firstName|string|-|Bot's first name| |lastName|string|-|Bot's last name| |username|string|-|Bot's username| On error, you will receive an [error response status code](/docs/response-codes#section-chat-error-codes). If you try to create an application without the user’s authorization, you will receive a `401` Unauthorized error. [block:api-header] { "type": "get", "title": "List all applications" } [/block] Use this method to retrieve all of your applications ``` https://api.infobip.com/telegram/1/applications ``` ###Request example [block:code] { "codes": [ { "code": "GET /telegram/1/applications HTTP/1.1\nHost: api.infobip.com\nAuthorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==", "language": "json" } ] } [/block] ###Response [block:code] { "codes": [ { "code": "{\n \"applications\": [\n {\n \"key\": \"8F0792F86035A9F4290821F1EE6BC06A\",\n \"telegram\": {\n \"authenticationToken\":\"...\",\n \"bot\": {\n \"id\": 1234,\n \"firstName\": \"First name\",\n \"lastName\": \"Last name\",\n \"username\": \"Username\"\n }\n }\n }\n ]\n}", "language": "json" } ] } [/block] On success, the response header HTTP status code will be `200 OK`. On error, you will receive an [error response status code](doc:2fa-status-codes-and-error-details) in the header and the response body will contain an [error object](doc:2fa-status-codes-and-error-details). If you try to create an application without the user’s authorization, you will receive a `401` Unauthorized error.