Plays well with everything.

Step 1 of 4

Shopper checks out on Shopify.

An order is placed. Shopify fires an order.created webhook to your Brevux endpoint in real time.

Send a message via REST

# Send a message to a contact
curl -X POST https://api.brevux.com/v1/messages \
  -H "Authorization: Bearer $BREVUX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "cid_abc123",
    "channel": "whatsapp",
    "text": "Hi {first_name}, your order is on its way!"
  }'

# Response
{
  "id": "msg_xyz789",
  "status": "queued",
  "created_at": "2026-05-09T10:00:00Z"
}

Verify an inbound webhook payload

// Verify HMAC-SHA256 signature (Node.js)
import crypto from 'crypto';

function verifyBrevuxWebhook(
  rawBody: Buffer,
  signature: string,
  secret: string,
): boolean {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected),
  );
}

// Sample payload — message.received event
{
  "event": "message.received",
  "workspace_id": "ws_abc",
  "data": {
    "id": "msg_xyz",
    "contact_id": "cid_abc",
    "channel": "whatsapp",
    "text": "Is my order shipped?"
  },
  "timestamp": "2026-05-09T10:01:00Z"
}

Query contacts via GraphQL

# Fetch recent contacts with their conversation status
query RecentContacts($limit: Int = 20) {
  contacts(limit: $limit, orderBy: LAST_MESSAGE_DESC) {
    nodes {
      id
      name
      phone
      email
      lastMessage {
        text
        channel
        receivedAt
      }
      crmRecord {
        stage
        dealValue
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

# Variables
{ "limit": 10 }