Erros e Avisos Comuns

Avisos do painel

"CANAIS PRECISAM DE ATENÇÃO"

O que significa: alguns canais estão com conexão próxima de expirar. O canal ainda pode estar funcionando, mas o sistema identificou que a sessão precisará de renovação em breve.

Como resolver:

Acesse Configurações → Sessões e atualize a sessão do canal indicado
Verifique se o canal está conectado e sem alertas internos
Confirme que o envio e recebimento continuam funcionando normalmente

Dica

Após atualizar a sessão em Configurações → Sessões, o aviso deve desaparecer. Se persistir, verifique se o token/sessão está válido ou se é necessário reconectar o canal.

"Servidor temporariamente offline"

Onde aparece: na tela de login, após digitar usuário e senha.

O que significa: o frontend está abrindo, mas não consegue se comunicar com o backend. O problema não é nas credenciais — é na infraestrutura.

Causas mais comuns:

Backend parado ou reiniciando com erro
Porta do backend não está respondendo
Configuração do Nginx apontando para porta errada
Subdomínio do backend com erro de SSL
Variável do frontend apontando para URL incorreta do backend
Banco de dados ou Redis indisponível
Erro de build após instalação ou atualização

Como diagnosticar: acesse a VPS e execute:

pm2 status
pm2 logs Connect.ai-backend --lines 200
pm2 logs Connect.ai-frontend --lines 100
systemctl status nginx --no-pager
nginx -t
docker ps
curl -I http://127.0.0.1:3000

O pm2 status e o pm2 logs Connect.ai-backend geralmente já mostram a causa principal. Envie o retorno ao suporte se o problema persistir.

"Recuperação de licença: A licença ficou inválida durante a operação"

Como resolver:

Insira a nova chave de licença (se renovou) ou a chave atual (se ainda válida) para revalidar
Se já renovou a licença mas o erro persiste, pode ser que a licença tenha ficado inválida por mais de 6 horas — nesse caso, reinicie o backend na VPS:

sudo su - deployConnect.ai
pm2 restart Connect.ai-backend
pm2 save

Atenção

Esta empresa está inativa. Entre em contato com o administrador

Causa: Ocorre quando é inativado o Conta 1 via banco ou rotina externa
Solução: Acessar o banco de dados e ativar na tabela de contas o Conta 1

Erros de envio de mensagens

"Aguarde alguns instantes..."

Onde aparece: ao tentar enviar uma mensagem por um canal que utiliza a lib Baileys.

O que significa: comportamento associado à lib Baileys. Pode ocorrer apenas em conexões específicas e tende a ser intermitente.

Como resolver (em ordem de prioridade):

Atualize o Connect.ai para a versão HOTFIX mais recente
Atualize o aplicativo do WhatsApp no celular vinculado ao canal
Atualize o Android do aparelho

Essas três ações resolvem o problema em cerca de 90% dos casos.

Alternativas adicionais:

Recriar o canal afetado
Migrar o canal para o Baileys v7: acesse Canais → Editar canal → Baileys → selecionar v7

Dica

O Baileys v7 está disponível a partir da versão 4.0.0.8 do Connect.ai.

Se o problema persistir após todas as tentativas acima, considere migrar o canal para wwebjs ou wuzapi — essas libs não apresentam relato desse comportamento.

META: Not supported type

Onde aparece: no processamento de mensagens recebidas via canal WABA (API Oficial).

O que significa: A meta gera esse aviso e não é possível saber ao certo qual a causa, pode ser por tipo de mensagem ou arquivo que o sistema ainda não suporta.

Tipos de conteúdo que comumente geram esse erro:

Reações a mensagens (emoji reactions)
Fotos ou vídeos com Visualização única (View Once)
Enquetes (Polls)
Compartilhamento de localização ao vivo
Stickers ou GIFs
Mensagens apagadas
Mensagens trocadas entre contas WABA
Arquivos em formatos não suportados

Como tratar: verifique se o arquivo ou tipo de mensagem está na lista de formatos suportados pelo Connect.ai: </ferramentas-do-atendimento/atendimento/tela-de-atendimento/tipos-de-arquivos-suportados-para-envio>

Se o tipo de conteúdo não for suportado, o comportamento esperado é que o Connect.ai ignore ou registre o evento sem processar — não há ação corretiva do lado do sistema.

Erros de acesso e permissão

ERR_NO_PERMISSION_CONNECTIONS_LIMIT

Onde aparece: ao tentar criar ou ativar um canal.

O que significa: o conta atingiu o limite de conexões permitidas para a sua conta.

ERR_NO_TICKET_ACCESS — 403

Usuário sem permissão para acessar o ticket. Verifique fila, canal, perfil e permissões do usuário.

Por que ocorre o ERR_NO_TICKET_ACCESS ao disparar um template WABA?

O erro indica que o usuário que realiza o disparo não possui acesso ao ticket associado ao contato. Mesmo com todos os canais liberados, o acesso ao ticket é validado individualmente.

Causas mais comuns — o contato já possuía um ticket aberto/pendente que foi reaproveitado, e esse ticket:

está atribuído a outro atendente;
está em uma fila da qual o usuário não faz parte;
está sem atendente e sem fila, enquanto a configuração nullTickets do conta está desabilitada (disabled).

Para identificar o motivo exato, habilite LOGGER_WARN=true no backend. O sistema registrará:

TicketAccessGuard ::: blocked POST /wabametaTemplateComponents

O que é a configuração nullTickets? Controla se os usuários podem acessar tickets que não possuem atendente nem fila definidos. Quando desabilitada (disabled), o acesso a esses tickets é bloqueado — o que também pode resultar neste erro.

Erros de API

errors.numberInvalidFormat — API WebChat

Onde aparece: ao tentar enviar mensagem via API pelo canal WebChat, no campo number.

O que significa: o campo number espera um número de telefone em formato internacional (somente dígitos). Identificadores internos de sessão do WebChat (como mphyls0-2hfb65) não são aceitos nesse campo.

Formato correto:

{
  "number": "5588999999999",
  "body": "Mensagem de teste",
  "externalKey": "msg"
}

Outros pontos a verificar:

O header de autenticação deve usar Bearer, não outras variações:

{
  "Authorization": "Bearer SEU_TOKEN"
}

Dica

Se o contato do WebChat não possui telefone cadastrado, não é possível enviar mensagem por essa rota. O campo number exige um telefone válido — o identificador do WebChat não substitui o número. Nesse caso, o atendimento deve seguir pelo próprio ticket do WebChat dentro do sistema.

Erros de Apontamento DNS

Erro ao gerar o certificado HTTPS

Verifique se o apontamento foi prapagado
Acesse a VPS como root e execute o comando

sudo certbot --nginx

Erros de Banco de Dados

Erro ao acessar Postgres

Dica

Internal server error: SequelizeConnectionError: could not open file "global/pg_filenode.map": Permission denied

Acessar o terminal com root

docker container restart portainer

Acessar o portainer, abrir console do postgres e executar o comando

chown -R postgres /var/lib/postgresql

Caso o erro persista, criar uma rotina no crontab