WhatsApp Coexistence: Como Usar o App e a API no Mesmo Número

Muita empresa quer a API oficial, mas não quer tirar o app do celular do dono. O WhatsApp Coexistence foi feito para esse caso. Ele tem regras que valem a pena conhecer antes de ativar.

O que você vai ver neste guia

• O que é a coexistência e como ela funciona
• O passo a passo para ativar no Chatsac
• O que deixa de funcionar enquanto ela está ativa
• O que a Meta sincroniza de histórico e mensagens
• Quando a coexistência cai e como desativar
• O resumo das regras da Meta

O que é o WhatsApp Coexistence e como ele funciona?

O WhatsApp Coexistence deixa o negócio usar o número no app WhatsApp Business e na Cloud API ao mesmo tempo, por meio de uma plataforma parceira. O negócio faz o onboarding com a conta e o número que já tem no app. Depois, continua usando o app enquanto a plataforma atende pela API. Isso vem da documentação da Meta sobre onboarding de usuários do app Business.

A Meta diz que o recurso é chamado de "Coexistence" em canais de suporte e na documentação para parceiros. Neste guia uso coexistência e coexistence como sinônimos. O botão do Chatsac usa a forma curta Coex.

As mensagens ficam espelhadas. O que o dono envia pelo app chega também à plataforma. Por trás, a Meta converte a conta existente em uma conta de Messaging compatível com a anterior. O ID da conta continua o mesmo.

A Meta lista quatro requisitos:

• App WhatsApp Business na versão 2.24.17 ou superior.
• Plataforma que seja Meta Solution Partner ou Tech Provider.
• Uso da Cloud API.
• Webhooks tratados.

O Chatsac é Tech Provider da Meta. Quer o contexto maior da API? Leia o guia completo da WhatsApp API para atendimento.

Como ativar a coexistência do WhatsApp no Chatsac?

No Chatsac, a ativação parte de um canal de WhatsApp já conectado, pelo botão Ativar Coex. Depois você autoriza o mesmo número no fluxo da Meta.

O passo a passo:

1. Abra o canal de WhatsApp conectado no Chatsac.
2. Clique em Ativar Coex.
3. Leia os avisos da tela antes de seguir.
4. Siga as instruções na tela até abrir o fluxo da Meta.
5. No fluxo da Meta, autorize o mesmo número que está no app.
6. Confira na tela do canal que a coexistência ficou ativa.

Do lado do celular, a Meta descreve este caminho. Você informa o número do app e recebe um código de verificação. O app recebe uma mensagem da conta oficial Facebook Business Account. Toque em Conectar e depois em Confirmar. Nessa tela você escolhe se compartilha o histórico de conversas. Por fim, cole o código ou escaneie o QR code e conclua o Embedded Signup.

Se o número ainda está em outro fluxo, veja antes o guia de migrar para a API oficial do WhatsApp sem perder o número. Para conhecer a solução de API da Chatsac, veja a API WhatsApp do Chatsac.

O que muda no celular e o que não funciona na coexistência?

Enquanto a coexistência está ativa, o número tem vazão fixa de 20 mensagens por segundo, e vários recursos ficam sem suporte na Cloud API. A Meta separa o que muda no app do que não roda na API.

A tabela de comparação da Meta lista como sem suporte na Cloud API:

• Grupos.
• Chamadas de voz e vídeo.
• Ferramentas de negócio: catálogo, pedidos e status.
• Ferramentas de mensagem: mensagens de marketing, saudação, mensagem de ausência, respostas rápidas e etiquetas.
• Edição do perfil comercial.
• Canais.

Para grupos, chamadas, catálogo, pedidos, status, ferramentas de mensagem, perfil e canais, a Meta marca "sem mudança" no app. Ou seja, eles seguem no app e só não rodam pela API. No app, a mudança da Meta é outra. As listas de transmissão ficam desativadas, não dá para criar novas, e as existentes viram somente leitura. Mensagens temporárias, visualização única e localização em tempo real ficam desligadas nas conversas 1:1. A edição e a revogação de mensagens passam a ser suportadas.

Sobre aparelhos vinculados, a Meta aceita até 4 clientes companheiros. Todos são suportados, menos o WhatsApp para Windows e o WearOS. O onboarding desvincula os aparelhos já vinculados, e o negócio pode vinculá-los de novo.

O que a Meta sincroniza de histórico e mensagens?

A Meta permite sincronizar as conversas 1:1 dos últimos 6 meses (180 dias), sem grupos. O negócio pode recusar compartilhar o histórico. Vale a leitura da página da Meta sobre a sincronização de histórico.

Os detalhes da regra da Meta:

• A plataforma pode sincronizar contatos e histórico de mensagens.
• Só há ID de mídia para arquivos enviados nos 14 dias anteriores ao onboarding.
• A sincronização precisa começar em até 24 horas da ativação.
• O pedido de histórico só pode ser feito uma vez.

Essa regra é da Meta. O que aparece na sua conta depende da plataforma, então confirme com o time antes de ativar.

Depois da ativação, as mensagens seguem espelhadas entre o app e a plataforma. Sobre a janela de atendimento, a Meta separa assim: ela vale só para mensagens enviadas pela Cloud API. Mensagens enviadas pelo app não abrem nem estendem a janela. Uma mensagem recebida pouco antes do onboarding só pode ser respondida por API com um template, não com texto livre.

Quando a coexistência do WhatsApp cai e como desativar?

A Meta desconecta o número da API quando o aparelho principal fica inativo por cerca de 14 dias. Um aparelho companheiro inativo por cerca de 30 dias também gera desconexão. A troca de aparelho ou um novo registro do app desconecta igualmente. Tudo isso está na página da Meta sobre reconectar clientes desconectados.

A Meta ainda lista outros motivos de desconexão, como troca de número e conta desconectada. Ela avisa a plataforma por um evento de webhook com o motivo.

Depois da desconexão, o negócio pode refazer o onboarding. Ele mantém a mesma conta de WhatsApp e a conta de Messaging já convertida. Na prática, vale abrir o app com regularidade no aparelho principal.

Para desativar, use a opção no próprio canal, dentro do Chatsac. Em caso de dúvida, fale com o time antes.

Coexistência ou só a plataforma: o que muda?

Na coexistência, o número roda no app e na Cloud API ao mesmo tempo. A tabela resume as regras que a Meta define para esse modo.

A coexistência serve a quem quer manter o dono no app enquanto a equipe atende pela plataforma. Para entender as bases da diferença entre app e plataforma, leia WhatsApp Business App x Business Platform.

Como fica o custo na coexistência?

A Meta diz que as mensagens enviadas pelo app continuam gratuitas e que as enviadas pela Cloud API seguem a precificação da Cloud API. Para o valor dos planos do Chatsac, a âncora abaixo lê a fonte oficial do site.

Para o detalhe do modelo de cobrança da Meta, veja o guia de preço da API oficial do WhatsApp.

Perguntas frequentes

Vale ativar a coexistência hoje?

Vale se você quer manter o dono no app e a equipe na plataforma. Antes, confira os limites: 20 mensagens por segundo e a lista de recursos que a Meta deixa sem suporte. Se isso cabe na sua operação, o caminho no Chatsac é o botão Ativar Coex no canal. Veja a API WhatsApp do Chatsac e me diga: qual recurso do app você não abre mão?