Reach thousands.
Answer every one.

# Send one personalised message from an API campaign
curl -X POST https://api.petasos.id/v1/campaigns/$CAMPAIGN_ID/messages \
  -H "X-API-Key: $PETASOS_API_KEY" \
  -H "Idempotency-Key: order-10482-shipped" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+628123456789",
    "variables": { "name": "Andi", "order": "#10482", "resi": "JNE8812" }
  }'

HTTP/1.1 201 Created
X-Request-Id: 7c1e…  X-RateLimit-Remaining: 299
{
  "success": true,
  "data": { "trace_id": "KOP-3f9a2c1e-…", "status": "queued" }
}

# Look a message up by its trace ID
curl https://api.petasos.id/v1/messages/KOP-3f9a2c1e-… \
  -H "X-API-Key: $PETASOS_API_KEY"

HTTP/1.1 200 OK
{
  "success": true,
  "data": {
    "trace_id": "KOP-3f9a2c1e-…",
    "status": "read",
    "queued_at": "2026-10-09T03:00:02Z",
    "sent_at": "2026-10-09T03:00:05Z",
    "delivered_at": "2026-10-09T03:00:09Z",
    "read_at": "2026-10-09T03:06:41Z",
    "failed_reason": null
  }
}

// Verify a status webhook (Node.js / Express)
import crypto from 'node:crypto'

app.post('/petasos/webhook', express.raw({ type: '*/*' }), (req, res) => {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', process.env.PETASOS_WEBHOOK_SECRET)
    .update(req.body).digest('hex')
  const got = req.get('X-Petasos-Signature') ?? ''
  if (got.length !== expected.length ||
      !crypto.timingSafeEqual(Buffer.from(got), Buffer.from(expected)))
    return res.sendStatus(401)

  const { trace_id, status } = JSON.parse(req.body)
  res.sendStatus(200)  // "read", "delivered", "failed", …
})

POST /petasos/webhook
X-Petasos-Event: message.status_changed
X-Petasos-Signature: sha256=9b74c9…
{ "trace_id": "KOP-3f9a2c1e-…", "status": "delivered", … }

# Reply into an open Iris conversation from your own tools
curl -X POST https://iris-api.petasos.id/v1/rooms/$ROOM_ID/messages \
  -H "X-API-Key: $IRIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Pesanan kakak sudah dikirim hari ini 🚚" }'

HTTP/1.1 201 Created
{
  "success": true,
  "data": { "direction": "outbound", "status": "sent", "body": "Pesanan kakak sudah…", … }
}