Pular para o conteúdo

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.

  • 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.
  • Sintoma: 422 coex_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.
  • 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.
  • 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.
  • 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.
  • 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.
  • Sintoma: 403 account_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.
  • Sintoma: 409 connection_already_exists ou waba_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.
  • Causa: na coexistência o número aceita um parceiro por vez.
  • O que fazer:
    1. Faça backup das conversas no app.
    2. No app, vá em Configurações > Conta > Plataforma Business > Desconectar.
    3. Conecte de novo pelo Messajo.
  • O parceiro antigo recebe o aviso PARTNER_REMOVED da Meta.
  • 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.

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.

  • 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.updated com reason coex_unlinked.
  • A conta removeu o Messajo como parceiro: a conexão fica Desconectada com reason partner_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: 422 coex_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.
  • Velocidade fixa de 20 msg/s. Passou disso, 429 connection_rate_limited com Retry-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.echo e não abre a janela de 24 h: só a mensagem do contato abre. Veja Janelas.