ATS hodisalari (webhook)

Har qo'ng'iroq hodisasi (boshlandi, jiringlayapti, javob berildi, tugadi) siz ko'rsatgan manzilga JSON bilan POST qilinadi.

Yoqish

Integratsiyalar → API orqali integratsiya → ATS hodisalari:

1. Xizmatni yoqish ni belgilang.
2. Hodisalar manzili maydoniga o'z serveringiz URLini kiriting (https://example.com/siptell).
3. Saqlang.

Hodisa ko'rinishi

{
  "event": "end",
  "callId": 1532,
  "direction": "inbound",
  "from": "+998901234567",
  "to": "+998712000000",
  "status": "answered",
  "user": "Aziza",
  "scheme": "Asosiy",
  "line": "+998712000000",
  "startedAt": "2026-09-29T10:15:00.000Z",
  "at": "2026-09-29T10:18:12.000Z"
}

Maydon	Izoh
event	start, ring, answer, end.
callId	Qo'ng'iroq raqami.
direction	inbound / outbound.
from, to	Raqamlar.
status	Holat, masalan answered.
user	Xodim ismi.
scheme, line	Sxema nomi va kompaniya raqami.
startedAt, at	Qo'ng'iroq boshi va hodisa vaqti (UTC).

Imzo tekshirish

Tana X-Siptell-Signature sarlavhasida kalit bilan HMAC-SHA256 yordamida imzolanadi. Qabul qiluvchi imzoni o'z hisobi bilan solishtirib, soxta so'rovlarni ajratadi:

import { createHmac, timingSafeEqual } from "node:crypto";

function valid(rawBody, signature, apiKey) {
  const mine = createHmac("sha256", apiKey).update(rawBody).digest("hex");
  const a = Buffer.from(mine);
  const b = Buffer.from(signature);
  return a.length === b.length && timingSafeEqual(a, b);
}

Javob

Tezda 200 qaytaring; og'ir ishlarni orqa fonda bajaring.