Diagnosticando problemas de conexão

Quando Configurações → Conexão do WhatsApp mostra o número como desconectado, o motivo cai em uma de três categorias — e cada uma tem um caminho de solução diferente.

“Token armazenado não pode ser decifrado”

Esse aviso aparece quando o token salvo no banco não consegue mais ser decifrado (por exemplo, depois de uma mudança na chave de criptografia do ambiente). Não tem conserto manual: clique em Redefinir configuração, confirme, e o Cerne Talk apaga a configuração salva para você reentrar as credenciais do zero. Isso não apaga contatos, conversas nem histórico — só os dados de conexão.

Erro da API da Meta

Quando o teste de conexão bate direto na Meta e recebe um erro, a mensagem retornada aparece verbatim abaixo do banner — o Cerne Talk não reescreve o texto da Meta. Se o erro citar um código numérico (132018, 130497, 131042 etc.), veja a categoria Erros comuns da API do WhatsApp para o significado de cada um.

Credenciais válidas, mas número não registrado

Este é o caso mais enganoso: o banner de credenciais fica verde (o token autentica normalmente), mas o banner de registro fica amarelo. Nesta situação a causa quase sempre é o PIN de duas etapas — sem ele, o registro fica incompleto e a Meta não entrega nada, mesmo com um token perfeitamente válido. Use Verificar com a Meta para ver exatamente qual checagem falhou antes de mexer em qualquer credencial.

Retenção de anexos recebidos

Um sintoma diferente, que não é bem um “erro de conexão” mas aparece na mesma tela: fotos, vídeos, áudios e documentos recebidos somem depois de um tempo. Isso é esperado — a Meta apaga mídia recebida cerca de 30 dias depois da chegada. Para evitar isso, ligue Manter anexos recebidos (ativado por padrão): o Cerne Talk copia cada anexo para o seu próprio armazenamento assim que chega. Arquivos acima de 16 MB são ignorados pela cópia. Desligar essa opção não afeta anexos já copiados — só os novos param de ser salvos.

Redefinindo do zero

Se nada disso resolver, Redefinir configuração é sempre a saída segura: apaga phone number ID, WABA ID e token salvos, sem tocar em nenhum outro dado da conta, para você reconectar seguindo o passo a passo de conexão novamente.