Műveletek és eszközök

Az Actions lapon kezelheted mindazt, amit az ügynököd a beszélgetésen túl tehet — eszközöket, amelyeket az ügynök egy élő beszélgetés közben hív, prefetch-hookokat, amelyek a hívás megkezdése előtt futnak, és hívás utáni műveleteket, amelyek a hívás befejezésekor sülnek el. A kinyert változók (azok az adatmezők, amelyeket az ügynök minden beszélgetésből kinyer) ugyanezen a lapon találhatók.

Minden csomag

Minden eszköz, művelet és az új előzetes lekérési hook minden csomagon elérhető, beleértve a Free csomagot is.

A három fázis

Az Actions lap minden bejegyzése a három életciklus-fázis egyikéhez tartozik. Az Add Tool legördülő menü úgy csoportosítja őket, hogy egyértelmű legyen, mikor mi sül el:

Fázis	Mikor	Példák
Pre fetch	Mielőtt az ügynök köszön	Hívó kikeresése a CRM-ből telefonszám alapján, legfrissebb rendelés lekérése, személyre szabott üdvözlés lekérése a backendről
Live call	A beszélgetés közben, az AI által, amikor itt az ideje	Hívás átadása embernek, naptári elérhetőség ellenőrzése, átadás másik ügynöknek, külső API lekérdezése adatokért
Post call	A hívás után	Összefoglaló e-mail küldése, SMS-megerősítés indítása, hívás-csomag továbbítása a CRM-be

A legördülő menü a Pre fetch opcióval nyílik a tetején, mert minden más fázisnak már így is sok opciója van — az új pre-fetch bejegyzés a legvalószínűbb, amit keresel.

Pre fetch

A pre-fetch hookok lehetővé teszik, hogy az ügynököd úgy kezdje meg a hívást, hogy már tudja, ki hív. Párhuzamosan futnak a hívás-felépítéssel, és a választ az ügynök rendszer-promptjába injektálják, mielőtt az első szó is elhangzana.

Mikor használd

Visszatérő ügyfél felismerése telefonszám alapján és név szerinti üdvözlése
A hívó nyitott rendelésének, utolsó időpontjának vagy tagsági szintjének lekérése
Üzleti kontextus előtöltése a hívott vonaltól függően
CRM-jegyzetek injektálása, hogy az ügynök ismerje a lead állapotát és előzményeit

Hogyan működik

A platform feloldja a hívó telefonszámát (SIP-ből bejövő, illetve a hívási célból kimenő hívás esetén).
Minden aktív Pre fetch művelet párhuzamosan elsül, kemény 1,5 másodperces kérésenkénti időtúllépéssel és 2 másodperces teljes kerettel.
A sikeres válaszok az ügynök rendszer-promptjába kerülnek elnevezett blokkokként — az ügynök az első körében olvassa őket.
A hibák csendben vannak elnyelve — lassú vagy hibás végpont sosem blokkolja az üdvözlést. Az ügynök csak elkezd beszélni az adott blokk nélkül.

Konfiguráció

Mező	Leírás
Név	Kötelező. Belső címke és a blokk neve a promptban — tartsd röviden és leíró jelleggel (pl. `crm_lookup`, `vip_check`).
API URL	Kötelező. Lekérendő végpont. Támogatja a `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}` helyettesítőket.
HTTP-metódus	A `GET` az alapértelmezett és legjobb illeszkedés. A `POST` / `PUT` / `PATCH` / `DELETE` is működik.
Fejlécek	Opcionális. Statikus vagy sablonozott (a helyettesítők itt is működnek).
Query paraméterek	Opcionális. Új pre-fetch művelet esetén `phone={phone}` értékkel előtöltve.

Elérhető változók

Ezeket a tokeneket helyettesíti be az URL-be, fejlécekbe és query/body paraméterekbe a kérés időpontjában:

Változó	Forrás	Példa-érték
`{phone}`	A hívó telefonszáma (E.164) — kimenő esetén a célszám	`+431234567890`
`{direction}`	`inbound` vagy `outbound`	`inbound`
`{agent_id}`	Belső ügynök-azonosító	`65f1a2b3c4...`
`{user_id}`	Munkaterület-tulajdonos azonosítója	`65e0b1c2d3...`
`{call_id}`	Hívás-azonosító (lehetővé teszi a backend számára a későbbi hívás utáni payload korrelálását)	`65f1f2c4d5...`

Az ismeretlen helyettesítők szó szerint maradnak — a hibás sablonozás soha nem zúzza össze a hívást.

Mi kerül a promptba

Ha a https://crm.example.com/lookup?phone={phone} címen lévő végpontod ezt adja vissza:

{ "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }

Az ügynök rendszer-promptjához hozzáfűződik egy XML-be csomagolt blokk, amely a műveletről van elnevezve:

<call_context>
  <block name="crm_lookup">
  { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }
  </block>
</call_context>

Nem kell megmondanod az ügynöknek, hogyan használja — az LLM természetesen felveszi a kontextust. Opcionálisan említsd meg a pre-fetch-et a rendszer-promptodban: „Ha a <call_context> tartalmaz ügyfélnevet, üdvözöld őt név szerint."

Fontos korlátok

Csak telefonhívások. A pre-fetch nem fut widget- (web-) hívásokhoz — nincs telefonszám, amire sablonozni lehetne.
8 KB-os felső határ a válasz törzsére — az ennél hosszabb tartalom levágódik az injektálás előtt. A felső határ védi a prompt-token-büdzsédet és határt szab egy rosszindulatú végpont hatókörének.
Nincs condition kiértékelés — a pre-fetch mindig elsül, amikor aktív. Még nincs átirat, amihez viszonyítani lehetne.

tanács

Használj GET-et egy telefon-kulcsú lekérési végponttal. Tartsd a válaszokat kicsinek és strukturáltnak (3-5 mezős JSON-objektum). Az ügynöknek nincs szüksége a teljes ügyfél-rekordra — csak azokra a részekre, amelyek megváltoztatják a beszélgetést.

Élő hívási eszközök

Ezek a beszélgetés közben futnak. Az AI dönti el, mikor hívja meg az egyes eszközöket a leírásuk és az aktuális párbeszéd alapján.

Elérhető eszközök

Eszköz	Cél	Mikor használd
Call Forwarding	Átadás emberi operátornak	Ügyfél személyt kér, összetett kérdések
Google Calendar	Elérhetőség ellenőrzése és időpontfoglalás	Az ügyfél időpontot szeretne foglalni
Outlook Calendar	Ugyanaz, Microsoft Outlookon keresztül	Az ügyfél időpontot szeretne foglalni
API Tool RAG	Élő adatok lekérése külső API-ból	Valós idejű információ szükséges (rendelések, készlet, fiókállapot)
Agent Transfer	Átadás másik AI hangügynöknek	A hívónak más részleg vagy szakember kell
HubSpot CRM	Kapcsolatok és üzletek olvasása/írása HubSpotban	Hívás naplózása a HubSpotba, lead kikeresése
MCP-szerverek	Eszközök elérhetővé tétele a regisztrált MCP-szerverekből	MCP-kompatibilis eszközszervert futtatsz, és szeretnéd, hogy az ügynök beszélgetés közben használja eszközeit

Hívástovábbítás

Hívások átadása embernek, ha meghatározott feltételek teljesülnek.

Beállítás	Leírás	Példa
Név	Kötelező. Személy vagy részleg neve	`"Sales Manager"`
Átirányítási szám	Az alapértelmezett telefonszám, amelyre átirányít	`"+49 123 456 789"`
Kiváltó feltétel	Mikor adja át az ügynök	`"Az ügyfél a menedzsert kéri, vagy a probléma nem oldható meg"`
Feltételes irányítási számok	Feltétel–szám hozzárendelés a routinghoz	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Hogyan működik:

Beszélgetés közben az AI kiértékeli a Kiváltó feltételt.
Ha feltételes irányítási számok vannak beállítva, az illeszkedő feltétel határozza meg, melyik számot kell hívni.
Egyébként az Átirányítási szám kerül felhasználásra.
Az ügynök tájékoztatja a hívót az átadásról.
A hívás átadódik — ha nincs válasz, visszakerül az ügynökhöz.

tanács

Több Call Forwarding eszközt is hozzáadhatsz különböző részlegekhez — egyet az „Értékesítéshez" és egy másikat a „Műszaki támogatáshoz" különböző feltételekkel és számokkal.

Google Calendar

Csatlakoztasd a Google Calendart, hogy az ügynök hívások közben ellenőrizhesse az elérhetőséget és időpontot foglalhasson.

Beállítás:

Lépj az Integration → Calendars menüpontba, és először csatlakoztasd a Google-fiókod.
Add hozzá a Google Calendar eszközt az ügynök Actions lapján.
Válaszd ki a használni kívánt naptárt.
Konfiguráld az elérhetőségi beállításokat.

Beállítás	Leírás	Alapértelmezett
Naptár	Kötelező. Melyik naptárt használja	Az elsődleges naptárad
Időzóna	Időzóna az időpontokhoz (IANA formátum)	Automatikus észlelés
Munkaidő kezdete	A munkaidő kezdete	9:00
Munkaidő vége	A munkaidő vége	18:00
Időblokk hossza	Időpont hossza percben	30
Munkanapok	A hét elérhető napjai	Hétfő–péntek
Pufferidő időpontok között	Pufferidő időpontok között (0–60 perc)	0

Támogatott időblokk-hosszak: 15, 30, 45, 60, 75, 90, 105, 120 perc.

tanács

Pontosan állítsd be a munkaidőd és a munkanapokat — az ügynök csak a beállított elérhetőségen belüli időpontokat ajánlja fel.

Outlook Calendar

Csatlakoztasd az Outlook Calendart az időpontfoglaláshoz hívások közben. Ugyanúgy működik, mint a Google Calendar.

Beállítás:

Lépj az Integration → Calendars menüpontba, és először csatlakoztasd az Outlook-fiókod.
Add hozzá az Outlook Calendar eszközt az ügynök Actions lapján.
Válaszd ki a használni kívánt naptárt.
Konfiguráld az elérhetőségi beállításokat.

A beállítások megegyeznek a Google Calendaréval (időzóna, munkaidő, időblokk hossza, munkanapok, puffer).

Agent Transfer

Hívás átadása a fiókodban lévő másik AI hangügynöknek. Akkor hasznos, ha specializált ügynököd van különböző részlegekhez.

Beállítás	Leírás
Cél-ügynök	Kötelező. Válaszd ki, melyik ügynöknek adja át
Kiváltó feltétel	Mikor adja át (pl. „A hívó műszaki támogatást kér")

Példa: Egy recepciós ügynök átadja a hívókat egy értékesítési ügynöknek, amikor árazásról kérdeznek, vagy egy támogatási ügynöknek, amikor műszaki problémájuk van.

HubSpot CRM

Olvasás és írás a HubSpot CRM-edben hívás közben. Lehetővé teszi az ügynök számára, hogy interakciókat naplózzon, kapcsolatot keressen ki telefonszám alapján, vagy üzlet-frissítéseket küldjön — anélkül, hogy az API-hívásokat kézzel kellene programoznod.

Beállítás:

Lépj az Integrations oldalra, és csatlakoztasd a HubSpot-fiókod.
Add hozzá a HubSpot CRM eszközt az ügynök Actions lapján.
Válaszd ki, melyik pipeline-okat és tulajdonságokat módosíthatja az ügynök.

Miután hozzáadtad az eszközt, az AI a hívót telefonszám alapján párosíthatja egy HubSpot-kapcsolathoz, lekérheti az üzlet állapotát, és mezőket frissíthet — mindezt az élő beszélgetésből.

MCP-szerverek

Tedd elérhetővé bármely MCP-kompatibilis szerver eszközeit, amelyet a Hanc.AI-hoz csatlakoztattál. Egy ügynök több MCP-szerverből is meríthet; egy MCP-szerver több ügynököt is kiszolgálhat.

Beállítás:

Egyszer csatlakoztasd az MCP-szerveredet (vagy szervereidet) az Integration → MCP-szerverek menüpont alatt. A teljes regisztrációs lépésekért lásd a dedikált MCP-szerverek oldalt.
Add hozzá az MCP-szerverek bejegyzést az ügynök Actions lapjához — az Add Action legördülőben a Live call alatt található.
Kapcsold be, hogy a regisztrált kapcsolataid közül melyikhez férjen hozzá ez az ügynök.
Adj hozzá egy rövid „Mikor használja" utasítást, hogy az ügynök tudja, mikor nyúljon ezekért az eszközökért.

Az ügynök minden hívás elején újra felfedezi az eszközkészletet minden engedélyezett MCP-szerverből, így a szerveroldali változások automatikusan megjelennek a következő híváson. Az eszközök a kapcsolat-címkével előtagolva vannak átnevezve, hogy a különböző szerverek hasonló nevű eszközei ne ütközzenek.

API Tool RAG

Csatlakozz külső API-khoz, hogy valós idejű információt szerezzél hívások közben — rendelések kikeresése, készlet ellenőrzése, fiókok igazolása vagy bármilyen API-n keresztül elérhető adat.

Beállítás	Leírás	Példa
Név	Kötelező. Eszköz neve	`"Order Lookup"`
Leírás / Mikor használja	Kötelező. Mikor kérdezze le az API-t	`"Az ügyfél a rendelés státuszáról kérdez"`
API URL	Kötelező. API-végpont. Tartalmazhat `{placeholder}` tokeneket, amelyeket a Body Parameters Schema (lásd alább) értékei helyettesítenek.	`"https://api.yourshop.com/orders/{order_id}"`
HTTP-metódus	Kötelező. HTTP-metódus	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Várakozási üzenet	Mit mond az ügynök várakozás közben	`"Hadd nézzem meg ezt önnek..."`
Időtúllépés	Maximális várakozási idő (ms)	`5000` (alapértelmezett)
Fejlécek	Minden kéréssel elküldött statikus HTTP-fejlécek	`{"Authorization": "Bearer KEY"}`
Query paraméterek	Minden kéréshez hozzáadott statikus query-paraméterek	`{"apiVersion": "v2"}`
Body Parameters Schema	Kötelező. JSON Schema, amely leírja azokat az argumentumokat, amelyeket az AI-nak ki kell nyernie a beszélgetésből és át kell adnia az eszköznek. Lásd A Body Parameters Schema írása.	JSON Schema objektum

tanács

Mindig állíts be Várakozási üzenetet — az API-hívás közbeni csend a hívónak elromlottnak hat.

megjegyzés

A régi „Run on call start" jelölőnégyzetet az API Tool RAG-on a dedikált Pre fetch bejegyzés váltotta fel. Pre fetch-et akkor használj, ha a beszélgetés kezdete előtt szeretnéd az adatokat; API Tool RAG-ot akkor, ha az ügynöknek hívás közben kell eldöntenie, hogy lekérje-e.

A Body Parameters Schema írása

A nevével ellentétben a Body Parameters Schema nem nyers kérés-törzs. Ez egy JSON Schema, amely leírja, mit kell az AI-nak kinyernie a beszélgetésből és átadnia az eszközödnek. A HTTP-metódustól és az URL-sablontól függően ezek az értékek az URL-be, a query stringbe vagy a JSON-törzsbe kerülnek:

HTTP-metódus	Hová kerülnek a kinyert értékek
Az URL tartalmaz `{name}` placeholdert	Az illeszkedő érték az URL-be kerül
`GET`, `DELETE`	A fennmaradó értékek az URL-hez fűződnek `?key=value` formában
`POST`, `PUT`, `PATCH`	A fennmaradó értékek JSON-törzsként kerülnek elküldésre

Minimális struktúra

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "Mit jelent ez az érték és hogyan válassza ki az AI"
    }
  },
  "required": ["param_name"]
}

A gyökér type mindig "object". A properties listázza az egyes argumentumokat. A required jelöli azokat, amelyeket az AI-nak mindig biztosítania kell — ha az ügyfél még nem mondta ki, az AI az eszköz hívása előtt rákérdez.

Mezőreferencia

Mező	Cél
`type`	Az érték JSON-típusa: `"string"`, `"number"`, `"integer"`, `"boolean"`, `"array"`, `"object"`
`description`	A legfontosabb. Megmondja az AI-nak, mit jelent az érték, milyen formátumot használjon és mikor adja meg. Lehetőség szerint mindig adj példákat.
`enum`	Egy rögzített listára korlátozza az értéket. Az AI a természetes beszédet a legközelebbi opcióra képezi le (pl. `"a kék"` → `"blue"`).
`minimum`, `maximum`	Számértékek határai. Az AI elutasítja/korrigálja a tartományon kívüli értékeket.
`default`	Az érték, amelyet akkor használ, ha az AI nem adja át ezt a mezőt. Nem kötelező, de dokumentálja az implicit értéket.
`format`	Validációs tipp, pl. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Példák

Termékkeresés (csak kulcsszó):

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Termékkereső kulcsszó — pl. \"telefon\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

A https://dummyjson.com/products/search?q={query}&limit=5 URL-lel és GET-tel használva: a query érték az URL placeholderébe kerül. A törzsbe semmi sem kerül.

Rendelés keresése azonosító alapján:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "A rendelés azonosítója, amelyről az ügyfél érdeklődik, általában 6-10 számjegy. Kérdezd meg az ügyfeltől, ha nem adta meg."
    }
  },
  "required": ["order_id"]
}

A https://api.example.com/orders/{order_id} URL-lel és GET-tel használva.

Foglalás több kötelező mezővel:

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Egy korábbi search_products hívás által visszaadott termék-azonosító."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Hány tételt kell foglalni. Alapértelmezett 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "Hogyan szeretné az ügyfél megkapni a tételt."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Az ügyfél e-mail-címe a rendelés megerősítéséhez. Kérdezd meg, ha nem adta meg."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

A POST https://api.example.com/reservations esetében: a négy érték a JSON-törzsbe kerül. Az AI az eszköz hívása előtt rákérdez az ügyfélre a hiányzó required mezőkért.

Paraméter nélküli eszköz:

{
  "type": "object",
  "properties": {}
}

Akkor használd ezt, ha a végpont teljesen statikus (pl. GET /store/hours) és az AI-nak nem kell semmit átadnia.

Legjobb gyakorlatok AI hangügynökökhöz

Tartsd a sémát laposan. A beágyazott objektumok és tömbök működnek, de az AI telefonbeszélgetés közben elcsúszhat. Inkább legfeljebb 3-5 felső szintű mezőt használj.
Mindig írj description-t minden mezőhöz. Adj példákat (pl. "telefon", "laptop") — a példák megbízhatóbban irányítják az AI-t, mint az absztrakt definíciók.
Használj enum-ot, ha rögzített értéklistád van. Ez kiküszöböli azt a kockázatot, hogy az AI értékeket találjon ki, vagy "Electronics"-et küldjön "electronics" helyett.
A required jelzést csak akkor használd, ha az eszköz nélküle nem működik. Minden más opcionális, és az AI átugorja, ha az ügyfél nem említette — nincs kínos plusz kérdés.
Használj snake_case neveket, és pontosan illeszd őket az URL-ben lévő {placeholder} tokenekhez.
Dokumentáld a hiányzó értékek viselkedését a description-ben — pl. "Hagyd ki, ha nincs költségvetési korlát", "Alapértelmezett 5".

Hívás utáni műveletek

A hívás utáni műveletek a hívás befejezése után sülnek el, miután az elemzési lánc elkészítette az összefoglalót, a hangulatot és a kinyert változókat. Hívási adatokat fogyasztanak — nem beszélnek az ügyféllel.

Elérhető műveletek

Művelet	Cél
Send Email	Strukturált összefoglaló e-mailben a csapatnak vagy az ügyfélnek
Send SMS	Szöveges megerősítés a hívónak
Send WhatsApp	WhatsApp-üzenet vagy sablon (a 24 órás ablakon belül és kívül is működik)
API Call	A teljes hívás-payload elküldése külső API-nak (CRM, webhook, az adattárházad)

Send Email

Beállítás	Leírás
Név	Kötelező. Művelet-azonosító
Tárgy	Kötelező. Az e-mail tárgysora
Üzenettörzs	Kötelező. Az e-mail törzse — tartalmazhat kinyert változókat
Kiváltó feltétel	Mikor küldje (üres = mindig)
Címzettek	Kötelező. E-mail-címek, amelyek mindig megkapják az e-mailt
Feltételes címzettek	Feltétel–címzett hozzárendelés

Változók használata e-mailben:

Új lead telefonhívásból:

Név: {{customer_name}}
E-mail: {{customer_email}}
Érdeklődik a következő iránt: {{selected_plan}}
Megjegyzések: {{call_notes}}

Send SMS

Beállítás	Leírás
Név	Kötelező. Művelet-azonosító
Feladó neve	Megjelenített feladó-név
Üzenet	Kötelező. SMS-tartalom (tartalmazhat változókat)
Kiváltó feltétel	Mikor küldje
Címzettek	Kötelező. Telefonszámok, amelyek mindig megkapják az SMS-t
Feltételes címzettek	Feltétel–szám hozzárendelés

Send WhatsApp

A WhatsApp-üzenetküldés a HANC-on előre jóváhagyott sablonokat használ egy központi Twilio Content-fiókból — nem kell kézzel beillesztened a Template SID-t. A művelet-szerkesztő egy legördülő menüt mutat minden jelenleg aktív és jóváhagyott sablonnal, és te kiválasztasz egyet. A sablonban lévő helyettesítőket ({{1}}, {{2}}, …) ezután a szerkesztőben általad hozzárendelt hívásváltozók vagy statikus szöveg tölti fel.

Beállítás	Leírás
Név	Kötelező. Művelet-azonosító
Kiváltó feltétel	Mikor küldje
Címzettek	Kötelező. Telefonszámok, amelyek mindig megkapják az üzenetet
Feltételes címzettek	Feltétel–szám hozzárendelés
Sablon	Kötelező. Legördülő választó a központi Twilio Content-fiókból szinkronizált, előre jóváhagyott WhatsApp-sablonokhoz. Minden bejegyzés mutatja a sablon nevét, nyelvét és a törzs előnézetét, így tudod, melyiket válaszd.
Sablonváltozók	A kiválasztott sablonhoz a szerkesztő listázza az egyes helyettesítőket (`{{1}}`, `{{2}}`, …), és lehetővé teszi, hogy hívásváltozóhoz (lásd alább) vagy statikus stringhez rendeld őket.

Elérhető hívásváltozók, amelyeket sablon-helyettesítőkbe képezhetsz le:

Változó	Leírás
`{{call_from}}`	A hívó telefonszáma
`{{call_to}}`	A hívott szám
`{{call_summary}}`	AI által generált hívás-összefoglaló
`{{call_sentiment}}`	Hangulat (positive/neutral/negative)
`{{call_task_achieved}}`	Hogy elérte-e a hívás a feladatot
`{{call_transcription}}`	Teljes hívás-átirat

Miért választó, nem szabad szöveg

A WhatsApp megköveteli, hogy minden vállalkozás által kezdeményezett üzenet a 24 órás ügyfélszolgálati ablakon kívül előre jóváhagyott sablont használjon. A HANC szinkronizálja a jóváhagyott sablonok listáját a megosztott Twilio Content-fiókból, így a legördülő mindig pontosan azt mutatja, ami most küldhető — nem választhatsz véletlenül vázlatot, elutasított sablont vagy nem létező SID-t. Új sablon hozzáadásához lépj kapcsolatba a támogatással; amint a WhatsApp jóváhagyta, automatikusan megjelenik a legördülőben.

API Call

A hívás utáni API Call művelet az általános webhook-od a stacked többi részéhez. Válaszd ki a metódust, állítsd be az URL-t, és elküldjük a teljes hívás-payloadot — a végpontod egy strukturált JSON-objektumot kap, amely leírja, mi történt.

Beállítás	Leírás
Név	Kötelező. Művelet-azonosító
Kiváltó feltétel	Mikor süljön el (üres = minden hívás). Az átirathoz képest egy LLM értékeli ki.
API URL	Kötelező. API-végpont URL-je
HTTP-metódus	Kötelező. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Fejlécek	Opcionális kérés-fejlécek
Query paraméterek	Opcionális query-paraméterek

Mit kap a végpontod

POST / PUT / PATCH esetén a végpontod egy JSON-objektumot kap a kérés-törzsben. A konfigurált body-paramétereid összeolvadnak a teljes hívás-payloaddal:

{
  "call_from": "+431234567890",
  "call_to":   "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "ended",
  "start_timestamp": 1730000000000,
  "end_timestamp":   1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user",  "content": "Hi…",    "timestamp": 1730000003000 }
  ],
  "call_summary": "Az ügyfél árazásról kérdezett…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": {
    "name": "John",
    "email": "john@example.com"
  },
  "collected_data": { /* hívás közbeni űrlap-beküldések */ },
  "transfer_history": [ /* ha történt ügynök-átadás */ ],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

GET / DELETE esetén ugyanezek a mezők a query stringbe kerülnek lapítva — de a beágyazott értékeket, mint a transcription, sentiment és custom_analysis_data, eldobjuk (az URL-ek nem hordoznak strukturált adatot ésszerűen). Ha szükséged van az átiratra, használj POST/PUT/PATCH-et.

Minden kérés kap egy X-Correlation-Id fejlécet a nyomon követéshez, és 30 másodperc után időtúllépést kap.

Pre-fetch vs hívás utáni API Call

A Pre fetch a {phone} és társait sablonozza az URL-be/fejlécekbe/queryba/törzsbe. Visszatér a promptba, a hívás előtt.
A Hívás utáni API Call a teljes hívás-dumpot küldi a törzsben vagy queryben. Nincs URL-sablonozás — a végpontod statikus URL-t + dinamikus törzset kap.

Kinyert változók

A kinyert változók olyan egyéni adatmezők, amelyeket az AI automatikusan kinyer a beszélgetésekből. Például az ügynök elcsípheti a hívó nevét, e-mailjét, telefonszámát vagy bármely más megadott információt.

Alapértelmezett változók

Minden új ügynök két alapértelmezett kinyert változóval jön létre:

Változó	Típus	Leírás
Email	Email	A hívó e-mail-címe
Phone	Phone	A hívó telefonszáma

Ezek alapértelmezetten engedélyezve vannak, és megjelennek a hívás-widget űrlapján. Szerkesztheted vagy eltávolíthatod őket, és hozzáadhatsz saját egyéni változókat.

Változótípusok

Típus	Felhasználási eset	Példa
Text	Nevek, címek, jegyzetek, szabadszövegű bevitel	Ügyfél neve, szállítási cím
Number	Mennyiségek, költségvetések, ID-k	Rendelési mennyiség, költségvetés összege
Email	E-mail-címek validációval	Ügyfél e-mailje
Phone	Telefonszámok validációval	Ügyfél telefonszáma
Selector	Választás előre meghatározott opciók közül	Preferált csomag (Basic/Pro/Enterprise)
Checkbox	Igen/nem hozzájárulás vagy megerősítés	„Beleegyezem a marketinges e-mailek fogadásába"

Változó konfigurálása

Mező	Leírás	Példa
Változó neve	Kötelező. Változó-azonosító	`customer_email`
Utasítások az AI-nak	Kötelező. Utasítások az AI-nak, hogy mikor és hogyan nyerje ki ezt az értéket	`"Az ügyfél e-mail-címe. Kérdezd meg, ha nem adta meg."`
Példa formátum	(Opcionális) Az elvárt formátum példája	`"john@example.com"`
Opciók (Selector esetén)	(Csak Selector) Megengedett opciók listája	`["Basic", "Pro", "Enterprise"]`
Megjelenítés űrlapon	Hogy ez a mező megjelenjen-e a hívás-widget űrlapján	Alapértelmezetten engedélyezve

Megjelenítés űrlapon

Amikor a Megjelenítés űrlapon engedélyezve van, a változó látható beviteli mezőként jelenik meg a webes widgetben a hívás előtt és alatt. Ez lehetővé teszi, hogy a hívók közvetlenül megadják az információikat, az AI által a beszélgetésből történő kinyerésen túl.

tanács

Az AI természetesen rákérdez a hiányzó információkra a beszélgetés során. Adj meg világos leírást, mint például „Az ügyfél e-mail-címe, kérdezd meg udvariasan, ha nem adta meg", és az ügynök kezeli.

Eszközök és műveletek hozzáadása

Lépj az ügynököd Actions lapjára.
Kattints az Add Tool gombra.
Válaszd ki a megfelelő fázist a legördülőből — Pre fetch, Live call vagy Post call.
Konfiguráld a beállításokat.
Mentsd el — a változtatások a következő híváson lépnek életbe.

Minden bejegyzés együtt szerepel az Actions táblázatban. Kattints bármelyik sorra a szerkesztéshez, vagy használd a kuka ikont a törléshez.

Kapcsolódó

AI hangügynökök áttekintése
Prompt-mérnökség — hivatkozz az eszközökre a promptodban
Tudásbázis — információforrások
Integrációk — külső rendszerek, amelyekkel az eszközeid kommunikálhatnak

A három fázis​

Pre fetch​

Mikor használd​

Hogyan működik​

Konfiguráció​

Elérhető változók​

Mi kerül a promptba​

Fontos korlátok​

Élő hívási eszközök​

Elérhető eszközök​

Hívástovábbítás​

Google Calendar​

Outlook Calendar​

Agent Transfer​

HubSpot CRM​

MCP-szerverek​

API Tool RAG​

A Body Parameters Schema írása​

Minimális struktúra​

Mezőreferencia​

Példák​

Legjobb gyakorlatok AI hangügynökökhöz​

Hívás utáni műveletek​

Elérhető műveletek​

Send Email​

Send SMS​

Send WhatsApp​

API Call​

Mit kap a végpontod​

Kinyert változók​

Alapértelmezett változók​

Változótípusok​

Változó konfigurálása​

Megjelenítés űrlapon​

Eszközök és műveletek hozzáadása​

Kapcsolódó​

A három fázis

Pre fetch

Mikor használd

Hogyan működik

Konfiguráció

Elérhető változók

Mi kerül a promptba

Fontos korlátok

Élő hívási eszközök

Elérhető eszközök

Hívástovábbítás

Google Calendar

Outlook Calendar

Agent Transfer

HubSpot CRM

MCP-szerverek

API Tool RAG

A Body Parameters Schema írása

Minimális struktúra

Mezőreferencia

Példák

Legjobb gyakorlatok AI hangügynökökhöz

Hívás utáni műveletek

Elérhető műveletek

Send Email

Send SMS

Send WhatsApp

API Call

Mit kap a végpontod

Kinyert változók

Alapértelmezett változók

Változótípusok

Változó konfigurálása

Megjelenítés űrlapon

Eszközök és műveletek hozzáadása

Kapcsolódó