DialerBee APIv1 · 1.0.0-rc6

Telegram

Your company can receive customer messages on Telegram with a bot that you create and own. You paste the bot's token into DialerBee, messages arrive in the queue you choose, and your agents answer from the agent desktop. Telegram is off for your company until your administrator connects a bot. Nobody at DialerBee connects one for you.

Messenger and Instagram are coming soon. Only Telegram is available now.

Connect your bot (administrator)

  1. In Telegram, open @BotFather and send /newbot. Choose a name and a username for your bot.
  2. Copy the token BotFather gives you. Treat it like a password.
  3. In the DialerBee console, open Settings > Web chat and find the Telegram card.
  4. Choose the queue that Telegram messages should arrive in.
  5. Paste the token and press Connect bot.

DialerBee then checks the token with Telegram, stores it encrypted, and registers the connection with Telegram for you. The card says Connected as @yourbot, and the token is never shown again. Agents answer from the conversation list; the switch "Agents can reply from the desktop" is turned on with the connection.

The card tells you where you are:

What the card shows What it means
"Not connected", with the four steps No bot is connected. This is how every company starts.
"Connected as @yourbot" Your bot is registered and customer messages are arriving.
"The bot token stopped working" Telegram refused the bot (for example you revoked the token). Paste a fresh token.
"Not available on this platform yet" Telegram is switched off for the whole platform. Nothing is lost; your bot is kept.

To stop, press Disconnect. DialerBee asks Telegram to stop sending messages, and deletes the stored token. New Telegram messages stop arriving at once.

What you can do

What is not supported

Limits

Security

Errors you may see

Code (for support) What it means
invalid_token (422) That is not a token from BotFather, or Telegram did not accept it. Copy it again.
bot_already_connected (409) Another bot is already connected. Disconnect it first.
bot_taken (409) This bot is already connected to another company.
telegram_off (409) Telegram is switched off for the whole platform.
telegram_unavailable (503) Telegram could not check the token or register the connection. Nothing was saved; try again.
encryption_unavailable (503) The token cannot be stored safely right now. Nothing was saved; try again later.

Is there an API for this?

Not yet. The Telegram bot is managed in the console only. It is not part of the key-based API, and an API key cannot connect or disconnect a bot.