Pular para o conteúdo principal
Version: 1.0.0

WapiHub - WhatsApp Cloud API

A API WapiHub permite enviar mensagens via WhatsApp, gerenciar templates de mensagem e configurar webhooks para receber notificações de eventos em tempo real.

Getting Started​

Base URL​

https://{host}/api/v1

Pré-requisitos​

  • Conta ativa na plataforma WapiHub
  • Token de API gerado no painel administrativo
  • Número de telefone (Phone Number ID) configurado na conta

Passo a passo​

  1. Acesse o painel em Minha Conta > Configurações > API
  2. Clique em Gerar Token (ou Regenerar Token se já possuir um)
  3. Copie o token exibido — ele será mostrado apenas uma vez e não poderá ser recuperado depois
  4. Inclua o token no header de todas as requisições: 
    Authorization: Bearer \{seu_token\}
  5. Envie sua primeira mensagem:
curl -X POST https://app.wapihub.com.br/api/v1/messages/send \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "110123456789",
    "to": "5511999999999",
    "type": "text",
    "content": "Olá! Esta é minha primeira mensagem via API."
  }'

Autenticação​

A API utiliza autenticação via Bearer Token no header Authorization.

Authorization: Bearer {seu_token}

Como funciona​

  • O token é gerado no painel administrativo e exibido uma única vez no momento da criação
  • Internamente, o token é armazenado como hash SHA-256 — o valor original nunca é salvo em texto puro
  • Cada requisição é validada comparando o hash do token enviado com o hash armazenado
  • O token identifica a empresa e autentica automaticamente o usuário associado

Erros de autenticação​

Token ausente — quando o header Authorization não é enviado:

{
  "success": false,
  "error": {
    "message": "Token de autenticação não fornecido",
    "code": "TOKEN_MISSING"
  }
}

Token inválido ou empresa inativa — quando o token não corresponde a nenhuma empresa ativa:

{
  "success": false,
  "error": {
    "message": "Token inválido ou empresa inativa",
    "code": "TOKEN_INVALID"
  }
}

Ambas as respostas retornam HTTP status 401 Unauthorized.

Regeneração de token​

Ao regenerar o token no painel, o token anterior é imediatamente invalidado. Todas as integrações que utilizam o token antigo deixarão de funcionar e precisarão ser atualizadas com o novo token.

Rate Limiting​

  • Mensagens: throttle wca-messages
  • Templates: throttle wca-templates

Formato de Resposta​

Todas as respostas seguem o formato:

{
  "success": true|false,
  "data": { ... },
  "message": "opcional"
}

Em caso de erro:

{
  "success": false,
  "error": {
    "message": "Descrição do erro",
    "code": "ERROR_CODE"
  }
}

Authentication​

Token da API gerado no painel administrativo. Enviado como Bearer token no header Authorization. O token é validado via SHA-256 contra o registro da empresa.

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Contact

WapiHub: