API oficial

Coexistência no WhatsApp: como usar o aplicativo e a API oficial no mesmo número

Por VeyloCRM · · 9 min de leitura

O maior motivo para uma empresa pequena adiar a API oficial nunca foi o preço. Foi o medo de perder o número — e, com ele, anos de conversas, contatos salvos e clientes que só reconhecem aquele contato. A coexistência tira esse medo da mesa: o número vai para a plataforma oficial e continua no WhatsApp Business do celular. O que pouca gente conta é o que muda nos dois lados.

O que é a coexistência

Durante anos, colocar um número na API oficial do WhatsApp tinha um preço escondido: o número saía do aplicativo. Quem registrava na API perdia o WhatsApp Business do celular, o histórico ficava para trás e a equipe que respondia pelo aparelho precisava mudar de ferramenta no mesmo dia.

A coexistência muda isso. É o recurso da Meta que permite manter o mesmo número ativo no aplicativo WhatsApp Business e na Cloud API ao mesmo tempo. As mensagens enviadas e recebidas pelo celular aparecem no sistema conectado à API, e as mensagens enviadas pelo sistema aparecem no celular. Os dois lados enxergam a mesma conversa.

Na prática, a conexão é feita pelo cadastro incorporado da Meta: a empresa entra com o perfil do Facebook, escolhe ou cria o portfólio de negócios e, em vez de digitar um número novo, lê um QR Code com o WhatsApp Business do celular. É por isso que muitos painéis chamam essa modalidade de "API oficial via QR Code" — o QR é só a porta de entrada; o que roda por trás é a API oficial.

Não confunda com a conexão por QR Code comum. A conexão pelo protocolo do WhatsApp Web também usa QR Code, mas não é autorizada pela Meta para uso empresarial. Na coexistência, o número fica registrado na plataforma oficial, com portfólio, modelos aprovados e medição de qualidade. As diferenças estão em API não oficial do WhatsApp: os riscos reais.

Para quem ela foi feita

A coexistência resolve um problema específico: a empresa que já tem um número forte no WhatsApp Business — anos de histórico, contatos salvos, clientes que conhecem aquele número — e precisa de algo que só a API oficial entrega, sem abrir mão do aplicativo.

Leitura liberada

Continue lendo de graça

Preencha uma vez e libere este e todos os outros artigos do blog. Não cobramos nada — só queremos saber para quem estamos escrevendo.

Leva 20 segundos. Prefere falar direto no WhatsApp?

O que muda no aplicativo

A coexistência não é gratuita em recursos. Ao conectar, parte do aplicativo muda de comportamento, e é melhor a equipe saber antes do que descobrir no meio do atendimento. Segundo a documentação da Meta:

  • Listas de transmissão: as existentes ficam somente para leitura e não é possível criar novas. O envio para muitos contatos passa a ser feito pela API, com modelo.
  • Grupos: continuam no celular, mas não são sincronizados com o sistema.
  • Mensagens temporárias, visualização única e localização em tempo real são desativadas nas conversas individuais.
  • Chamadas de voz e vídeo e canais não fazem parte da sincronização.

Para a maioria das empresas, só a lista de transmissão pesa. E ela pesa por um bom motivo: era justamente o recurso usado para envio em massa sem controle, que agora vai para o lugar certo.

Histórico e contatos: o que vem junto

Na conexão, a empresa pode sincronizar o que já existe no aplicativo:

  • Conversas dos últimos 6 meses podem ser trazidas para o sistema conectado. A sincronização precisa acontecer nas primeiras 24 horas após a conexão.
  • Contatos com WhatsApp também podem ser sincronizados.
  • Mensagens anteriores a 6 meses continuam no celular, mas não entram no sistema.

Durante a sincronização, a Meta orienta manter o aplicativo aberto no celular. É um detalhe operacional que evita a pergunta mais comum do primeiro dia: "por que as conversas antigas não apareceram?".

Velocidade, custo e qualidade

Três pontos que entram na conta antes de decidir:

  • Velocidade de envio. Números em coexistência têm vazão fixa de 20 mensagens por segundo na API. Para atendimento e campanhas de empresa pequena e média, é muito mais do que o necessário; para quem dispara para centenas de milhares de contatos de uma vez, pode ser limite.
  • Custo. O que a empresa envia pelo aplicativo continua gratuito. O que é enviado pela API segue a tabela da Meta: mensagens de modelo de marketing, autenticação e utilidade fora da janela de atendimento são cobradas; respostas dentro da janela de 24 horas, não. Detalhes em preços de conversa da Meta.
  • Qualidade e limite de envio. O número passa a ter nota de qualidade e limite de contatos por dia, como qualquer número oficial. Veja limites de envio e como subir de tier.

O Mapa das Duas Portas: quem responde por onde

O maior risco da coexistência não é técnico, é de processo. Com duas portas abertas para o mesmo número, duas pessoas respondem o mesmo cliente, ou ninguém responde porque cada uma acha que a outra viu. A solução é decidir por escrito o que passa por cada porta:

  • Porta do aplicativo (celular): clientes antigos que falam direto com a dona, grupos, respostas rápidas fora do horário quando só ela está disponível.
  • Porta do sistema (API): todo lead novo, toda conversa com responsável definido, campanhas e lembretes com modelo aprovado, automação e relatório.
  • Regra de passagem: se a conversa começou no celular e virou negociação, ela ganha responsável no sistema — e quem estava no celular para de responder ali.
  • Regra de silêncio: nenhuma conversa com responsável no sistema é respondida pelo celular sem avisar o responsável.

Parece burocracia, mas é o que evita o cliente receber duas respostas diferentes em cinco minutos — a forma mais rápida de perder a confiança que o número acumulou em anos.

O passo a passo da conexão

  1. Confirme que o número está no WhatsApp Business, não no WhatsApp pessoal, e que o aplicativo está atualizado.
  2. Tenha acesso de administrador ao portfólio de negócios da Meta, ou crie um no fluxo de conexão.
  3. Inicie o cadastro incorporado pela ferramenta que vai usar a API e escolha conectar um número do aplicativo.
  4. Leia o QR Code com o WhatsApp Business do celular.
  5. Autorize a sincronização de contatos e conversas e deixe o aplicativo aberto até terminar.
  6. Crie e envie para aprovação os primeiros modelos de mensagem — lembrete, retomada de conversa, confirmação.
  7. Treine a equipe no Mapa das Duas Portas antes de liberar o painel para todos.

Para aprovar modelos na primeira tentativa, veja como escrever e aprovar template.

A conta de uma clínica que não quis trocar de número

Uma clínica de estética usa o mesmo número há sete anos, com cerca de 4.800 contatos. A dona responde pelo celular; duas recepcionistas dividem um segundo aparelho. A clínica perde, em média, 22% dos agendamentos por falta sem aviso, numa agenda de 360 atendimentos por mês com ticket de R$ 180.

  • Mudar para um número novo na API significaria avisar 4.800 contatos e, pela estimativa da própria dona, perder parte das clientes que só salvam o número antigo.
  • Com a coexistência, o número foi conectado à API sem sair do celular. A dona continuou respondendo as clientes antigas pelo aplicativo; as recepcionistas passaram ao painel.
  • A clínica criou um modelo de confirmação enviado na véspera. As faltas caíram de 22% para 13%.

Nove pontos a menos de falta em 360 atendimentos são cerca de 32 horários salvos por mês: R$ 5.760. Os lembretes custam por mensagem de utilidade fora da janela, uma fração disso. E nenhuma cliente precisou salvar um número novo.

Os primeiros 30 dias depois de conectar

A conexão leva minutos; o que decide se ela deu certo é o primeiro mês. Um roteiro simples, semana a semana:

  • Semana 1 — conferência. Verifique se as conversas dos últimos meses apareceram no painel, se as mensagens enviadas pelo celular estão entrando no sistema e se as enviadas pelo sistema aparecem no celular. Anote qualquer conversa que ficou de fora e confira se ela é anterior a 6 meses ou se é de grupo.
  • Semana 2 — divisão de portas. Aplique o Mapa das Duas Portas com a equipe inteira. Todo lead novo ganha responsável no sistema. A dona combina quais clientes continua atendendo pelo celular.
  • Semana 3 — primeiro modelo em uso. Coloque em produção um único modelo de utilidade, como confirmação de horário ou aviso de pedido. Acompanhe a taxa de resposta e se alguém bloqueou.
  • Semana 4 — revisão de qualidade. Olhe a nota de qualidade e o limite de envio do número. Se estiver verde, o próximo passo é um modelo de retomada para quem conversou recentemente — sempre para quem tem motivo para esperar a mensagem.

Esse ritmo parece lento, mas protege o ativo mais valioso da operação: um número antigo, conhecido e confiável. Acelerar nos primeiros dias é o que costuma derrubar a qualidade logo de saída.

As perguntas que a equipe vai fazer

  • "O cliente vai perceber alguma mudança?" Não. O número, o nome e a foto continuam os mesmos. Ele só nota se receber resposta duplicada — que é o que o Mapa das Duas Portas evita.
  • "Posso continuar mandando áudio pelo celular?" Sim. Mensagens comuns pelo aplicativo continuam funcionando e aparecem no sistema.
  • "E se eu trocar de celular?" Faça a troca do aplicativo com cuidado e confira a conexão depois; o número continua registrado na plataforma oficial.
  • "Por que não consigo criar lista de transmissão?" Porque o envio para muitos contatos passou a ser feito com modelo aprovado pela API, com controle de permissão e qualidade.

Quando a coexistência não é a melhor escolha

  • A empresa depende de lista de transmissão e não quer passar a usar modelo aprovado. Nesse caso, a coexistência vai tirar o recurso que ela usa.
  • O volume de envio é muito alto e a vazão de 20 mensagens por segundo não comporta a operação.
  • Ninguém mais responde pelo celular. Se todo o atendimento já acontece no painel, o número pode ir para a API sem coexistência, sem as limitações do aplicativo.
  • O número está com histórico de denúncias por envios antigos. A qualidade vai ser medida desde o primeiro dia na API; vale limpar o comportamento antes.

Erros comuns na coexistência

  • Não avisar a equipe que a lista de transmissão vai parar. Alguém tenta mandar a campanha da semana e acha que o sistema quebrou.
  • Sair do aplicativo durante a sincronização. Conversas antigas deixam de aparecer no painel.
  • Responder o mesmo cliente pelas duas portas. Sem regra de passagem, a coexistência vira confusão.
  • Usar a API como licença para disparar para toda a agenda. Contato salvo não é contato que deu permissão; a qualidade cai e o limite desce.
  • Confundir com conexão por QR Code comum. Só a coexistência coloca o número na plataforma oficial; a outra continua fora das regras.

Bem usada, a coexistência é a migração mais suave que existe para a API oficial: o número fica, o histórico recente vem junto e o aplicativo continua no bolso de quem sempre respondeu. O que muda é que o que precisa de escala passa a acontecer no lugar certo.

Perguntas frequentes

Posso usar o WhatsApp Business no celular e a API oficial ao mesmo tempo?

Sim, por meio da coexistência, recurso da Meta que permite manter o mesmo número ativo no aplicativo WhatsApp Business e na Cloud API. As mensagens enviadas e recebidas pelo celular aparecem no sistema conectado à API e vice-versa. A conexão é feita pelo cadastro incorporado da Meta, lendo um QR Code com o WhatsApp Business do celular. É preciso que o número esteja no WhatsApp Business, e não no WhatsApp pessoal, e que a empresa tenha acesso a um portfólio de negócios. Alguns recursos do aplicativo mudam: listas de transmissão ficam somente para leitura, grupos não são sincronizados e mensagens temporárias, visualização única e localização em tempo real são desativadas nas conversas individuais. Mensagens enviadas pelo aplicativo continuam gratuitas; as enviadas pela API seguem a tabela de preços da Meta.

A coexistência traz o histórico de conversas do WhatsApp Business?

Traz parte dele. Segundo a documentação da Meta, as conversas dos últimos 6 meses podem ser sincronizadas com o sistema conectado à API, e a sincronização precisa acontecer nas primeiras 24 horas depois da conexão. Os contatos que têm WhatsApp também podem ser sincronizados. Mensagens mais antigas que 6 meses continuam no celular, mas não aparecem no sistema, e conversas de grupo não são sincronizadas. A orientação é manter o aplicativo aberto no celular durante a sincronização. Por isso vale conectar num momento de pouco movimento e conferir, no primeiro dia, se as conversas recentes apareceram no painel antes de liberar o atendimento para toda a equipe.

Quais as desvantagens da coexistência no WhatsApp?

As principais são as mudanças no aplicativo e o risco de processo. Listas de transmissão existentes ficam somente para leitura e não é possível criar novas, então quem depende delas precisa passar a usar modelos aprovados pela API. Grupos não são sincronizados, e mensagens temporárias, visualização única e localização em tempo real são desativadas nas conversas individuais. A vazão na API é fixa em 20 mensagens por segundo, suficiente para a maioria das empresas, mas limitante para envios gigantes. O número passa a ter nota de qualidade e limite de envio. E, com duas portas abertas para o mesmo número, a equipe pode responder o mesmo cliente em dobro se não houver regra clara sobre quais conversas são atendidas pelo celular e quais pelo sistema.

Conecte o número do celular à API oficial sem trocar de número

No VeyloCRM, a conexão "API oficial via QR Code" usa a coexistência da Meta: o número continua no WhatsApp Business do celular, as conversas aparecem na caixa da equipe com responsável definido e os lembretes com modelo aprovado saem pelo caminho oficial.