Problemas comuns

Sintoma, causa e solução para os problemas mais frequentes com números, mensagens, cobrança, acesso, equipe e API.

Procure pelo que aparece na sua tela. As mensagens entre aspas são as exibidas pelo painel.

Números (dispositivos)

Sintoma	Causa provável	Como resolver
Status Desconectado em Dispositivos	O WhatsApp foi desconectado no celular, o celular ficou muito tempo sem internet ou o número saiu de "Aparelhos conectados"	Clique em Retomar. Se não voltar, exclua e conecte de novo lendo o QR Code
O QR Code sumiu ou "Falha na conexão" durante o pareamento	O QR/código expirou antes de ser lido	Clique em Tentar novamente e escaneie em até alguns segundos; o código de pareamento também expira (o prazo aparece na tela)
"Número inválido para pareamento por código"	Número sem DDI/DDD ou com símbolos	Use só dígitos com DDI e DDD, ex.: `5511900000000`
Status Pareando parado	O celular não concluiu a leitura	Feche a janela, abra Conectar número de novo e refaça
Erro informando que o número já está conectado em outra sessão	O mesmo número já está pareado em outro dispositivo da conta	Use o dispositivo existente ou exclua-o antes
Status Ban temporário	O WhatsApp restringiu o número por um período	Aguarde o prazo, reduza o volume e use o Aquecimento antes de novas campanhas
"Limite de dispositivos do plano atingido…"	Todos os slots estão em uso	Contrate um plano ou slots extras; sem plano, os 2 grátis exigem o segundo fator ativo
"Pareamento temporariamente indisponível."	Serviço de conexão momentaneamente fora	Tente de novo em instantes

Sintoma	Causa provável	Como resolver
Mensagem não enviada / "Número desconectado"	O número da conversa está desconectado	Reconecte em Dispositivos
Envio recusado porque o número está ocupado	O número está em campanha ou aquecimento	Aguarde o fim, pause a campanha/aquecimento ou use outro número
"Resultado incerto. Confira o estado antes de repetir a operação."	A conexão caiu depois que a mensagem saiu	Confira na conversa se a mensagem chegou antes de reenviar
Mensagem com um relógio por muito tempo	Aceita pelo Zynzap, ainda não entregue ao destinatário	Aceitação não confirma entrega: aguarde; o celular do cliente pode estar sem internet
"Outra pessoa assumiu esta conversa…"	Um colega assumiu a conversa ao mesmo tempo	Confira os dados atualizados antes de continuar
"Imagens precisam ser JPEG, PNG ou WebP com até 16 MB." / "Vídeos precisam ser MP4 com até 64 MB."	Formato ou tamanho não aceito	Converta/comprima o arquivo
"O áudio excede o limite de 16 MB ou 15 minutos."	Áudio muito longo	Grave em partes menores
O bot não respondeu	Gatilho não casou, alguém da equipe respondeu há menos de 30 min ou intervalo de recomeço ativo	Veja Fluxos › Erros comuns

Sintoma	Causa provável	Como resolver
"Saldo insuficiente. Adicione créditos ou ajuste o plano."	Créditos acabaram e não há excedente autorizado	Compre créditos ou autorize o excedente em Plano e consumo
"A cotação expirou. Cancele e revise novamente."	A janela de revisão ficou aberta tempo demais	Cancele e execute de novo para gerar outra cotação
"A operação excede o valor revisado. Revise os custos novamente."	O conteúdo ou a audiência mudou depois da revisão	Revise de novo
"Há uma operação anterior em conciliação. Aguarde antes de repetir."	Uma operação paga anterior ainda está sendo fechada	Aguarde alguns segundos e tente de novo
"O armazenamento contratado foi atingido."	Quota de arquivos cheia	Exclua mídias ou contrate pacotes de armazenamento
Benefício mensal ou slots grátis sumiram	Segundo fator desativado ou redefinido	Cadastre um novo autenticador em Perfil e segurança

Sintoma	Causa provável	Como resolver
Perdi o autenticador (2FA)	Celular perdido/trocado	No login, Usar código de recuperação; sem códigos, Perdi meu autenticador → confirme usuário e senha → link por e-mail (30 minutos)
"Confirme sua identidade em Perfil e segurança para continuar."	Ação sensível exige confirmação recente	Digite o código e clique em Confirmar identidade (vale 10 minutos)
"Sua sessão expirou. Entre novamente para continuar."	Sessão encerrada (troca de senha, encerramento remoto ou tempo)	Entre de novo
"Confirme seu e-mail para continuar."	E-mail ainda não confirmado	Abra o link enviado no cadastro (verifique o spam)
"Seu papel nesta empresa não permite esta ação."	O papel não tem a permissão	Peça a um administrador — veja Permissões

Sintoma	Causa provável	Como resolver
"Este convite expirou. Peça um novo ao administrador."	Passaram 7 dias	O administrador usa Reenviar convite
"Este convite foi enviado para outro e-mail. Entre com a conta convidada."	Login com outra conta	Entre com o e-mail exato do convite
"Convite inválido ou já utilizado."	Link já usado ou cancelado	Peça um novo convite
Atendente não vê uma conversa	O número não está liberado para ele	Em Equipe › Acesso, marque o número
"A empresa precisa manter ao menos um administrador ativo."	Tentativa de remover o último administrador	Promova outra pessoa antes

Código	Causa provável	Como resolver
`401 UNAUTHENTICATED`	Chave errada, vencida ou revogada	Confira o cabeçalho `Authorization: Bearer SUA_CHAVE` ou crie uma nova chave
`403 FORBIDDEN`	A chave não tem a permissão (ou o dispositivo)	Crie uma chave com o escopo necessário
`402/428 PAYMENT_REQUIRED`	Falta cotação ou saldo	Peça a cotação em `POST /api/v1/billing/quotes` e envie o `quoteId`
`409 CONFLICT`	Cotação expirada ou estado mudou	Gere nova cotação / releia o recurso
`429 RATE_LIMITED`	Mais de 120 solicitações por minuto	Espere e tente com intervalos crescentes
`503/504 UNAVAILABLE`	Indisponibilidade temporária	Tente de novo; em operações pagas, confira o resultado antes

Ao falar com o suporte, informe a referência que aparece no fim da mensagem de erro (ex.: "ref. 3f9a1c2b") ou o requestId da API.