O que as pessoas procuram quando buscam "grátis"
Quem pesquisa por API de WhatsApp gratuita geralmente está em uma de três situações, e cada uma tem uma resposta diferente:
- Quer testar antes de decidir. Aqui grátis faz todo sentido, e existem caminhos para isso sem gambiarra.
- Tem um projeto pequeno ou pessoal. Um número, pouco volume, sem cliente pagante dependendo da conexão. Rodar uma solução open source pode ser uma boa escolha.
- Quer reduzir custo de um produto em produção. Aqui é onde o "grátis" costuma sair mais caro, e vale fazer a conta com calma.
Opções open source e hospedadas por você
Existem bibliotecas e projetos de código aberto que implementam o protocolo do WhatsApp Web e expõem uma API HTTP em cima dele. Você baixa, sobe num servidor e conecta o número pelo QR. O código não custa nada; a operação custa. Antes de escolher esse caminho, liste o que vai ficar sob sua responsabilidade:
- Servidor e dependências. A aplicação precisa de máquina ligada o tempo todo, banco para guardar a sessão, e muitas vezes fila e armazenamento para mídia. Hospedagem de qualidade tem fatura mensal.
- Atualização. O WhatsApp muda o protocolo sem aviso. Quando isso acontece, as conexões podem parar até a biblioteca ser atualizada e você aplicar a nova versão no seu ambiente.
- Rede. Por padrão, todos os números saem pelo IP do seu servidor. Para separar, você precisa contratar e configurar proxies.
- Monitoramento e reconexão. Saber que um número caiu, entender o motivo e reconectar é trabalho seu, inclusive de madrugada.
- Banimento. Se um número for bloqueado, não há a quem recorrer. O impacto em outros números do mesmo servidor também é problema seu.
Para um número pessoal ou um protótipo, tudo isso é administrável. Para um produto com clientes, é um segundo produto para manter. A comparação completa entre os dois modelos está em API self-hosted vs gerenciada.
Quanto custa o "grátis" na prática
Uma forma simples de colocar no papel, antes de decidir:
| Item | Open source hospedado por você | API gerenciada |
|---|---|---|
| Licença ou mensalidade | Zero | Valor por conexão |
| Servidor, banco e armazenamento | Por sua conta | Incluso |
| IP separado por número | Proxy contratado e configurado por você | Depende do fornecedor; na D-API, incluso |
| Atualizar quando o WhatsApp muda | Horas do seu time | Responsabilidade do fornecedor |
| Conexão caída às 3h da manhã | Seu plantão | Reconexão automática e suporte |
A pergunta útil não é "quanto custa a API", e sim "quanto custa manter o WhatsApp funcionando para os meus clientes". Para ver os modelos de cobrança lado a lado, leia quanto custa uma API de WhatsApp.
Como testar sem pagar
Ambiente de testes da API oficial
A Meta disponibiliza, no painel de desenvolvedor, um número de teste para experimentar a API oficial, enviando mensagens para uma lista pequena de destinatários que você cadastra. Serve para entender o formato das chamadas e dos templates. Não serve para operar com clientes reais, e as regras desse ambiente são definidas pela própria Meta.
Trial da D-API
Na D-API, o trial dura 3 dias, com uma conexão e acesso completo, sem cartão. É tempo para fazer o teste que importa: conectar um número real pelo QR, enviar pelo seu sistema e receber os eventos no seu webhook.
Um roteiro que cabe nesses 3 dias:
- Criar a conta, copiar a API Key e criar a primeira sessão.
- Conectar um número de teste pelo QR e enviar uma mensagem com curl.
- Apontar o webhook para um endpoint seu e ver as mensagens recebidas chegando.
- Desconectar o aparelho vinculado no celular e observar o evento de status.
- Enviar imagem e documento, que costumam revelar ajustes no seu código.
O primeiro passo, em curl, é este:
curl -X POST https://api.d-api.cloud/api/v1/sessions \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "sessionId": "teste-trial", "type": "unofficial" }'Quando grátis é a escolha certa
Não existe resposta única. Rodar uma solução open source é razoável quando o número é seu, o volume é baixo e uma queda não custa um cliente. Também faz sentido quando o seu time já opera infraestrutura parecida e tem tempo sobrando para mais um serviço.
Quando o WhatsApp é parte do que você vende, a conta muda. Cada hora gasta mantendo conexão é uma hora a menos no seu produto, e cada queda aparece para o seu cliente como falha sua. Nesse cenário, pagar por conexão tende a sair mais barato que o "grátis". Se esse é o seu caso, veja como funciona a API não oficial da D-API e os valores em preços.