Conceito
Um Channel é a conexão entre um agente Timely.ai e uma plataforma de mensagens onde seus clientes estão. Cada canal representa uma conta ou número ativo: um número WhatsApp Business, um perfil Instagram Business, um bot do Telegram ou um widget de chat embutido no seu site. O agente associado ao canal recebe todas as mensagens que chegam por aquele canal e responde por ele. Um agente pode ter múltiplos canais associados. Um canal, no entanto, pertence a exatamente um agente por vez — se você precisar trocar o agente de um canal, basta atualizar a associação.Tipos de canal
| Tipo | Identificador | Observações |
|---|---|---|
| WhatsApp Business | whatsapp | Requer WABA aprovada pela Meta |
instagram | Requer perfil Business e Página vinculada | |
| Telegram | telegram | Requer Bot Token do @BotFather |
| Widget (site) | widget | Sem conta externa — gerado pela Timely |
Ciclo de vida
GET /v1/channels/{id}/qr-code retorna o QR code em base64 durante a janela de conexão.
Campos principais
| Campo | Tipo | Descrição |
|---|---|---|
id | string (UUID) | ID único do canal |
agent_id | string (UUID) | Agente associado |
type | enum | whatsapp | instagram | telegram | widget |
name | string | Nome descritivo do canal |
status | enum | connected | disconnected | error |
phone_number | string | Número associado (para WhatsApp/Telegram) |
username | string | Username do perfil (para Instagram/Telegram) |
widget_token | string | Token público de inicialização do widget |
created_at | string | ISO 8601 de criação |
last_connected_at | string | ISO 8601 da última conexão bem-sucedida |
Endpoints disponíveis
Consulte a barra lateral à esquerda para a lista completa de endpoints deste grupo. Cada endpoint tem sua própria página com schema de request/response, exemplos em cURL/JS/Python e playground interativo.
Próximos passos
Primeira requisição
Se você ainda não fez sua primeira chamada, comece por aqui.