Coexistência do WhatsApp (Coexistence)

Coexistência é o recurso oficial da Meta que permite usar o mesmo número no aplicativo WhatsApp Business e na Cloud API simultaneamente. O histórico das conversas individuais sincroniza nos dois sentidos, o dono do número continua respondendo pelo celular e a equipe atende pela plataforma — sem segundo chip e sem migração.

Atualizado em


Também chamado de: Coexistence, WhatsApp CoEx, modo coexistência.

Como funciona

Antes da coexistência, conectar um número à API oficial era uma via de mão única: o número saía do aplicativo WhatsApp Business e passava a existir só pela API. Quem tinha o histórico e a rotina no celular perdia os dois.

Com a coexistência, o número passa a viver nos dois ambientes. A Meta sincroniza até 180 dias de histórico das conversas individuais no momento do onboarding, e as mensagens seguintes continuam sincronizando nos dois sentidos.

Em troca dessa compatibilidade, o número recebe uma vazão fixa de 20 mensagens por segundo — um teto menor que o de um número exclusivamente de API, mas mais que suficiente para atendimento.

A cobrança segue separada por origem: mensagens enviadas pelo aplicativo continuam gratuitas, e as enviadas pela Cloud API entram na tabela de preços normal da Cloud API.

Na prática

  • É o caminho natural para quem já vende pelo WhatsApp há anos e não pode perder o histórico nem reeducar os clientes para um número novo.

  • Alguns recursos do aplicativo são desativados depois do onboarding: mensagens temporárias, visualização única, localização em tempo real, listas de transmissão (as existentes ficam somente leitura), grupos, chamadas de voz e vídeo, ferramentas comerciais e canais.

  • Conversas em grupo não sincronizam. Mensagens antigas sincronizam sem o ID do arquivo de mídia — só as dos últimos 14 dias trazem a mídia junto.

  • O aplicativo precisa estar na versão 2.24.17 ou superior para o onboarding funcionar.

Perguntas frequentes

Preciso de dois números para usar a API oficial?
Não. Com a coexistência, o mesmo número funciona no aplicativo WhatsApp Business e na Cloud API ao mesmo tempo. Dois números só são necessários se você optar pela migração tradicional, em que o número deixa o aplicativo.
Perco o histórico das conversas ao ativar a coexistência?
Não. A Meta sincroniza as mensagens individuais enviadas ou recebidas nos 180 dias anteriores ao onboarding. Conversas em grupo não são sincronizadas, e mensagens com mais de 14 dias vêm sem o arquivo de mídia anexado.
Quantas mensagens por segundo a coexistência suporta?
Números em coexistência têm vazão fixa de 20 mensagens por segundo, definida pela Meta para manter a compatibilidade com o aplicativo. É um teto menor que o de um número exclusivo de API, mas adequado para operações de atendimento.

Fontes

Leia também