TecnologiaArtigo
WhatsApp Business: como usar o aplicativo e a API oficial no mesmo número (coexistência)
Em resumo
A Meta permite ligar à API oficial um número que já está no aplicativo WhatsApp Business, recurso às vezes chamado de coexistência. O ConnectWeek explica o que a loja precisa, o que muda no aplicativo, o que é cobrado, o que acontece com o histórico e com os aparelhos conectados, o que derruba a ligação e traz uma lista de dez itens para conferir antes de ligar.
Dá para usar o aplicativo WhatsApp Business e a API oficial no mesmo número. A Meta documenta o recurso na página Como integrar usuários do app WhatsApp Business, atualizada em 26 de junho de 2026, e avisa que ele às vezes é chamado de coexistência nos canais de suporte e na documentação para parceiros. A loja continua respondendo cliente a cliente pelo celular, a plataforma de atendimento passa a enviar pelo mesmo número, e as conversas individuais ficam espelhadas nos dois lados. Em troca, alguns recursos do aplicativo são desligados e a ligação cai se o celular principal ficar parado. Este guia mostra o que muda, o que é cobrado e o que conferir antes de ligar. A leitura da página foi feita em 8 de outubro de 2026.
O que é a coexistência do WhatsApp Business?
O WhatsApp para empresas tem dois produtos. O aplicativo WhatsApp Business roda no celular e serve para a conversa manual. A Plataforma do WhatsApp Business, acessada pela API que a documentação chama de API de Nuvem, é o caminho para ligar a conversa a um sistema: fila com várias pessoas, robô, aviso automático de pedido. A diferença entre os dois e o que cabe em cada um estão em vender pelo WhatsApp com catálogo e agente de IA.
A coexistência é a opção de ligar à API uma conta que já existe no aplicativo, com o mesmo número de telefone, sem abandonar o aplicativo. Segundo a documentação da Meta, depois da ligação a empresa pode usar o sistema do parceiro para enviar grandes volumes de mensagens, segue podendo escrever de forma individual pelo aplicativo, e o WhatsApp mantém o histórico sincronizado entre os dois.
Na avaliação do ConnectWeek, o recurso atende a loja que construiu o atendimento em um número conhecido dos clientes e quer automatizar parte do trabalho sem trocar de número nem tirar o celular da mão de quem vende.
O que a loja precisa para ligar o aplicativo à API?
O caminho que a documentação descreve não começa dentro do aplicativo. A ligação acontece na tela de cadastro que a Meta fornece aos parceiros, o Cadastro Incorporado, exibida dentro do sistema de quem vai operar a API para a loja. A página da Meta lista os requisitos:
- Do lado da loja: aplicativo WhatsApp Business na versão 2.24.17 ou mais nova, conforme a lista de requisitos.
- Do lado do fornecedor: ser Parceiro de Soluções ou Provedor de Tecnologia da Meta, saber usar a API de Nuvem, ter um endereço capaz de receber e processar os avisos automáticos da plataforma (webhooks) e usar o Cadastro Incorporado com registro de sessão.
O roteiro que a loja vê, descrito na mesma página, pode ser resumido em cinco momentos, na organização do ConnectWeek:
- No cadastro aberto dentro do sistema do parceiro, a loja escolhe conectar a conta que já tem e informa o número do aplicativo.
- O WhatsApp mostra um código de verificação.
- Chega ao aplicativo uma mensagem da conta comercial oficial do Facebook, com o botão de conectar à plataforma.
- O aplicativo pede uma confirmação e dá à loja a opção de compartilhar o histórico de conversas com o parceiro.
- A loja cola o código e conclui o cadastro.
Concluída a ligação, o aplicativo é atualizado e passa a indicar que o número está conectado à API, diz a documentação.
O que muda no aplicativo depois da ligação?
A página traz uma tabela de comparação de recursos. O quadro abaixo resume, em redação do ConnectWeek, o que a tabela da Meta informa para cada item.
| Recurso do aplicativo | O que acontece no aplicativo | Aparece no sistema ligado à API? |
|---|---|---|
| Conversas individuais | Continuam; passa a ser possível editar e apagar mensagens | Sim. As mensagens enviadas e recebidas são espelhadas nos dois lados |
| Contatos | Sem alteração | Sim, os contatos que têm número de WhatsApp |
| Grupos | Sem alteração | Não. Conversas em grupo não são sincronizadas |
| Mensagens temporárias | Desativadas nas conversas individuais | Não |
| Visualização única | Desativada nas conversas individuais | Não |
| Localização em tempo real | Desativada nas conversas individuais | Não |
| Listas de transmissão | Desativadas: não dá para criar novas, e as existentes ficam só para leitura | Não |
| Ligações de voz e de vídeo | Sem alteração | Não |
| Catálogo, pedidos e status | Sem alteração | Não |
| Saudação, ausência, respostas rápidas e etiquetas | Sem alteração | Não |
| Perfil comercial | Sem alteração | Não |
| Canais | Sem alteração | Não |
Na avaliação do ConnectWeek, duas linhas pedem decisão antes da ligação. A primeira é a das listas de transmissão: quem avisa clientes por lista no aplicativo perde esse caminho e precisa refazer a rotina com modelos de mensagem enviados pela API. A segunda é a dos grupos: se a loja atende revendedores ou clientes em grupo, essas conversas continuam só no celular e ficam fora do painel de atendimento.
Há ainda um limite de velocidade. Segundo a seção de limitações, o número usado ao mesmo tempo no aplicativo e na API tem taxa fixa de 20 mensagens por segundo. A página de taxa de transferência da Meta informa que essa conta soma mensagens enviadas e recebidas e que o padrão dos números da API é de até 80 por segundo. Na avaliação do ConnectWeek, esse teto só entra na conta de quem dispara campanhas grandes de uma vez.
O que acontece com os aparelhos conectados?
O aplicativo permite ligar a conta a outros aparelhos, como o computador. A documentação fala em até quatro aparelhos adicionais; o ConnectWeek destaca três avisos sobre eles:
- No momento da ligação à API, todos os aparelhos adicionais são desvinculados da conta. A loja pode conectar de novo, em seguida, os que forem compatíveis.
- Os aparelhos adicionais são compatíveis, com duas exceções citadas pela página: o WhatsApp para Windows e o WhatsApp para WearOS, o sistema de relógios.
- A mensagem que um cliente manda a partir de um aparelho adicional incompatível chega à loja, mas não gera o aviso automático para o sistema do parceiro, de modo que não aparece no painel. Nesse caso, a orientação da página é conferir a conversa no aplicativo.
Na prática, na avaliação do ConnectWeek: avise a equipe de que o WhatsApp no computador vai cair no dia da ligação e combine quem reconecta cada aparelho.
O que é cobrado quando o número fica nos dois lados?
A regra da seção de preços da página é curta: as mensagens que a empresa envia pelo aplicativo continuam gratuitas, e as enviadas pela API ficam sujeitas aos preços da API de Nuvem. A mesma seção remete a um documento da Meta com cenários de cobrança para quem usa o aplicativo e a API juntos.
A janela de atendimento também é separada. Segundo a seção sobre a janela de atendimento, a restrição de 24 horas vale para o que sai pela API; a mensagem enviada pelo aplicativo não está sujeita à janela e não cria, estende nem afeta as janelas de conversa da API nem os preços dela. Há um detalhe para o dia da virada: a janela só se abre quando o cliente escreve para uma empresa que já está ligada à API. Se ele escreveu pouco antes da ligação, o sistema só consegue responder com modelo de mensagem; pelo aplicativo, a resposta segue normal.
As categorias de mensagem, a franquia mensal e o que voltou a ser cobrado em 1º de outubro de 2026 estão explicados em custo do WhatsApp Business em 2026. Na avaliação do ConnectWeek, a consequência para a rotina é direta: definir o que sai por cada lado. Resposta de pessoa a pessoa pode sair pelo aplicativo; envio em volume, aviso automático e robô saem pela API.
O histórico de conversas vai para o fornecedor?
Só se a loja permitir. O compartilhamento do histórico é uma opção apresentada durante a ligação, e a página descreve o que acontece em cada escolha:
- Se a loja compartilha: o parceiro recebe as mensagens individuais enviadas e recebidas nos 180 dias anteriores à ligação, segundo a descrição do histórico. Conversas em grupo ficam de fora, e a mídia só acompanha as mensagens enviadas em até 14 dias da ligação, que o ConnectWeek lê como os 14 dias anteriores a ela.
- Se a loja não compartilha: o parceiro recebe apenas o aviso de que o histórico foi recusado. O espelhamento das mensagens novas é descrito pela página em etapa separada, sem depender dessa escolha.
- Contatos: o parceiro pode sincronizar os contatos que têm número de WhatsApp, e as inclusões e alterações futuras também são informadas ao sistema dele.
Existe um prazo que é do fornecedor, mas afeta a loja: a documentação dá ao parceiro 24 horas, contadas da ligação, para sincronizar contatos e histórico, e cada sincronização só pode ser pedida uma vez. Passado o prazo, é preciso desconectar e refazer o cadastro. A página recomenda manter o aplicativo aberto durante a sincronização, que pode levar vários minutos.
Histórico de conversa traz nome, telefone e o que cada cliente escreveu. Na avaliação do ConnectWeek, a decisão de compartilhar deve ser tomada antes do dia da ligação e registrada no contrato com o fornecedor, com o que ele pode fazer com esses dados e por quanto tempo os guarda.
O que derruba a ligação e como desligar?
A ligação depende de o celular principal continuar em uso. A página da Meta lista os motivos de desconexão que o sistema informa ao parceiro:
- aparelho principal sem atividade por cerca de 14 dias, segundo a lista de motivos da página;
- aparelho adicional sem atividade por cerca de 30 dias, na mesma lista;
- troca do número de telefone;
- novo registro do número em outro aparelho;
- registro do número no WhatsApp comum, de uso pessoal;
- conta desconectada por aplicação das políticas ou excluída pela própria empresa.
Os prazos de 14 e 30 dias aparecem na documentação como aproximados. Na avaliação do ConnectWeek, eles pedem duas rotinas: abrir o aplicativo no celular principal toda semana, mesmo que o atendimento do dia a dia aconteça no painel, e tratar a troca de aparelho como tarefa planejada, com o fornecedor avisado, porque o novo registro encerra a ligação.
Para desligar por vontade própria, o caminho é pelo aplicativo. Segundo a documentação, a empresa acessa Configurações, depois Conta, depois Plataforma comercial (Business Platform, no original em inglês), e toca em Desconectar conta. Os nomes exibidos no aplicativo podem variar. O parceiro não consegue cancelar o registro do número pela API enquanto ele está em uso nos dois lados.
Para quem a coexistência vale a pena?
O quadro abaixo é avaliação do ConnectWeek, construída a partir das regras descritas acima; não é recomendação da Meta.
| Situação da loja | Leitura do ConnectWeek |
|---|---|
| Número antigo, divulgado em embalagem, site e anúncios, com dono ou vendedor que responde pelo celular | Caso típico: mantém o número e o hábito, e ganha painel, fila e automação |
| Atendimento todo feito por equipe em painel, ninguém usa o celular | A ligação exige manter o celular principal ativo; vale avaliar o número só na API |
| Rotina apoiada em listas de transmissão do aplicativo | As listas são desativadas; antes de ligar, monte os modelos de mensagem que vão substituí-las |
| Disparo de campanhas grandes em poucos minutos | A taxa fixa de 20 mensagens por segundo, informada na página da Meta, pode pesar |
| Equipe que usa o WhatsApp para Windows | A página lista esse aparelho adicional como não compatível; planeje outra forma de acesso no computador |
Quem quer colocar um robô para responder no mesmo número encontra a conta de mensagens e de modelos de IA em agente de IA no WhatsApp: quanto custa. E, com dois lados respondendo, convém escrever quem atende o quê e em quanto tempo; o método está em SLA de atendimento no e-commerce.
O que conferir antes de ligar: lista de dez itens
A lista é elaboração do ConnectWeek a partir das regras da documentação. Serve para a loja e para a conversa com o fornecedor.
- Atualize o aplicativo WhatsApp Business no celular principal e confira a versão.
- Confirme com o fornecedor que ele é Parceiro de Soluções ou Provedor de Tecnologia da Meta e que oferece a ligação de número que já está no aplicativo.
- Pergunte em que versão do Cadastro Incorporado a integração dele está. Um aviso no topo da página da Meta informa que as versões 2 e 3 ficam obsoletas a partir de 15 de outubro de 2026 e pede a migração para a versão 4. A página de controle de versões, atualizada em 24 de julho de 2026, repete o aviso e a data.
- Decida se o histórico será compartilhado e ponha a decisão no contrato.
- Liste o que hoje depende de lista de transmissão, mensagem temporária, visualização única e localização em tempo real, e defina o substituto de cada uso.
- Marque a ligação para um horário calmo e mantenha o aplicativo aberto até o fornecedor avisar que a sincronização terminou.
- Reconecte os aparelhos adicionais compatíveis e avise quem usava o WhatsApp para Windows.
- Escreva a regra de quem responde por onde: o que sai pelo aplicativo e o que sai pelo painel.
- Ponha na agenda a abertura semanal do aplicativo no celular principal.
- Guarde o caminho de desligamento e combine com o fornecedor o que fazer em troca de aparelho ou de número.
A documentação da Meta muda com frequência, e a página consultada é escrita para desenvolvedores. Antes de contratar, confira a versão atual da página e peça ao fornecedor que confirme, por escrito, cada ponto desta lista.
Fonte: Meta for Developers — Como integrar usuários do app WhatsApp Business
Perguntas frequentes
Dá para usar o WhatsApp Business no celular e a API oficial no mesmo número?
Sim. A documentação da Meta para desenvolvedores descreve a ligação de uma conta do aplicativo WhatsApp Business à API de Nuvem com o mesmo número, recurso que, segundo a mesma página, às vezes é chamado de coexistência nos canais de suporte. A empresa segue respondendo de forma individual pelo aplicativo, o sistema do parceiro envia pelo mesmo número, e as conversas individuais ficam espelhadas nos dois lados.
O que deixa de funcionar no aplicativo depois de ligar o número à API?
Segundo a tabela de recursos da documentação da Meta, as mensagens temporárias, a visualização única e a localização em tempo real são desativadas nas conversas individuais, e as listas de transmissão são desativadas: não dá para criar novas, e as existentes ficam só para leitura. Grupos, ligações, catálogo, etiquetas e perfil comercial seguem sem alteração no aplicativo.
As mensagens enviadas pelo aplicativo passam a ser cobradas?
Não. A documentação da Meta informa que as mensagens enviadas pela empresa pelo aplicativo WhatsApp Business continuam gratuitas depois da ligação, e que as enviadas pela API ficam sujeitas aos preços da API de Nuvem. A página também diz que a mensagem enviada pelo aplicativo não cria, não estende e não afeta as janelas de conversa da API.
O fornecedor recebe todo o histórico de conversas da loja?
Só se a loja permitir. O compartilhamento do histórico é uma opção apresentada durante a ligação. Quando a loja aceita, a documentação da Meta fala nas mensagens individuais dos 180 dias anteriores, sem conversas em grupo e com mídia apenas das mensagens enviadas em até 14 dias da ligação (na leitura do ConnectWeek, os 14 dias anteriores). Quando a loja recusa, o parceiro recebe só o aviso da recusa.
O que faz a ligação entre o aplicativo e a API cair?
A documentação da Meta lista os motivos informados ao parceiro: aparelho principal sem atividade por cerca de 14 dias, aparelho adicional sem atividade por cerca de 30 dias, troca de número, novo registro em outro aparelho, registro do número no WhatsApp de uso pessoal e conta desconectada por aplicação das políticas ou excluída pela empresa.
