> ## 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. # Динамічна конфігурація для кожного дзвінка > Вибирайте агента або змінюйте промпт для кожного вхідного дзвінка на основі власної логіки у вебхуку. За замовчуванням кожному номеру телефону та публічному ключу призначено статичного агента. Якщо вам потрібне налаштування **для кожного абонента** або **для кожного відвідувача** — VIP-маршрутизація, контекст авторизованого користувача, A/B-тестування промптів — перейдіть у режим вебхуків і дозвольте вашому серверу ухвалювати рішення. ## Як це працює 1. Підпишіть кінцеву точку на подію [`telephony.incoming`](/uk/webhooks/events) (телефон) або [`web.incoming`](/uk/webhooks/events) (віджет). Обидві події є **блокувальними** вебхуками: ThunderPhone очікує до 10 секунд на вашу відповідь, перш ніж продовжити дзвінок. 2. ThunderPhone надсилає вам `{call_id, from_number, to_number}` (сеанси віджета містять поля, специфічні для віджета, замість номерів — див. [схему запиту](/uk/webhooks/call-incoming)). 3. Ваш сервер відповідає конфігурацією агента (промпт, голос, продукт, інструменти). ThunderPhone використовує цю конфігурацію для дзвінка. 4. Якщо ви повернете `{}`, відповідь не надійде вчасно або станеться помилка, як резервний варіант буде використано статично призначеного агента. Безпечне значення за замовчуванням. Працює однаково для телефонних дзвінків (`telephony.incoming`) і сеансів віджета (`web.incoming`), незалежно від того, чи доставляються вони до кінцевої точки вебхука або до застарілого вебхука з єдиною URL-адресою. ## 1. Налаштуйте призначення вебхука Для номерів телефону підпишіть свою кінцеву точку на `telephony.incoming`: ```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"] }' ``` Відповідь містить одноразовий `secret` — збережіть його; він знадобиться для перевірки підпису. Для сеансів віджета створіть публічний ключ у `mode="webhook"` із вбудованою URL-адресою вашої кінцевої точки: ```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"] }' ``` Віджет надсилатиме POST-запит на цю URL-адресу на початку кожного сеансу. ## 2. Реалізуйте обробник Три практичні правила: * **Перевіряйте підпис** у кожному запиті (див. [Перевірка підписів вебхуків](/uk/guides/verify-webhook-signatures)). Не пропускайте це в dev — налаштуйте правильно один раз і повторно використовуйте. * **Відповідайте швидко**. Десять секунд — це жорсткий ліміт, і кожна секунда — тиша для абонента. Виконуйте пошук у базі даних за потреби, але не викликайте нижчестоящі LLM синхронно — якщо потрібне динамічне генерування промптів, попередньо обчислюйте та кешуйте їх. * **Коректно повертайтеся до запасного варіанта**. Будь-який неочікуваний стан має повертати `{}`, щоб виклик обробив статично призначений агент. ```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. Схема відповіді Тіло відповіді точно відповідає [схемі відповіді на вхідний виклик](/uk/webhooks/call-incoming). Поширені поля: | Поле | Тип | Опис | | ----------------------------- | -------------------- | ------------------------------------------------------------------------------------- | | `prompt` | string (обов’язкове) | Системний промпт для агента | | `voice` | string (обов’язкове) | Ідентифікатор голосу з [`GET /v1/voices`](/api-reference/agents#voices) | | `product` | string | За замовчуванням — `spark` | | `background_track` | string \| null | Ідентифікатор фонового аудіо | | `acknowledgement_prompt_mode` | string | `auto` або `manual` (лише Storm-with-ack) | | `acknowledgement_prompt` | string | Обов’язкове, якщо режим — `manual` | | `tools` | array | Вбудовані схеми інструментів функцій — див. [Інструменти функцій](/uk/tools/overview) | Порядок озвучення для окремого виклику та `max_hold_seconds` недоступні у відповіді вебхука. Налаштуйте їх для [агента](/api-reference/agents), на якого ви посилаєтеся. ## Шаблони ### Контекст авторизованого користувача У віджетах у режимі webhook сторінка відвідувача вже знає, ким він є. Викличте свій webhook із параметром рядка запиту, який SDK віджета пересилає (`?customer_id=123`), і знайдіть дані клієнта на сервері. ### A/B-розгортання промптів Перш ніж реалізовувати це вручну, зверніть увагу, що ThunderPhone має нативну функцію [Експерименти](/uk/guides/concepts) (`/dashboard/experiments` і вкладка **A/B** у конструкторі агентів), яка визначає варіанти, розподіляє трафік і порівнює результати для кожного варіанта — webhook не потрібен. Якщо вам усе ж потрібне керування на стороні webhook: хешуйте `call_id` → сегмент; подавайте промпт A для `0..49` і промпт B для `50..99`. Запишіть вибраний сегмент у власну БД, а потім зіставте його з оцінкою завершеного дзвінка. ### Маршрутизація за часом Робочий час → агент «жива підтримка»; поза робочим часом → агент «прийом повідомлень». Просте перемикання за `new Date().getUTCHours()` у вашому обробнику. *** ## Наступні кроки Точні схеми запитів і відповідей, зокрема кожен ключ конфігурації. Один раз правильно налаштуйте HMAC; використовуйте всюди. Поєднайте динамічну маршрутизацію з інструментами для кожного агента. Повторні спроби, порядок, тайм-аути.