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.
Versão 2.24.17 ou posterior do WhatsApp Business App. 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 do Coexistence
Conecte o número do seu WhatsApp Business App ao respond.io sem abrir mão do aplicativo
Envie e receba mensagens em ambas as plataformas
Veja as 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 automaçã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 esta taxa pode causar erros de entrega, como “limite de requisições atingido.” |
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 todas as conversas individuais (1:1). |
Para mais informações, consulte a documentação oficial da Meta.
Limitações conhecidas
Função | 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 enviadas pelo WhatsApp Business App contam para os limites 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 ser contabilizadas no uso de Contatos Ativos Mensais (MAC) da respond.io — veja a pergunta acima.
Preciso manter o aplicativo WhatsApp Business ativo?
Sim. Você deve abrir o WhatsApp Business App pelo menos uma vez a cada 14 dias para manter 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 Coexistence 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 WhatsApp Business App à 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 do WhatsApp Business (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ê já teve uma configuração de Coexistence com um BSP diferente e quer migrar para o respond.io, siga estes passos:
Faça backup das mensagens dos seus clientes empresariais.
Desconecte a conta comercial do WhatsApp Business App.
Faça login no WhatsApp Personal 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 vejo o erro “The business already has this WABA shared with a partner.”? “Switching partners is not supported in this flow”?
Isso acontece quando a conta do WhatsApp Business (WABA) já está conectada ao WhatsApp Coexistence por meio de um Business Solution Provider (BSP) diferente. A Meta não permite trocar o parceiro BSP diretamente por este fluxo, e a simples desconexão do parceiro existente não resolverá o problema.
Se você já teve uma configuração de Coexistence com um BSP diferente e quer trocar para o respond.io, siga estes passos:
Faça backup e restaure seu histórico de chat.
Desconecte a conta comercial do WhatsApp Business App.
Faça login no WhatsApp Personal 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 webhook é enviado para o respond.io, a mensagem não pode ser espelhada na plataforma e aparecerá como uma 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 este período de atualização, alguns eventos 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 a Meta retorna um erro de elegibilidade para o número de telefone ou para a WABA durante o Embedded Signup. Uma causa comum é uma conta comercial que foi desativada anteriormente e depois reativada. Isso pode reduzir a classificação de qualidade e afetar a elegibilidade.
Você verá este erro ao conectar o número do seu WhatsApp Business App:
"Seu número de telefone não é elegível para conectar-se à Plataforma WhatsApp Business. Mais atividade no app WhatsApp Business é necessária para ajudar a determinar a elegibilidade."
O que você pode fazer
Use um novo número de telefone para Coexistence — a maneira mais rápida de começar.
Conecte o número via Plataforma WhatsApp Business (API) em vez disso para uma experiência de mensagens mais estável e confiável.
Para continuar usando o Coexistence com o mesmo número, continue usando-o no app do WhatsApp. Mantenha a boa qualidade das mensagens até que o número se torne elegível.
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 o WhatsApp Manager.
Clique em Gerenciar.
Remova o respond.io como parceiro.
O que acontece depois que eu desativar o WhatsApp Coexistence?
As mensagens deixarão de aparecer no respond.io depois que a conexão com o parceiro for removida.
Os dispositivos vinculados serão desvinculados automaticamente.
Importante: A desvinculação remove 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 — entre em contato com a Meta diretamente pelo 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 aplicação na conta do Administrador Comercial vinculada à sua Meta Business Account.
O que você pode fazer
Vá para Central de Ajuda para Empresas.
Verifique se há restrições ou medidas de aplicação.
Resolva-as.
Configure seu WhatsApp Coexistence novamente.
Por que não consigo enviar mensagens pelo meu número do WhatsApp Coexistence?
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 a integração do número para o WhatsApp Coexistence:
Faça backup e restaure seu histórico de conversas.
Desconecte a conta comercial do WhatsApp Business App.
Faça login no WhatsApp Personal App.
Reconecte a conta comercial no WhatsApp Business App.
Inicie o fluxo de integração da Coexistence no respond.io.
Como faço backup e restauração do meu histórico de chat antes de trocar de provedor do WhatsApp Coexistence?
Antes de trocar sua conexão de WhatsApp Coexistence para o respond.io, faça backup do seu histórico de chat no WhatsApp Business App.
Importante: Não exclua sua conta do WhatsApp Business durante esse processo, pois isso pode resultar em perda de dados.
No WhatsApp Business App, vá para Configurações > Conversas > Backup de conversas.
Toque em Fazer backup agora e aguarde a conclusão.
Abra o WhatsApp Personal App e registre o mesmo número de telefone.
Aceite a solicitação para transferir o número para o WhatsApp Personal e aguarde a conclusão do processo.
Abra o WhatsApp Business App e registre o mesmo número de telefone novamente.
Aguarde o WhatsApp detectar o backup disponível.
Selecione o backup e restaure seu histórico de conversas.
Depois que seu histórico de conversas for restaurado, continue com o fluxo de integração do WhatsApp Coexistence no respond.io.
