Coexistência da WhatsApp Business API

No cenário digital acelerado de hoje, as empresas estão recorrendo cada vez mais a plataformas de mensagens como o WhatsApp para melhorar o engajamento com os clientes. A WhatsApp Business API oferece ferramentas poderosas para ampliar as comunicações, mas e se você já usa o WhatsApp Business App? É aí que entra a Coexistência . Esse recurso permite integrar perfeitamente a API à configuração atual do seu app, possibilitando o envio eficiente de mensagens em grande escala sem interromper suas operações do dia a dia. A seguir, explicamos tudo o que você precisa saber sobre a Coexistência da WhatsApp Business API, com foco em proprietários e gestores de empresas — sem termos técnicos. Você pode ler mais detalhes sobre a Coexistência do WhatsApp em nosso artigo do blog sobre Coexistência.

O que é a Coexistência?

A Coexistência é um recurso da WhatsApp Business API que permite que as empresas usem a conta e o número de telefone existentes do WhatsApp Business App junto com a API. Essencialmente, ela conecta as interações individuais pelo app às mensagens automatizadas em grande volume pela API. Isso significa que você pode atender conversas informais com clientes pelo celular e, ao mesmo tempo, usar a automação para campanhas mais amplas ou suporte. O histórico de mensagens é sincronizado entre os dois, garantindo uma experiência unificada. É ideal para empresas em crescimento que querem expandir sem começar do zero.

Como funciona

A Coexistência funciona por meio de um processo simples de integração:

1. Informe seus dados: durante a configuração (muitas vezes chamada de Cadastro Incorporado), informe o número de telefone do seu WhatsApp Business App.
2. Verifique a titularidade: receba um código de verificação de uma Facebook Business Account conectada e confirme-o no app.
3. Compartilhe dados: opte por compartilhar seu histórico de conversas e contatos para sincronizá-los.
4. Conclua a integração: o sistema atribui os IDs e tokens necessários, permitindo que seu provedor conecte a API sem registrar o número novamente.
5. Sincronização contínua: as novas mensagens do app são replicadas na API e vice-versa, mantendo tudo sincronizado.

Essa configuração permite que você envie mensagens em grande escala pela API e continue usando o app para respostas rápidas. A sincronização geralmente é concluída em até 24 horas.

Requisitos

Para ativar a Coexistência, sua empresa precisa atender a estes critérios:

• Use a versão 2.24.17 ou posterior do WhatsApp Business App.
• Tenha um número de telefone de qualquer país. A Coexistência agora é compatível com todos os países (consulte a seção Países não compatíveis abaixo para ver as restrições gerais da WhatsApp Business API).
• Tenha como parceiro um Provedor de Soluções do WhatsApp ou um Provedor de Tecnologia para acessar a API.
• Verifique se seu sistema consegue processar notificações recebidas (webhooks) para atualizações em tempo real.
• Use uma configuração compatível com o registro de sessões para conexões seguras.

Esses requisitos garantem compatibilidade e segurança, facilitando a transição para sua equipe.

Limitações

Embora seja poderosa, a Coexistência tem algumas limitações:

• O limite de envio é de 20 mensagens por segundo para números compartilhados, o que é suficiente para a maioria das empresas, mas pode exigir planejamento em períodos de alto volume.
• Alguns recursos do app, como mensagens temporárias ou listas de transmissão, ficam limitados ou somente para leitura após a integração.
• Se você já compartilhou linhas de crédito com outros parceiros, poderá encontrar erros de configuração — que podem ser resolvidos pelos canais de suporte.
• Conversas em grupo e chamadas continuam disponíveis apenas no app e não são sincronizadas com a API.

Entender essas limitações ajuda a definir expectativas realistas para seu fluxo de trabalho.

Países não compatíveis

Todos os países compatíveis com a WhatsApp Business API agora também são compatíveis com a Coexistência.

No entanto, a WhatsApp Business API tem restrições gerais mais amplas. As empresas não podem enviar nem receber mensagens dessas regiões:

• Crimeia (+7978)
• Cuba (+53)
• Irã (+98)
• Coreia do Norte (+850)
• Síria (+963)

Se sua empresa opera nessas regiões, considere soluções alternativas de mensagens ou consulte as atualizações da Meta.

Preços

Os preços da WhatsApp Business API com a Coexistência são simples, mas variam de acordo com o uso:

• Mensagens do app: continuam totalmente gratuitas, como sempre foram.
• Mensagens da API: cobradas por mensagem, de acordo com a localização do destinatário e a categoria da mensagem (por exemplo, marketing, utilidade, autenticação ou serviço).
• Mensagens de serviço gratuitas: dentro da janela de atendimento ao cliente de 24 horas (iniciada por uma mensagem do usuário), as respostas de serviço são gratuitas.
• Tarifas por mensagem: em 1 de julho de 2025, a Meta adotou o Preço por Mensagem (PMP). As tarifas começam em $0.005–$0.010 por mensagem, com faixas de descontos por volume. Por exemplo, mensagens de marketing podem custar mais do que mensagens de utilidade. Você recebe 1,000 conversas de serviço gratuitas por mês.
• Taxas do provedor: seu parceiro de API pode adicionar taxas (de $50–$500/month, dependendo do plano), então leve isso em conta.

Consulte as tabelas oficiais de tarifas da Meta para ver os preços por país e observe que podem ocorrer atualizações trimestrais (janeiro, abril, julho, outubro).

Janela de atendimento ao cliente

A janela de atendimento ao cliente é uma das principais vantagens da WhatsApp Business API. É um período móvel de 24 horas que começa sempre que um cliente envia uma mensagem para sua empresa. Durante esse período:

• Você pode enviar mensagens de serviço ilimitadas (por exemplo, respostas a consultas) sem custo.
• Fora da janela, você só pode enviar mensagens de modelo aprovadas, que são cobradas.
• Na Coexistência, isso se aplica às mensagens enviadas pela API; as mensagens do app são sempre gratuitas, mas não estendem a janela para o uso da API.

Isso incentiva respostas rápidas e ajuda a gerenciar os custos com eficiência.

Comparação de recursos

A Coexistência combina o melhor do WhatsApp Business App e da API, mas alguns recursos mudam. Veja a comparação:

A API se destaca em automação e escalabilidade, enquanto o aplicativo cuida do atendimento personalizado.

Observações importantes

• Nome de exibição: O nome de exibição não é compatível com o Coexistence, então os clientes verão seu número de telefone em vez do nome da sua marca. Por padrão, o nome de exibição só é compatível com números conectados como números independentes da Cloud API. No entanto, se você assinar o Meta Verified (uma assinatura paga), o nome de exibição será compatível e seus clientes verão um selo azul de verificação.
• WhatsApp Calling API: O recurso WhatsApp Calling API não é compatível com a configuração Coexistence.
• WhatsApp Groups API: WhatsApp Groups API não é compatível com a configuração Coexistence.

Dispositivos conectados

Você pode conectar até 4 dispositivos complementares ao seu aplicativo WhatsApp Business:

• Compatíveis: a maioria dos dispositivos móveis complementares (por exemplo, tablets e celulares secundários).
• Não compatíveis: WhatsApp para Windows e WearOS.

Após a configuração do Coexistence, todas as conexões são temporariamente interrompidas, mas você pode conectar novamente os dispositivos compatíveis. As mensagens de dispositivos não compatíveis não serão sincronizadas com a API e poderão aparecer como marcadores de posição.

Sincronização de dados/contatos

A sincronização de dados é automática após a integração:

• Os contatos e o histórico de conversas são transferidos em até 24 horas.
• Todos os contatos do WhatsApp são sincronizados com a API para que você possa usá-los sem interrupções.
• Se a sincronização falhar, você precisará desconectar e tentar novamente.

Isso garante que sua equipe tenha acesso às mesmas informações em todas as plataformas.

Sincronização do histórico de mensagens

Para iniciar a sincronização do histórico:

• Após a integração, inicie a sincronização pelo sistema do seu provedor (ou por uma chamada de API, se o gerenciamento for interno).
• Ela abrange até 180 dias de histórico, divididos em etapas (0-1 dia, 1-90 dias, 90-180 dias).
• As mídias dos últimos 14 dias são sincronizadas separadamente.

É possível sincronizar apenas uma vez por configuração; para sincronizar novamente, é necessário desconectar.

Histórico de mensagens compartilhado

Se você optar por compartilhar:

• Os webhooks do histórico enviam as conversas em lotes.
• Isso garante a continuidade do atendimento ao cliente.

Histórico de mensagens não compartilhado

Se você recusar:

• Uma notificação de erro será exibida.
• Nenhum histórico será sincronizado; você começará do zero na API.

Recomendamos compartilhar o histórico para uma experiência mais fluida.

Espelhar novas mensagens

As novas mensagens enviadas pelo aplicativo (ou por dispositivos compatíveis) são espelhadas automaticamente na API por meio de notificações de "eco". Isso mantém as conversas atualizadas em tempo real e permite que sua equipe as visualize e responda em qualquer uma das plataformas.

Relatar a atividade das conversas

Para campanhas como anúncios Click to WhatsApp:

• Acompanhe conversões e leads pela Conversions API da Meta.
• Faça relatórios em nome dos clientes para medir o ROI.

Isso ajuda a otimizar os esforços de marketing.

Desconexão de clientes comerciais

Para desconectar:

• Acesse WhatsApp Business > Configurações > Conta > Plataforma empresarial > Desconectar conta.
• Isso aciona um evento de remoção e libera o número para uso somente no aplicativo.
• Você não pode cancelar o registro pela API enquanto a coexistência estiver ativa.

Planeje isso com cuidado para evitar a perda de dados.

Erros

Os problemas mais comuns incluem:

• Erro 131060: geralmente ocorre em dispositivos não compatíveis. Verifique e vincule novamente no aplicativo.
• Erros de linha de crédito: ocorrem ao trocar de provedor. Siga o guia de suporte da Meta.
• Falhas de sincronização: precisam ser resolvidas em até 24 horas; caso contrário, será necessário desativar e integrar novamente.
• Notificações não recebidas: verifique se a configuração está inscrita em todas as atualizações relevantes (histórico, contatos e ecos).

Se os erros persistirem, entre em contato com seu provedor de API ou com o suporte da Meta.

A coexistência ajuda as empresas a expandir sua presença no WhatsApp com eficiência. Ao combinar a simplicidade do aplicativo com o poder da API, você pode oferecer melhores experiências aos clientes e alcançar resultados. Para saber mais sobre como integrar essa solução a ferramentas como plataformas de chat, consulte os recursos oficiais da Meta ou fale com um provedor.