Um erro na coexistência do WhatsApp costuma vir com um código e uma causa conhecida: app desatualizado, número já conectado, pouca atividade ou regra do recurso. Para os erros de conexão, a Meta publica a solução de cada código, e o código indica quem resolve.
Este guia reúne os códigos oficiais, os motivos de desconexão e as falhas de histórico, com base na documentação da Meta de outubro de 2026. Para entender o recurso antes, vale ler o guia completo da coexistência do WhatsApp.
Principais Conclusões
- Cada código tem solução oficial: 4563015 pede app atualizado, 3441045 pede mais atividade no app, e 3441049, 2655094 ou 2655093 pedem desconectar a plataforma anterior.
- Desconexão sem aviso pode vir de celular principal inativo por cerca de 14 dias, troca de aparelho ou reinstalação, e o parceiro vê o motivo no webhook.
- O histórico precisa ser sincronizado em até 24 horas e só pode ser pedido uma vez; refazer exige desconectar, esperar 15 minutos e repetir o fluxo.
Erro na Coexistência do WhatsApp: Tabela de Códigos e Soluções
Os erros de coexistência têm códigos numéricos publicados na página oficial de erros do Cadastro Incorporado, cada um com a solução recomendada. A tabela abaixo resume os principais, segundo a documentação da Meta consultada em outubro de 2026.
| Código | O que significa | O que fazer |
|---|---|---|
| 4563015 | WhatsApp Business App desatualizado | Atualizar o app (versão mínima 2.24.17) |
| 3441045 | Número ainda não elegível para a plataforma | Usar mais o WhatsApp Business App e tentar depois |
| 3441042 | Recurso indisponível para números da região | Usar um número de outra região |
| 2655095 / 2655048 | Número não registrado no WhatsApp Business | Registrar o número no app ou usar outro |
| 3441030 | Número já registrado, por exemplo na API | Desregistrar o número ou usar outro |
| 3441049 / 2655094 | Número já conectado a uma plataforma | Desconectar no app e esperar 15 minutos |
| 2655093 | Conta já compartilhada com outro parceiro | Desconectar o parceiro atual no app |
| 3441041 | Número fora do portfólio escolhido | Escolher o portfólio certo ou desvincular o número |
| 2655082 | Número vinculado a uma Página do Facebook | Remover a Página no Meta Business Suite |
| 3441047 | Conta usa marketing messages | Escolher outra conta do WhatsApp Business |
| 2593109 | Empresa não autorizou o envio do histórico | Desconectar e refazer o fluxo, se o histórico for necessário |
| 131060 | Mensagem não suportada logo após a conexão | Conferir a mensagem no app; costuma se resolver em segundos |
Os Três Momentos em Que o Erro Aparece
Os códigos se dividem em três momentos. Antes da conexão, o fluxo checa o aplicativo e o número; durante, confere a conta, o portfólio e o parceiro; depois, os problemas vêm de regras de sincronização e de uso do celular.
Essa divisão mostra quem age. Erros de app e de número costumam ser resolvidos pela própria empresa no celular. Erros de permissão, webhook e sincronização ficam com o parceiro, que opera a integração com a Cloud API.
Onde Ver o Código e o Que Enviar ao Parceiro
O código aparece na tela do Cadastro Incorporado, a janela de conexão aberta no site do parceiro, ou nos webhooks que o parceiro recebe. Erros como 2593109 e 131060 chegam ao sistema do parceiro, e não à tela da empresa.
Ao pedir ajuda, convém enviar o código, um print da mensagem, o número usado, a versão do WhatsApp Business App e o horário da tentativa. Com esses dados, o parceiro identifica a causa sem repetir o fluxo às cegas.
Não Consigo Ativar a Coexistência: Erros de App e Elegibilidade
Quando a coexistência não ativa logo no início, a causa costuma estar no aplicativo ou no número. A Meta exige o WhatsApp Business App atualizado, o número registrado nele e atividade suficiente para avaliar a elegibilidade.
App Desatualizado: Erro 4563015
O erro 4563015 pede para atualizar o WhatsApp Business App para a versão mais recente. Segundo a documentação oficial da coexistência, a versão mínima é a 2.24.17, e versões anteriores não concluem a conexão.
A correção é atualizar o app na loja do celular, abri-lo e repetir o fluxo. Vale conferir também se o número está mesmo no WhatsApp Business, e não no WhatsApp comum, que é outro aplicativo e não serve para a coexistência.
Número Não Elegível ou de Região Bloqueada: 3441045 e 3441042
O código 3441045 indica que o número ainda não é elegível. A solução oficial é usar mais o WhatsApp Business App, porque mais atividade ajuda a Meta a avaliar o caso. Ela não publica um mínimo de dias ou de mensagens.
Já o 3441042 informa que o recurso não está disponível para números daquela região, e a saída é usar um número de outra região. A lista de países bloqueados não aparece mais na documentação desde junho de 2026, e o Brasil (+55) nunca constou nela.
Número Não Registrado no App: 2655095 e 2655048
Os códigos 2655095 e 2655048 aparecem quando o número informado não está registrado no WhatsApp Business. É o caso de linhas que nunca foram ativadas no app ou de números digitados com algum erro na tela do Cadastro Incorporado.
A Meta orienta registrar o número no WhatsApp Business App ou informar outro que já esteja ativo. Antes de tentar de novo, a empresa deve conferir o código do país, o DDD e se o app abre normalmente no celular principal.
Número Já Conectado: API, Outro Parceiro, Portfólio ou Página
Outra família de erros aparece quando o número ou a conta já estão ligados a algo. A coexistência não move o número sozinha de um lugar para outro: a empresa precisa desfazer a conexão anterior antes de tentar de novo.
Número Já Registrado na API: Erro 3441030
O 3441030 informa que o número já está registrado, por exemplo, na Cloud API ou em outra conta da plataforma. A coexistência serve para números que estão no app; um número que já opera só pela API segue outro caminho.
A solução oficial é desregistrar o número atual ou usar outro. Quando a linha estava em outra conta do WhatsApp, a documentação avisa que pode levar até 3 minutos para ela ficar disponível depois da desconexão.
Número Ligado a Outro Parceiro: 3441049, 2655094 e 2655093
Os códigos 3441049 e 2655094 indicam que o número já está conectado a uma plataforma comercial. O 2655093 avisa que a conta já é compartilhada com um parceiro, e a Meta não permite trocar de parceiro direto nesse fluxo.
Nos três casos, a empresa abre o app em Configurações > Conta > Plataforma comercial, toca no parceiro conectado e em Desconectar. Depois, espera 15 minutos e refaz o fluxo. Uma linha de crédito antiga ainda compartilhada também pode gerar erro na troca.
Portfólio, Página e Marketing Messages: 3441041, 2655082 e 3441047
O 3441041 aparece quando o número não pertence ao portfólio empresarial escolhido no fluxo. A saída é selecionar o portfólio certo ou desvincular a conta do WhatsApp em Meta Business Suite > Configurações > Contas > Contas do WhatsApp antes de repetir.
O 2655082 indica número ligado a uma Página do Facebook, que precisa ser removida no Meta Business Suite. O 3441047 surge em contas que usam marketing messages. Manter o portfólio organizado, como mostra o guia de verificação do WhatsApp Business, ajuda a evitar esses conflitos.
Erros no Fluxo do Parceiro (Cadastro Incorporado)
Parte dos erros não depende da empresa, e sim do parceiro que oferece a conexão. Segundo a Meta, só um Solution Partner ou Tech Provider com acesso aprovado, webhook pronto e Cadastro Incorporado configurado consegue conectar contas do WhatsApp Business App.
Parceiro Sem Acesso Aprovado pela Meta
Quando o app do parceiro está em modo live, o Cadastro Incorporado só mostra as permissões aprovadas com Advanced Access na análise do app. Sem essa aprovação, o parceiro não consegue concluir a conexão de clientes, qualquer que seja o número usado.
Para atender outras empresas, o app precisa de Advanced Access em whatsapp_business_management e whatsapp_business_messaging, segundo a referência de permissões. Sem a primeira, as chamadas às contas de terceiros retornam erro 200. A análise do app pede vídeo por permissão e empresa verificada.
Limite de Novos Clientes por Semana
Mesmo aprovado, o parceiro tem limite de conexões: 10 novos clientes a cada 7 dias, em janela móvel. Com verificação da empresa, análise do app e verificação de acesso concluídas, o teto sobe para 200 novos clientes por semana.
Por isso, um parceiro em fase inicial pode pedir alguns dias de espera. Conexão que não passa pelo Cadastro Incorporado da Meta não é a coexistência oficial e pode envolver API não oficial, com mais risco de bloqueio do número.
Versão do Fluxo, Confirmação no App e Status
No fluxo atual, a empresa informa o número, recebe um código, toca em Conectar na mensagem da conta oficial Facebook Business e confirma se compartilha o histórico. Versões anteriores usavam QR code, então a tela pode variar conforme o parceiro.
A Meta anunciou que versões antigas do Cadastro Incorporado serão descontinuadas em 15/10/2026, com migração para a v4, segundo a página de versões. Para conferir o status, a equipe técnica checa is_on_biz_app (true) e platform_type (CLOUD_API) no número.
Coexistência Desconectou: Inatividade, Troca de Aparelho e Outros Motivos
Quando a coexistência desconecta sem ação da empresa, a Meta registra o motivo no webhook account_update, no campo disconnection_info. Ali o parceiro vê se a causa foi inatividade, troca de aparelho, troca de número ou fiscalização.
Celular Principal Inativo por Cerca de 14 Dias
O motivo PRIMARY_INACTIVITY indica que o celular principal ficou inativo por cerca de 14 dias, e o sistema desfaz a conexão com o parceiro e a API. A regra consta na referência do webhook account_update.
Para evitar, a empresa mantém o WhatsApp Business App instalado e aberto com frequência no aparelho principal. Há ainda o motivo COMPANION_INACTIVITY, registrado quando um dispositivo vinculado (companion) fica inativo por cerca de 30 dias.
Troca de Aparelho, Reinstalação e Reconexão
Ao trocar de celular ou reinstalar o app, a conexão com a Cloud API cai automaticamente (ACCOUNT_OFFBOARDED). No novo registro, aparece uma opção já marcada com os produtos conectados; se a empresa não desmarcar, a reconexão automática ocorre em poucos minutos.
Enquanto isso, as mensagens pela API ficam suspensas, o app fica brevemente indisponível e o histórico do intervalo não sincroniza. O WhatsApp Web precisa ser vinculado de novo à mão. Se outro parceiro conectar a conta nesse intervalo, a reconexão falha.
Outros Motivos Registrados pela Meta
Além da inatividade, a referência oficial lista outros motivos no disconnection_info. O campo initiated_by mostra se a ação partiu da empresa (USER) ou do sistema (SYSTEM), o que ajuda a separar descuido de bloqueio:
- ACCOUNT_DISCONNECTED: conta excluída pela empresa ou ação de fiscalização;
- BUSINESS_DOWNGRADE: o número foi registrado no WhatsApp comum;
- CHANGE_NUMBER: a empresa trocou o número da conta;
- USER_RE_REGISTERED: o número foi registrado em um novo aparelho.
Se o motivo for fiscalização, a empresa deve revisar o uso do número antes de reconectar, como explica o guia sobre WhatsApp banido. Reconectar sem entender a causa pode repetir o problema na mesma conta.
Coexistência Não Funciona Como Esperado: Histórico, Mídias e Aparelhos
Muitas queixas de que a coexistência não funciona vêm de limites do próprio recurso, e não de falha. Histórico com prazo, mídias antigas sem arquivo, grupos fora da API e WhatsApp Web desconectado são comportamentos descritos pela Meta.
Histórico Não Sincronizado e Prazo de 24 Horas
Depois da conexão, o parceiro tem 24 horas para sincronizar contatos e histórico. Se perder o prazo, a empresa precisa ser desconectada e refazer o fluxo. Cada sincronização só pode ser pedida uma vez, então uma falha também exige recomeçar.
O histórico cobre conversas individuais dos últimos 180 dias e é opcional: se a empresa recusar o compartilhamento na tela de confirmação, o parceiro recebe o erro 2593109. A Meta recomenda manter o app aberto durante o processo, que pode levar vários minutos.
Quem monta a integração por conta própria, como em projetos com n8n e a API oficial, precisa assinar os webhooks history, smb_app_state_sync e smb_message_echoes. Sem eles, histórico, contatos e mensagens enviadas pelo app não chegam à plataforma.
Mídias Antigas, Grupos e Recursos Fora da API
No histórico, só as mídias enviadas até 14 dias antes da conexão chegam com arquivo. As mais antigas aparecem como media_placeholder, sem a foto ou o documento. Grupos continuam no app, mas não sincronizam nem funcionam pela API.
Chamadas, catálogo, etiquetas e mensagens automáticas do app seguem só no celular. Listas de transmissão ficam só para leitura, e os templates saem apenas pela API, como mostra o material oficial da Meta. Envios em volume passam a seguir as regras de disparo em massa.
WhatsApp Web Desconectado e Erro 131060
Na conexão, todos os dispositivos vinculados são desconectados. A empresa pode vincular de novo até quatro, inclusive o WhatsApp Web, mas o WhatsApp para Windows e o Wear OS não são suportados e mostram as mensagens com texto de aviso.
O erro 131060 é esperado no primeiro contato de um cliente, comum em anúncios de clique para o WhatsApp, e se resolve em segundos. Mensagens recebidas antes da conexão só têm resposta pela API com template aprovado, porque a janela de 24 horas ainda não abriu.
Como Desconectar e Refazer a Coexistência
A coexistência é desconectada pelo próprio WhatsApp Business App, e não por API. Desconectar é o primeiro passo para trocar de parceiro, repetir uma sincronização perdida ou passar o número para outro modelo de uso.
Desconectar pelo App em Quatro Passos
A Deregister API não funciona para números em coexistência, então o caminho é sempre o aplicativo. Segundo a documentação da Meta, o passo a passo para desfazer a conexão com o parceiro e a Cloud API é este:
- Abrir o WhatsApp Business App no celular principal.
- Entrar em Configurações > Conta > Plataforma comercial.
- Tocar no parceiro conectado e em Desconectar conta.
- Esperar 15 minutos antes de conectar outro parceiro.
A desconexão dispara o evento PARTNER_REMOVED para o parceiro, e a integração com a Cloud API deixa de valer para aquele número. Antes de desconectar, convém exportar da plataforma os dados que a equipe precisa guardar.
Quando Refazer o Fluxo ou Mudar de Caminho
Refazer do zero é a saída quando o prazo de 24 horas passou, quando a sincronização falhou ou quando a empresa troca de parceiro. Nesses casos, o caminho é desconectar, aguardar 15 minutos e repetir o Cadastro Incorporado.
Se os problemas vêm de volume, vale rever o modelo. Em coexistência, o número tem throughput fixo de 20 mensagens por segundo, segundo a documentação da Meta consultada em outubro de 2026, valor que não muda com o volume da operação.
Na Cloud API pura, base da API oficial do WhatsApp, o número sai do app e começa com 80 mensagens por segundo, com subida automática até 1.000 se for elegível. A comparação entre coexistência ou Cloud API mostra quando cada modelo compensa.
Checklist Antes de Ativar e Quando Pedir Ajuda
A maioria dos erros de coexistência pode ser evitada com uma checagem rápida antes de abrir o fluxo. O checklist abaixo segue os requisitos e as soluções publicados pela Meta e separa o que cabe à empresa e ao parceiro.
Checklist de Oito Itens Antes de Ativar
Antes de iniciar a conexão, a empresa e o parceiro devem confirmar estes pontos, nesta ordem, para não repetir o fluxo várias vezes:
- WhatsApp Business App na versão 2.24.17 ou superior, no celular principal;
- número registrado e em uso no app, com atividade recente;
- número fora da Cloud API e sem outra plataforma comercial conectada;
- portfólio empresarial correto e número sem Página do Facebook vinculada;
- parceiro com acesso aprovado pela Meta e fluxo na versão atual;
- webhooks de histórico, contatos e mensagens do app assinados;
- equipe avisada de que o WhatsApp Web precisará ser vinculado de novo;
- rotina para abrir o app no celular principal com frequência.
O checklist de migração para a API oficial complementa essa lista com templates, opt-in e equipe. Para dividir o atendimento entre celular e plataforma, vale ver o guia de WhatsApp com múltiplos atendentes.
Quando Chamar o Parceiro e Quando Falar com a Meta
O parceiro é o primeiro contato para erros de permissão, webhook, sincronização e versão do fluxo, porque só ele vê os eventos da integração. Ele também acompanha a nota de qualidade, já que as mensagens enviadas pela API passam pela fiscalização normal da Cloud API.
O suporte da Meta entra quando o erro persiste depois das soluções oficiais ou quando o número é bloqueado. Nesses casos, a empresa reúne código, número, horário e prints e busca ajuda pelo parceiro ou pelo Business Support Home da Meta.
Perguntas Frequentes sobre Erros da Coexistência do WhatsApp
Conclusão
Resolver um erro de coexistência começa pelo código: ele separa o que depende do app, do número, da conta ou do parceiro. Depois da conexão, manter o celular principal ativo e sincronizar o histórico no prazo evita a maior parte das falhas.
O guia da coexistência do WhatsApp explica o recurso por inteiro, dos requisitos aos custos. Para atender pela API oficial com agentes de IA ligados ao CRM, caixa de entrada com vários atendentes e disparos com templates aprovados, a ConverZAP tem planos para cada etapa.
As mensagens enviadas pelo app continuam gratuitas, e as enviadas pela API seguem a tabela da Cloud API. A partir de 01/10/2026, a Meta cobra as mensagens de serviço e as de utilidade dentro da janela de 24 horas, com franquia de 1.000 mensagens de serviço por número a cada mês, segundo a página oficial de preços. O guia sobre cobrança do WhatsApp detalha as categorias.
O fluxo de conexão leva poucos passos, e a sincronização de contatos e histórico pode levar vários minutos, segundo a Meta. Depois da conexão, o parceiro tem até 24 horas para fazer essa sincronização.
Sim. Na coexistência, as mensagens enviadas e recebidas ficam espelhadas entre a Cloud API e o WhatsApp Business App, então a equipe vê no celular o que a plataforma respondeu e vice-versa.
Ao conectar a coexistência, a Meta desativa mensagens temporárias, visualização única e localização em tempo real em todas as conversas individuais. Não é erro: é uma mudança prevista na documentação oficial do recurso para chats 1:1.
As mensagens individuais enviadas pelo app não contam para os limites da Cloud API. As enviadas pela API seguem os limites de mensagens da Meta, que começam em 250 usuários únicos em 24 horas para empresas que entram pelo Cadastro Incorporado.
Reinstalar o app tem o mesmo efeito de trocar de aparelho: a conexão com a API cai e volta sozinha em poucos minutos, se a empresa mantiver marcada a opção de reconectar. Deixar o celular principal sem uso por cerca de 14 dias leva à desconexão por inatividade.
