Modo de Coexistência da WhatsApp Business API: Use o WhatsApp Business App Junto com a API

O modo de coexistência permite que você use o WhatsApp Business App no seu celular ao mesmo tempo que a WhatsApp Business Cloud API. Isso significa que você pode continuar usando seu familiar WhatsApp Business App para conversas diretas enquanto aproveita os recursos avançados da API, como mensagens de template, fluxos automatizados e mensagens de alto volume através do WhatsTeam.

O Que É o Modo de Coexistência?

O modo de coexistência é um recurso introduzido pelo Meta que permite que um único número de telefone do WhatsApp Business seja conectado tanto ao WhatsApp Business App quanto à WhatsApp Business Cloud API simultaneamente. Anteriormente, registrar um número com a API desconectava-o do WhatsApp Business App completamente, forçando as empresas a escolher um ou outro.

Com o modo de coexistência habilitado:

• Seu número de telefone permanece ativo no WhatsApp Business App
• O mesmo número também está conectado ao Cloud API através do WhatsTeam
• Mensagens recebidas são entregues tanto ao aplicativo quanto à API
• Você pode enviar mensagens tanto do aplicativo quanto da API
• As informações do perfil comercial são compartilhadas entre ambas as conexões

Isso dá às empresas a flexibilidade de gerenciar conversas rápidas e pessoais diretamente do celular enquanto usam a plataforma do WhatsTeam para mensagens automatizadas, colaboração em equipe e gerenciamento de campanhas.

Por Que Usar o Modo de Coexistência?

O modo de coexistência é ideal para empresas que querem o melhor dos dois mundos. Aqui estão três cenários comuns onde faz sentido:

Cenário 1: Migração Gradual do App para a API

Se sua empresa está usando o WhatsApp Business App e quer migrar para o Cloud API, o modo de coexistência permite uma transição gradual. Você pode começar a usar a API para mensagens automatizadas e campanhas enquanto continua lidando com conversas do dia a dia pelo aplicativo. Isso evita interrupções e dá tempo à sua equipe para se adaptar à nova plataforma.

Cenário 2: Equipes de Campo e Equipes de Escritório Trabalhando Juntas

Empresas com agentes de campo (representantes de vendas, entregadores, técnicos no local) frequentemente precisam do WhatsApp Business App para comunicação rápida em movimento. Ao mesmo tempo, a equipe do escritório precisa da API para gerenciar filas de suporte ao cliente, enviar notificações em massa e executar campanhas de marketing. O modo de coexistência permite que ambas as equipes trabalhem com o mesmo número sem interferir uma na outra.

Cenário 3: Toque Pessoal com Automação

Algumas empresas querem manter o toque pessoal de responder pelo aplicativo para clientes VIP ou conversas de alto valor, enquanto automatizam mensagens rotineiras (confirmações de pedido, lembretes de agendamento, atualizações de envio) através da API. O modo de coexistência habilita essa abordagem híbrida.

Informações Importantes

Antes de habilitar o modo de coexistência, há vários detalhes importantes que você deve conhecer sobre limitações, requisitos, preços e sincronização de mensagens.

Limitações

• Histórico de mensagens: Quando você habilita a Coexistência pela primeira vez, o histórico de mensagens existente do WhatsApp Business App não é migrado para a API, e vice-versa. Ambos os sistemas começam com seus próprios registros de mensagens dali em diante
• Grupos: Mensagens enviadas e recebidas em grupos do WhatsApp são visíveis apenas no WhatsApp Business App. Mensagens de grupo não são suportadas pelo Cloud API
• Atualizações de status: O Status do WhatsApp (stories) só pode ser postado e visualizado pelo WhatsApp Business App, não pela API
• Chamadas: Chamadas de voz e vídeo estão disponíveis apenas pelo WhatsApp Business App. O Cloud API não suporta recursos de chamada
• Listas de transmissão: Listas de transmissão criadas no WhatsApp Business App não são sincronizadas com a API. Use mensagens de template pela API para mensagens em massa
• Gerenciamento de catálogo: Embora tanto o aplicativo quanto a API suportem catálogos, alterações feitas em um podem levar tempo para refletir no outro

Requisitos

Para usar o modo de coexistência, você precisa de:

• WhatsApp Business App: A versão mais recente instalada no seu celular (Android ou iOS)
• Conta WhatsApp Business Cloud API: Configurada através do fluxo de Embedded Signup do WhatsTeam
• Meta Business Manager: Uma conta verificada do Meta Business Manager
• Mesmo número de telefone: O número deve estar registrado tanto no aplicativo quanto na API
• Conexão de internet estável: Tanto o celular quanto o WhatsTeam devem ter acesso confiável à internet

Preços

O modo de coexistência em si não gera cobranças adicionais. No entanto, os preços padrão da WhatsApp Business API se aplicam:

• Mensagens enviadas pela API (através do WhatsTeam) estão sujeitas aos preços baseados em conversação do Meta
• Mensagens enviadas pelo WhatsApp Business App diretamente são gratuitas (sem cobranças de API)
• Mensagens recebidas são entregues tanto ao aplicativo quanto à API, mas contam como apenas uma conversação para fins de cobrança
• Sua assinatura da plataforma WhatsTeam se aplica normalmente

Para informações detalhadas de preços, consulte nosso Guia de Preços da WhatsApp Business API.

Notas sobre Sincronização de Mensagens

Entender como as mensagens sincronizam entre o aplicativo e a API é fundamental para gerenciar conversas com clientes:

• Mensagens recebidas: Quando um cliente envia uma mensagem, ela é entregue tanto ao WhatsApp Business App quanto ao Cloud API simultaneamente
• Mensagens enviadas pelo aplicativo: Mensagens que você envia pelo WhatsApp Business App são visíveis no aplicativo mas não são sincronizadas com a API. O WhatsTeam não verá essas mensagens
• Mensagens enviadas pela API: Mensagens enviadas pelo WhatsTeam (API) são entregues ao cliente mas não são visíveis no WhatsApp Business App
• Confirmações de leitura: Se você ler uma mensagem no aplicativo, a confirmação de leitura é enviada ao cliente. A API pode ainda mostrar a mensagem como não lida
• Indicadores de digitação: Indicadores de digitação do aplicativo não são retransmitidos à API, e vice-versa

Melhor prática: Estabeleça diretrizes internas claras sobre quais conversas são tratadas pelo aplicativo e quais pela API para evitar respostas duplicadas ou mensagens perdidas.

Como Habilitar o Modo de Coexistência

Siga estes quatro passos para habilitar o modo de coexistência para seu número do WhatsApp Business através do WhatsTeam.

Passo 1: Conclua o Embedded Signup

Se você ainda não conectou seu número do WhatsApp Business ao WhatsTeam via Cloud API, precisa concluir o fluxo de Embedded Signup primeiro.

1. Faça login no painel do WhatsTeam
2. Navegue até Dispositivos > Adicionar Dispositivo > WhatsApp Business API
3. Clique em Conectar com Facebook para iniciar o fluxo de Embedded Signup
4. Siga as instruções para conectar seu Meta Business Manager e selecionar ou criar uma WhatsApp Business Account

Passo 2: Registre Seu Número de Telefone

Durante o Embedded Signup, será solicitado que você registre seu número de telefone com o Cloud API.

1. Insira seu número de telefone comercial no formato internacional
2. Selecione seu método de verificação preferido (SMS ou chamada de voz)
3. Insira o código de verificação recebido
4. Aguarde a conclusão do registro

Importante: Se seu número está atualmente ativo no WhatsApp Business App, você verá um aviso perguntando se deseja habilitar o modo de coexistência. Selecione Sim para manter seu número ativo tanto no aplicativo quanto na API.

Passo 3: Habilite a Coexistência no WhatsTeam

Quando seu número estiver registrado no Cloud API, habilite o modo de coexistência através das configurações do dispositivo.

1. No WhatsTeam, vá em Dispositivos e selecione seu dispositivo WABA recém-conectado
2. Abra o painel de Configurações do dispositivo
3. Encontre o toggle Modo de Coexistência
4. Mude para Habilitado
5. Confirme a ação quando solicitado

Passo 4: Confirme no Seu WhatsApp Business App

Após habilitar a Coexistência no WhatsTeam, verifique se a conexão está ativa no seu WhatsApp Business App.

1. Abra o WhatsApp Business App no seu celular
2. Vá em Configurações > Dispositivos Vinculados
3. Você deve ver uma conexão ativa da API listada
4. Verifique se você ainda pode enviar e receber mensagens pelo aplicativo

Sua configuração de Coexistência está agora completa. Você pode usar tanto o WhatsApp Business App quanto o WhatsTeam simultaneamente no mesmo número.

Como Desabilitar o Modo de Coexistência

Se você decidir parar de usar o modo de coexistência, pode desabilitá-lo a qualquer momento. Isso desconectará o WhatsApp Business App do número compartilhado, deixando apenas a conexão Cloud API ativa.

Passos para Desabilitar

1. No WhatsTeam: Navegue até Dispositivos > selecione seu dispositivo WABA > Configurações
2. Desative a Coexistência: Mude o toggle do Modo de Coexistência para Desabilitado
3. Confirme a ação: Um diálogo de confirmação aparecerá avisando que o WhatsApp Business App perderá acesso a este número. Clique em Confirmar
4. Verifique no seu celular: Abra o WhatsApp Business App e verifique Configurações > Dispositivos Vinculados. A conexão da API não deve mais aparecer
5. Aguarde a conclusão: O processo de desconexão pode levar alguns minutos para se propagar completamente

O Que Acontece Quando Você Desabilita

• O WhatsApp Business App será desconectado do número
• O número continuará funcionando exclusivamente pelo Cloud API e WhatsTeam
• O histórico de mensagens no WhatsApp Business App permanecerá no dispositivo, mas nenhuma nova mensagem será recebida
• Todas as futuras mensagens serão acessíveis apenas pelo WhatsTeam
• Você pode reabilitar a Coexistência posteriormente seguindo os passos de configuração novamente

Reabilitando a Coexistência

Se você quiser reabilitar a Coexistência após desabilitá-la:

1. Abra o WhatsApp Business App no seu celular
2. Pode ser necessário verificar novamente seu número de telefone no aplicativo
3. Siga os passos de habilitação descritos acima no WhatsTeam
4. Confirme a conexão no seu celular

Comparação de Recursos: Somente App vs Somente API vs Coexistência

A tabela a seguir resume os recursos disponíveis em cada modo para ajudá-lo a decidir qual configuração é a certa para o seu negócio.

Perguntas Frequentes

O modo de coexistência custa extra?

Não. O modo de coexistência em si é gratuito. As cobranças padrão de conversação da WhatsApp Business API do Meta se aplicam a mensagens enviadas pela API. Mensagens enviadas diretamente pelo WhatsApp Business App não geram cobranças de API.

Posso usar a Coexistência com o aplicativo WhatsApp padrão (não Business)?

Não. O modo de coexistência funciona apenas com o WhatsApp Business App. O aplicativo WhatsApp padrão não suporta Coexistência com o Cloud API.

Os clientes saberão que estou usando o modo de coexistência?

Não. Do ponto de vista do cliente, nada muda. Eles veem o mesmo número e perfil comercial independentemente de você responder pelo aplicativo ou pela API.

O que acontece se eu responder tanto pelo aplicativo quanto pela API?

O cliente receberá ambas as respostas. Não há deduplicação integrada. Por isso é importante estabelecer diretrizes internas sobre quais conversas são tratadas por qual canal.

Posso usar dispositivos companion com o modo de coexistência?

Sim, mas com limitações. Dispositivos companion conectados ao WhatsApp Business App continuarão funcionando, mas mostrarão apenas mensagens enviadas e recebidas pelo aplicativo, não pela API.

Meu histórico de mensagens é transferido quando habilito a Coexistência?

Não. O histórico de mensagens existente não é transferido entre o aplicativo e a API. Ambos os sistemas mantêm registros de mensagens separados a partir do momento em que a Coexistência é habilitada.