Início rápido do aplicativo WhatsApp Business (coexistência com o WhatsApp)

O WhatsApp Coexistence conecta seu WhatsApp Business App ao respond.io via API do WhatsApp usando o mesmo número de telefone. Continue usando o WhatsApp Business App enquanto acessa automação, sincronização com CRM, relatórios e outros recursos do respond.io. Esta configuração é adequada para equipes que desejam adotar fluxos de trabalho baseados em API gradualmente, sem abrir mão do aplicativo que já usam.

Antes de começar

O WhatsApp Coexistence está disponível apenas para empresas que utilizam ativamente o WhatsApp Business App, com base na análise da Meta sobre a idade da conta e a qualidade das mensagens.
Aplicação WhatsApp Business versão 2.24.17 ou posterior. Como atualizar o WhatsApp.
Número de telefone adicionado ao seu Meta Business Manager. Como adicionar um número de telefone ao Meta Business Manager.

Importante: Abra o WhatsApp Business App pelo menos uma vez a cada 14 dias para manter a conexão do seu Canal ativa. Se o aplicativo não for aberto dentro desse período, a conexão pode ser removida e afetar a entrega das mensagens.

Recursos de Coexistence

Ligue o seu número de aplicação WhatsApp Business ao respond.io sem sair da aplicação
Envie e receba mensagens de ambas as plataformas
Ver mensagens enviadas pelo aplicativo no respond.io como mensagens de eco
Acesse recursos do respond.io como automação, integração com CRM, visibilidade da equipe e mais

Nota: A sincronização do histórico de contatos e mensagens não é compatível no momento. Quer este recurso? Vote para mostrar seu interesse.

Configurar o WhatsApp Coexistence

Adicionar número de telefone ao seu Meta Business Manager

Vá para Meta Business Suite > Configurações.
Selecione Contas do WhatsApp no menu lateral.
Clique em Adicionar > Vincular uma conta do WhatsApp Business.
Digite seu número de telefone.

Conectar Canal

Vá para Configurações > Canais > Adicionar Canal no respond.io e, em seguida, selecione WhatsApp.
Clique no link para conectar o WhatsApp Business App.
Clique em Connect With Facebook, faça login com sua conta do Facebook e conclua o fluxo de inscrição incorporado.
Conclua a configuração. Seu WhatsApp Business App permanecerá utilizável e o Canal do respond.io ficará ativo.

Após a configuração:

Continue a usar o seu aplicativo WhatsApp Business
Envie e receba mensagens no respond.io utilizando o mesmo número
Ver mensagens enviadas da aplicação como mensagens de eco

Entendendo as mensagens de eco

As mensagens enviadas do WhatsApp Business App aparecem no respond.io como mensagens de eco. Elas oferecem visibilidade das conversas da equipe e permitem sincronizar dados de contato ou acompanhamento via automação.

Comportamento das mensagens de eco:

Não abrirá uma janela de serviço
Não acionará a automatização
Não iniciará uma nova conversa
Criará um Contato se não existir

As mensagens de eco que criam um novo Contato — ou que são enviadas a um Contato existente — contam para o seu uso de Monthly Active Contacts (MAC) no respond.io.

Mensagens editadas

Quando um Contato edita uma mensagem que enviou anteriormente no WhatsApp, a mensagem atualizada aparecerá em respond.io com o rótulo “Editado”. Isso permite que sua equipe veja que o Contato modificou sua mensagem original, mantendo a visibilidade completa da conversa.

Comportamento das mensagens editadas:

Não abrirá uma janela de serviço
Não acionará a automação
Não iniciará uma nova conversa
Criará um Contato se não existir

Alterações de recursos após a ligação

Assim que o WhatsApp Business App estiver conectado ao respond.io via WhatsApp Coexistence, algumas funcionalidades nativas do WhatsApp Business App deixarão de estar disponíveis. Essas alterações são aplicadas pelo WhatsApp e se aplicam a todas as integrações com plataformas de terceiros.

Função	Mudar
Listas de Transmissão	Não disponível para criação ou envio a partir do WhatsApp Business App. As listas existentes ficarão somente leitura. Use o módulo de Broadcast no respond.io em vez disso. Nota: Transmissões enviadas através do Canal de Coexistência do WhatsApp estão sujeitas a um limite de taxa de 20 mensagens por segundo, conforme imposto pela Meta. Ultrapassar esse limite pode causar erros de entrega, como “rate limit hit.”
Editar/Revogar Mensagem	Não é mais suportado em chats individuais (1:1).
Mensagens que desaparecem	Desligado automaticamente para todos os chats individuais (1:1).
Ver mensagens únicas	Desativado para todas as conversas individuais (1:1).
Partilha de localização ao vivo	Desativado para todos os chats individuais (1:1).

Para mais informações, consulte a documentação oficial da Meta.

Limitações conhecidas

Característica	Suportado
Importação de histórico de mensagens e contactos	Não
Chats em grupo, chamadas e atualizações de estado	Não
Ver conversas anteriores na aplicação WhatsApp Business	Sim
CRM e automação no respond.io	Sim
Dispositivos complementares	Deve ser reconectado após a configuração
Limite de taxa de mensagens (Coexistência)	Limitado a 20 mensagens por segundo (conforme a política da Meta)

FAQ e solução de problemas

Posso continuar usando o aplicativo WhatsApp Business?

Sim. Você pode continuar usando o aplicativo enquanto ganha acesso a ferramentas baseadas em API no respond.io.

Serei cobrado se enviar mensagens pelo meu aplicativo WhatsApp Business depois de conectar ao respond.io?

O envio de mensagens pelo WhatsApp Business App não acarreta taxas do WhatsApp — essas mensagens permanecem gratuitas. No entanto, as mensagens de eco que criam um novo Contato ou que são enviadas a um Contato existente contam para o seu uso de Monthly Active Contacts (MAC) no respond.io, o que pode afetar a cobrança do seu plano.

Minha equipe perderá acesso ao histórico de chat?

Não. O histórico de chat permanece disponível no aplicativo WhatsApp Business. Respond.io não exibirá conversas passadas durante a Fase 1.

O que acontece quando alguém envia uma mensagem do aplicativo Business?

Respond.io exibirá isso como uma mensagem de eco. Não abrirá uma janela de serviço nem acionará automação.

As mensagens do aplicativo Business contam para os limites de envio de mensagens?

Não. As mensagens enviadas pelo WhatsApp Business App não contam para os limites de mensagens da API do WhatsApp, e não há taxas do WhatsApp para essas mensagens. Observe que as mensagens de eco ainda podem contar para seu uso de Monthly Active Contacts (MAC) no respond.io — veja a pergunta acima.

Preciso manter o aplicativo WhatsApp Business ativo?

Sim. Você deve abrir o aplicativo WhatsApp Business pelo menos uma vez a cada 14 dias para manter a sua conexão ativa. Se você não fizer isso, a conexão do Canal pode ser removida, o que pode interromper a entrega de mensagens no respond.io. Se a conexão for perdida, você precisará reconectar seu número de telefone como um novo Canal de Coexistência do WhatsApp.

Vou perder meu selo Meta Verified (marca azul) ao migrar para o WhatsApp Coexistence?

Não. Você não perderá seu selo Meta Verified ao integrar seu aplicativo WhatsApp Business à API do WhatsApp Business por meio do WhatsApp Coexistence. A Meta agora permite transferir sua assinatura Meta Verified quando você conectar seu número via WhatsApp Coexistence.

Por que vejo o erro “A Conta Empresarial do WhatsApp (WABA) que você está tentando conectar já possui um método de pagamento existente” ao configurar a Coexistência do WhatsApp?

Esta é uma limitação definida pela Meta. As linhas de crédito para contas de Coexistência do WhatsApp não podem ser removidas ou migradas para outro provedor. Devido a essa limitação, a linha de crédito de Coexistence não pode ser migrada ou reatribuída para um BSP diferente sob o mesmo WABA ID — é necessário um novo WABA ID.

Se você tiver configurado Coexistence com um BSP diferente e quiser mudar para o respond.io, siga estas etapas:

Faça backup das mensagens dos seus clientes empresariais.
Desconecte a conta comercial do WhatsApp Business App.
Reconecte a conta comercial no WhatsApp Business App.
Inicie o fluxo de integração da Coexistence no respond.io.

Para mais informações, consulte a documentação da Meta sobre mudança de parceiros e linhas de crédito.

Por que as mensagens enviadas do WhatsApp para Windows não aparecem no respond.io ao usar um número de coexistência?

Isso pode acontecer devido a limitações do WhatsApp Coexistence ou problemas de conexão.

Mensagens enviadas de dispositivos secundários não suportados, como WhatsApp for Windows ou WhatsApp for WearOS, não acionam os webhooks do WhatsApp. Como resultado, essas mensagens podem aparecer no WhatsApp Business App, mas não serão exibidas no respond.io.

Além disso, as mensagens podem deixar de aparecer se:

O WhatsApp Business App não é aberto no telefone principal por mais de 14 dias, fazendo com que os dispositivos vinculados sejam desconectados, ou
A conexão de parceiro do respond.io com sua WhatsApp Business Account (WABA) foi removida ou interrompida

O que você pode fazer

Verifique se a mensagem está visível no dispositivo primário do WhatsApp Business App, mas não aparece no respond.io.
Vá para WhatsApp Business Manager e verifique se respond.io está listado como um parceiro conectado ativo da sua WhatsApp Business Account.
Se o respond.io não estiver listado, exclua o Canal WhatsApp Coexistence existente no respond.io e reconecte-o usando o Embedded Signup (ES) flow.

As regras de WhatsApp Coexistence e o comportamento de dispositivos vinculados são aplicados pelo WhatsApp (Meta). Consulte a documentação da Meta para mais detalhes.

Quantos dispositivos posso vincular à minha conta de Coexistência do WhatsApp e todos os dispositivos são suportados?

As empresas podem vincular até quatro clientes companheiros do WhatsApp (“dispositivos vinculados”) à sua conta do WhatsApp Business App. A Coexistence suporta a maioria dos clientes acompanhantes, exceto WhatsApp para Windows e WhatsApp para WearOS, que não são compatíveis.

Ao conectar-se à Coexistence, ela mantém seu dispositivo principal vinculado, mas desvincula todos os outros dispositivos acompanhantes. Você precisará reconectar seus dispositivos acompanhantes depois.

Por que estou vendo várias mensagens não suportadas e o erro “Message received during sync and not available on respond.io”? Ver no WhatsApp Business App?

Isso pode acontecer devido a limitações da Meta, como:

Dispositivo acompanhante não suportado
- De acordo com o documento da Meta, se o seu Contato usar um dispositivo acompanhante do WhatsApp que não seja compatível (como certos dispositivos vinculados ou secundários), mensagens enviadas a partir desse dispositivo podem não acionar notificações do Webhook.
- Como nenhum evento de Webhook é enviado para o respond.io, a mensagem não pode ser espelhada na plataforma e aparecerá como mensagem não suportada.
Sincronização de mensagens após inatividade
- Se um Contato enviar uma mensagem para o seu número de Coexistence após um longo período de inatividade, pode levar algum tempo para que ele seja atualizado.
- Durante esse período de atualização, alguns eventos de Webhook podem aparecer como mensagens não suportadas.
Tipo de mensagem não suportado
- O Contato envia um tipo de mensagem que não é suportado pela Cloud API. Essas mensagens não podem ser encaminhadas pelo webhook e aparecem como não suportadas.
Mensagem inicial via um anúncio Click-to-WhatsApp
- Quando um Contato envia uma mensagem a um número comercial em Coexistence pela primeira vez — especialmente após tocar em um anúncio Click-to-WhatsApp — a mensagem inicial pode não ser entregue via webhook e aparecerá como não suportada.
Mensagens editadas por Contatos
- Quando um Contato edita uma mensagem enviada anteriormente, a versão editada também pode aparecer como uma mensagem não suportada no respond.io.

O que você pode fazer

Para dispositivo acompanhante não suportado: Veja a mensagem completa diretamente no seu dispositivo principal do WhatsApp Business App.
Para sincronização de mensagens após inatividade: Aguarde o número de Coexistence ser atualizado. Uma vez concluída a sincronização, as mensagens subsequentes devem chegar como esperado.
Para tipo de mensagem não suportado, mensagens iniciais de anúncio e mensagens editadas: Veja a mensagem original diretamente no WhatsApp Business App. Estas são limitações impostas pela Meta sem solução alternativa no respond.io.

Por que meu dispositivo associado foi desvinculado?

Isso pode acontecer porque todos os dispositivos vinculados serão automaticamente desvinculados ao ativar ou desativar o WhatsApp Coexistence.

O que você pode fazer

Após ativar ou desativar a Coexistence do WhatsApp, aguarde até 24 horas para que o WhatsApp sincronize seus dados e o histórico de mensagens.
Reconecte seu dispositivo associado.

Nota: Pode não ser possível reconectar seu dispositivo associado até que a sincronização seja concluída.

Por que não posso usar meu número de telefone para configurar a coexistência do WhatsApp?

Isso acontece quando seu número de telefone atualmente não é elegível para a coexistência do WhatsApp.

O que você pode fazer

Continue usando seu número de telefone no WhatsApp e mantenha a boa qualidade das mensagens até que seu número se torne elegível.
Se precisar usar o WhatsApp Coexistence agora, tente ativá-lo com outro número de telefone.
Como alternativa, use seu número de telefone para conectar a Plataforma WhatsApp Business (API) ao respond.io.

Como removo a Coexistência do WhatsApp do respond.io?

Veja como remover a Coexistence do respond.io:

Opção 1: Pelo aplicativo WhatsApp Business

Vá para Configurações da conta.
Selecione Plataforma empresarial.
Remova ou desconecte o respond.io como parceiro.

Opção 2: Pelo Meta Business Manager

Vá para Configurações do Meta Business.
Selecione Contas do WhatsApp.
Abra WhatsApp Manager.
Clique em Gerenciar.
Remova o respond.io como parceiro.

O que acontece depois que eu remover o WhatsApp Coexistence?

Importante: A remoção encerra a conexão com o parceiro. Isso não exclui sua conta do WhatsApp Business nem o número de telefone.

Por que vejo o erro "The business that you selected has one or more ad accounts in an invalid state"?

Esse erro é retornado pela Meta durante o fluxo de inscrição incorporado. Isso ocorre quando uma ou mais contas de anúncios ou outros ativos sob seu Meta Business Manager (MBM) estão restritos.

O que você pode fazer

Vá para Central de Ajuda para Empresas.
Selecione sua empresa.
Selecione a conta de anúncios para ver quaisquer problemas e opções de resolução disponíveis.

Se nenhuma opção de resolução estiver disponível — por exemplo, se a conta de anúncios tiver sido desativada permanentemente — contate a Meta diretamente através do Central de Ajuda para Empresas para obter mais assistência.

Por que vejo o erro "Couldn't scan QR code. Please try again later."?

Esse erro aparece durante a etapa final da configuração do WhatsApp Coexistence, quando é solicitado que você abra o WhatsApp Business App para escanear um código QR.

A leitura do código QR pode falhar se houver restrições ou medidas de execução na conta do Administrador Comercial vinculada ao seu Meta Business Account.

O que você pode fazer

Vá para Central de Ajuda para Empresas.
Verifique se há restrições ou medidas de execução.
Resolva-as.
Configure seu WhatsApp Coexistence novamente.

Por que não consigo enviar mensagens no meu número de Coexistence do WhatsApp?

Isso pode acontecer se sua WhatsApp Business Account (WABA) não tiver um método de pagamento associado, se o método de pagamento não estiver vinculado a rocketbots.io, ou se a moeda do seu WABA não for USD.

O que você pode fazer

Refaça o fluxo de integração do número para o WhatsApp Coexistence: