Channels Overview
Connect your AI assistant to Telegram, Instagram, WhatsApp, Facebook Messenger, and Viber
Overview
Channels are the messaging platforms where your AI assistant communicates with customers. A single assistant can serve customers across all connected channels simultaneously.
Supported Messengers
| Channel | Setup | Connection Method |
|---|---|---|
| Telegram | Easy | Phone number + MTProto authentication |
| Medium | Meta OAuth 2.0 flow | |
| Medium | WaSender API | |
| Facebook Messenger | Medium | Meta OAuth 2.0 flow |
| Viber | Medium | E-Chat platform |
How Channels Work
- Add an integration — Connect a messenger account via Integrations
- Assign an assistant — Choose which AI assistant handles conversations
- Go live — Messages are automatically handled by the assigned assistant
Each channel creates separate conversations per customer. The assistant treats each channel independently.
You can connect multiple accounts of the same type and assign different assistants to each. See Integrations > Three-Tier Model for details.
Adding a Channel
- Go to Integrations in the sidebar
- Click Add Integration
- Select the channel type
- Enter credentials and complete authentication
- Assign an AI assistant
- Activate the integration
Switching Assistants
Change which assistant handles a channel at any time:
- Go to Integrations
- Click on the integration
- Change the assigned assistant
- Save
New conversations use the updated assistant. Active conversations continue with the current one. You can also transfer individual chats via API.
Disabling a Channel
Temporarily disable a channel without removing it:
- Go to Integrations
- Click the integration
- Toggle it off
When deactivated, all related chats are cleaned up.
Message Flow
When a customer sends a message:
- The messenger delivers it to Happ via webhook or API subscription
- Happ creates/finds the chat and saves the message
- Five things happen in parallel:
- WebSocket — Dashboard gets a real-time update
- AI Processing — If AI is enabled, the assistant generates a response (with 4-second debouncing for rapid messages)
- Messenger Delivery — AI response is sent back to the channel
- Webhook — If configured, message is forwarded to your external webhook
- AI Toggle —
/botcommand toggles AI mode
Channel Features
| Feature | Telegram | Viber | |||
|---|---|---|---|---|---|
| Text messages | Yes | Yes | Yes | Yes | Yes |
| Images | Yes | Yes | Yes | Yes | Yes |
| Voice messages | Yes | Yes | Yes | Yes | Limited |
| Group chats | Yes | No | No | No | No |
| Stickers | Yes | No | No | No | Yes |
For the full API reference, see api.happ.tools/reference.