Integrations
Telegram Bot API
Connect a Telegram bot to GChat with a bot token.
The Telegram Bot API integration connects a Telegram bot to GChat.
Use this integration when customers write to a Telegram bot and your operators need to process those conversations in GChat.
Required Data
| Field | Description |
|---|---|
| Service | The service type. For this integration it is Telegram. |
| Token | The Telegram bot token. This field is required. |
Create a Telegram Bot API Integration
- Open Integrations.
- Under Create Integration, select Telegram Bot API.
- Confirm the service is Telegram.
- Paste the bot token into Token.
- Click Create.
Token Format
Telegram bot tokens are generated by Telegram for bot accounts. The form accepts the token as a single text value.
Example placeholder:
123456:ABC-DEF123...Keep the full token private. In the integrations list, GChat masks the token for safety.
After Creating
After the integration is created:
- Check that it appears in the Integrations table.
- Enable it if it is not enabled.
- Open Settings -> Groups.
- Create or update a group and select this integration.
- Assign staff profiles to the group.
Troubleshooting
The Integration Does Not Receive Messages
Check that:
- The token is correct.
- The Telegram bot is active.
- The integration is enabled.
- A group is linked to the integration.
- Operators are assigned to that group.
The Token Was Exposed
Create a new token in Telegram, update the integration, and remove the old token from any shared notes or files.