Status e diagnóstico

Cada canal tem um status visual que mostra se está saudável. Esta página explica os estados e como reagir a cada um.

Os 3 estados

Banner de erro

Quando há qualquer canal em estado error, o topo da lista de canais mostra um banner vermelho:

“Você tem 1 canal com erro. Clique para ver.”

Clica nele, role até o card vermelho e leia a mensagem específica.

Mensagens de erro mais comuns

Invalid OAuth access token (WhatsApp)

Acontece quando: Access Token foi revogado/expirado/copiado errado. Como resolver: Editar canal → cole novo token → reconecte.

(#100) Phone Number ID required (WhatsApp)

Acontece quando: o Phone Number ID está vazio ou não corresponde ao número. Como resolver: Vá no Meta Developer Console → API Setup → confirme o ID e reedite.

Webhook verification failed (WhatsApp)

Acontece quando: Verify Token na Meta ≠ Verify Token no ConectAI. Como resolver: Copie do ConectAI e cole na Meta (Webhooks → Edit), salve.

SIP timeout (Telefonia)

Acontece quando: trunk SIP não responde em 5s. Como resolver: Confirme com o provider que o trunk está ativo. Se Custom, cheque host/porta.

Authentication failed (Telefonia SIP custom)

Acontece quando: user/senha SIP errados. Como resolver: Editar canal, redigite credenciais.

Quality rating LOW (WhatsApp)

Acontece quando: Meta detectou problemas de qualidade. Como resolver: Pause envios em massa. Reduza volume. Use só templates relevantes. Em 1-7 dias o rating reavalia.

Testar conexão

No card de cada canal, botão Testar conexão (POST /api/channels/:id/test):

• WhatsApp Cloud API → testa Graph API call (/me)
• Telefonia → testa registro SIP

Resultado aparece inline:

• Conexão OK (verde)
• **Aviso: … ** (amarelo — funcional mas com problema)
• Erro: … (vermelho — não funciona)

Reconectar

Botão Reconectar está visível só em estados error ou disconnected:

• WhatsApp Cloud API → re-valida credenciais com Meta
• Telefonia → re-registra trunk

Latência por canal

Em cada card expandido, a métrica Latência mostra o tempo médio de resposta:

Se latência subir muito, geralmente é problema de provider (Cloud API, trunk SIP).

Diagnóstico avançado

Para super-admins, há a aba /admin?tab=infra que mostra:

• Canais ativos vs limit
• Capacidade global
• Latência média por provider
• Health portfólio (verde/amarelo/vermelho por ISP)

Se o problema é amplo (afeta vários ISPs), provavelmente é o provider, não a sua configuração.

Quando abrir ticket

Abra ticket com o suporte do ConectAI quando:

• Canal volta a error mesmo após reconectar
• Latência alta persiste por mais de 1h
• Mensagens em massa começam a falhar (>5% bounce)
• Webhook não está disparando para sua URL configurada

→ Falar com suporte

Próximo passo

→ Horários de atendimento
→ Configuração do agente