Coexistência

Normalmente, conectar um número à Cloud API desliga o aplicativo do WhatsApp Business naquele aparelho. A coexistência é o modo em que os dois funcionam juntos: a equipe segue atendendo pelo celular e a API opera no mesmo número.

Quando faz sentido

Faz sentido quando a operação já roda no aplicativo e você quer automatizar parte dela sem migrar tudo de uma vez — disparos automáticos pela API, atendimento humano pelo celular.

Não faz sentido quando ninguém mais vai usar o celular. O modo dedicado é mais simples e não tem as limitações abaixo.

Como conectar

No painel, ao Conectar número, escolha Coexistência. O fluxo é o mesmo Embedded Signup da Meta, com dois pedidos extras no celular do responsável:

1. Autorizar a integração.
2. Autorizar o compartilhamento de histórico de conversas e contatos.

O segundo passo é opcional para o cliente e definitivo para você: se ele recusar, não há como pedir de novo sem refazer o onboarding inteiro.

O que muda no dia a dia

	Modo dedicado	Coexistência
App WhatsApp Business	desativado	continua funcionando
Mensagens enviadas pelo celular	—	chegam a você como smb_message_echoes
Mensagens recebidas	webhook messages	webhook messages, nos dois lados
Histórico anterior	não existe	sincronizável nas primeiras 24h
Contatos do aparelho	não existem	sincronizáveis nas primeiras 24h

Ecos das mensagens do celular

Tudo que a equipe digita no aplicativo chega para você no evento smb_message_echoes, no mesmo formato de messages.

Assine esse evento se o seu sistema mantém a conversa completa — sem ele, você só vê o que o cliente escreve e o que a API envia, e o histórico fica com buracos.

{
  "field": "smb_message_echoes",
  "value": {
    "message_echoes": [
      {
        "from": "5541987111527",
        "to": "5541999999999",
        "id": "wamid.HBgN...",
        "type": "text",
        "text": { "body": "Claro, já vou verificar!" }
      }
    ]
  }
}

Alterações de contato

Adicionar, renomear ou remover um contato no celular gera um evento smb_app_state_sync. Isso continua acontecendo indefinidamente, não só na sincronização inicial.

Limitações

A janela de 24 horas continua valendo. Uma resposta enviada pelo celular abre a janela para a API também — as duas compartilham a mesma conversa.

Grupos não passam pela API. O aplicativo continua acessando grupos; a Cloud API não os enxerga. Mensagens de grupo não geram webhook.

Chamadas continuam no aplicativo. Ligações de voz e vídeo não são expostas pela API.

A qualidade do número é uma só. Um disparo em massa mal recebido pela API derruba a qualidade que o atendimento humano também usa.

Sincronizando o histórico

O passo mais delicado e o que menos perdoa erro: você tem 24 horas e uma única tentativa. Está no guia Sincronizar histórico.

Voltando atrás

Desconectar o número no painel devolve a operação inteira para o aplicativo. O histórico que estava no celular nunca saiu de lá.

O caminho inverso — sair da coexistência para o modo dedicado — exige refazer o onboarding e desliga o aplicativo naquele aparelho.