API de WhatsApp passo a passo: da conta à primeira mensagem

O cadastro é feito no painel do ZapZap. O modelo é pré-pago: você adiciona saldo e paga por número ativo por mês, sem cobrança por mensagem e sem fidelidade. A página de preços traz o valor atual e a informação sobre crédito para testar, então confira lá antes de decidir.

Se você é desenvolvedor, comece os testes com um número seu como destino antes de falar com clientes de verdade.

Instância é o nome que damos a cada número de WhatsApp conectado. No painel, crie uma instância e escaneie o QR code com o aplicativo do WhatsApp do número que será usado, no mesmo caminho de conectar o WhatsApp Web. A conexão leva poucos minutos.

Use um número que você controla e que já tenha histórico de conversas reais. Número recém-criado e sem uso é o mais vulnerável a bloqueio. Se for começar com um chip novo, passe antes pelo aquecimento do número.

No painel, em Configurações e API, ficam a chave (x-api-key) e o segredo (x-api-secret). O ID da instância aparece na lista de instâncias. Esses três valores identificam e autenticam todas as chamadas. A documentação de autenticação explica cada um.

Antes de enviar, confirme que a chave e o segredo funcionam buscando os dados da sua conta.

curl https://api.zapzapapi.com/api/v1/account \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET"

Com a autenticação certa, o envio é uma chamada. Use o seu próprio número como destino no primeiro teste. Para o mesmo envio em Node.js, Python e PHP, veja o guia enviar mensagem de WhatsApp por API.

curl -X POST https://api.zapzapapi.com/api/v1/SEU_INSTANCE_ID/send/text \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"number":"5511999999999","text":"Minha primeira mensagem pela API."}'

Uma conversa tem duas pontas. Para o seu sistema ser avisado quando o cliente responder, configure um webhook que aponta para um endereço seu. A documentação de webhooks lista os eventos. Ferramentas como n8n e Make recebem esse webhook sem código, veja as integrações.

Quando o teste funcionar, resista à vontade de disparar para toda a base. Envie só para quem aceitou receber, comece devagar e aumente aos poucos, varie o texto e acompanhe as respostas. Nenhuma plataforma elimina o risco de bloqueio, e quem promete isso está prometendo algo que não controla. O que existe é prática que reduz a chance, e está descrita no guia de anti-bloqueio.