# 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](/connect/whatsapp/).

## 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

- **Sintoma:** `422` [`coex_not_on_business_app`](/errors#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**.

## A janela da Meta terminou sem número

- **Sintoma:** [`signup_incomplete`](/errors#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

- **Sintoma:** [`signup_session_expired`](/errors#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

- **Sintoma:** [`signup_scope_mismatch`](/errors#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

- **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

- **Sintoma:** `403` [`account_flagged`](/errors#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.

## Número já conectado

- **Sintoma:** `409` [`connection_already_exists`](/errors#connection_already_exists) ou [`waba_owned_by_other_org`](/errors#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.

## O número já está com outro parceiro

- **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.

## 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

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

- **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](/connect/whatsapp/#quando-a-conexão-cai) e em [Motivos da conexão](/webhooks/events/#motivos-da-conexão).

## Não consigo editar perfil, nome ou username pela API

- **Sintoma:** `422` [`coex_not_supported`](/errors#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.

## Limites que parecem bug

- **Velocidade fixa de 20 msg/s.** Passou disso, `429` `connection_rate_limited` com `Retry-After`. Veja [Limites](/api/limits/).
- **Ligações:** [`calling_not_supported_in_coex`](/errors#calling_not_supported_in_coex). Use um número só API.
- **Grupos:** [`group_not_supported`](/errors#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](/api/limits/#janelas).
