Műveletek és eszközök

Az Actions fülön kezelheted mindent, amit az ügynököd a beszélgetésen túl tud — eszközöket, amelyeket az ügynök egy élő beszélgetés során hív meg, előlekérési hookokat, amelyek a hívás megkezdése előtt futnak, és hívás utáni műveleteket, amelyek a hívás befejeztével indulnak. A lekérdezési változók (azok az adatmezők, amelyeket az ügynök minden beszélgetésből kinyer) ugyanezen a fülön találhatók.

Minden csomag

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

A három fázis

Az Actions fül minden bejegyzése a három életciklus-fázis egyikéhez tartozik. Az Add Tool legördülő menü úgy csoportosítja őket, hogy világos legyen, mikor indul el az egyes elemek:

Fázis	Mikor	Példák
Pre fetch	Mielőtt az ügynök köszönne	A hívó felkeresése a CRM-edben telefonszám alapján, a legutóbbi rendelés lekérése, személyre szabott üdvözlés lekérése a backendedről
Live call	A beszélgetés közben, az AI által kiváltva, amikor eljön a megfelelő pillanat	A hívás továbbítása egy emberhez, naptár elérhetőségének ellenőrzése, átadás egy másik ügynöknek, külső API lekérdezése adatokért
Post call	Miután a hívás véget ér	Összefoglaló e-mail küldése, SMS-visszaigazolás indítása, a hívás adatcsomagjának továbbítása a CRM-edbe

A legördülő menü a Pre fetch fázissal a tetején nyílik meg, mert minden más fázisnak már bőven van opciója — az új előlekérési bejegyzés a legvalószínűbb, amit keresel.

Pre fetch

Az előlekérési hookok révén az ügynököd már úgy kezdheti a hívást, hogy tudja, ki hív. Ezek a hívás felépítésével párhuzamosan futnak, és a választ még az első szó kimondása előtt beillesztik az ügynök rendszerpromptjába.

Mikor használd

Ismerd fel a visszatérő ügyfelet telefonszám alapján, és üdvözöld a nevén
Kérd le a hívó nyitott rendelését, legutóbbi időpontját vagy tagsági szintjét
Töltsd be előre azt az üzleti kontextust, amely attól függ, melyik vonalat tárcsázták
Illessz be CRM-jegyzeteket, hogy az ügynök ismerje a lead szakaszát és előzményeit

Hogyan működik

A platform feloldja a hívó telefonszámát (bejövő hívásnál a SIP-ből, kimenőnél a tárcsázási célból).
Minden aktív Pre fetch művelet párhuzamosan indul el, kérésenként kemény 1,5 mp-es időtúllépéssel és 2 mp-es összesített kerettel.
A sikeres válaszok elnevezett blokkokként fűződnek össze az ügynök rendszerpromptjában — az ügynök a legelső fordulójánál olvassa be őket.
A hibák némák — egy lassú vagy hibás endpoint soha nem blokkolja az üdvözlést. Az ügynök egyszerűen az adott blokk nélkül kezd beszélni.

Konfiguráció

Mező	Leírás
Name	Kötelező. Belső címke és a blokk neve a promptban — tartsd rövidnek és leírónak (pl. `crm_lookup`, `vip_check`).
API URL	Kötelező. A lekérdezendő endpoint. Támogatja a `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}` helykitöltőket.
HTTP Method	A `GET` az alapértelmezett és legjobb választás. A `POST` / `PUT` / `PATCH` / `DELETE` is működik.
Headers	Opcionális. Statikus vagy sablonozott (a helykitöltők itt is működnek).
Query Parameters	Opcionális. Új előlekérési műveleteknél `phone={phone}` értékkel töltődik ki előre.

Elérhető változók

Ezek a tokenek behelyettesítődnek az URL-be, a fejlécekbe és a 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őnél a célszám	`+431234567890`
`{direction}`	`inbound` vagy `outbound`	`inbound`
`{agent_id}`	Belső ügynök-azonosító	`65f1a2b3c4...`
`{user_id}`	A munkaterület tulajdonosának azonosítója	`65e0b1c2d3...`
`{call_id}`	Hívásazonosító (lehetővé teszi, hogy a backended később összekapcsolja a hívás utáni adatcsomaggal)	`65f1f2c4d5...`

Az ismeretlen helykitöltők szó szerint maradnak — a hibás sablonozás soha nem szakít meg egy hívást.

Mi kerül a promptba

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

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

Az ügynök rendszerpromptjához egy XML-be csomagolt, a műveletről elnevezett blokk fűződik hozzá:

<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 az előlekérést a rendszerpromptodban: "If <call_context> contains a customer name, greet them by name."

Fontos korlátozások

Csak telefonhívások. Az előlekérés nem fut le widget- (web-) hívásoknál — nincs telefonszám, amely alapján sablonozni lehetne.
8 KB-os felső korlát a válasz törzsére — bármi ennél hosszabb a beillesztés előtt levágásra kerül. A korlát védi a prompt token-keretedet, és behatárolja egy rosszindulatú endpoint hatókörét.
Nincs condition kiértékelés — az előlekérés mindig lefut, amikor aktív. Még nincs átirat, amely alapján ki lehetne értékelni.

tanács

Használj GET-et egy telefonszám-kulcsú lekérdező endpointtal. Tartsd a válaszokat kicsinek és strukturáltnak (JSON-objektum 3-5 mezővel). Az ügynöknek nincs szüksége a teljes ügyfélrekordodra — 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	Az ügyfél élő személyt kér, összetett problémák
Google Calendar	Elérhetőség ellenőrzése és időpontfoglalás	Az ügyfél megbeszélést szeretne egyeztetni
Outlook Calendar	Ugyanaz, Microsoft Outlookon keresztül	Az ügyfél megbeszélést szeretne egyeztetni
API Tool RAG	Élő adatok lekérése külső API-ból	Valós idejű infó kell (rendelések, készlet, fiókállapot)
Agent Transfer	Átadás egy másik AI hangügynöknek	A hívónak másik részleg vagy szakértő kell
HubSpot CRM	Kapcsolatok és üzletek olvasása/írása a HubSpotban	A hívás naplózása a HubSpotba, egy lead felkeresése
MCP servers	Eszközök közzététele bármelyik regisztrált MCP-szerveredről	MCP-kompatibilis eszközszervert futtatsz, és szeretnéd, hogy az ügynök beszélgetés közben használja annak eszközeit

Hívástovábbítás

Hívások továbbítása emberhez, ha meghatározott feltételek teljesülnek.

Beállítás	Leírás	Példa
Name	Kötelező. A személy vagy részleg neve	`"Sales Manager"`
Forwarding Number	Az alapértelmezett telefonszám, amelyre továbbít	`"+49 123 456 789"`
Trigger Condition	Mikor továbbítson az ügynök	`"Customer asks for manager or issue cannot be resolved"`
Conditional Routing Numbers	Feltétel–szám hozzárendelés az irányításhoz	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Hogyan működik:

A beszélgetés során az AI kiértékeli a Trigger Condition feltételt.
Ha vannak beállított feltételes irányítási számok, az illeszkedő feltétel dönti el, melyik számot hívja.
Egyébként a Forwarding Number kerül felhasználásra.
Az ügynök tájékoztatja a hívót az átadásról.
A hívás továbbításra kerül — ha nincs válasz, visszatér az ügynökhöz.

tanács

Több Call Forwarding eszközt is hozzáadhatsz különböző részlegekhez — egyet a „Sales", egy másikat a „Technical Support" számára, különböző feltételekkel és számokkal.

Google Calendar

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

Beállítás:

Először lépj az Integration → Calendars menüpontra, és csatlakoztasd a Google-fiókodat.
Add hozzá a Google Calendar eszközt az ügynök Actions fülén.
Válaszd ki a használandó naptárt.
Konfiguráld az elérhetőségi beállításaidat.

Beállítás	Leírás	Alapértelmezett
Calendar	Kötelező. Melyik naptárt használja	Az elsődleges naptárad
Timezone	Időzóna az időpontokhoz (IANA formátum)	Automatikusan felismerve
Work Start Time	A munkaidő kezdete	9:00
Work End Time	A munkaidő vége	18:00
Slot Duration	Az időpont hossza percben	30
Working Days	A hét elérhető napjai	Hétfő–péntek
Buffer Between Appointments	Szünet az időpontok között (0–60 perc)	0

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

tanács

Állítsd be pontosan a munkaidődet és munkanapjaidat — az ügynök csak a beállított elérhetőségeden belüli időpontokat kínálja fel.

Outlook Calendar

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

Beállítás:

Először lépj az Integration → Calendars menüpontra, és csatlakoztasd az Outlook-fiókodat.
Add hozzá az Outlook Calendar eszközt az ügynök Actions fülén.
Válaszd ki a használandó naptárt.
Konfiguráld az elérhetőségi beállításaidat.

A beállítások megegyeznek a Google Calendaréval (időzóna, munkaidő, időpont-hossz, munkanapok, szünet).

Agent Transfer

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

Beállítás	Leírás
Target Agent	Kötelező. Válaszd ki, melyik ügynöknek adja át
Trigger Condition	Mikor adja át (pl. „A hívó technikai támogatás felől érdeklődik")

Példa: Egy recepciós ügynök átadja a hívókat egy értékesítési ügynöknek, amikor árakról kérdeznek, vagy egy ügyfélszolgálati ügynöknek, ha technikai problémájuk van.

HubSpot CRM

Olvass és írj a HubSpot CRM-edbe a hívás során. Lehetővé teszi, hogy az ügynök naplózza az interakciókat, telefonszám alapján felkeressen egy kapcsolatot, vagy üzletfrissítéseket küldjön anélkül, hogy neked kellene beprogramoznod az API-hívásokat.

Beállítás:

Lépj az Integrations oldalra, és csatlakoztasd a HubSpot-fiókodat.
Add hozzá a HubSpot CRM eszközt az ügynök Actions fülén.
Válaszd ki, mely pipeline-t és tulajdonságokat érhet el az ügynök.

Az eszköz hozzáadása után az AI telefonszám alapján párosíthatja a hívót egy HubSpot-kapcsolathoz, lekérheti az üzlet szakaszát, és frissítheti a mezőket — mindezt az élő beszélgetésből.

MCP servers

Tegyél közzé eszközöket bármely MCP-kompatibilis szerverről, 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:

Csatlakoztasd az MCP-szerveredet/szerveredet egyszer az Integration → MCP servers menüpontban. A teljes regisztrációs lépésekhez lásd a dedikált MCP-szerverek oldalt.
Add hozzá az MCP servers bejegyzést ennek az ügynöknek az Actions füléhez — ez a Live call alá van csoportosítva az Add Action legördülő menüben.
Kapcsold be, mely regisztrált kapcsolataidhoz kapjon hozzáférést ez az ügynök.
Adj hozzá egy rövid „When to use it" utasítást, hogy az ügynök tudja, mikor nyúljon ezekhez az eszközökhöz.

Az ügynök minden hívás elején újra felfedezi az eszközkészletet minden engedélyezett MCP-szerverről, így a szerveroldali módosításaid automatikusan megjelennek a következő híváson. Az eszközök átnevezésre kerülnek a kapcsolat címkéjével mint előtaggal, hogy a különböző szerverekről érkező, hasonló nevű eszközök ne ütközzenek.

API Tool RAG

Csatlakozz külső API-khoz, hogy valós idejű információt kérj le a hívások közben — keress rá rendelésekre, ellenőrizd a készletet, igazolj fiókokat, vagy férj hozzá bármely API-n keresztül elérhető adathoz.

Beállítás	Leírás	Példa
Name	Kötelező. Az eszköz neve	`"Order Lookup"`
Description / When to Use	Kötelező. Mikor kérdezze le az API-t	`"Customer asks about order status"`
API URL	Kötelező. Az API-végpont. Tartalmazhat `{placeholder}` tokeneket, amelyek a Body Parameters Schema értékeivel helyettesítődnek be (lásd lentebb).	`"https://api.yourshop.com/orders/{order_id}"`
HTTP Method	Kötelező. HTTP-metódus	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Loading Message	Mit mond az ügynök várakozás közben	`"Let me check that for you..."`
Timeout	Maximális várakozási idő (ms)	`5000` (alapértelmezett)
Headers	Minden kéréssel elküldött statikus HTTP-fejlécek	`{"Authorization": "Bearer KEY"}`
Query Parameters	Minden kéréshez hozzáadott statikus query-string paraméterek	`{"apiVersion": "v2"}`
Body Parameters Schema	Kötelező. JSON-séma, amely leírja az AI által a beszélgetésből kinyerendő és az eszköznek átadandó argumentumokat. Lásd A Body Parameters Schema megírása.	JSON-séma-objektum

tanács

Mindig állíts be egy Loading Message üzenetet — az API-hívások alatti csend a hívó számára úgy hat, mintha valami elromlott volna.

megjegyzés

Az API Tool RAG korábbi „Run on call start" jelölőnégyzetét a dedikált Pre fetch bejegyzés váltotta fel. Használd az előlekérést, ha a beszélgetés megkezdése előtt akarod az adatot; használd az API Tool RAG-ot, ha az ügynöknek a hívás közben kell eldöntenie, hogy lekérje-e.

A Body Parameters Schema megírása

A név ellenére a Body Parameters Schema nem nyers kéréstörzs. Ez egy JSON-séma, amely leírja, mit nyerjen ki az AI a beszélgetésből, és adjon át 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 `{name}` tokent tartalmaz	Az illeszkedő érték behelyettesítődik az URL-be
`GET`, `DELETE`	A fennmaradó értékek `?key=value` formában fűződnek az URL-hez
`POST`, `PUT`, `PATCH`	A fennmaradó értékek JSON-törzsként kerülnek elküldésre

Minimális szerkezet

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "What this value is and how the AI should pick it"
    }
  },
  "required": ["param_name"]
}

A gyökér type mindig "object". A properties sorolja fel az egyes argumentumokat. A required jelöli, melyeket kell az AI-nak mindig megadnia — ha az ügyfél még nem mondta ki, az AI rákérdez, mielőtt meghívná az eszközt.

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. Adj hozzá példákat, amikor csak lehet.
`enum`	Az értéket egy rögzített lista egyik elemére korlátozza. Az AI a természetes beszédet a legközelebbi opcióra képezi le (pl. `"a kék"` → `"blue"`).
`minimum`, `maximum`	Számhatárok. Az AI elutasítja/behatárolja a tartományon kívüli értékeket.
`default`	Az az érték, amelyet az AI használ, ha nem adja át ezt a mezőt. Nem kötelező, de dokumentálja az implicit értéket.
`format`	Ellenőrzési segédlet, pl. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Példák

Termékkeresés (csak kulcsszó):

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product search keyword — e.g. \"phone\", \"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éke az URL helykitöltőjé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": "Order ID the customer is asking about, usually 6 to 10 digits. Ask the customer if not provided."
    }
  },
  "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": "Product ID returned by a previous search_products call."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "How many items to reserve. Default 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "How the customer wants to receive the item."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Customer's email for order confirmation. Ask if not provided."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

A POST https://api.example.com/reservations kéréssel használva: a négy érték a JSON-törzsbe kerül. Az AI rákérdez a hiányzó required mezőkre, mielőtt meghívná az eszközt.

Eszköz paraméterek nélkül:

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

Ezt akkor használd, ha az endpoint 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 laposnak. A beágyazott objektumok és tömbök működnek, de az AI megbotolhat, amikor telefonon beszél. Legfeljebb 3–5 legfelső szintű mezőt részesíts előnyben.
Mindig írj description-t minden mezőhöz. Adj meg példákat (pl. „phone", „laptop") — a példák megbízhatóbban vezetik az AI-t, mint az elvont definíciók.
Használj enum-ot, amikor rögzített értéklistád van. Ez kiküszöböli annak kockázatát, hogy az AI értékeket találjon ki, vagy "Electronics"-et küldjön "electronics" helyett.
Csak akkor jelölj egy mezőt required-nek, ha az eszköz nélküle nem működik. Minden más opcionális, és az AI kihagyja, ha az ügyfél nem említette — nincs kínos plusz kérdés.
Használj snake_case neveket, és pontosan illeszd az URL-ben lévő {placeholder} tokenekhez.
Dokumentáld a hiányzó értékek viselkedését a description-ben — pl. "Omit if no budget limit", "Default 5".

Élő üzenetküldési műveletek

(v2.4) A Send SMS live és a Send Email live lehetővé teszi, hogy az ügynök hívás közben, miközben még a hívóval beszél, szöveges üzenetet vagy e-mailt küldjön — nem csak a hívás után, mint a hívás utáni párjaik. Használd őket egy link, egy foglalási visszaigazolás, egy kód vagy egy összefoglaló elküldésére, amelyre a hívó még a letevés előtt reagálhat.

Az AI maga indítja el ezeket a műveleteket, az adott pillanatban, a művelet leírása és a beszélgetés alapján — ugyanúgy, ahogy bármely más élő eszköz meghívásáról dönt.

Művelet	Mikor indul	Kinek küld
Send SMS live	A hívás közben	A hívó telefonszámára
Send Email live	A hívás közben	A hívó e-mail-címére

Hívásonkénti küldési korlát

Minden csatorna hívásonként és csatornánként 3 küldésre van korlátozva. Egy ügynök egyetlen hívásban akár három élő SMS-t és akár három élő e-mailt is küldhet; a negyedik küldés egy adott csatornán elutasításra kerül. Ez megakadályozza, hogy egy fecsegő vagy ismétlődő beszélgetés spammelje a hívót.

Elutasítási mátrix

Egy élő küldés elutasításra kerül (és az ügynök megkapja az okát, hogy elegánsan helyre tudjon állni), amikor:

Feltétel	Eredmény
Érvénytelen vagy hiányzó e-mail (Send Email live esetén)	Elutasítva — az ügynök megkéri a hívót, hogy erősítse meg az e-mail-címét
Érvénytelen vagy hiányzó telefonszám (Send SMS live esetén)	Elutasítva — az ügynök megkéri a hívót, hogy erősítse meg a számát
A törzs meghaladja a 160 karaktert	Elutasítva — az üzenet túl hosszú ahhoz, hogy változtatás nélkül elküldhető legyen
Elérve a csatornakorlát (már 3 küldés ebben a hívásban)	Elutasítva — nincs több küldés azon a csatornán

Mivel az ügynök visszakapja az elutasítás okát, a beszélgetésben ki tudja javítani a problémát („Le tudnád betűzni azt az e-mail-címet?"), és újra próbálkozhat, ahelyett, hogy némán hibázna.

CRM-idővonalba naplózás

Minden élő küldés naplózásra kerül a kapcsolat CRM-idővonalára, így a hívás közben elküldött üzenet a híváskarton mellett jelenik meg — pontosan látod, mit küldtek, melyik csatornán és mikor.

Intelligens űrlap–csatorna láncolás

Amikor egy webes hívó csak néhány elérhetőséggel küldi el a widget űrlapját, az ügynök csak azt a csatornát használja, amely ténylegesen rendelkezésére áll:

A hívó csak e-mailt ad meg → az ügynök a Send Email live műveletet indítja (soha nem SMS-t).
A hívó csak telefonszámot ad meg → az ügynök a Send SMS live műveletet indítja (soha nem e-mailt).
A hívó mindkettőt megadja → az ügynök bármelyik csatornát használhatja, ahogy a beszélgetés megkívánja.

Ez azt jelenti, hogy az ügynök soha nem próbál SMS-t küldeni annak a hívónak, aki csak e-mailt adott meg, vagy e-mailt annak, aki csak számot — a rendelkezésre álló űrlapadatok döntik el, melyik élő művelet jöhet szóba.

Hívás utáni műveletek

A hívás utáni műveletek akkor indulnak el, amikor a hívás véget ért, és az elemzési lánc előállította az összefoglalót, a hangulatot és a kinyert változókat. Ezek a hívás adatait dolgozzák fel — nem beszélnek az ügyféllel.

Elérhető műveletek

Művelet	Cél
Send Email	Strukturált összefoglaló e-mailben a csapatodnak vagy az ügyfélnek
Send SMS	Szöveges visszaigazolás a hívónak
Send WhatsApp	WhatsApp-üzenet vagy -sablon (a 24 órás időablakon belül és kívül is működik)
API Call	A teljes hívás-adatcsomag továbbítása egy külső API-nak (CRM, webhook, adattárház)

Send Email

Beállítás	Leírás
Name	Kötelező. Művelet-azonosító
Subject	Kötelező. Az e-mail tárgysora
Message Body	Kötelező. Az e-mail törzse — tartalmazhat lekérdezési változókat
Trigger Condition	Mikor küldje (üres = mindig)
Recipients	Kötelező. Az e-mail-címek, amelyek mindig megkapják az e-mailt
Conditional Recipients	Feltétel–címzett hozzárendelés

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

New lead from phone call:

Name: {{customer_name}}
Email: {{customer_email}}
Interested in: {{selected_plan}}
Notes: {{call_notes}}

Send SMS

Beállítás	Leírás
Name	Kötelező. Művelet-azonosító
Sender Name	A megjelenített feladónév
Message	Kötelező. Az SMS tartalma (tartalmazhat változókat)
Trigger Condition	Mikor küldje
Recipients	Kötelező. A telefonszámok, amelyek mindig megkapják az SMS-t
Conditional Recipients	Feltétel–szám hozzárendelés

Send WhatsApp

A HANC-on a WhatsApp-üzenetküldés előre jóváhagyott sablonokat használ egy központi Twilio Content fiókból — nem kézzel illeszted be a Template SID-et. A művelet-szerkesztő megjelenít egy legördülő menüt minden jelenleg aktív és jóváhagyott sablonról, és te választasz egyet. A sablonon belüli helykitöltők ({{1}}, {{2}}, …) ezután a szerkesztőben leképezett hívásváltozókból vagy statikus szövegből töltődnek ki.

Beállítás	Leírás
Name	Kötelező. Művelet-azonosító
Trigger Condition	Mikor küldje
Recipients	Kötelező. A telefonszámok, amelyek mindig megkapják az üzenetet
Conditional Recipients	Feltétel–szám hozzárendelés
Template	Kötelező. Legördülő választó az előre jóváhagyott WhatsApp-sablonokból, a központi Twilio Content fiókból szinkronizálva. Minden bejegyzés mutatja a sablon nevét, nyelvét és a törzs előnézetét, hogy tudd, melyiket válaszd.
Template Variables	A kiválasztott sablonhoz a szerkesztő felsorolja az egyes helykitöltőket (`{{1}}`, `{{2}}`, …), és lehetővé teszi, hogy hozzárendeld őket egy hívásváltozóhoz (lásd lentebb) vagy egy statikus szöveghez.

Elérhető hívásváltozók, amelyeket a sablon helykitöltőibe leképezhetsz:

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 (pozitív/semleges/negatív)
`{{call_task_achieved}}`	Teljesült-e a hívás feladata
`{{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 idő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ő menü mindig pontosan azt mutatja, ami épp küldhető — nem tudsz véletlenül piszkozatot, elutasított sablont vagy nem létező SID-et választani. Új sablon hozzáadásához fordulj a támogatáshoz; miután a WhatsApp jóváhagyta, automatikusan megjelenik a legördülő menüben.

API Call

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

Beállítás	Leírás
Name	Kötelező. Művelet-azonosító
Trigger Condition	Mikor induljon (üres = minden hívás). Egy LLM értékeli ki az átirat alapján.
API URL	Kötelező. Az API-végpont URL-je
HTTP Method	Kötelező. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Headers	Opcionális kérésfejlécek
Query Parameters	Opcionális query-string paraméterek

Mit kap az endpointod

POST / PUT / PATCH esetén az endpointod egy JSON-objektumot kap a kérés törzsében. A beállított body paramétereid összefésülődnek a teljes hívás-adatcsomaggal:

{
  "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": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": {
    "name": "John",
    "email": "john@example.com"
  },
  "collected_data": { /* in-call form submissions */ },
  "transfer_history": [ /* if any agent transfer happened */ ],
  "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 laposodnak — de a beágyazott értékek, mint a transcription, sentiment és custom_analysis_data, kimaradnak (az URL-ek nem hordozhatnak épeszűen strukturált adatot). Használj POST/PUT/PATCH-et, ha szükséged van az átiratra.

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

Előlekérés vs. hívás utáni API Call

Az Pre fetch a {phone} stb. tokeneket sablonozza be az URL-be/fejlécekbe/querybe/törzsbe. A promptba tér vissza, a hívás előtt.
A Post call API Call a teljes hívás-adatcsomagot küldi a törzsben vagy a queryben. Nincs URL-sablonozás — az endpointod statikus URL-t + dinamikus törzset kap.

Lekérdezési változók

A lekérdezési változók olyan egyéni adatmezők, amelyeket az AI automatikusan kinyer a beszélgetésekből. Például az ügynök rögzítheti a hívó nevét, e-mail-címét, telefonszámát vagy bármely más információt, amelyet meghatározol.

Alapértelmezett változók

Minden új ügynök két alapértelmezett lekérdezési 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élyezettek, és megjelennek a hívás-widget űrlapján. Szerkesztheted vagy eltávolíthatod őket, és hozzáadhatod a saját egyéni változóidat.

Változótípusok

Típus	Felhasználási eset	Példa
Text	Nevek, címek, jegyzetek, szabad szöveges bevitel	Ügyfélnév, szállítási cím
Number	Mennyiségek, költségvetések, azonosítók	Rendelési mennyiség, költségvetési összeg
Email	E-mail-címek ellenőrzéssel	Ügyfél e-mail-címe
Phone	Telefonszámok ellenőrzéssel	Ügyfél telefonszáma
Selector	Választás előre definiált opciók közül	Preferált csomag (Basic/Pro/Enterprise)
Checkbox	Igen/nem hozzájárulás vagy megerősítés	„Beleegyezem marketing e-mailek fogadásába"

Egy változó konfigurálása

Mező	Leírás	Példa
Variable Name	Kötelező. Változóazonosító	`customer_email`
Instructions for AI	Kötelező. Utasítások az AI-nak arról, mikor és hogyan nyerje ki ezt az értéket	`"The customer's email address. Ask if not provided."`
Example Format	(Opcionális) Példa a várt formátumra	`"john@example.com"`
Options (for Selector)	(Csak Selector) Az engedélyezett opciók listája	`["Basic", "Pro", "Enterprise"]`
Show in Form	Megjelenjen-e ez a mező a hívás-widget űrlapján	Alapértelmezetten engedélyezve

Show in Form

Ha a Show in Form engedélyezve van, a változó látható beviteli mezőként jelenik meg a web-widgetben a hívás előtt és közben. Ez lehetővé teszi, hogy a hívók közvetlenül kitöltsék az adataikat, azon felül, hogy az AI kinyeri őket a beszélgetésből.

tanács

Az AI a beszélgetés során természetes módon rákérdez a hiányzó információkra. Állíts be egy világos leírást, például „Az ügyfél e-mail-címe, udvariasan kérdezd meg, ha nincs megadva", és az ügynök elintézi.

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

Navigálj az ügynököd Actions fülére.
Kattints az Add Tool gombra.
Válaszd ki a megfelelő fázist a legördülő menüből — Pre fetch, Live call vagy Post call.
Konfiguráld a beállításokat.
Mentsd el — a módosítá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ó témák

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átozások​

É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 servers​

API Tool RAG​

A Body Parameters Schema megírása​

Minimális szerkezet​

Mezőreferencia​

Példák​

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

Élő üzenetküldési műveletek​

Hívásonkénti küldési korlát​

Elutasítási mátrix​

CRM-idővonalba naplózás​

Intelligens űrlap–csatorna láncolás​

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

Elérhető műveletek​

Send Email​

Send SMS​

Send WhatsApp​

API Call​

Mit kap az endpointod​

Lekérdezési változók​

Alapértelmezett változók​

Változótípusok​

Egy változó konfigurálása​

Show in Form​

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

Kapcsolódó témák​

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átozások

É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 servers

API Tool RAG

A Body Parameters Schema megírása

Minimális szerkezet

Mezőreferencia

Példák

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

Élő üzenetküldési műveletek

Hívásonkénti küldési korlát

Elutasítási mátrix

CRM-idővonalba naplózás

Intelligens űrlap–csatorna láncolás

Hívás utáni műveletek

Elérhető műveletek

Send Email

Send SMS

Send WhatsApp

API Call

Mit kap az endpointod

Lekérdezési változók

Alapértelmezett változók

Változótípusok

Egy változó konfigurálása

Show in Form

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

Kapcsolódó témák