Coexistência no WhatsApp: como usar o mesmo número no app Business e na API oficial

Atualizado em 20/10/2026

Coexistência é o recurso da Meta que conecta um número já ativo no app WhatsApp Business à Cloud API sem tirá-lo do app. Depois da integração, a empresa continua conversando pelo celular e, ao mesmo tempo, envia e recebe mensagens pela API, com o histórico sincronizado entre os dois. A conexão é feita pelo Cadastro Incorporado (Embedded Signup) de um parceiro da Meta e tem limitações: taxa de envio de 20 mensagens por segundo, alguns recursos do app desativados e a obrigação de abrir o app com regularidade.

Na documentação da Meta, o recurso aparece como “Como integrar usuários do app WhatsApp Business” (Onboarding WhatsApp Business app users, página atualizada em 26/06/2026). A própria Meta diz que ele “às vezes é chamado de Coexistência” nos canais de suporte.

Por que a coexistência existe

Antes dela, colocar um número na API exigia excluí-lo do aplicativo. A documentação de números da Cloud API ainda diz que números em uso no WhatsApp não podem ser registrados sem serem excluídos antes. Para pequenas empresas, isso significava perder o histórico e o jeito de trabalhar no celular.

Com a coexistência, o número do app Business vira também um número da API. O dono continua respondendo pelo celular, e o sistema (CRM, chatbot, agente de IA, plataforma de notificações) passa a operar no mesmo número.

O que acontece com a conta na integração

Quando o cliente conclui o fluxo, a Meta converte a conta do WhatsApp Business existente em uma conta de mensagens compatível. Pontos práticos:

O waba_id devolvido pelo Cadastro Incorporado é o mesmo identificador que a conta já tinha antes da conversão.
Não é criada uma conta de mensagens separada para o parceiro.
A conta do WhatsApp ligada ao número e a conta de mensagens convertida são compartilhadas com o parceiro, mas continuam no portfólio empresarial do cliente.
A etapa de registro do número é pulada, porque ele já está registrado.

Requisitos

Requisito	Detalhe
Versão do app	WhatsApp Business 2.24.17 ou superior no celular do cliente
Quem integra	Um Parceiro de Soluções ou Provedor de Tecnologia da Meta
Fluxo	Cadastro Incorporado com registro de sessão e `featureType: "whatsapp_business_app_onboarding"`
Webhooks	Endpoint capaz de receber e processar os campos adicionais (ver abaixo)
Versão do Cadastro Incorporado	As versões 2 e 3 ficam obsoletas a partir de 15/10/2026; a Meta orienta migrar para a versão 4

O último item é recente: a página da Meta avisa que as versões 2 e 3 do Cadastro Incorporado, incluindo prévias públicas, ficam obsoletas a partir de 15 de outubro de 2026. Integrações antigas precisam ser atualizadas.

Disponibilidade por país: a página consultada não lista restrições geográficas.

Como o fluxo funciona para o cliente

No Cadastro Incorporado, o cliente escolhe conectar a conta existente do app WhatsApp Business e informa o número.
O WhatsApp mostra um código de verificação.
O cliente recebe no app uma mensagem da conta comercial oficial do Facebook e toca em Conectar à Plataforma do WhatsApp Business.
O app pergunta se ele quer compartilhar o histórico de conversas com o parceiro.
O cliente cola o código e conclui o fluxo.

Do lado do parceiro, o Cadastro Incorporado devolve os IDs e um código de token trocável, como em qualquer integração. A diferença é o evento da sessão:

{
  "data": { "waba_id": "<CUSTOMER_WABA_ID>" },
  "type": "WA_EMBEDDED_SIGNUP",
  "event": "FINISH_WHATSAPP_BUSINESS_APP_ONBOARDING",
  "version": 3
}

O recurso é ativado no código de inicialização do Cadastro Incorporado, no objeto extras:

{
  "config_id": "<CONFIGURATION_ID>",
  "response_type": "code",
  "override_default_response_type": true,
  "extras": {
    "setup": {},
    "featureType": "whatsapp_business_app_onboarding",
    "sessionInfoVersion": "3"
  }
}

Esse trecho reproduz o exemplo da documentação. Se você já usa a versão 4 do Cadastro Incorporado, confira os parâmetros equivalentes na página de versões da Meta.

Sincronização: prazo de 24 horas

Depois da integração, o parceiro tem 24 horas para sincronizar contatos e histórico. Se perder o prazo, o cliente precisa ser desligado e refazer o fluxo. Cada sincronização só pode ser pedida uma vez.

A sincronização usa a API de dados do app (smb_app_data):

# 1. Contatos
curl -X POST "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/smb_app_data" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "messaging_product": "whatsapp", "sync_type": "smb_app_state_sync" }'

# 2. Histórico de mensagens
curl -X POST "https://graph.facebook.com/<API_VERSION>/<BUSINESS_PHONE_NUMBER_ID>/smb_app_data" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{ "messaging_product": "whatsapp", "sync_type": "history" }'

A resposta traz um request_id, que vale guardar para chamados de suporte. O histórico cobre até seis meses de conversas individuais e só é enviado se a empresa tiver autorizado o compartilhamento. A Meta recomenda pedir ao cliente que mantenha o app aberto durante o processo.

Webhooks adicionais

Além dos campos que você já assina, a coexistência exige assinar quatro campos da conta de mensagens:

Campo	O que traz
`account_update`	Mudanças no ciclo de vida da conta, incluindo desconexão (`PARTNER_REMOVED`)
`history`	Mensagens antigas enviadas e recebidas pelo cliente
`smb_app_state_sync`	Contatos novos e atuais do app
`smb_message_echoes`	Mensagens que o cliente envia pelo app depois da integração

O smb_message_echoes é o que mantém o seu sistema em dia: quando o dono responde pelo celular, o evento chega e você grava a mensagem no histórico do contato. Sem ele, o sistema só enxerga metade da conversa.

Para entender a estrutura dos eventos e montar um endpoint robusto, veja Webhooks da API do WhatsApp: guia prático.

O que muda no app WhatsApp Business

A Meta publica uma tabela comparando os recursos antes e depois. Os pontos principais:

Recurso do app	Depois da integração	Disponível pela API?
Conversas individuais	Continuam; passa a ser possível editar e revogar mensagens	Sim, espelhadas entre app e API
Contatos	Sem mudança	Sim, sincronizados
Grupos	Sem mudança no app	Não sincronizados
Mensagens temporárias	Desativadas nas conversas individuais	Não
Visualização única	Desativada	Não
Localização em tempo real	Desativada	Não
Listas de transmissão	Desativadas; as existentes ficam só para leitura	Não
Ligações de voz e vídeo	Sem mudança	Não
Catálogo, pedidos, status	Sem mudança	Não
Saudação, ausência, respostas rápidas, etiquetas	Sem mudança	Não
Dispositivos conectados	Desvinculados na integração; podem ser vinculados de novo	Exceto WhatsApp para Windows e WearOS

Sobre dispositivos conectados: o app aceita até quatro aparelhos companheiros. Mensagens enviadas por um usuário a partir de um dispositivo companheiro incompatível não disparam webhook de mensagens, então não aparecem no seu sistema.

A API de Grupos também não está disponível para números do app WhatsApp Business, segundo a documentação de grupos.

Limitações que afetam a operação

Taxa de envio fixa em 20 mps

Números que usam app e API ao mesmo tempo têm throughput fixo de 20 mensagens por segundo. Números comuns da Cloud API começam em 80 mps e podem subir. Para disparos grandes de notificações, isso pesa.

Inatividade derruba a conexão

O webhook account_update com evento PARTNER_REMOVED informa o motivo da desconexão. Entre os motivos documentados:

PRIMARY_INACTIVITY: o dispositivo principal ficou inativo por cerca de 14 dias;
COMPANION_INACTIVITY: um dispositivo companheiro ficou inativo por cerca de 30 dias;
BUSINESS_DOWNGRADE: o número foi registrado no WhatsApp comum;
CHANGE_NUMBER e USER_RE_REGISTERED: troca de número ou novo registro em outro aparelho.

Na prática, oriente o cliente a abrir o app no celular principal com regularidade. Trate o evento PARTNER_REMOVED no seu sistema e avise a equipe, em vez de descobrir a queda pelas mensagens que pararam de sair.

Desconexão só pelo app

O endpoint de cancelamento de registro não funciona para números em coexistência. O cliente desconecta pelo app, em Configurações > Conta > Plataforma comercial > Desconectar conta.

Erro 131060 na primeira mensagem

A Meta documenta que mensagens recebidas podem chegar com o erro 131060 quando um usuário escreve pela primeira vez (comum após um clique em anúncio) ou usa um dispositivo companheiro incompatível. No primeiro caso, o erro costuma se resolver em segundos.

Preços e janela de atendimento na coexistência

Mensagens enviadas pelo app continuam gratuitas.
Mensagens enviadas pela API seguem a tabela da Cloud API, por categoria e país.
A janela de 24 horas só é aberta por mensagens recebidas depois da integração. Se o cliente escreveu antes, a resposta pela API precisa ser um template.
Mensagens enviadas pelo app não abrem, não estendem e não afetam as janelas nem os preços da API.

Os valores para o Brasil estão em Quanto custa a API do WhatsApp no Brasil em 2026, com base na página oficial de preços.

Como conferir se o número está em coexistência

Consulte os campos is_on_biz_app e platform_type do número:

curl "https://graph.facebook.com/<API_VERSION>/<PHONE_NUMBER_ID>?fields=is_on_biz_app,platform_type" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

{ "is_on_biz_app": true, "platform_type": "CLOUD_API", "id": "106540352242922" }

Se is_on_biz_app for true e platform_type for CLOUD_API, o número opera no app e na API.

Quando a coexistência vale a pena

Ela resolve bem o caso de quem já tem clientes conversando com o número do app e quer automatizar parte do atendimento ou das notificações sem trocar de número. Funciona para clínicas, lojas e prestadores de serviço em que o dono ou a equipe ainda responde pelo celular.

Ela é menos indicada quando:

o volume de envio exige mais de 20 mensagens por segundo;
a operação depende de listas de transmissão, mensagens temporárias ou grupos via API;
não há ninguém para manter o celular principal ativo.

Coexistência e Vectalk

A Vectalk oferece coexistência: você conecta pelo Cadastro Incorporado da Meta o número que já usa no app WhatsApp Business e passa a usá-lo também pela API, sem tirá-lo do celular. Como a Vectalk funciona como proxy da Cloud API, as chamadas e os eventos de webhook seguem o mesmo formato da Meta, conforme a documentação.

Para falar com o time ou abrir uma conta, use a Central de Ajuda ou o cadastro. Se você ainda está decidindo entre API e app, o guia da API oficial do WhatsApp ajuda a comparar.

Perguntas frequentes

Coexistência funciona com o WhatsApp comum (Messenger)?

Não. O recurso é para números no app WhatsApp Business. Se o número está no WhatsApp comum, você pode migrá-lo para o app Business antes, ou excluir a conta do app e registrar o número direto na Cloud API.

Vou perder o histórico de conversas?

Não no app. Para o sistema conectado à API, a Meta permite sincronizar até seis meses de conversas individuais, se a empresa autorizar, em até 24 horas após a integração. Grupos não são sincronizados.

Posso continuar mandando mensagens pelo celular?

Sim. As mensagens enviadas pelo app continuam gratuitas e aparecem no sistema conectado por meio do webhook smb_message_echoes.

Posso fazer a coexistência com uma integração direta, sem parceiro?

A documentação da Meta coloca como requisito ser Parceiro de Soluções ou Provedor de Tecnologia. Uma empresa que integra apenas o próprio número normalmente faz isso por meio de um parceiro.

Por que o número desconectou da API sozinho?

Confira o evento PARTNER_REMOVED no webhook account_update. O motivo mais comum é inatividade do celular principal por cerca de 14 dias (PRIMARY_INACTIVITY). A reconexão com o mesmo parceiro dispara o evento ACCOUNT_RECONNECTED.

Fontes oficiais consultadas em 20/10/2026: Como integrar usuários do app WhatsApp Business (atualizada em 26/06/2026), Números de telefone comerciais, API de Grupos, Preços da plataforma.