> ## 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 > Nem blokkoló webhook, amely a hívás befejeződésekor érkezik, átirattal, felvétel-URL-lel és mérőszámokkal. Befejezési esemény indul minden hívás befejeződése után — bejövő telefonhívás, kimenő telefonhívás, webes hívás vagy teszthívás (a builder mikrofonos munkamenete). Ez **nem blokkoló**: bármely 2xx válasszal válaszoljon. Az esemény mindkét útvonalon kézbesítésre kerül: * A **[webhook-végpontok](/hu/webhooks/endpoints)** a stabil, alább dokumentált payloadtal fogadják a `telephony.complete` (telefonhívások) vagy `web.complete` (webes hívások és builder mikrofonos teszthívások) eseményt, kézbesítésenkénti `event_id` azonosítóval, 30 másodperces időtúllépéssel és [legfeljebb 24 órán át tartó újrapróbálkozásokkal](/hu/webhooks/overview). * A **[régi, egyetlen URL-es webhook](/api-reference/organizations#legacy-single-url-webhook)** egy szinkron próbálkozást fogad (10 másodperces időtúllépés, újrapróbálkozás nélkül), kissé eltérő payloadtal — lásd: [Régi payload eltérései](#legacy-payload-differences). ## Kérelem payloadja (végponti kézbesítések) ```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" } ``` | Mező | Típus | Leírás | | -------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `call_id` | integer | Stabil az ehhez a híváshoz tartozó minden eseményben | | `direction` | string | `inbound`, `outbound`, `web`, `test`. A korábbi payloadok régi `mic` vagy `widget` értékeket is tartalmazhatnak | | `from_number`, `to_number` | string | E.164. Webes hívások és teszthívások esetén a `from_number` literális értéke `"web"` | | `origin_domain` | string | **Csak web/test esetén** — a widgetet tároló oldal originje (mikrofonos munkamenetek esetén üres) | | `start_time`, `end_time` | timestamp | ISO 8601 UTC | | `duration_seconds` | integer \| null | A kezdési és befejezési időből származtatva | | `status` | string | `completed` vagy `failed` | | `end_reason` | string | Lásd az alábbi táblázatot | | `product`, `voice` | string | A hívás időpontjában érvényes ügynökkonfiguráció | | `transfer_number` | string \| null | A hívás átirányításakor van beállítva | | `recording_url` | string \| null | Lejáró, aláírt URL; töltse le mielőbb. Felvétel nélküli munkameneteknél `null` | | `billable_minutes` | number | Számlázott percek, a legközelebbi negyed percre kerekítve (15 másodperces lépésekben, minimum 0,25). A közvetlenül hangpostára irányuló hívások helyette egységesen 1¢ díjba kerülnek. | | `billing_total_cents` | integer | USD cent | | `transcripts` | array | Fordulónkénti átirat — lásd a következő szakaszt | ### Befejezési okok | Érték | Jelentés | | ------------------ | -------------------------------------------------------------------------------------------------- | | `user_hangup` | A távoli fél bontotta először a hívást | | `ai_hangup` | Az AI szándékosan befejezte a hívást | | `ai_transfer` | Az AI átirányította a hívást; a `transfer_number` be van állítva | | `ai_warm_transfer` | Az AI sikeresen végrehajtott egy meleg (felügyelt) átirányítást | | `voicemail_hangup` | A rendszer hangpostát észlelt, és a hívás az Ön `voicemail_action` beállítása szerint befejeződött | | `max_duration` | A hívás elérte a maximális időtartamkorlátot | | `superseded` | A munkamenetet egy újabb munkamenet váltotta fel | | `unknown` | A befejezési okot nem lehetett meghatározni | ## Átirat formátuma A `transcripts` minden bejegyzése egy beszélgetési forduló. A szerepkörök: `user` (a hívó beszéde), `model` (az ügynök beszéde **és** eszközhívások), `tool` (eszközeredmények) és `system` (hívási események, például nyelvváltások). ```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"] } } } ] ``` | Mező | Típus | Leírás | | ------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `role` | string | `user`, `model`, `tool` vagy `system` | | `content_type` | string | `text/plain` beszédhez; `application/json` eszközhívásokhoz, eszközeredményekhez és rendszereseményekhez | | `content` | string \| object | Beszédszöveg, vagy a fent bemutatott strukturált objektum. Eszközhívások: `{"tool_call": name, "arguments": {…}}`. Eszközeredmények: `{"tool_name": name, "response": {…}}` | | `start_ms`, `end_ms` | integer | Eltolások a hívás kezdetétől, ezredmásodpercben. Akkor szerepel, ha ismert a hang időzítése | | `ttfa_ms` | integer | Az első hangig eltelt idő egy `model` fordulónál, ha mérve van | | `audio_url`, `audio_urls` | string / array | Lejáró, aláírt URL-ek a forduló hanganyagához, ha fordulónként rögzítették | A teljesen strukturált fordulótörténethez (megszakításjelölőkkel, visszajelzéskérő promptokkal és nyers pozíciókkal) használja a [`GET /v1/calls/{call_id}/history`](/api-reference/calls#get-history) végpontot. ## Eltérések a régi payloadban A régi, egyetlen URL-t használó webhook boríték formátuma: `{"type": "telephony.complete" | "web.complete", "data": {…}}`, amely **nem tartalmaz `event_id` értéket**, és a `data` mezője eltér a végpont payloadjától: * A fordulók tömbje a **`history`** alatt található, nem a `transcripts` alatt (a fordulóséma megegyezik a fentivel). * A mezőkészlet a nyers hívásvégi jelentés, és a fenti táblázaton túl további belső mezőket is tartalmazhat — az ismeretlen mezőket tájékoztató jellegűként kezelje. * A webes hívások (`direction: "web"`) **kihagyják** a `from_number` / `to_number` mezőket, és hozzáadják az `origin_domain` mezőt. * A Builder mikrofonteszt-hívások a régi útvonalon `telephony.complete` eseményként jelennek meg (a végpont rendszere ezeket `web.complete` eseményre képezi le). * **Hívásátadási koordináció:** amikor egy hívás átadással ér véget, a régi webhookot szinkron módon hívja meg a rendszer, és az `{"transfer_ready": false}` választ adhatja annak jelzésére, hogy az átadási cél még nem áll készen. Bármely más válasz (vagy régi webhook hiánya) lehetővé teszi az átadás folytatását. A végpontkézbesítéseket ehhez soha nem veszi figyelembe a rendszer. *** ## Példa kezelő ```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 }); }, ); ``` *** ## Gyakori használati esetek Tárolja minden hívás átiratát és felvételi URL-jét az ügyféladatok mellett. Továbbítsa az átiratokat egy folyamatba témamodellezéshez, CSAT-jelek kinyeréséhez vagy átadási arányok monitorozásához. Nyissa meg a hívásokat egy QA-eszközben emberi felülvizsgálathoz, vagy futtassa őket saját értékelési modelljén. Átadás vagy hiba esetén értesítsen egy emberi csapattársat. *** ## Kapcsolódó tartalom A hívás indításakor futó, blokkoló párja. További eseménytípusok, amelyekre feliratkozhat. Ugyanezek az adatok REST-en keresztül is elérhetők visszatöltéshez vagy újrajátszáshoz.