Envie WhatsApp via API de Integração

Autenticação

Autentique usando a Local API Key no corpo da requisição (campo `api_key`), não no cabeçalho HTTP. Cada empresa tem 1 Local API Key (UUID) que é gerada automaticamente quando a empresa é criada.

Como obter a Local API Key

1. Faça login no painel cshub em /app.
2. Abra o menu Configurações → API Key (ou Perfil → Integração).
3. Copie a Local API Key. Pode regenerar a qualquer momento (a antiga se torna inválida imediatamente).

Endpoint

Um endpoint para todos os tipos de mensagens WhatsApp Não Oficiais (whatsmeow). Escolha o método = text para mensagens livres, ou método = template para mensagens de um template já criado no painel.

Campo corpo

Corpo da requisição no formato JSON. Os campos abaixo têm paridade com o whatscrmhub Laravel — se você estiver migrando de uma versão antiga, a forma da requisição é idêntica.

Exemplo de requisição

1. Enviar mensagem de texto simples

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "text",
    "text": "Halo, makasih udah order ya!"
  }'

2. Enviar mensagem de template com substituição de variáveis

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "6281234567890",
    "method": "template",
    "template": "<TEMPLATE_ID>",
    "variables": {
      "$name": "Pak Budi",
      "$order_id": "INV-20260602-001"
    }
  }'

3. Enviar para grupo (usando JID de grupo)

curl -X POST "https://api.cshub.id/api/v1/integration/whatsapp/send-message" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "<LOCAL_API_KEY>",
    "device_key": "<DEVICE_ID>",
    "phone": "120363012345678901@g.us",
    "method": "text",
    "text": "Pengumuman: order minggu ini ditutup pukul 17:00.",
    "is_group": true
  }'

Resposta de sucesso (200 OK)

{
  "status": true,
  "message": "berhasil mengirim pesan"
}

Código de erro & solução

Notas & limitações

• Há um limite daily_send por dispositivo. Evite enviar mais de 10 mensagens/segundo de um único dispositivo para evitar bloqueio do WhatsApp.
• Se as configurações da sua empresa definirem `api_device_use = required`, o campo `device_key` É OBRIGATÓRIO. Se definido como opcional, o servidor escolherá automaticamente um dispositivo ativo de acordo com a estratégia (`sequence` / `spin` / `random` nas configurações `whatsapp_sender_notif`).
• Substitua variáveis usando literal `str_replace` — o placeholder pode ser qualquer string (ex. `$name`, `{name}`, `[NAME]`). O importante é que seja exatamente igual ao que está na mensagem template.
• Sempre no formato sem "+" e sem espaços/tracos. Exemplo: 6281234567890 (Indonésia), 60123456789 (Malásia). Para grupos: use o JID completo com o sufixo `@g.us`.
• Iteração MVP: ainda não suporta upload de arquivo binário via multipart/form-data. Para enviar mídia, use method=template com um template que já tenha a imagem configurada no painel.

Integration API vs Internal Panel API

cshub possui dois caminhos para enviar mensagens que foram intencionalmente separados. A Integration API é para desenvolvedores de terceiros / automação; a Internal API é para o painel web + aplicativo móvel cshub. Público diferente, autenticação diferente, forma de resposta diferente.