Todos os posts

WhatsApp

Coexistência no WhatsApp: como conectar o número do vendedor à API oficial sem perder o histórico

Vinícius Molina9 min
Coexistência no WhatsApp: como conectar o número do vendedor à API oficial sem perder o histórico

A coexistência no WhatsApp é um recurso da Meta que permite usar o mesmo número, ao mesmo tempo, no aplicativo WhatsApp Business do celular e na API oficial (Cloud API). O vendedor continua com o aparelho, o número e as conversas. A empresa ganha registro, integração com o CRM, campanhas e métricas sobre aquele número.

Até pouco tempo atrás, levar um número para a API oficial significava tirá-lo do aplicativo. O vendedor perdia o WhatsApp que usava no dia a dia, e o histórico com os clientes ficava para trás. Por isso, muita empresa preferia deixar o WhatsApp da equipe fora de qualquer sistema. A coexistência muda essa conta.

Este guia explica o que é a coexistência, o que a Meta exige, o que deixa de funcionar, como é o passo a passo com um provedor de tecnologia e como a Arco Educação usou o recurso para conectar 125 consultores, cada um no próprio número.

O que é a coexistência do WhatsApp com a API oficial

Na documentação da Meta, o recurso aparece como integração de usuários do aplicativo WhatsApp Business à Cloud API. Na prática, o número passa a ter duas portas de entrada que enxergam a mesma conversa:

  • O aplicativo WhatsApp Business, no celular do vendedor, como sempre foi.
  • A API oficial, conectada a uma plataforma como a Sailer, que registra as mensagens, integra com o CRM e permite envios em escala.

Uma mensagem enviada pelo aplicativo aparece na plataforma. Uma mensagem enviada pela plataforma aparece no aplicativo. Para o cliente, nada muda: ele continua falando com o mesmo número e a mesma pessoa.

Coexistência, número central e ferramenta não oficial

ModeloO vendedor mantém o númeroHistóricoRisco de bloqueioVisibilidade da empresa
Cada vendedor no app, sem sistemaSimFica no celularBaixoNenhuma
Número central da empresa na APINãoComeça do zeroBaixoAlta
Ferramenta não oficial (QR code)SimDepende da ferramentaAltoParcial
Coexistência app + API oficialSimAté 6 meses sincronizadosBaixoAlta

Requisitos da Meta para a coexistência

Antes de planejar o projeto, confira estes pontos. Eles estão na documentação da Meta para desenvolvedores, consultada em outubro de 2026.

RequisitoO que a Meta pede
AplicativoWhatsApp Business (não o WhatsApp comum), versão 2.24.17 ou superior
Quem conectaUm Tech Provider ou Solution Partner da Meta, pelo fluxo de cadastro incorporado (Embedded Signup)
HistóricoMensagens individuais dos últimos 6 meses podem ser sincronizadas, e o provedor tem 24 horas para fazer a sincronização
Uso do celularO aparelho principal precisa ser aberto com regularidade: após cerca de 14 dias inativo, o número é desconectado da API
Aparelhos vinculadosFuncionam, com exceção do WhatsApp para Windows e para WearOS, cujas mensagens não chegam à API
VazãoNúmeros em coexistência têm vazão fixa de 20 mensagens por segundo

Se o vendedor usa o WhatsApp comum, o primeiro passo é passar o número para o aplicativo WhatsApp Business. A coexistência só funciona a partir dele.

O que muda no aplicativo depois da coexistência

Alguns recursos do aplicativo são desligados quando o número é conectado. Vale avisar o time antes, para ninguém achar que é defeito:

  • Mensagens temporárias são desativadas nas conversas individuais.
  • Visualização única deixa de funcionar nas conversas individuais.
  • Localização em tempo real é desativada nas conversas individuais.
  • Listas de transmissão são desativadas, e as existentes ficam só para leitura.

Na prática, as listas de transmissão eram a gambiarra que o vendedor usava para falar com a carteira. Com a API conectada, esse papel passa para campanhas com templates aprovados, segmentadas e rastreadas.

O que continua no app, mas não passa pela API

Alguns recursos seguem funcionando no celular, mas a API não enxerga: grupos, chamadas de voz e vídeo, catálogo e pedidos, respostas rápidas e mensagens de ausência, canais e a edição do perfil comercial. Se uma parte relevante da sua venda acontece em grupos, isso precisa entrar no desenho do projeto.

Custo e janela de 24 horas

Mensagens enviadas pelo aplicativo continuam gratuitas e, segundo a Meta, não estão sujeitas à janela de atendimento. Mensagens enviadas pela API seguem a tabela da Cloud API: dentro da janela de 24 horas, texto livre; fora dela, template cobrado por envio. Explicamos essa regra em detalhe no guia da janela de 24 horas do WhatsApp.

Passo a passo para conectar o número do vendedor

O fluxo é curto e o vendedor participa de poucos minutos dele. Com um provedor de tecnologia credenciado, funciona assim:

  1. Preparação. A empresa define o portfólio do Meta Business onde os números vão ficar e confere se cada vendedor está no WhatsApp Business atualizado.
  2. Cadastro incorporado. No fluxo do provedor, o vendedor escolhe conectar a conta existente do aplicativo e informa o número.
  3. Confirmação no celular. O vendedor recebe uma mensagem da conta oficial da Meta no aplicativo, toca em conectar e confirma a conexão com a plataforma.
  4. Compartilhamento do histórico. O aplicativo pergunta se ele quer compartilhar o histórico de conversas. Com a confirmação, as conversas individuais dos últimos 6 meses são sincronizadas.
  5. Código de verificação. O vendedor cola o código no fluxo e a conexão é concluída.
  6. Sincronização e carteira. O provedor importa o histórico e os contatos, e a plataforma liga cada conversa ao cliente certo no CRM.

Para desconectar, o próprio aplicativo tem a opção, no menu de configurações da conta, em Plataforma Business. Por isso a política interna precisa ser clara desde o começo, como explicamos abaixo.

Cuidados que evitam dor de cabeça

  • Portfólio da empresa, não do vendedor. Os números precisam ficar num portfólio do Meta Business controlado pela empresa, com e-mail corporativo e mais de um administrador.
  • Celular ativo. Um vendedor de férias que não abre o aplicativo por duas semanas pode ter o número desconectado. Combine a rotina de abrir o app, ou use a cobertura temporária da carteira.
  • Grupos fora do registro. O que acontece em grupos não chega à API. Se o grupo é parte do processo, decida o que fica nele.
  • Um orquestrador por número. Cada número opera com um único provedor na API. Se o seu CRM também dispara mensagens, eleja quem decide o envio e quem executa.
  • Política escrita. O número do vendedor passa a ser um canal da empresa com clientes. Deixe isso por escrito, com o jurídico e o RH. Detalhamos o tema em WhatsApp corporativo e LGPD.

Como a coexistência vira governança comercial

Conectar o número é o começo. O valor está no que a empresa passa a fazer com ele:

  • Carteira ligada ao CRM. Cada cliente tem um dono, sincronizado com o Salesforce, o HubSpot ou o CRM que você já usa.
  • Campanhas do número de cada vendedor. Uma campanha montada uma vez sai pelo número do responsável por cada carteira, e a resposta volta para a conversa certa.
  • Tempo de resposta e follow-up vencido. Pela primeira vez, essas métricas existem por vendedor e por time.
  • Continuidade. Quando alguém sai ou entra de férias, a carteira muda de dono com o histórico preservado.
  • Copiloto e análise. A IA resume conversas, sugere respostas, preenche o CRM e avalia cada conversa contra o playbook.

É isso que o Sailer Fleet faz em cima da coexistência. A Sailer AI é uma plataforma de CRM e agentes de IA para vendas no WhatsApp: conecta os números da marca e de cada vendedor à API oficial, coloca agentes de IA e pessoas na mesma caixa de entrada, preenche o CRM sozinha e mede cada conversa. A Sailer é Tech Provider oficial da Meta.

O caso Arco Educação: 125 consultores nos próprios números

A Arco Educação atende mais de 12 mil escolas e roda a operação comercial no Salesforce. Os consultores falavam com as escolas pelo próprio WhatsApp, e cada comunicação levava cerca de 3 minutos por mensagem, entre copiar, colar e anexar.

Com a coexistência e o Fleet:

  • O piloto começou com 11 consultores e chegou a 125 de 135 em dois meses.
  • Foram 16.500 mensagens enviadas dos números dos consultores, para mais de 8.000 escolas.
  • A taxa de resposta ficou em 26%, um número que antes não era medido.
  • Foram 825 horas economizadas, cerca de R$43 mil em dois meses.

Nenhum consultor trocou de número ou de celular. Veja o case completo da Arco Educação e o guia de gestão do WhatsApp da equipe de vendas.

Perguntas frequentes

O que é coexistência no WhatsApp?

É o recurso da Meta que permite usar o mesmo número no aplicativo WhatsApp Business e na API oficial ao mesmo tempo. O vendedor segue no celular com as mesmas conversas, e a empresa passa a registrar as mensagens, integrar com o CRM e enviar campanhas por aquele número, dentro das regras da Meta.

Perco o histórico de conversas ao conectar o número à API?

Não. As conversas continuam no aplicativo, e a Meta permite sincronizar com a plataforma as mensagens individuais dos últimos 6 meses, se o dono do número aceitar compartilhar o histórico. Mensagens de grupos não entram na sincronização e continuam apenas no aplicativo.

A coexistência funciona com o WhatsApp comum?

Não. É preciso usar o aplicativo WhatsApp Business, na versão 2.24.17 ou superior. Se o vendedor usa o WhatsApp comum no número que fala com clientes, o primeiro passo é passar esse número para o WhatsApp Business. Depois disso, a conexão com a API é feita por um provedor credenciado.

O que deixa de funcionar no aplicativo?

Nas conversas individuais, mensagens temporárias, visualização única e localização em tempo real são desativadas. As listas de transmissão também saem, e as existentes ficam só para leitura. Grupos, chamadas e catálogo seguem no aplicativo, mas não passam pela API.

Preciso de um parceiro da Meta para usar a coexistência?

Sim. A conexão é feita pelo fluxo de cadastro incorporado de um Tech Provider ou Solution Partner da Meta. A Sailer AI é Tech Provider oficial e faz a conexão como parte da implantação do Fleet, junto com a integração ao CRM e a política de uso.

Artigos que podem te interessar

PRONTO PARA AVANÇAR?

Coloque suas oportunidades na rota do resultado.

Comece com autonomia ou converse com nosso time para desenhar a melhor rota para sua operação.