API REST

curl https://app.bee-zap.com/api/v1/messages/123 \
  -H "Authorization: Bearer bz_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "messageId": "cmod1828ze00d2bl8sn3kr0w",
  "externalMessageId": "true_5511999999999@c.us_3EB0...",
  "wahaMessageId": "true_5511999999999@c.us_3EB0...",
  "status": "SENT",
  "session": {
    "id": "ckxx...",
    "name": "Zoom Principal",
    "engine": "WAHA",
    "routedReason": "sticky"
  }
}

curl https://app.bee-zap.com/api/v1/messages/cmod1828ze00d2bl8sn3kr0w \
  -H "Authorization: Bearer bz_xxx..."

{
  "id": "cmod1828ze00d2bl8sn3kr0w",
  "chatId": "5511999999999@c.us",
  "direction": "OUTBOUND",
  "status": "READ",
  "externalMessageId": "true_5511...",
  "wahaMessageId": "true_5511...",
  "failReason": null,
  "sentAt": "2026-04-27T13:42:01.123Z",
  "deliveredAt": "2026-04-27T13:42:03.001Z",
  "readAt": "2026-04-27T13:42:30.220Z",
  "createdAt": "2026-04-27T13:42:00.998Z"
}

{
  "contactId": "cmod1828ze00d2bl8sn3kr0w",
  "name": "Maria",
  "whatsappJid": "5511999998888@c.us",
  "phone": "5511999998888",
  "created": true,
  "lead": { "leadId": "cmod...", "stageId": "cmod...", "created": true }
}

curl https://app.bee-zap.com/api/v1/contacts \
  -X POST \
  -H "authorization: Bearer bz_xxx..." \
  -H "content-type: application/json" \
  -d '{"phone":"11999998888","name":"Maria","email":"maria@ex.com","tags":["vip"]}'

curl https://app.bee-zap.com/api/v1/events \
  -X POST \
  -H "authorization: Bearer bz_xxx..." \
  -H "content-type: application/json" \
  -H "idempotency-key: pedido-12345" \
  -d '{
    "name": "compra",
    "value": 199.90,
    "chatId": "5511999998888@c.us",
    "metadata": { "product": "premium" }
  }'

async function sendWhatsApp(phone, text) {
  const res = await fetch(`${process.env.HUB_URL}/api/v1/messages`, {
    method: "POST",
    headers: {
      "content-type": "application/json",
      authorization: `Bearer ${process.env.HUB_API_KEY}`,
      "idempotency-key": `lead-${phone}-${Date.now()}`,
    },
    body: JSON.stringify({
      chatId: `${phone.replace(/\D/g, "")}@c.us`,
      text,
    }),
  });
  if (!res.ok) throw new Error(`hub ${res.status}: ${await res.text()}`);
  return res.json();
}

<?php
function sendWhatsApp(string $phone, string $text): array {
    $payload = [
        'chatId' => preg_replace('/\D/', '', $phone) . '@c.us',
        'text'   => $text,
    ];
    $ch = curl_init(getenv('HUB_URL') . '/api/v1/messages');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'content-type: application/json',
            'authorization: Bearer ' . getenv('HUB_API_KEY'),
            'idempotency-key: lead-' . $phone . '-' . time(),
        ],
        CURLOPT_POSTFIELDS => json_encode($payload),
        CURLOPT_RETURNTRANSFER => true,
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if ($code >= 400) throw new RuntimeException("hub $code: $body");
    return json_decode($body, true);
}

import os, requests, time

def send_whatsapp(phone: str, text: str) -> dict:
    digits = "".join(c for c in phone if c.isdigit())
    res = requests.post(
        f"{os.environ['HUB_URL']}/api/v1/messages",
        headers={
            "authorization": f"Bearer {os.environ['HUB_API_KEY']}",
            "content-type": "application/json",
            "idempotency-key": f"lead-{phone}-{int(time.time())}",
        },
        json={"chatId": f"{digits}@c.us", "text": text},
        timeout=15,
    )
    res.raise_for_status()
    return res.json()