Call data, in your own systems

Authorization: Bearer agos_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-API-Key: agos_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl -s "https://api.agenticos.tech/api/public/v1/voice/calls?since=2026-10-01T00:00:00%2B07:00&limit=50" \
  -H "Authorization: Bearer $AGENTICOS_API_KEY"

{
  "data": [ { …call (section 6)… }, { … } ],
  "next_cursor": "WyIyMDI2LTEwLTA5VDA5OjI5OjIzIiwgIjEzMTVmODQzLi4uIl0="
}

curl -s "https://api.agenticos.tech/api/public/v1/voice/calls/1315f843-00df-4350-9d72-a29c0cdbd8f1" \
  -H "X-API-Key: $AGENTICOS_API_KEY"

{
  …call fields…,
  "transcript": [
    { "seq": 1, "who": "agent",    "at": "00:00", "text": "สวัสดีค่ะ ศูนย์บริการลูกค้า ยินดีให้บริการค่ะ" },
    { "seq": 2, "who": "customer", "at": "00:06", "text": "อยากได้กล่องลูกฟูกใส่ขนมครับ" }
  ],
  "recording_url": "https://…/call-1315f843….wav?X-Amz-…"
}

{
  "id": "1315f843-00df-4350-9d72-a29c0cdbd8f1",
  "direction": "inbound",
  "channel": "phone",
  "mode": "ai",
  "status": "completed",
  "phone": "0812345678",
  "caller": "0812345678",
  "agent": { "id": "eea31038-5836-4bd5-a941-bd98f5b86a2a", "name": "ศูนย์บริการลูกค้า (AI)" },
  "started_at": "2026-10-09T09:29:23.392000+00:00",
  "duration_sec": 95,
  "urgent": false,
  "summary": {
    "text": "ลูกค้าสอบถามกล่องลูกฟูกสำหรับใส่ขนม ประมาณ 5,000 ใบต่อเดือน และขอให้ฝ่ายขายติดต่อกลับ",
    "key_points": ["กล่องลูกฟูกใส่ขนม", "5,000 ใบต่อเดือน"],
    "outcome": "ส่งต่อฝ่ายขายกล่องลูกฟูก",
    "next_action": "ฝ่ายขายโทรกลับพร้อมใบเสนอราคา",
    "sentiment": "positive",
    "emotion": "สนใจ",
    "needs_human": false,
    "urgent_reason": ""
  },
  "collected": {
    "intent": "สอบถามสินค้า/ขอใบเสนอราคา",
    "customer_name": "สมชาย",
    "company": "เอบีซีฟู้ด",
    "callback_phone": "0812345678"
  },
  "topics": ["สอบถามราคา"],
  "tags": [],
  "has_recording": true,
  "app_url": "https://app.agenticos.tech/apps/voice-agent/calls/1315f843-00df-4350-9d72-a29c0cdbd8f1"
}

POST https://your-server.example.com/agenticos/webhook
Content-Type: application/json
User-Agent: AgenticOS-Webhook/1.0
X-AgenticOS-Event: call.ended
X-AgenticOS-Delivery: 7b0c2b1e-4f7d-4a63-9d0e-2f4b8e1c9a10
X-AgenticOS-Signature: t=1760001234,v1=5f2b…c9

{
  "id": "7b0c2b1e-4f7d-4a63-9d0e-2f4b8e1c9a10",
  "event": "call.ended",
  "created_at": "2026-10-09T09:31:02.118000+00:00",
  "organization_id": "7dc951c1-9cbc-4571-b56a-cd2bd7979f44",
  "data": { … }
}

"data": {
  "live_id": "9eea211e4a484e3aaf416cf58fd96c8e",
  "direction": "inbound",
  "channel": "phone",
  "phone": "0812345678",
  "agent": { "id": "eea31038-…", "name": "ศูนย์บริการลูกค้า (AI)" },
  "started_at": "2026-10-09T09:29:23.392Z"
}

"data": {
  "live_id": "9eea211e4a484e3aaf416cf58fd96c8e",
  "channel": "phone",
  "phone": "0812345678",
  "agent": { "id": "eea31038-…", "name": "ศูนย์บริการลูกค้า (AI)" }
}

"data": {
  "call": {
    …every field in section 6…,
    "transcript": [ { "seq": 1, "who": "agent", "at": "00:00", "text": "…" } ]
  }
}

import crypto from "node:crypto";
import express from "express";

const app = express();
const SECRET = process.env.AGENTICOS_WEBHOOK_SECRET; // whsec_...

// Read the RAW body — the signature is over the exact bytes we sent.
app.post("/agenticos/webhook", express.raw({ type: "application/json" }), (req, res) => {
  const header = req.get("X-AgenticOS-Signature") || "";          // t=1760000000,v1=ab12...
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const expected = crypto.createHmac("sha256", SECRET)
    .update(`${parts.t}.${req.body}`)
    .digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;   // 5 min, against replays
  const ok = fresh && typeof parts.v1 === "string" && parts.v1.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
  if (!ok) return res.status(401).end();

  const event = JSON.parse(req.body);
  // event.id is unique per delivery — store it and skip repeats (retries).
  if (event.event === "call.ended") {
    const call = event.data.call;
    console.log(call.phone, call.summary.text, call.collected);
  }
  res.status(200).end();   // answer fast; do slow work in a queue
});

app.listen(3000);

import hashlib, hmac, json, os, time
from flask import Flask, abort, request

app = Flask(__name__)
SECRET = os.environ["AGENTICOS_WEBHOOK_SECRET"].encode()  # whsec_...

@app.post("/agenticos/webhook")
def agenticos_webhook():
    raw = request.get_data()                      # exact bytes, before parsing
    parts = dict(p.split("=", 1) for p in request.headers.get("X-AgenticOS-Signature", "").split(",") if "=" in p)
    t = parts.get("t", "")
    expected = hmac.new(SECRET, f"{t}.".encode() + raw, hashlib.sha256).hexdigest()
    if not t.isdigit() or abs(time.time() - int(t)) > 300 or not hmac.compare_digest(expected, parts.get("v1", "")):
        abort(401)
    event = json.loads(raw)
    if event["event"] == "call.ended":
        call = event["data"]["call"]
        print(call["phone"], call["summary"]["text"], call["collected"])
    return "", 200