Modo de Coexistência do WhatsApp: Guia de Conexão Passo a Passo

Resumo

O modo de coexistência permite usar o aplicativo WhatsApp Business móvel e o WhatsApp Cloud API simultaneamente no mesmo número de telefone. Isso significa que você pode continuar conversando com clientes diretamente do seu celular enquanto também aproveita os poderosos recursos da API do WhatsTeam, como mensagens automatizadas, chatbots, integrações com CRM e campanhas de mensagens em massa.

Este guia orienta você em tudo o que precisa saber antes de habilitar a Coexistência, o processo de conexão passo a passo, considerações de preços e dicas de solução de problemas.

Informações Importantes Antes de Começar

O modo de coexistência é um recurso poderoso, mas vem com mudanças comportamentais e limitações específicas que você deve entender antes de habilitá-lo. Leia esta seção cuidadosamente para evitar problemas inesperados após a integração.


Pontos-Chave para Entender

• A Coexistência está atualmente em beta. O Meta está desenvolvendo ativamente este recurso, o que significa que alguns comportamentos podem mudar com o tempo.
• Ambos os canais compartilham o mesmo número. Mensagens enviadas pelo aplicativo móvel e pela API se originam do mesmo número de telefone. Os clientes veem uma única thread de conversação.
• Mensagens da API têm prioridade. Quando tanto o aplicativo móvel quanto a API tentam responder à mesma conversação, a resposta da API é entregue e a resposta do aplicativo móvel pode ser suprimida.
• Nem todos os recursos do aplicativo móvel são preservados. Alguns recursos que funcionam no aplicativo móvel terão comportamento diferente ou ficarão indisponíveis quando a Coexistência for habilitada.
• A cobrança se aplica a mensagens da API. Mensagens enviadas pelo WhatsApp Cloud API via WhatsTeam estão sujeitas aos preços baseados em conversação do Meta. Mensagens enviadas diretamente pelo aplicativo móvel permanecem gratuitas.

Mudanças de Recursos Após a Integração

Quando você habilitar o modo de Coexistência, os seguintes recursos no WhatsApp Business móvel serão afetados:

Editar e Revogar Mensagens

• Editar: Mensagens enviadas pelo aplicativo móvel ainda podem ser editadas dentro da janela padrão de 15 minutos do WhatsApp. No entanto, mensagens enviadas pela API não podem ser editadas após a entrega.
• Revogar (Apagar para Todos): Mensagens enviadas pelo aplicativo móvel podem ser revogadas normalmente. Mensagens enviadas pela API não podem ser revogadas pela interface do aplicativo móvel.


Mensagens Temporárias

• As configurações de mensagens temporárias definidas no aplicativo móvel se aplicarão à conversação. No entanto, mensagens enviadas pela API não herdam automaticamente o temporizador de mensagens temporárias.
• Se um cliente habilitar mensagens temporárias do lado dele, todas as mensagens na conversação (tanto do aplicativo quanto da API) estarão sujeitas ao temporizador.

Mídia de Visualização Única

• Fotos e vídeos de visualização única enviados pelo aplicativo móvel funcionam como esperado para o destinatário.
• A API atualmente não suporta envio de mídia de visualização única. Qualquer mídia enviada pela API será entregue como mídia padrão (persistente).


Localização em Tempo Real

• Compartilhamento de localização em tempo real do aplicativo móvel para clientes funciona como esperado.
• A API não suporta receber ou exibir dados de localização em tempo real. Se um cliente compartilhar sua localização em tempo real, ela será visível no aplicativo móvel mas não pelo painel da API/WhatsTeam.

Listas de Transmissão

• Listas de transmissão criadas no aplicativo móvel permanecem funcionais.
• No entanto, para mensagens em larga escala, é fortemente recomendado usar os recursos de campanha do WhatsTeam, pois fornecem rastreamento de entrega, análises e gerenciamento de templates.


Requisitos

Antes de habilitar o modo de Coexistência, certifique-se de atender a todos os seguintes requisitos:


1. WhatsApp Business App: Você deve estar usando o aplicativo WhatsApp Business (não o aplicativo WhatsApp consumidor padrão). O aplicativo deve estar atualizado para a versão mais recente disponível na loja de aplicativos do seu dispositivo.

2. Número de Telefone: O número de telefone deve estar ativamente registrado no WhatsApp Business App. Não exclua ou desregistre o número antes de iniciar este processo.

3. Meta Business Account: Você precisa de uma Meta Business Account (anteriormente Facebook Business Manager). Se não tiver uma, ela será criada durante o processo de Embedded Signup.

4. Conta WhatsTeam: Você precisa de uma conta WhatsTeam ativa. Cadastre-se em whats.team se não tiver uma.

5. Permissões de Administrador: Você deve ter acesso de administrador à Meta Business Account que será associada à WhatsApp Business Account.

6. Desabilitar Respostas Automáticas: Desative todas as respostas automatizadas no WhatsApp Business App (mensagens de Ausência, mensagens de Saudação) para evitar conflitos com automações da API.

7. Conexão de Internet Estável: Tanto seu celular (para o aplicativo móvel) quanto seu computador (para o processo de configuração) precisam de uma conexão de internet confiável.

8. Navegador Moderno: Use Chrome, Firefox ou Edge com pop-ups habilitados para o fluxo de login do Meta.

Guia de Conexão Passo a Passo

Siga cuidadosamente estes 18 passos para conectar seu número do WhatsApp Business ao WhatsTeam usando o modo de Coexistência.

Passo 1: Faça Login no WhatsTeam

Abra seu navegador e vá para whats.team. Faça login com suas credenciais do WhatsTeam. Se não tiver uma conta, crie uma primeiro.


Passo 2: Navegue até Conexões WhatsApp

Após fazer login, vá em Configurações no menu de navegação da barra lateral esquerda. Em seguida, clique em Conexões WhatsApp para ver suas conexões atuais e adicionar uma nova.

Passo 3: Clique em Conectar um Novo Número

Na página de Conexões WhatsApp, clique no botão Conectar um Novo Número. Isso iniciará o fluxo de Embedded Signup.


Passo 4: Selecione o Modo de Coexistência

Quando solicitado a escolher um tipo de conexão, selecione Coexistência (Beta). Esta opção permite que seu número permaneça ativo no WhatsApp Business móvel enquanto também fica acessível pela API.


Passo 5: Login do Facebook

Uma janela popup de login do Meta aparecerá. Insira suas credenciais do Facebook e faça login. Se tiver autenticação de dois fatores habilitada na sua conta do Facebook, complete essa etapa de verificação também.

Passo 6: Conceda Permissões

Após fazer login, o Meta pedirá que você conceda permissões ao WhatsTeam. Revise a lista de permissões cuidadosamente e certifique-se de que todas as caixas estão marcadas:

• Gerenciar sua WhatsApp Business Account
• Gerenciar os números de telefone da sua WhatsApp Business Account
• Enviar e receber mensagens em seu nome

Clique em Continuar para conceder essas permissões.


Passo 7: Selecione ou Crie um Portfólio de Negócios

Escolha um Portfólio de Negócios do Meta existente no dropdown, ou crie um novo clicando em Criar Novo. Insira o nome e detalhes da sua empresa se estiver criando um novo portfólio.


Passo 8: Crie uma WhatsApp Business Account

Selecione Criar uma nova WhatsApp Business Account ou escolha uma existente. Se estiver criando uma nova, forneça:

• Um nome de exibição para sua empresa
• A categoria da sua empresa
• Uma descrição da sua empresa

Passo 9: Insira Seu Número de Telefone

Insira o número de telefone que está atualmente ativo no seu WhatsApp Business móvel. Certifique-se de incluir o código do país (ex.: +1 para Estados Unidos, +55 para Brasil).


Passo 10: Verifique a Propriedade

O WhatsApp enviará um código de verificação para seu número. Você pode escolher recebê-lo via:

• SMS: Uma mensagem de texto com um código de 6 dígitos.
• Chamada de Voz: Uma chamada automatizada que lê o código em voz alta.

Insira o código no campo de verificação.

Passo 11: Confirme o Pareamento de Coexistência

Após a verificação, o sistema detectará que o número está ativo no WhatsApp Business App e confirmará o pareamento de Coexistência. Você deve ver uma mensagem de confirmação indicando que o número será conectado no modo de Coexistência.


Passo 12: Revise as Configurações de Conexão

Revise todas as configurações de conexão antes de finalizar:

• Nome da empresa e nome de exibição
• Número de telefone
• Modo de conexão (Coexistência)
• Portfólio de Negócios do Meta associado

Passo 13: Aceite os Termos e Condições

Leia e aceite os termos de serviço da WhatsApp Business API e os termos da plataforma WhatsTeam. Estes cobrem políticas de mensagens, tratamento de dados e diretrizes de uso.

Passo 14: Finalize a Configuração

Clique no botão Finalizar Configuração para completar o processo de conexão. O sistema processará sua solicitação, o que geralmente leva de 30 segundos a 2 minutos.


Passo 15: Verifique a Conexão no Painel

Quando a configuração estiver completa, você será redirecionado para o painel do WhatsTeam. Sua nova conexão deve aparecer com status Conectado e um rótulo de Coexistência.


Passo 16: Envie uma Mensagem de Teste

No painel do WhatsTeam, envie uma mensagem de teste para verificar se a conexão da API está funcionando:

1. Vá em Mensagens ou Chat.
2. Inicie uma nova conversa com um número de teste.
3. Envie uma mensagem de texto simples.
4. Verifique se a mensagem é entregue e a resposta é recebida.

Passo 17: Verifique se o Aplicativo Móvel Ainda Funciona

Abra o WhatsApp Business App no seu celular e confirme:

• O aplicativo ainda está funcionando normalmente.
• Você ainda pode enviar e receber mensagens.
• Suas conversas existentes estão intactas.
• Você pode ver mensagens enviadas pela API (podem aparecer com um pequeno atraso).


Passo 18: Configure Automações da API

Agora que ambos os canais estão conectados, configure suas automações da API no WhatsTeam:

1. Configure fluxos de chatbot se desejado.
2. Configure regras de resposta automática (estas substituirão quaisquer respostas automáticas no nível do aplicativo).
3. Configure webhooks de notificação para mensagens recebidas.
4. Configure as atribuições de agentes da sua equipe.


Preços

O modo de coexistência segue o modelo de preços padrão da WhatsApp Business API com algumas distinções importantes:


Mensagens da API (Através do WhatsTeam)

• Conversas iniciadas pela empresa: Preços padrão do Meta se aplicam baseados na categoria da conversação (Marketing, Utilidade, Autenticação ou Serviço).
• Conversas iniciadas pelo usuário: Atualmente gratuitas para as primeiras 1.000 conversas por mês. Após isso, tarifas padrão por conversação se aplicam.
• Mensagens de template: Devem usar templates pré-aprovados e são cobradas na tarifa de conversação iniciada pela empresa.

Mensagens do Aplicativo Móvel

• Mensagens diretas do aplicativo: Mensagens enviadas diretamente pelo WhatsApp Business móvel não geram cobranças de API.
• Observação importante: Se uma automação da API responder a uma conversação que foi iniciada pelo aplicativo móvel, essa resposta automatizada será cobrada como uma conversação da API.

Taxas da Plataforma WhatsTeam

As taxas da plataforma WhatsTeam são cobradas separadamente dos preços baseados em conversação do Meta. Visite whats.team/pricing para detalhes atuais dos planos e volumes de mensagens incluídos.

Solução de Problemas

Conflitos de Resposta Automática

O problema mais comum no modo de Coexistência são respostas automáticas conflitantes entre o WhatsApp Business móvel e as automações da API do WhatsTeam.


Sintomas

• Clientes recebem respostas duplicadas: uma da resposta automática do aplicativo e outra da automação da API.
• Respostas se contradizem (ex.: horários comerciais diferentes ou informações diferentes).
• O fluxo da conversação parece desconexo para o cliente.

Solução

1. Desabilite todas as respostas automáticas no WhatsApp Business App:

   • Abra o aplicativo e vá em Configurações > Ferramentas Comerciais.
   • Desative Mensagem de Ausência.
   • Desative Mensagem de Saudação.
   • Remova ou desabilite quaisquer Respostas Rápidas que possam ser acionadas automaticamente.

2. Centralize automações no WhatsTeam:

   • Configure todas as respostas automatizadas pelo painel do WhatsTeam.
   • Isso garante uma única fonte da verdade para todas as interações automatizadas.

3. Treine sua equipe:

   • Se membros da equipe usam o aplicativo móvel para responder manualmente, certifique-se de que verificam o painel do WhatsTeam primeiro para ver se uma automação da API já respondeu.
   • Estabeleça protocolos claros sobre quem responde por qual canal.

Mensagens Não Aparecendo no Aplicativo Móvel

Se mensagens enviadas pela API não estão visíveis no aplicativo móvel:

• Certifique-se de que o WhatsApp Business App está atualizado para a versão mais recente.
• Verifique a conexão de internet do seu celular.
• Force o fechamento e reabra o aplicativo.
• Aguarde até 30 segundos, pois pode haver um breve atraso de sincronização.

Quedas de Conexão

Se a conexão de Coexistência cair inesperadamente:

• Verifique o painel do WhatsTeam para alertas de status de conexão.
• Confirme que você não fez logout do WhatsApp Business no seu celular.
• Certifique-se de que o celular está conectado à internet.
• Se o problema persistir, reconecte pelo painel do WhatsTeam sem excluir o número do aplicativo móvel.

Perguntas Frequentes

1. Vou perder meu histórico de mensagens ao habilitar a Coexistência?

Não. Seu histórico de mensagens existente no WhatsApp Business móvel permanecerá intacto. O modo de Coexistência não exclui ou modifica suas conversas existentes. No entanto, mensagens enviadas pela API antes da Coexistência ser habilitada não aparecerão retroativamente no aplicativo móvel.


2. Como funciona a janela de mensagens de 24 horas na Coexistência?

A janela de mensagens de 24 horas se aplica apenas a mensagens da API. Quando um cliente envia uma mensagem para você, uma janela de 24 horas se abre durante a qual você pode responder livremente pela API sem usar um template. Após a janela fechar, você deve usar um template de mensagem aprovado para reiniciar a conversação pela API. Mensagens enviadas diretamente pelo aplicativo móvel não estão sujeitas a essa restrição de janela.

3. O que acontece com conversas em andamento quando habilito a Coexistência?

Conversas em andamento no aplicativo móvel continuam normalmente. Uma vez que a Coexistência está ativa, novas mensagens recebidas serão visíveis tanto no aplicativo móvel quanto no painel do WhatsTeam. Você pode escolher responder de qualquer canal. Se uma automação da API estiver configurada, ela responderá automaticamente a menos que você tenha definido regras específicas para evitar isso.

4. As mensagens são sincronizadas entre o aplicativo móvel e a API em tempo real?

As mensagens são sincronizadas com um atraso muito curto, geralmente menos de 5 segundos. Mensagens recebidas de clientes aparecem tanto no aplicativo móvel quanto no painel do WhatsTeam quase simultaneamente. Mensagens enviadas de um canal aparecerão no outro canal em alguns segundos. No entanto, alguns metadados (como confirmações de leitura acionadas pelo aplicativo) podem não se propagar para o painel da API.


5. Posso desabilitar a Coexistência e voltar para o modo somente aplicativo móvel?

Sim. Você pode desconectar a conexão da API do painel do WhatsTeam a qualquer momento sem afetar seu aplicativo móvel. Vá em Configurações > Conexões WhatsApp, selecione o número e clique em Desconectar. Seu WhatsApp Business App continuará funcionando normalmente após a desconexão. Note que quaisquer automações da API, fluxos de chatbot e integrações deixarão de funcionar quando desconectado.