Webhook olayları

Genel bakışBölüm bağlantısını kopyala

Uç noktaları panelde sahip ve yönetici rolündeki üyeler ekler ve her uç nokta için hangi olayların gönderileceğini seçer.

• 52 olay, 8 grup.
• Teslimat en az bir kez yapılır: aynı olay birden fazla gelebilir, Speakline-Event-Id ile tekilleştirin.
• Adres https olmalıdır; yönlendirmeler izlenmez.

İstekBölüm bağlantısını kopyala

Teslimatın başarılı sayılması için uç noktanın 5 saniye içinde 2xx yanıt vermesi gerekir.

POST /speakline-webhook HTTP/1.1
Content-Type: application/json
User-Agent: Speakline-Webhooks/1.0
Speakline-Event-Type: lead.created
Speakline-Event-Id: 0f6a2c4e-8b1d-4e3f-9a5c-7d2e1b0f4c6a
Speakline-Delivery-Id: 3c9d2b7e-41f0-4a8e-b6d5-9e2c7a1f0b84
Speakline-Signature: t=1793572520,v1=5f2c…

Olay zarfıBölüm bağlantısını kopyala

Gövde, her olayda aynı alanlara sahip bir JSON zarfıdır; olaya özgü alanlar payload içindedir.

{
  "event_id": "0f6a2c4e-8b1d-4e3f-9a5c-7d2e1b0f4c6a",
  "event_type": "lead.created",
  "schema_version": 1,
  "stream": "leads",
  "company_id": "7a3e5c1b-9d2f-4b8a-a6e4-c0f2d8b6a4e2",
  "occurred_at": "2026-10-23T14:02:11.482000+00:00",
  "context": { "lead_id": "5e1d9a3c-7b2f-4c8e-9a61-3f0b2d4c6e81" },
  "payload": {
    "id": "5e1d9a3c-7b2f-4c8e-9a61-3f0b2d4c6e81",
    "full_name": "Emma Clarke",
    "phone": "+442079460344",
    "email": "emma@example.com",
    "source": "inbound_voice",
    "status": "new",
    "language": "en",
    "created_at": "2026-10-23T14:02:11.482000+00:00"
  }
}

İmza doğrulamaBölüm bağlantısını kopyala

Speakline-Signature başlığı t (Unix zaman damgası) ve v1 (imza) değerlerini taşır. İmza; t değeri, bir nokta ve isteğin ham gövdesi birleştirilerek uç noktanın gizli anahtarıyla HMAC-SHA256 ile hesaplanır ve onaltılık yazılır. Her denemede yeni bir zaman damgasıyla yeniden imzalanır.

• İmzayı JSON'u ayrıştırmadan önce, ham gövde üzerinden doğrulayın.
• Karşılaştırmayı sabit sürede yapın.
• 300 saniyeden eski istekleri reddetmenizi öneririz.
• Gizli anahtar whsec_ ile başlar ve yalnız oluşturulduğunda ya da yenilendiğinde bir kez gösterilir; yenilendiğinde eski anahtar hemen geçersiz olur.

import crypto from "node:crypto";

// rawBody: the request body exactly as received (string or Buffer), before JSON.parse.
export function verifySpeaklineSignature(rawBody, header, secret, toleranceSeconds = 300) {
  const parts = Object.fromEntries(header.split(",").map((part) => part.split("=")));
  const timestamp = Number(parts.t);
  if (!timestamp || Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;

  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${parts.t}.${rawBody}`)
    .digest();
  const received = Buffer.from(parts.v1 ?? "", "hex");
  return received.length === expected.length && crypto.timingSafeEqual(received, expected);
}

Yeniden denemeBölüm bağlantısını kopyala

2xx dışındaki yanıtlar, zaman aşımı ve bağlantı hataları başarısız sayılır ve teslimat aşağıdaki aralıklarla yeniden denenir.

Altı denemenin tamamı başarısız olursa teslimat tükendi olarak işaretlenir. Uç nokta kapatılmaz; çalışma alanının sahip ve yöneticilerine bildirim gider (her uç nokta için günde en fazla bir kez). Panelde teslimat geçmişinden bir teslimatı yeniden gönderebilirsiniz.

Olay filtresiBölüm bağlantısını kopyala

Her uç nokta için gönderilecek olaylar glob kalıplarıyla seçilir. Varsayılan * tüm olaylardır; boş liste hiçbir olay göndermez. Her kalıp en az bir olayla eşleşmelidir.

Olay kataloğuBölüm bağlantısını kopyala

Çağrı merkeziBölüm bağlantısını kopyala

AramalarBölüm bağlantısını kopyala

Sesli mesajlarBölüm bağlantısını kopyala

MesajlaşmaBölüm bağlantısını kopyala

Müşteri adaylarıBölüm bağlantısını kopyala

KampanyalarBölüm bağlantısını kopyala

RandevularBölüm bağlantısını kopyala

Etkinlik kaydıBölüm bağlantısını kopyala