Gerando um token de API e enviando sua primeira mensagem pela API

Visão geral da API da Zapini

A Zapini oferece uma API REST para integrar o WhatsApp aos seus sistemas. Com ela você pode enviar mensagens, mídias e áudios, gerenciar contatos e conversas e controlar a automação. A autenticação é feita por token Bearer, e cada token está vinculado a uma instância de WhatsApp.

Passo 1 — Gerar um token de API

Acesse a página /tokens no painel, escolha a instância desejada e gere um novo token. O token completo é exibido apenas uma vez no momento da criação, então copie e guarde em local seguro.

💡 Dica: trate o token como uma senha. Nunca o exponha em código de frontend, repositórios públicos ou URLs.

Passo 2 — Autenticar as requisições

Inclua o token no cabeçalho Authorization em todas as chamadas:

Authorization: Bearer {token}
Content-Type: application/json

Passo 3 — Enviar sua primeira mensagem

Use o endpoint de envio de mensagens informando o destinatário em formato internacional e o texto:

curl -X POST https://zapini.app/api/v1/messages/send \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "+5511999999999",
    "message": "Olá! Esta é minha primeira mensagem pela API da Zapini."
  }'

Uma resposta de sucesso retorna o identificador da mensagem para você acompanhar o status:

{
  "success": true,
  "data": {
    "message_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending"
  }
}

Enviar mídia

Para enviar uma imagem ou documento, use o endpoint de mídia com a URL pública do arquivo:

curl -X POST https://zapini.app/api/v1/messages/send-media \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "+5511999999999",
    "media_url": "https://exemplo.com/arquivo.jpg",
    "media_type": "image",
    "caption": "Confira nossa novidade"
  }'

Limites de uso

A API aplica limites de requisições para proteger a plataforma. Se você receber respostas de excesso de requisições, espace as chamadas e implemente uma nova tentativa com espera progressiva. A documentação completa dos endpoints está na página pública de documentação da API.