> ## 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. # Çağrı başına dinamik yapılandırma > Bir webhook içindeki özel mantığa göre her gelen çağrı için bir ajan seçin veya bir istemi yeniden yazın. Varsayılan olarak her telefon numarasına ve yayımlanabilir anahtara statik bir ajan atanır. **Arayan bazında** veya **ziyaretçi bazında** özelleştirme gerektiğinde — VIP yönlendirme, oturum açmış kullanıcı bağlamı, A/B istem testleri — webhook moduna geçin ve karar vermeyi sunucunuza bırakın. ## Nasıl çalışır 1. [`telephony.incoming`](/tr/webhooks/events) (telefon) veya [`web.incoming`](/tr/webhooks/events) (widget) etkinliğine abone olun. Her ikisi de **engelleyici** webhook'lardır: ThunderPhone, aramaya devam etmeden önce yanıtınızı en fazla 10 saniye bekler. 2. ThunderPhone size `{call_id, from_number, to_number}` gönderir (widget oturumları numaralar yerine widget'a özgü alanlar içerir — bkz. [istek şeması](/tr/webhooks/call-incoming)). 3. Sunucunuz bir ajan yapılandırmasıyla yanıt verir (istem, ses, ürün, araçlar). ThunderPhone bu yapılandırmayı arama için kullanır. 4. `{}` döndürürseniz, zaman aşımı oluşursa veya hata meydana gelirse, statik olarak atanmış ajan yedek olarak kullanılır. Güvenli varsayılan. İster bir webhook uç noktasına ister eski tek URL'li webhook'a teslim edilsin, telefon aramaları (`telephony.incoming`) ve widget oturumları (`web.incoming`) için aynı şekilde çalışır. ## 1. Webhook hedefini yapılandırın Telefon numaraları için uç noktanızı `telephony.incoming` etkinliğine abone edin: ```bash theme={null} curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "label": "Prod call-incoming", "url": "https://example.com/thunderphone/incoming", "events": ["telephony.incoming"] }' ``` Yanıt, tek kullanımlık bir `secret` içerir — kaydedin; bunu imza doğrulaması için kullanacaksınız. Widget oturumları için uç nokta URL'niz yerleşik olacak şekilde `mode="webhook"` içinde bir yayımlanabilir anahtar oluşturun: ```bash theme={null} curl -X POST https://api.thunderphone.com/v1/publishable-key \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Dynamic widget", "mode": "webhook", "webhook_url": "https://example.com/thunderphone/widget-incoming", "allowed_domains": ["example.com"] }' ``` Widget, her oturum başlangıcında bu URL'ye POST isteği gönderir. ## 2. İşleyiciyi uygulayın Üç temel kural: * Her istekte **imzayı doğrulayın** ([webhook imzalarını doğrulama](/tr/guides/verify-webhook-signatures) bölümüne bakın). Bunu geliştirme ortamında atlamayın — bir kez doğru yapın ve yeniden kullanın. * **Hızlı yanıt verin**. On saniye kesin sınırdır ve her saniye arayan için sessizliktir. Gerekiyorsa veritabanı sorguları yapın, ancak alt seviye LLM'leri eşzamanlı olarak çağırmayın — dinamik istem oluşturmak istiyorsanız önceden hesaplayın ve önbelleğe alın. * **Temiz bir şekilde geri dönün**. Beklenmeyen her durum, statik olarak atanan ajanın çağrıyı işlemesi için `{}` döndürmelidir. ```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, sig: str) -> bool: expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, sig or "") @app.post("/thunderphone/incoming") async def incoming(request: Request): body = await request.body() if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")): raise HTTPException(401) event = json.loads(body) if event["type"] not in ("telephony.incoming", "web.incoming"): return {} # fall back to default caller = event["data"]["from_number"] # Cheap DB lookup: is this a known VIP? customer = lookup_customer(caller) if customer and customer.tier == "vip": return { "prompt": f"You are a VIP concierge for {customer.name}. Be proactive…", "voice": "john", "product": "storm-base", } return {} # default agent handles non-VIPs def lookup_customer(phone: str): # ... your CRM integration ... pass ``` ```javascript 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, sig) { const expected = crypto.createHmac("sha256", SECRET).update(body).digest("hex"); return sig && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig)); } app.post( "/thunderphone/incoming", 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")); const IMPORTANT_TYPES = new Set([ "telephony.incoming", "web.incoming", ]); if (!IMPORTANT_TYPES.has(event.type)) return res.json({}); const customer = await lookupCustomer(event.data.from_number); if (customer?.tier === "vip") { return res.json({ prompt: `You are a VIP concierge for ${customer.name}. Be proactive…`, voice: "john", product: "storm-base", }); } res.json({}); // fall back to default agent }, ); ``` ## 3. Yanıt şeması Yanıt gövdesi, [gelen çağrı yanıt şemasıyla](/tr/webhooks/call-incoming) tam olarak eşleşir. Sık kullanılan alanlar: | Alan | Tür | Açıklama | | ----------------------------- | ---------------- | ------------------------------------------------------------------------------------ | | `prompt` | string (zorunlu) | Ajan için sistem istemi | | `voice` | string (zorunlu) | [`GET /v1/voices`](/api-reference/agents#voices) kaynağındaki ses kimliği | | `product` | string | Varsayılan değer `spark` | | `background_track` | string \| null | Ortam sesi kimliği | | `acknowledgement_prompt_mode` | string | `auto` veya `manual` (yalnızca onaylı Storm) | | `acknowledgement_prompt` | string | Mod `manual` olduğunda zorunludur | | `tools` | array | Satır içi işlev aracı şemaları — [İşlev Araçları](/tr/tools/overview) bölümüne bakın | Çağrı başına konuşma sırası ve `max_hold_seconds`, webhook yanıtında kullanılamaz. Bunları başvurduğunuz [Ajan](/api-reference/agents) üzerinde ayarlayın. ## Kalıplar ### Oturum açmış kullanıcı bağlamı Webhook modundaki widget'larda ziyaretçinin sayfası, kim olduğunu zaten bilir. Widget SDK'sının ilettiği bir sorgu dizesi parametresiyle (`?customer_id=123`) webhook'unuzu çağırın ve müşteriyi sunucu tarafında bulun. ### A/B istemi kullanıma sunma Bunu kendiniz geliştirmeden önce, ThunderPhone'un varyantları tanımlayan, trafiği bölen ve varyant başına sonuçları karşılaştıran yerel bir [Deneyler](/tr/guides/concepts) özelliği (`/dashboard/experiments` ve ajan oluşturucunun **A/B** sekmesi) olduğunu unutmayın — webhook gerekmez. Yine de webhook tarafında kontrol gerekiyorsa: `call_id` değerini hash'leyin → kovaya ayırın; `0..49` için A istemini, `50..99` için B istemini sunun. Seçtiğiniz kovayı kendi veritabanınıza kaydedin ve daha sonra tamamlanan çağrının notuyla ilişkilendirin. ### Zamana dayalı yönlendirme Mesai saatleri → "canlı destek" ajanı; mesai dışı → "mesaj alın" ajanı. İşleyicinizde `new Date().getUTCHours()` üzerinde basit bir geçiş yeterlidir. *** ## Sonraki adımlar Her yapılandırma anahtarı dahil olmak üzere tam istek ve yanıt şemaları. HMAC'i bir kez doğru uygulayın; her yerde yeniden kullanın. Dinamik yönlendirmeyi ajan başına araçlarla birleştirin. Yeniden denemeler, sıralama, zaman aşımları.