> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # telephony.complete / web.complete > Bir arama sona erdiğinde, transkript, kayıt URL'si ve metriklerle birlikte gönderilen engelleyici olmayan webhook. Her çağrı sona erdiğinde bir tamamlama olayı tetiklenir — gelen telefon görüşmesi, giden telefon görüşmesi, web çağrısı veya test çağrısı (oluşturucu mikrofon oturumu). Bu olay **engelleyici değildir**: herhangi bir 2xx ile yanıt verin. Olay her iki yola da iletilir: * **[Webhook uç noktaları](/tr/webhooks/endpoints)**, aşağıda belgelenen kararlı yük, her teslimat için bir `event_id`, 30 sn zaman aşımı ve [24 saate kadar yeniden denemelerle](/tr/webhooks/overview) `telephony.complete` (telefon çağrıları) veya `web.complete` (web çağrıları ve oluşturucu mikrofon test çağrıları) alır. * **[Eski tek URL webhook'u](/api-reference/organizations#legacy-single-url-webhook)** biraz farklı bir yükle tek bir eşzamanlı deneme alır (10 sn zaman aşımı, yeniden deneme yok) — bkz. [Eski yük farklılıkları](#legacy-payload-differences). ## İstek yükü (uç nokta teslimatları) ```json theme={null} { "data": { "billable_minutes": 1.25, "billing_total_cents": 8, "call_id": 987654321, "direction": "inbound", "duration_seconds": 54, "end_reason": "user_hangup", "end_time": "2026-04-20T18:25:04.822Z", "from_number": "+14155550199", "product": "spark", "recording_url": "https://storage.example.com/…", "start_time": "2026-04-20T18:24:10.113Z", "status": "completed", "to_number": "+15551234567", "transcripts": [ /* see Transcript format */ ], "transfer_number": null, "voice": "john" }, "event_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d", "type": "telephony.complete" } ``` | Alan | Tür | Açıklama | | -------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `call_id` | integer | Bu çağrı için her olayda sabittir | | `direction` | string | `inbound`, `outbound`, `web`, `test`. Geçmiş yükler eski `mic` veya `widget` değerlerini içerebilir | | `from_number`, `to_number` | string | E.164. `from_number`, web çağrıları ve test çağrıları için tam olarak `"web"` değeridir | | `origin_domain` | string | **Yalnızca web/test** — widget'ı barındıran sayfanın kaynağı (mikrofon oturumları için boştur) | | `start_time`, `end_time` | timestamp | ISO 8601 UTC | | `duration_seconds` | integer \| null | Başlangıç/bitiş zamanlarından türetilir | | `status` | string | `completed` veya `failed` | | `end_reason` | string | Aşağıdaki tabloya bakın | | `product`, `voice` | string | Çağrı anında geçerli olan ajan yapılandırması | | `transfer_number` | string \| null | Çağrı aktarıldığında ayarlanır | | `recording_url` | string \| null | Süresi dolan imzalı URL; hemen indirin. Kaydı olmayan oturumlar için `null` | | `billable_minutes` | number | Faturalandırılan dakikalar, en yakın çeyrek dakikaya yuvarlanır (15 saniyelik artışlar, en az 0,25). Doğrudan sesli mesaja giden çağrılar bunun yerine sabit 1¢ ücretlendirilir. | | `billing_total_cents` | integer | USD sent | | `transcripts` | array | Tur başına transkript — sonraki bölüme bakın | ### Bitiş nedenleri | Değer | Anlamı | | ------------------ | ------------------------------------------------------------------------------ | | `user_hangup` | Karşı taraf önce kapattı | | `ai_hangup` | Yapay zeka çağrıyı kasıtlı olarak sonlandırdı | | `ai_transfer` | Yapay zeka çağrıyı aktardı; `transfer_number` ayarlanır | | `ai_warm_transfer` | Yapay zeka sıcak (katılımlı) aktarımı tamamladı | | `voicemail_hangup` | Sesli mesaj algılandı ve çağrı `voicemail_action` ayarınıza göre sonlandırıldı | | `max_duration` | Çağrı maksimum süre sınırına ulaştı | | `superseded` | Oturum daha yeni bir oturumla değiştirildi | | `unknown` | Bitiş nedeni belirlenemedi | ## Transkript biçimi `transcripts` içindeki her giriş, tek bir konuşma turudur. Roller `user` (arayanın konuşması), `model` (ajan konuşması **ve** araç çağrıları), `tool` (araç sonuçları) ve `system` (dil değişiklikleri gibi çağrı olayları) şeklindedir. ```json theme={null} [ { "role": "user", "content_type": "text/plain", "content": "Hi, I'm calling about my appointment.", "start_ms": 1200, "end_ms": 4100, "audio_url": "https://storage.example.com/…" }, { "role": "model", "content_type": "text/plain", "content": "Sure, what date works best?", "start_ms": 4200, "end_ms": 6100 }, { "role": "model", "content_type": "application/json", "content": { "tool_call": "search_appointments", "arguments": { "date": "2026-04-21" } } }, { "role": "tool", "content_type": "application/json", "content": { "tool_name": "search_appointments", "response": { "available_slots": ["9:00 AM", "2:00 PM"] } } } ] ``` | Alan | Tür | Açıklama | | ------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `role` | string | `user`, `model`, `tool` veya `system` | | `content_type` | string | Konuşma için `text/plain`; araç çağrıları, araç sonuçları ve sistem olayları için `application/json` | | `content` | string \| object | Konuşma metni veya yukarıda gösterilen yapılandırılmış nesne. Araç çağrıları: `{"tool_call": name, "arguments": {…}}`. Araç sonuçları: `{"tool_name": name, "response": {…}}` | | `start_ms`, `end_ms` | integer | Çağrı başlangıcından itibaren ms cinsinden ofsetler. Ses zamanlaması bilindiğinde bulunur | | `ttfa_ms` | integer | Ölçüldüğünde, bir `model` turu için ilk sese kadar geçen süre | | `audio_url`, `audio_urls` | string / array | Tur bazında kaydedildiğinde, turun sesi için süresi dolan imzalı URL'ler | Tam yapılandırılmış tur geçmişi için (kesinti işaretleri, onay istemleri ve ham konumlar dahil) [`GET /v1/calls/{call_id}/history`](/api-reference/calls#get-history) kullanın. ## Eski yük farkları Eski tek URL'li webhook zarfı `{"type": "telephony.complete" | "web.complete", "data": {…}}` biçimindedir; **`event_id` içermez** ve `data` alanı uç nokta yükünden farklıdır: * Tur dizisi `transcripts` yerine **`history`** altında bulunur (yukarıdakiyle aynı tur şeması). * Alan kümesi ham çağrı sonu raporudur ve yukarıdaki tablonun ötesinde ek dahili alanlar içerebilir — bilinmeyen alanları bilgi amaçlı kabul edin. * Web çağrıları (`direction: "web"`) `from_number` / `to_number` alanlarını **içermez** ve `origin_domain` ekler. * Builder mikrofon test çağrıları, eski yolda `telephony.complete` olarak raporlanır (uç nokta sistemi bunları `web.complete` olarak eşler). * **Aktarım koordinasyonu:** Bir çağrı aktarımla sona erdiğinde, eski webhook eşzamanlı olarak çağrılır ve aktarım hedefinin henüz hazır olmadığını belirtmek için `{"transfer_ready": false}` yanıtını verebilir. Diğer tüm yanıtlar (veya eski webhook bulunmaması), aktarımın devam etmesine izin verir. Uç nokta teslimatları bunun için hiçbir zaman dikkate alınmaz. *** ## Örnek işleyici ```python Python (FastAPI) theme={null} import hashlib import hmac import json import os from fastapi import FastAPI, HTTPException, Request app = FastAPI() SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"] def verify(body: bytes, signature: str) -> bool: expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, signature or "") @app.post("/thunderphone-webhook") async def webhook(request: Request): body = await request.body() if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")): raise HTTPException(status_code=401) event = json.loads(body) if event["type"] in ("telephony.complete", "web.complete"): data = event["data"] # Endpoint deliveries use "transcripts"; the legacy webhook uses "history". turns = data.get("transcripts") or data.get("history") or [] await persist_call_record( call_id=data["call_id"], turns=turns, recording_url=data.get("recording_url"), ) if data["end_reason"] in ("ai_transfer", "ai_warm_transfer"): await notify_team(data.get("transfer_number"), data["call_id"]) return {"ok": True} ``` ```javascript Node.js (Express) theme={null} import crypto from "node:crypto"; import express from "express"; const app = express(); const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET; function verify(body, signature) { const expected = crypto.createHmac("sha256", SECRET).update(body).digest("hex"); return signature && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature)); } app.post( "/thunderphone-webhook", express.raw({ type: "application/json" }), async (req, res) => { if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) { return res.sendStatus(401); } const event = JSON.parse(req.body.toString("utf8")); if (["telephony.complete", "web.complete"].includes(event.type)) { const data = event.data; // Endpoint deliveries use "transcripts"; the legacy webhook uses "history". const turns = data.transcripts ?? data.history ?? []; await persistCallRecord({ ...data, turns }); if (["ai_transfer", "ai_warm_transfer"].includes(data.end_reason)) { await notifyTeam(data.transfer_number, data.call_id); } } res.json({ ok: true }); }, ); ``` *** ## Yaygın kullanım alanları Her aramanın transkriptini ve kayıt URL'sini müşteri kayıtlarınızla birlikte saklayın. Konu modelleme, CSAT sinyali çıkarma veya aktarma oranı izleme için transkriptleri bir işlem hattına aktarın. Aramaları insan incelemesi için bir QA aracında açın veya kendi değerlendirme modelinizden geçirin. Aktarma / başarısızlık durumunda bir ekip arkadaşınızı tetikleyin. *** ## İlgili içerikler Arama başlangıcında çalışan engelleyici karşılığı. Abone olabileceğiniz diğer olay türleri. Geri doldurma / yeniden oynatma için REST üzerinden erişilebilen aynı veriler.