WhatsApp Business (app) ou API: quando migrar
O app WhatsApp Business atende bem no manual; a API liga o WhatsApp ao seu sistema. Veja as diferenças, os sinais de que é hora de integrar e o mesmo número.
Atualizado em
Quase toda empresa começa no WhatsApp do mesmo jeito: um celular, o aplicativo WhatsApp Business e alguém respondendo os clientes. Funciona bem por um bom tempo. Um dia, porém, as mensagens começam a depender de dados que estão em outro lugar (o pedido no e-commerce, o horário na agenda, a fatura no financeiro), e copiar e colar vira o gargalo.
É nesse ponto que surge a pergunta: continuar no app ou partir para uma API de WhatsApp? Esta página compara os dois, mostra os sinais de que é hora de integrar e responde à dúvida mais comum: dá para usar o mesmo número?
O que o app WhatsApp Business faz bem
O WhatsApp Business é o aplicativo gratuito da Meta para pequenas empresas. Ele foi pensado para uma pessoa atendendo pelo celular (ou pelo WhatsApp Web) e traz ferramentas para esse trabalho manual:
- perfil comercial, com endereço, horário de funcionamento e site;
- etiquetas para organizar conversas (novo cliente, pedido pago, aguardando retorno);
- catálogo de produtos e serviços para mostrar dentro da conversa;
- respostas rápidas, mensagem de saudação e mensagem de ausência.
Para quem atende poucas conversas por dia e toma cada decisão olhando a tela, o app é suficiente. O limite aparece quando a mensagem precisa ser disparada por um evento no seu sistema, e não por uma pessoa: "o pagamento foi confirmado", "a consulta é amanhã às 14h", "o pedido saiu para entrega". O app não tem como ouvir esses eventos, e as ferramentas dele, como etiquetas e catálogo, vivem só dentro do aplicativo.
O que uma API acrescenta
Uma API de WhatsApp permite enviar e receber mensagens por chamadas HTTP, a partir do seu próprio código. Em vez de alguém digitar, o sistema que conhece o dado envia a mensagem. Em vez de alguém ler no celular, a resposta do cliente chega ao seu sistema como um evento.
Na apiwpp, isso funciona assim:
- Envio pela API:
POST /connections/{id}/sendcoloca a mensagem na fila do número e responde202na hora, comjobId,scheduledAteposition. Dá para enviar texto (com o indicador de "digitando…"), imagem, vídeo, áudio, documento, figurinha, localização e templates com variáveis. - Recebimento por webhook: cada mensagem recebida chega ao seu sistema como um
POSTcom o eventomessage.incoming. Status de entrega e leitura chegam emmessage.delivery, e mudanças na conexão emconnection.status. As entregas são assinadas com HMAC e repetidas se o seu servidor falhar. - Sem mensagem duplicada: o campo
clientReftorna o envio idempotente. Se o seu sistema repetir a mesma requisição, a apiwpp devolve o job original em vez de enviar de novo. - Ritmo que protege o número: cada número tem uma fila anti-bloqueio com limites por minuto, hora e dia, e um número recém-conectado passa por um aquecimento de 14 dias.
Um exemplo do envio mais simples, com a chave de API do projeto:
curl -X POST "https://api.apiwpp.com/connections/$CONNECTION_ID/send" \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{"to": "5511988887777", "message": "Seu pedido 1042 foi confirmado.", "clientRef": "pedido-1042-confirmado"}'
Se quiser entender o conceito do zero antes de continuar, o guia API de WhatsApp: o que é, como funciona e quando usar explica com calma.
App ou API: lado a lado
| Critério | App WhatsApp Business | API (apiwpp) |
|---|---|---|
| Quem envia | Uma pessoa, pelo celular ou WhatsApp Web | O seu sistema, por HTTP |
| Quem lê as respostas | Uma pessoa, na tela | O seu sistema, por webhook |
| Mensagens disparadas por eventos | Não | Sim: pedido, pagamento, agenda, qualquer evento |
| Etiquetas e catálogo | Sim, dentro do app | Não: a organização fica no seu sistema |
| Integração com CRM, ERP ou agenda | Manual | Direta, com o seu código |
| Ritmo de envio | O de quem digita | Fila com limites por número e aquecimento |
| Custo | App gratuito | Por número conectado, por mês (ver preços) |
| Começar | Instalar o app | Cadastro, conectar o número por QR code e teste grátis de 7 dias |
A tabela não indica um vencedor. O app continua sendo a melhor ferramenta para o atendimento humano, uma conversa por vez. A API resolve o que o app não resolve: tirar a mensagem das mãos de alguém e ligá-la aos seus dados.
Sinais de que é hora de integrar
Nenhum desses sinais obriga a migrar sozinho, mas quando vários aparecem juntos, a integração costuma se pagar em tempo de equipe:
- Mensagens repetidas todos os dias. Confirmação de pedido, lembrete de consulta, aviso de vencimento: o mesmo texto com dados diferentes. É o caso típico de um template com variáveis enviado pelo sistema.
- Copiar e colar entre sistemas. Se alguém abre o painel do e-commerce ou a agenda para montar cada mensagem, a informação já existe e pode ir direto para o WhatsApp.
- Respostas que precisam virar dado. Quando o "confirmo" do cliente deveria atualizar a agenda, ou uma dúvida deveria abrir um chamado, o webhook
message.incomingleva a resposta para o seu sistema. Veja o caso de lembretes de agendamento. - Histórico espalhado. Conversas presas em um celular somem do contexto do cliente. Com a API, cada mensagem enviada e recebida pode ser registrada no seu CRM.
- Você quer oferecer WhatsApp no seu produto. Se você tem um SaaS ou CRM, a API permite que cada cliente conecte o próprio número dentro da sua plataforma. O guia como colocar o WhatsApp dentro do seu SaaS mostra a arquitetura.
Um sinal que não é motivo para migrar: querer enviar mensagens para listas grandes de pessoas que nunca falaram com a empresa. A apiwpp não é uma ferramenta de disparo em massa; a fila limita os destinatários novos por dia justamente para proteger o número. Para campanhas desse tipo, compare com a API oficial do WhatsApp.
Posso usar o mesmo número?
Na apiwpp, sim. A conexão é um aparelho conectado do número, exatamente como o WhatsApp Web ou o WhatsApp no computador. Você escaneia o QR code em Aparelhos conectados › Conectar um aparelho no celular do número, ou digita um código de pareamento de 8 caracteres. O número continua no aplicativo do celular, e a API passa a ser mais um aparelho ligado a ele.
Na prática, isso quer dizer que:
- a equipe pode continuar respondendo pelo app enquanto o sistema envia notificações pela API, com o mesmo número que os clientes já conhecem;
- a sessão fica salva e criptografada nos servidores, e o celular pode ficar desligado sem derrubar a API;
- se você ativar o evento opcional
message.outgoingno projeto, o seu sistema recebe também o que foi digitado no celular (comorigin: PHONE), além do que saiu pela API (origin: API), e o histórico fica completo; - se alguém remover o aparelho na lista de aparelhos conectados do celular, a sessão da API termina e o número precisa ser pareado de novo, o que também recomeça o aquecimento.
Duas ressalvas honestas. Primeiro, as ferramentas do app (etiquetas, catálogo, respostas rápidas) continuam só no app; a API não as lê nem as altera. Segundo, a apiwpp é uma API não oficial: ela usa o protocolo do WhatsApp Web e não tem vínculo com o WhatsApp nem com a Meta. A fila e o aquecimento reduzem o risco de restrição do número, mas nada garante que ele nunca será restringido. O passo a passo de conexão está em conexão por QR code ou código de pareamento.
Como migrar sem parar o atendimento
Como o número não sai do app, a migração pode ser gradual:
- Crie a conta e um projeto. O teste grátis dura 7 dias, com 1 número e os recursos do PRO (exceto IP dedicado), sem cartão.
- Conecte o número atual por QR code. O atendimento no celular continua igual.
- Automatize uma mensagem por vez. Comece pela mais repetida, como a confirmação de pedido, usando
clientRefcom o id do pedido para nunca enviar duas vezes. - Ligue o webhook para receber as respostas no seu sistema e decida quais conversas continuam no app e quais viram dado.
- Respeite o aquecimento. Nos primeiros 14 dias os limites começam baixos; priorize quem já conversa com o número.
Para o código, as páginas de integração trazem exemplos prontos, como a de Node.js.
Perguntas frequentes
Preciso deixar de usar o app WhatsApp Business para usar a apiwpp?
Não. A apiwpp conecta o número como um aparelho conectado, então ele continua no app do celular. A equipe pode seguir atendendo pelo app enquanto o seu sistema envia e recebe mensagens pela API.
O celular precisa ficar ligado?
Não. Depois do pareamento, a sessão fica salva e criptografada nos servidores da apiwpp, e a API continua funcionando com o celular desligado. Se o aparelho for removido da lista de aparelhos conectados, é preciso parear de novo.
A API consegue usar as etiquetas e o catálogo do app?
Não. Etiquetas, catálogo e respostas rápidas são ferramentas do aplicativo e ficam só nele. Com a API, a organização das conversas passa a viver no seu sistema, a partir dos eventos de webhook.
A apiwpp é a API oficial do WhatsApp Business?
Não. A apiwpp usa o protocolo do WhatsApp Web e não tem vínculo com o WhatsApp nem com a Meta. Por isso não exige aprovação de conta nem de modelos de mensagem. Se você precisa da API oficial, veja o comparativo com a Cloud API.
Quanto custa sair do app para a API?
O app é gratuito. Na apiwpp, você paga por número conectado, por mês, com mensagens ilimitadas dentro dos limites da fila, e pode testar grátis por 7 dias. Os valores estão na página de preços.
Outros comparativos
Todos: Comparativos →A Cloud API da Meta exige conta comercial e templates aprovados e cobra por mensagem; a apiwpp conecta o número como aparelho conectado, sem aprovação, e cobra por número. Cada uma vence em cenários diferentes.
Os critérios para comparar APIs de WhatsApp gerenciadas, como cobrança, fila anti-bloqueio, webhooks assinados, idempotência, proxy e documentação, com a posição da apiwpp em cada um e um roteiro de migração.
A Evolution API é um servidor open source que você hospeda e opera; a apiwpp é uma API gerenciada cobrada por número. Veja o custo total de cada modelo, o que a apiwpp opera por você e quando hospedar faz sentido.