Canais de atendimento
Canais são as portas de entrada do seu provedor — por onde os clientes falam com você. O ConectAI suporta hoje dois tipos de canal voltados ao cliente final, cada um com sua finalidade e fluxo de configuração.
Toda configuração de canais vive em Configurações → Canais (/config/canais). Lá você lista, conecta, edita, testa e remove canais.
Canais disponíveis
WhatsApp Cloud API
Canal oficial regulado pela Meta. Usado para atendimento ao cliente final, com templates HSM, janela de 24h e webhook seguro.
LerTelefonia SIP
Voz por trunk SIP. Compatível com Athostec, Retell AI, Twilio ou trunk próprio do provedor.
LerTemplates HSM
Mensagens pré-aprovadas pela Meta para iniciar conversa fora da janela de 24h.
LerStatus e diagnóstico
Como ler o status de cada canal, diagnosticar erros e reconectar quando algo falhar.
LerHorários de atendimento
Definir quando a IA responde e o que fazer fora do horário comercial.
LerComo o ConectAI organiza canais
A tela /config/canais mostra todos os canais conectados, agrupados em uma lista. Para cada canal:
| Indicador | O que significa |
|---|---|
connected | Canal funcionando normalmente |
disconnected | Desligado manualmente (toggle off) |
error | Falha de credencial/conexão — precisa reconectar |
Cada card de canal pode ser expandido para ver:
- Conectado em — data e hora da conexão inicial
- Último evento — última atividade registrada
- Interações no mês — volume usado
- Latência — tempo de resposta médio
- Mensagem de erro — quando aplicável
Ações por canal:
- Toggle ligar/desligar — pausa o canal sem deletar
- Testar conexão — POST
/api/channels/:id/testvalida credenciais - Reconectar — útil em estados
erroroudisconnected - Editar — abre modal preservando credenciais sensíveis
- Remover — exclui o canal (soft delete)
Comparativo rápido
| Recurso | WhatsApp Cloud | Telefonia SIP |
|---|---|---|
| Uso recomendado | Cliente final | Cliente final (voz) |
| Regulação | Meta (oficial) | Operadora SIP |
| Janela de 24h | Sim (HSM) | Não |
| Templates HSM | Sim | — |
| Áudio | Sim | Stream contínuo |
| Imagem/documento | Sim | Não |
| Risco de banimento | Baixo | — |
| Setup | Phone Number ID + Access Token + App Secret | DID + trunk SIP ou provider |
Limites por plano
A quantidade de canais que cada org pode ter depende do plano:
- Starter — 3 canais
- Pro — 10 canais (configurável)
- Enterprise — ilimitado / customizado
Para cada canal extra, você pode comprar override do plano. → Limites