Integrations
Integrations
Connect external messaging channels to GChat.
Integrations connect external messaging channels to GChat so operators can receive and reply to customer conversations from one workspace.
Open Integrations from the main sidebar to view existing connections or create a new one.
Available Integrations
GChat currently supports these integration types:
| Integration | Use it for | Setup method |
|---|---|---|
| Telegram Bot API | Connecting a Telegram bot by token. | Enter the bot token and create the integration. |
| Telegram User | Connecting a Telegram user account. | Optional proxy settings, then QR code authorization. |
| Facebook Messenger | Connecting a Facebook page inbox. | Meta OAuth flow with Connect Facebook. |
Integrations List
The Integrations page shows all connected channels in a table.
| Column | Description |
|---|---|
| Name | The integration display name and account handle. |
| Service | The connected service, for example Telegram Bot. |
| Token | Masked access token or connection identifier. |
| Enabled | Whether the integration is active. |
| Actions | Management actions for the integration. |
Common Actions
The actions column can include:
| Action | Purpose |
|---|---|
| Refresh integration | Refresh account data and connection state. |
| Setup webhook | Create the webhook used to receive channel events. |
| Delete webhook | Remove the current webhook connection. |
| Edit | Update supported connection settings. |
| Delete | Permanently remove the integration from the organization. |
Use the Enabled switch to temporarily stop or resume an integration without deleting its configuration.
An integration can be pending while it is connecting, active when healthy, or degraded when the connection needs attention.
Create an Integration
- Open Integrations.
- Choose an integration type from Create Integration.
- Fill in the required connection details.
- Complete authorization if the integration requires it.
- Save or create the integration.
Recommended Setup Flow
- Create the integration.
- Confirm it appears in the integrations list.
- Enable the integration.
- Create or update a group in Settings -> Groups.
- Link the group to the integration.
- Assign staff profiles to that group.
- Send a test message and confirm it appears in the inbox.
Best Practices
- Use clear integration names so managers can understand the source quickly.
- Keep tokens private and rotate them if they are exposed.
- Set up the webhook when the selected channel requires one.
- Disable an integration before deleting it if you only need a temporary pause.
- Create separate groups for separate traffic sources.
- Test every new connection before giving it to operators.