Pular para o conteúdo
apiwpp
Comparativo

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:

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:

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érioApp WhatsApp BusinessAPI (apiwpp)
Quem enviaUma pessoa, pelo celular ou WhatsApp WebO seu sistema, por HTTP
Quem lê as respostasUma pessoa, na telaO seu sistema, por webhook
Mensagens disparadas por eventosNãoSim: pedido, pagamento, agenda, qualquer evento
Etiquetas e catálogoSim, dentro do appNão: a organização fica no seu sistema
Integração com CRM, ERP ou agendaManualDireta, com o seu código
Ritmo de envioO de quem digitaFila com limites por número e aquecimento
CustoApp gratuitoPor número conectado, por mês (ver preços)
ComeçarInstalar o appCadastro, 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:

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:

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:

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.

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.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.