Guides · Telegram

Connect a Telegram channel in Vemra

Vemra receives messages for a Telegram channel through a bot you control. You will create the bot in Telegram, add it to your channel with the right permissions, then paste its credentials into Vemra.

Before you start

• A Telegram account.
• A Telegram channel (new or existing) where you can add administrators.
• Access to Vemra with permission to manage channels for your workspace.

1. Create a bot with BotFather

1. Open Telegram and start a chat with @BotFather.
2. Send /newbot and follow the prompts to choose a display name and username for your bot.
3. Copy the HTTP API token BotFather gives you—you will paste this into Vemra as the bot token.
4. Note your bot’s username exactly as Telegram shows it, without the @ prefix (for example my_company_inbox_bot).

2. Add the bot to your channel

Open your Telegram channel → channel profile → Administrators → Add administrator → select your new bot.

Grant the permissions Telegram requires for your workflow. At minimum, the bot typically needs to be able to read messages in the channel and post if you want outbound replies from Vemra to appear there. Telegram’s permission labels may vary by client; adjust to match what your team needs.

3. Connect the channel in Vemra

1. Sign in to the Vemra app.
2. Open Settings in the sidebar. You should land on Channels (or go to Settings → Channels).
3. Click Add Channel to open the dialog titled Connect or reconnect Telegram.
4. Fill in the fields:
   • Channel name — a label your team will see inside Vemra (for example “Support — public channel”).
   • Bot token — the token from BotFather.
   • Bot username — the bot’s username without @.
5. Click Connect channel and wait for the request to finish.

Behind the scenes, Vemra registers a webhook with Telegram for that connection so new messages can reach your workspace.

4. Confirm it worked

After a successful connection, your channel should appear in the Channels list in Settings. If something fails, read the error shown in the dialog—it often points to an invalid token or a bot that is already connected elsewhere in Vemra.

Troubleshooting

• Invalid or revoked token — repeat the BotFather flow and paste the new token carefully (no extra spaces).
• Channel already connected / duplicate bot — each bot can only be linked once per workspace; disconnect the old entry first if you are reconnecting.
• Self-hosted deployments — Telegram must reach your webhook URL over the public internet. Ensure your environment sets an appropriate base URL for webhooks (for example WEBHOOK_BASE_URL in your server configuration) so Telegram’s servers can call your API.

Create a Vemra account All guides →