Uspacy Knowledge Base
All materialsCommunication hubExternal channels

External Lines: Telegram. How to connect?

External Lines: Telegram. How to connect?

Here we'll tell you what you need to do to configure the integration with Telegram to communicate with clients directly in the Space chat

With the help of External Lines, you can communicate with clients directly in your Uspacy while they write to you to third-party messengers, for example, in Telegram.

DpSnweA_G3thZTdsQSmGIGa6wzWvwZgtfUf9DfTUrRxhkisCQvBm7vgWXqreL04jramceExFP1m__tGw_zFHs2EzFo1zwgvQKCQdNCCv2MxhiVYxKEGO2EJuIrbJnOQ4e9HLK0G6dXjMRExweXd5mOQ

To do this, it is enough to connect and configure the integration, which will ensure that messages are sent to the Space.

k6bjNsutNgg-bYtYyauE6cD5FG6kdWKTTHpduL68d3bJ9-FqzoawxTzuL-TfYSJA4YexXbxfFV1jqVQe_gPES8fFFPqPoYckZD2vxXfY837FY52TsZSa0Qs1tbSBJYxmf6KM98gMYJt603yMzd1Hnlc

Features of work

At Uspacy, the functionality of external lines is implemented through integrations with specialized services.

In the Marketplace section there is a free application for work with Telegram, which, after its installation and configuration, will allow you to work with client requests in the Uspacy chat.

💡Telegram is connected to your Space via a special Telegram bot.

If you already have one, you can easily configure it to work at your Uspacy using the Auth Token option.

If you have never worked with a Telegram bot before, then in order to work and connect to the external lines of Space, you will need to create it first.

About everything below ⬇️

Creating a new Telegram bot

To do this, go to the application and enter BotFather in the search bar.

aEvoAjsQpTLTuNATrejY0kM9kk2d6GJOuI94gB5u0twcI7Xqxalkh3RnXfvndqjpLaaB5FGaeMnFbAOFndPduGWCiyOtkGeKxRD-T4kSAQkFw876H1YrIRWv13zINfGmG4mYNKgf286vGWhZ_ZL5HhI

Open this chat and click on the Start button.

i_6HeGz7-jSlPS5amwlADC3Pa8fd-RnmpE5mfcUeX538enbC1RUVwUl_6R8mzro-eA3HzU4cdX-4aloQXmgzPbgj_vbcYnbHQAigMFSBMXl_qbUOuUbJaOc0bf23wDBnODIaV_40Tf9T8h6HmZU6XiE

To create a new bot, use the new bot command.

9rbX8F8SuOu9l8lP6ygl19Yi4fzFrYB5quBrjlTIXZHPMrrMEPolawsbsoP3N-TK6a41B9OW0j7JqPL5nqD8QpEIBq5j_o7sYpN5PQJ1uR9MGxiU5ZOOBEEI1qYIlhvtDXFTMs-tRM9r02nIsiyt-4E

Next, specify its name. It is what clients will see when contacting you via Telegram. For example, JuniorWorld. Send the name in the chat.

QAf3wQ5aGv-9ZtLE2QfX7EnMWQVxwpuJnDnBqf0mXDAJj1HMVJ0SpGtWaXyIqZN662dpp5rxCOBzUAk4RuyCmr6kE6yyPOS5RhxtCUpWlXW44Sbsgd7O7gKv5k_pyvZ_of6g1Qh6vTrvW-ginJyKk6M

Next, enter the user name. It should be unique, because by this name the clients will know you in Telegram.

💡The username must end with the word bot.

For example, JuniorWorld_bot.

adglkAfPNQGn-pvvY0MTW88-Diz5vVtdO8OAUSvxBPj49yMWZyrtvHWVAtbKdGxT-pdCjRyuAPSc8TZQbJe0qQ8twI3g0-5Ie-F4aR-5cMsbnzShMlqnam0gXXALcS3SN1Z-3_cZKGkpxA3Z-QPmqzk

After sending, your bot will be created, and you will receive the necessary parameter to connect to Uspacy - Auth Token.

Od7inPW6_j27RVKlECJ1fa2ootFzBypg-9qsyibJVCrONo2fJxwnexVOUYy2RZtP5e2Izo9XKlshCjb5Gmmio4uJK6fuE9vhAa3CJA1SgepXl7z_OvrwCCKwJRXuyp1Bo_WUlC7QBtTG2tDA-kdnXpw

Bot settings

This Telegram bot allows you to communicate with your clients not only in personal chats but also in group ones. To enable or disable the option to add it to Telegram groups, go to its settings. To do this, use the /mybots command and select the desired bot.

💡If you have only one of them, then only this one will be available for selection.

krA_YoALe0Xa63nR4-gmCreghqct0tNkIDwjkthBV6g9wi22AEhYov9dyTHj4Yly0FUfHBkqPB5hQwUHqx-l9oa2cW_O0qJVjLh-z8vxZ6LD9JPldwjL2VnHZHo4p5V9qeZe7RM_EdZHsQ3-DtOysx4

Next, click on the Bot Settings item to go to the settings.

kaXQmO9s0I8eFMaNGJPQiQgeap_xFznJRownH33pIBQ-DbMKQMMHFT_lgCyfLqYAyskwKG3ZoYTI2BjjsSmvUiKr4IijRrCLktLIp6oJjZ0aBLp0hC40gxncOueI7Xi7_xKq3u4Y_I0P1uOzDWQCO2Y

Select Allow Groups?

yOWEed4ftFD0N7tpLYdWokNbVPEsSSD-xJvgIzWSc5ctheMk82KYLslk1KAmfZ9GsRuptd0AK9ICPkkI2hZVqgdLoCDPwAS4sJKFeDjXzpNHaBB4yHI90Gmy367mCg73Fpbc2dOLbprDHDJVf_wtzpQ

Click Turn groups off. The bot will not be able to be added to group chats now.

bX3G100VESEnOzXfOA496FrgLCtgU-HurI2cglBDFKE2u68wprkHtWpvficgyytQFGe1esEuJ6r0EKyhuuhgIwDM5UBfS2gz-TVroApWQ4OZStVWfQgBW7qoPOcNhHh7LJQGTZyLMlXyHJdkDzt23ZM

The Turn groups on option, on the contrary, allows you to add it to group chats.

AD_4nXeC3rxyyhB-BZI5nxjZ7DeCFQd_hu3IunYUeU0OrhRpjO7FiMPH9P4n2ZtCO8PjodOr_rksk8x3d4PmQ-qs72z-kKezORLo6Kz5AIaSNYKRstNy-gN0TBD96vcUqx1Pv2eKwm5_vLdrCmRe2iqQUninm_4r

⬇️🔍 You can read more about the features of the bot in group chats below

To be recognized among clients, and just for the visual component, select a profile photo for your bot. To do this, use the /setuserpic command.

4oAs9wIIZMEOjuwSGaVMbSWoreHJNf0n-L50GunVV-81vr4mwMvnBpro9ofCjz2qYEFThxpWohRF4nvlq5Rqdw02Qrghb77eu2rsuINBoqirnW2hTZkB2gTkB1lh2VrHcYRKBq08_Dk3frdKWBhZ-6c

Select the bot for which you want to set a profile photo.

💡If you have only one of them, then only this one will be available for selection.

QSarsRHXXsnjSenMYzWb5SivZ1jfozuLvuMlR1iJ9gLZU4OpwuX1hEbbwp9xdp3r8pieFLdl2d07iLNvHqQT9JpZIjy9LGoIAPNKLahY0mNa7Xmh1k_fbBa0Ah-SNjD6Wm5dnkYvHx4JD6g6RGOaTuU

Send the photo you chose.

gI0gnZg7EdTcHnvDOuCmummHJmTijvKuoyC9pQJkqlgdlryJgTRtC4Ok84PaNt5zZRnypActYAHWTBIYkJw_w2mZ8AOR2Pin7WEgGBwFs9flgoPPoaFhyRhmfEvK5SKfRlcdZXnFVFysZ3nrOIg_xfs

At this stage the creation and configuration of the bot is complete. Now you can use it and connect to your Uspacy.

Getting the Auth Token parameter of an existing bot

If you already have a bot and just want to use it to connect to Space, then you also need to use BotFather.

UKdHXtcMBoRGmlITnXLQ3M3eftDOmdibNm7hgVRfPg6lxC2j8x412PxfZ0e6ksX2HRsiWhY369ZlOZij1418F5V3N_fgrtYe_78jyyMTgf7k5xmztm9jS1i5cXYnm8OCHMFgMc4ssmNiCUD9i86-FO0

Just enter the command/token in the text input field and send it to the chat. Then select the bot that requires the Auth Token parameter.

💡If you have only one bot, then only this one will be available for selection.

qEYeCFjgAEqD4QtA0Hc_R5WrcC672jGyoHkopG5psQUWmYe293EzlsF1S0JyjkNsRf3BYf3nwGuO0ndWXLmBLcm9V_Wd7lb4AVvSm6DiW5o0EYByPdupvaQkvUX0xUJhHhzOdJSQzXS9Y2LHYXuH_HA

As a result, BotFather will send you a token from the desired Telegram bot, which you need to use to connect to your Uspacy.

uVTVuS0UOB_Al2GbStRqxffxeq5tXgI49NHJnL7_bSRrbQ9K7ylV47YT_u4Sph2EW1SVyjiTFVtxqfn8qtVX4XybX_fI_SkMi4uZ8w33FJn83bvHGqrw2CNgYIb55wKagDVBViLh9uSm7BLmHFR1rRU

Token replacement (revocation)

If necessary, it is possible to reset the current token and replace it with a new one that will be generated automatically. This is an additional security measure.

To reset, use the /revoke command and send it to the chat. Then select the bot for which you want to replace the token.

💡If you have only one bot, then only this one will be available for selection.

7l7yKKyUf6Otblji_srhwyoPIS7vsoMF08KPEi6028n0PqD8NVQ8zaf_a5bg4fojNC8usMtrSQG3hG5HxcEyOpV5WOz9gKw3TTFZxuDSz08dV1TCLsqXS5dGmJJeZTYzbGC40QGdtywCZcIpcRBLjKY

As a result, the token of your Telegram bot will be replaced with a new one. It will need to be used to connect (or reconnect) to Space.

yL2jY4qWgIw6zafP0hmV2nlD0M7KykNEFnvwpaWF6e319ofkrjBEZug-FBURTOHV13b026CMkw9WhlMVLL2JZiquO3vxXUtaUhp9gLoXvK3VKJ5TZVnphdTYee1lE1uUqAGdFItZeaW9AVsSBGp9tig

Connecting the Telegram bot to Space

First, you need to install a free app to integrate Telegram to your Space. To do this, go to the Marketplace section and click on the Get button.

aNGaHItH_FlRoxrHQ_R-NLQoFBPF3y21Zedi3RrT2lom08Fthu2cSAgqU5w4dbYUZyszF_-hi93G03eBxrpns2h4IgxPDbIdqqNsuGZyfdfMjMFMYBwZ5Knsu8CxOlxi-00OjLDlivrsm2Usj5ipNjc

When the application is installed, open its settings.

AD0FYwISzA4ksM7FAitnQ-qdN_6xxvvtfl2vig08086i66zdoiZKv7Lbhpd0xVCbFY65UwNp1XW6RGm46j9pm2Q47TLhfAyC-bu0s8DFeaXtEwwUN05Tdt4IlYPxXGPkfmDejl_Sqm4lyj9Zh9sgrDA

In order for everything to work correctly, all that remains is to fill out the fields with the necessary parameters:

  1. The name of the channel can be absolutely optional. For example, the same as the name of the bot that you specified when creating it.
  2. Auth Token – the token of your Telegram bot (new or existing).

a04bb013-7e29-4df8-bf56-7e9cc83edde2

You can also enable the option to Display the operator's name. This way, clients will be able to see which manager is responding to them.

f0606218-ca5d-4454-8924-595e3850bc85

And click Save.

a22000b5-a861-428b-8bf7-950c0138c3b9

💡 Additional connection settings include Access settings and CRM connections.

If you don't need to specify which employees should handle chats from this channel or define how those chats are distributed, simply leave the fields in this section unchanged.

Similarly, if you don’t need to link incoming chats to CRM elements, just leave the CRM connections section inactive.

52f73da9-9f99-405c-a302-0e64e63bd571

If you do need to configure these settings, you can find detailed instructions in the following articles:

🔍 Access settings in External Lines

🔍 CRM connections for External Lines

If it was successful, it will be displayed in status at once.

0fwdOWwZXLrpLMBhmvc5oKS4QIItoe3i6GEjRQ_1DPIKqCwIviJfEztX7X3Y9r84Sfa7dlo2Y5hrCIgvEVyaFZOCbI3thiqC-JVa_xQf3LQZZRoCBnqsZZFrqfV_RzP5cwUsKrf_kZNk9uUofhUrZyc

If necessary, you can either Add a new connection or Delete a number/channel that has already been configured.

ukfmUf8UAGtS3VpucvD85pPvXopbd3woOzFx1kZ4SQcPG9cfFh0leB5OEvKvpFw4vXMKHp7RAo8yK26F3HE8Ko8pRmftsvXsY7xBMHJaIWEyOJ3ot44yR8JO-fM9-Htj72OFEsQZrIPXBU6kd76_B1M

How does it work?

The client can find your Telegram bot when searching by name. Then open a chat and start writing.

🖇When chatting, you can also send images, gifs, videos and files in formats supported by Viber itself.

fkU-Ih3hhBe-syofPmySJUYAo6sInRGTqBPvq8LreKz7aiSKstCyBJY_NbzKVoMZUfD4Cz2vyaudOCinbSKAYXXqRFiGnnAKAuytpwxRfmSR4jeM7eWKkfNmbW5SHxm5_f5Zla7-doVIOA1hZzIcWFs

💡If the “Display operator name” option is enabled, the client will be able to see who from your company is communicating with them.

047e3bc6-9d62-4d34-8724-aa30fe8dedec

You will receive its message in the External Lines and you will be able to communicate with it directly in the chat of your Space.

DpSnweA_G3thZTdsQSmGIGa6wzWvwZgtfUf9DfTUrRxhkisCQvBm7vgWXqreL04jramceExFP1m__tGw_zFHs2EzFo1zwgvQKCQdNCCv2MxhiVYxKEGO2EJuIrbJnOQ4e9HLK0G6dXjMRExweXd5mOQ

🔍 You can read more about how to work with chats in external lines in the following article.

Features of working in group chats

In order to be able to receive and reply to messages from a Telegram group chat in your Space, you must first add a bot to that chat.

💡In order for the bot to be found in search, check whether you have set up the possibility to use it in group chats.

Monosnap+Telegram+2024-06-10+10-46-06.png

Next, assign it as administrator in this chat. This makes it possible to receive messages from Telegram to Space.

Monosnap+Telegram+2024-06-10+10-47-45.png

Done! A chat will be automatically created in your Uspacy at once.

💡Even if there are no messages after adding the bot, the chat will appear in the Space anyway.

Now you can continue to communicate in the Telegram group chat. But now the messages will be redirected to Uspacy. And you can answer them without leaving your workspace.

Monosnap+Uspacy+—+єдиний+робочий+простір+для+організації+щоденних+процесів+компанії+2024-06-10+11-00-21.png

Monosnap+IMG_6516+2-portrait_png+2024-06-10+11-05-57.png

🟣 Even if you add a bot to the chat, where there are messages, and give it access to view the last 100 messages, this correspondence will NOT get to Uspacy. That is, only new messages will be received after adding the bot and assigning it administrator rights.

🟣 Polls or video chats from Telegram will NOT be redirected to the workspace.

🟣 Important! Do not change the type of group (chat) in Telegram to Public for the FIRST time, when the bot has already been added to this group (and therefore the chat in Space has already been created). Because then its ID will change and this will create another same chat to appear at Uspacy. If the type changes not the first time, then there will be no duplicates.

If you have additional questions or you need to contact the support, send a request to this email [email protected]

Created: September 5, 2023 / Updated: September 2, 2025