Solução de problemas
Problemas na coexistência
O que fazer quando a conexão em coexistência não conclui, não sincroniza ou cai.
Cada sintoma abaixo segue o mesmo formato: o que você vê, a causa e o que fazer. O passo a passo da conexão está em Conectar o WhatsApp.
Antes de conectar
Seção intitulada “Antes de conectar”- O número está ativo no app WhatsApp Business 2.24.17 ou mais novo.
- Você é admin do portfólio de negócios na Meta.
- No painel, você é dono ou admin, com o 2FA ligado.
O número não está no app WhatsApp Business
Seção intitulada “O número não está no app WhatsApp Business”- Sintoma:
422coex_not_on_business_app. - Causa: na coexistência o número precisa estar no app WhatsApp Business do celular, e este não está.
- O que fazer: instale e ative o número no app WhatsApp Business, ou conecte no modo Número novo, só pela API.
A janela da Meta terminou sem número
Seção intitulada “A janela da Meta terminou sem número”- Sintoma:
signup_incomplete. A janela criou ou escolheu a conta, mas não terminou com exatamente um número. - O que fazer: conecte de novo e escolha (ou adicione) o número na janela da Meta até o fim.
A sessão expirou
Seção intitulada “A sessão expirou”- Sintoma:
signup_session_expired(410). - Causa: a sessão de conexão dura 30 minutos e acabou, ou foi cancelada.
- O que fazer: comece de novo pelo painel ou pelo link de conexão.
Faltaram permissões
Seção intitulada “Faltaram permissões”- Sintoma:
signup_scope_mismatch. - Causa: a janela da Meta terminou sem as permissões para gerenciar e enviar mensagens pela conta.
- O que fazer: conecte de novo e mantenha todas as permissões marcadas.
O popup não abre
Seção intitulada “O popup não abre”- Causa: o navegador bloqueou o popup da Meta.
- O que fazer: libere popups do endereço do painel e tente de novo. Não feche a página do painel enquanto o popup estiver aberto.
Conta banida ou sinalizada
Seção intitulada “Conta banida ou sinalizada”- Sintoma:
403account_flagged. - Causa: a Meta baniu ou sinalizou a conta. O Messajo recusa antes de alterar qualquer coisa na Meta.
- O que fazer: resolva com a Meta no Gerenciador do WhatsApp. Depois de liberada, conecte de novo.
Número já conectado
Seção intitulada “Número já conectado”- Sintoma:
409connection_already_existsouwaba_owned_by_other_org. - Causa: o número já tem uma conexão ativa, na sua organização ou em outra. Uma conta do WhatsApp Business (WABA) pertence a uma organização só.
- O que fazer: use a conexão existente. Para mover para outra organização, desconecte lá primeiro.
O número já está com outro parceiro
Seção intitulada “O número já está com outro parceiro”- Causa: na coexistência o número aceita um parceiro por vez.
- O que fazer:
- Faça backup das conversas no app.
- No app, vá em Configurações > Conta > Plataforma Business > Desconectar.
- Conecte de novo pelo Messajo.
- O parceiro antigo recebe o aviso
PARTNER_REMOVEDda Meta.
A conexão ficou Pendente
Seção intitulada “A conexão ficou Pendente”- Causa: um passo depois da inscrição falhou. O painel mostra o motivo.
- O que fazer: na página da conexão, Concluir conexão refaz o que faltou, sem abrir o popup. A aba Histórico mostra cada passo, inclusive onde um cancelamento no popup aconteceu.
Histórico ou contatos não vieram
Seção intitulada “Histórico ou contatos não vieram”Abra a aba Sincronização da conexão.
| Status | O que fazer |
|---|---|
| Na fila | Aguarde. Ainda não foi pedida ou vai ser pedida de novo depois de uma falha |
| Pedida à Meta | Aguarde. A Meta aceitou e está mandando os dados |
| Concluída | Os dados chegaram: contatos em contacts.sync, conversas em history.batch |
| Recusada | A pessoa recusou compartilhar o histórico no celular |
| Prazo de 24 h vencido | A Meta só aceita o pedido até 24 h depois da conexão |
A sincronização é pedida uma vez só. Se falhar, o Messajo tenta de novo em 1 min, 5 min, 15 min, 1 h, 3 h e 6 h, sempre dentro das 24 h. Grupos não sincronizam.
A conexão caiu sozinha
Seção intitulada “A conexão caiu sozinha”- O app precisa ser aberto a cada ~14 dias, uma regra da Meta para todo número em coexistência.
- O número saiu do app WhatsApp Business: a conexão manda
connection.updatedcomreasoncoex_unlinked. - A conta removeu o Messajo como parceiro: a conexão fica Desconectada com
reasonpartner_removed.
Os motivos e o que fazer em cada status estão em Quando a conexão cai e em Motivos da conexão.
Não consigo editar perfil, nome ou username pela API
Seção intitulada “Não consigo editar perfil, nome ou username pela API”- Sintoma:
422coex_not_supported. - Causa: na coexistência a Meta não deixa a API mudar o perfil, o nome exibido nem o username.
- O que fazer: altere no app WhatsApp Business do celular, ou use um número só API.
Limites que parecem bug
Seção intitulada “Limites que parecem bug”- Velocidade fixa de 20 msg/s. Passou disso,
429connection_rate_limitedcomRetry-After. Veja Limites. - Ligações:
calling_not_supported_in_coex. Use um número só API. - Grupos:
group_not_supported. Use um número só API. - Mensagem enviada pelo celular chega como
message.echoe não abre a janela de 24 h: só a mensagem do contato abre. Veja Janelas.