Skip to content

Telegram platform configuration

Connect your Telegram bot to Pushwoosh to run Telegram as part of your omnichannel journeys from one place and track delivery results in Journey analytics.

Prerequisites

Anchor link to

Before configuring Telegram, ensure the following requirements are met:

  • Telegram account: Use an active Telegram account that can access @BotFather.
  • Telegram bot: Create a Telegram bot in BotFather.

Copy your Telegram bot API token

Anchor link to

To get an API token for an existing bot:

  1. In Telegram, open @BotFather.
  2. Send /mybots and select your bot.
  3. Tap API Token and copy the token.

If you do not have a bot, create one in @BotFather by following the official Telegram guide.

Set up the Telegram configuration in Pushwoosh

Anchor link to

To set up the Telegram configuration, follow these steps:

  1. Navigate to Settings > Configure platforms and open Telegram.

  2. (Optional) If you don’t have a bot yet, click Open BotFather in the Create a new Telegram bot panel and create the bot in Telegram.

  3. Click Add token.

Telegram integration screen in Configure platforms with Add token and instructions for BotFather.
  1. In the Connect Telegram bot dialog, enter the API token you copied from BotFather. Learn how to get the token.
Empty Connect Telegram bot dialog with the API token field, Check token, Cancel, and Connect.
  1. Click Check token to verify the token.
Connect Telegram bot dialog after Check token, showing Token is valid with the bot name, bot ID, and username.
  1. Click Connect to save. To discard changes, click Cancel.

Manage Telegram bot tokens

Anchor link to

Replace the bot token

Anchor link to
  1. In Telegram settings, click Replace bot.
  2. In the Confirm replace Telegram bot dialog, click Replace bot.
  3. In the Connect Telegram bot dialog, enter the new API token.
  4. Click Check token.
  5. Click Connect.

Delete a token

Anchor link to
  1. Click the three-dot menu next to the bot token.
  2. Click Delete.

Deleting a token turns off Telegram for the project. Active journeys and scheduled one-time campaigns keep running, but their Telegram messages aren’t delivered. To turn Telegram back on, set up the Telegram configuration again with a bot token.

Send Telegram messages

Anchor link to

After setup, you can send Telegram messages in Customer Journey Builder.