Antes de mudar qualquer coisa: não exclua sua conta do WhatsApp, não remova sua Conta Comercial do WhatsApp nem desconecte um provedor como solução geral. A recuperação correta depende de como seu número está configurado hoje. Anote a mensagem de erro completa, qualquer código e a tela onde apareceu.
Conexão
Primeiro, saiba como seu número é usado hoje: um número novo, um número no aplicativo WhatsApp Business (use a Coexistência para manter o app), ou um número em outro provedor de API (estes usam caminhos diferentes). Veja Escolha como conectar o WhatsApp.
| O que você vê | Código Meta | O que significa e o que fazer |
|---|---|---|
| Número não elegível, precisa de mais atividade no aplicativo WhatsApp Business | 3441045 | Uma verificação de elegibilidade da Coexistência. Continue usando o app normalmente com clientes reais e tente novamente mais tarde. A Meta não publica um mínimo. Não gere atividade falsa nem recrie a conta. |
| Número não registrado no aplicativo WhatsApp Business | 2655095, 2655048 | Verifique o número e o código do país, e se está no app Business (não no WhatsApp pessoal). Para um número novo apenas API, utilize o caminho de novo número. |
| Atualize o aplicativo | 4563015 | Instale o aplicativo WhatsApp Business mais recente e tente novamente. |
| Empresa já compartilha essa conta com um parceiro | 2655093 | A Meta informa que essa Conta Comercial do WhatsApp já está associada a um parceiro. Isso não confirma se o outro provedor ainda está ativo. Não é possível trocar de parceiro neste fluxo. Fale com o suporte antes de desconectar qualquer coisa. |
| Já registrado no produto ou desconecte sua plataforma comercial | 3441049, 2655094 | Uma conexão de plataforma existente deve ser tratada primeiro. Se você desconectar de propósito, a Meta exige uma espera de 15 minutos antes de tentar novamente. |
| Número não associado à empresa selecionada | 3441041 | Escolha o portfólio de empresas que possui o número. |
| Número vinculado a uma Página do Facebook | 2655082 | Verifique Meta Business Suite › Configurações › Contas › Páginas. Remova o vínculo com a Página (após confirmar com o administrador da Página) ou use outro número. |
| Conta utiliza mensagens de marketing | 3441047 | Selecione outra Conta Comercial do WhatsApp. Tentar novamente não resolve. |
| Empresa ou conta restrita | 2655089, 3441040, 2388107 | Abra o Meta Business Support Home, revise a restrição e faça recurso. Não crie novas contas para contornar. |
| Verificação iniciada com outro parceiro | 2494143 | Continue com esse parceiro, ou solicite a Verificação Comercial da Meta diretamente. |
| Recurso indisponível em sua região | 3441042 | Verifique o código do país. Se estiver correto, esse fluxo ainda não está disponível para o número. |
| Código não pôde ser enviado ou verificado | 2388091, 2388093 | Verifique novamente o número e use um método que ele possa receber (fixos precisam de voz). Números de IVR não são suportados. |
Outros problemas de conexão
-
Conta ou portfólio ausente: faça login com a conta do Facebook que seja administrador do portfólio correto. "O usuário não tem permissão" significa que um administrador existente deve conceder acesso.
-
Conta do Facebook muito nova: aguarde algumas horas ou use uma conta já estabelecida com acesso comercial.
-
Verificação comercial em andamento: verifique em Meta Business Suite › Central de segurança.
-
Nome de exibição rejeitado: veja Nome de exibição em Gerencie seu número WhatsApp.
-
Limite de número de telefone atingido: escolha o número já listado, ou solicite um limite maior à Meta. Não exclua um número funcional.
-
"Você tentou adivinhar muitas vezes": aguarde cerca de 12 horas. "Solicitou seu código muitas vezes": siga o tempo de espera exibido pela Meta.
-
Prompt de coexistência ou código QR não funciona: use o app Business mais recente, mantenha o telefone online, mantenha a janela de cadastro aberta e verifique a permissão da câmera para códigos QR.
-
Janela Meta não abre ou trava: permita pop-ups, desative extensões de bloqueio, complete qualquer checagem de segurança da Meta e aguarde alguns minutos após um erro temporário.
-
Meta finalizou, mas não há inbox no Chatwoot: atualize e verifique Configurações › Caixas de entrada antes de tentar novamente. Não crie caixas de entrada duplicadas.
-
Histórico de chat de coexistência incompleto: mantenha o app aberto e online. A Meta sincroniza o histórico apenas dentro de 24 horas após conectar. Contate o suporte rapidamente em vez de reconectar.
Recebendo e enviando mensagens
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Mensagens pararam de chegar, mas o número aparece como Conectado e qualidade Verde | Algo na conexão precisa de atenção: registro, permissões ou o webhook. Isso geralmente ocorre após uma alteração no nome de exibição ou perfil. Após qualquer correção, envie uma mensagem teste para seu número e responda no Chatwoot para confirmar os dois sentidos. | Contate o suporte primeiro para que possamos verificar o registro, permissões e webhook no seu inbox existente. Se precisar registrar o número novamente, faça isso você mesmo na Meta, seguindo o processo da Meta. Não exclua o número nem crie nova inbox. Números de Coexistência precisam de um caminho de recuperação diferente, então contate o suporte antes de alterar qualquer coisa. |
| Nenhuma mensagem chega após configuração | Uma possível razão: o webhook não está registrado ou aponta para outro lugar | Abra a Saúde da Conta. Se Configuração do Webhook mostrar Webhook não configurado ou URL do Webhook incompatível, clique em Registrar Webhook. Depois, teste: envie uma mensagem para seu número de outro telefone, verifique se chegou no Chatwoot, e responda do Chatwoot. Se mostrar como configurado mas ainda não chegam mensagens, contate o suporte. Para Twilio, verifique o Callback URL na Twilio (página 5). |
| Você só pode responder usando uma mensagem modelo | Mais de 24 horas desde a última mensagem do cliente | Envie um modelo. Veja Templates e a janela de 24 horas |
| Uma mensagem falha com o erro 131049 | A Meta não entregou este modelo de marketing para preservar a qualidade do engajamento. O WhatsApp limita quantas mensagens de marketing cada pessoa recebe de todas as empresas. | Não reenvie nem clique em Tentar novamente imediatamente. Aguarde pelo menos 24 horas antes de enviar outro modelo de marketing para esta pessoa. Modelos utilitários não são afetados. Se o cliente responder, mensagens de marketing dentro da janela de 24 horas não contam no limite. |
| A conexão com o WhatsApp precisa ser atualizada / Reconectar WhatsApp | A conexão de Configuração rápida expirou | Clique em Reconectar WhatsApp. Veja Gerencie seu número WhatsApp |
| Token de acesso do WhatsApp requer atenção | O token da configuração manual expirou ou foi revogado | Substitua na aba Configuração do inbox |
Templates
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| Um template não aparece no Chatwoot | Ainda não aprovado, não sincronizado ou tipo não suportado pelo Chatwoot | Verifique o status dele no WhatsApp Manager e clique em Sincronizar Templates. Veja os tipos suportados na página 7. |
| Mensagens funcionam mas templates nunca sincronizam (Configuração rápida) | A conexão perdeu a permissão para ler sua Conta Comercial do WhatsApp | Adicione um token de Gerenciamento Comercial (página 7) |
| Token de Gerenciamento Comercial: Token deve conceder permissão whatsapp_business_management | whatsapp_business_management não foi selecionado | Gere um novo token com essa permissão |
| Token de Gerenciamento Comercial: sem permissão de acesso ou token inválido | O usuário do sistema não tem acesso à conta WhatsApp, ou o token expirou ou pertence a outro app | Verifique os ativos e app atribuídos ao usuário e gere um novo token |
| Token aceito, templates ainda ausentes | O token acessa outra Conta Comercial do WhatsApp | Confirme que o usuário do sistema tem a exata conta usada pelo inbox, e que os templates existem ali |
| Um template falha ao enviar, ou mídia não aparece | Variáveis vazias, link de mídia privado ou quebrado, ou arquivo acima dos limites da Meta | Preencha todas as variáveis, use link público, verifique formato e tamanho (página 7) |
| Botão de URL dinâmica não funciona | Problema conhecido com certos setups de botão de URL dinâmico | Use uma URL estática no template |
Contatos e números de telefone
Números aparecem diferentes no WhatsApp e no Chatwoot (Brasil, México, Argentina). Esses países mudaram os formatos de números móveis, e o WhatsApp pode usar o antigo:
-
Brasil: um
9foi adicionado após o DDD (+55 11 9 8765-4321vs+55 11 8765-4321). -
Argentina: um
9após o código do país pode ou não estar presente (+54 9 11 ...vs+54 11 ...). -
México: o WhatsApp pode adicionar um
1após o código do país (+52 1 ...vs+52 ...).
O Chatwoot faz o ajuste automaticamente para o mesmo contato, então você não terá duplicatas. O número pode apenas aparecer diferente nos dois lugares.
Contate o suporte
Se ainda estiver com problemas, contate o suporte Chatwoot com:
-
A mensagem de erro completa e o código, e uma captura de tela
-
Em qual etapa ocorreu a falha e se o erro apareceu na Meta ou no Chatwoot
-
O link do seu inbox, o número comercial com código do país, e o horário da tentativa com fuso horário
-
Como o número é usado: novo, app WhatsApp Business ou outro provedor
-
Para Coexistência: versão do app, há quanto tempo é usado e se ainda funciona no telefone
-
Seu ID do portfólio comercial, ID da Conta Comercial do WhatsApp e ID do Número de Telefone, todos identificados
Nunca compartilhe sua senha, token de acesso, código de verificação ou PIN em duas etapas. Oculte-os em capturas de tela. O Chatwoot não pode mediar decisões ou revisões da Meta.