Akce a nástroje

Karta Akce je místo, kde spravujete všechno, co váš agent umí nad rámec konverzace — nástroje, které agent volá během živého hovoru, prefetch hooky, jež běží před zahájením hovoru, a akce po hovoru, které se spustí, jakmile hovor skončí. Proměnné pro získávání dat (datová pole, která agent z každé konverzace extrahuje) najdete na stejné kartě.

Všechny tarify

Všechny nástroje, akce i nový pre-fetch hook jsou dostupné v každém tarifu, včetně tarifu Free.

Tři fáze

Každá položka na kartě Akce patří do jedné ze tří fází životního cyklu. Rozbalovací nabídka Add Tool je seskupuje, aby bylo jasné, kdy se každá věc spustí:

Fáze	Kdy	Příklady
Pre fetch	Před tím, než agent pozdraví	Vyhledání volajícího ve vašem CRM podle telefonu, načtení nejnovější objednávky, získání personalizovaného pozdravu z vašeho backendu
Živý hovor	Během konverzace, spuštěno AI ve správnou chvíli	Přepojení hovoru na člověka, kontrola dostupnosti v kalendáři, přepojení na jiného agenta, dotaz na externí API pro data
Po hovoru	Po skončení hovoru	Odeslání souhrnného e-mailu, odeslání SMS potvrzení, odeslání dat o hovoru do vašeho CRM

Rozbalovací nabídka se otevírá s možností Pre fetch nahoře, protože každá další fáze už má spoustu možností — nová položka pre-fetch je nejpravděpodobněji to, co hledáte.

Pre fetch

Pre-fetch hooky umožňují vašemu agentovi zahájit hovor už s vědomím, kdo volá. Běží paralelně s navazováním hovoru a vloží odpověď do systémového promptu agenta ještě předtím, než padne úplně první slovo.

Kdy jej použít

Rozpoznání vracejícího se zákazníka podle telefonního čísla a oslovení jménem
Načtení otevřené objednávky volajícího, poslední schůzky nebo úrovně členství
Předběžné načtení obchodního kontextu, který závisí na tom, na kterou linku bylo voláno
Vložení poznámek z CRM, aby agent znal fázi a historii leadu

Jak to funguje

Platforma vyřeší telefon volajícího (ze SIP u příchozích hovorů, z cílového čísla u odchozích).
Každá aktivní akce Pre fetch se spustí paralelně s pevným časovým limitem 1,5 s na požadavek a celkovým rozpočtem 2 s.
Úspěšné odpovědi jsou spojeny do systémového promptu agenta jako pojmenované bloky — agent si je přečte hned při svém prvním tahu.
Selhání jsou tichá — pomalý nebo nefunkční endpoint nikdy nezablokuje pozdrav. Agent prostě začne mluvit bez tohoto bloku.

Konfigurace

Pole	Popis
Name	Povinné. Interní štítek a název bloku v promptu — udržujte jej krátký a výstižný (např. `crm_lookup`, `vip_check`).
API URL	Povinné. Endpoint, ze kterého se načítá. Podporuje zástupné symboly `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}`.
HTTP Method	`GET` je výchozí a nejvhodnější. `POST` / `PUT` / `PATCH` / `DELETE` také fungují.
Headers	Volitelné. Statické nebo šablonované (zástupné symboly zde fungují také).
Query Parameters	Volitelné. U nových pre-fetch akcí se předvyplní hodnotou `phone={phone}`.

Dostupné proměnné

Tyto tokeny se v čase požadavku dosadí do URL, hlaviček a query/body parametrů:

Proměnná	Zdroj	Příklad hodnoty
`{phone}`	Telefon volajícího (E.164) — u odchozích hovorů cílové číslo	`+431234567890`
`{direction}`	`inbound` nebo `outbound`	`inbound`
`{agent_id}`	Interní id agenta	`65f1a2b3c4...`
`{user_id}`	Id vlastníka pracovního prostoru	`65e0b1c2d3...`
`{call_id}`	Id hovoru (umožňuje vašemu backendu později korelovat data po hovoru)	`65f1f2c4d5...`

Neznámé zástupné symboly zůstanou ponechány doslovně — chybné šablonování nikdy neshodí hovor.

Co se dostane do promptu

Pokud váš endpoint na adrese https://crm.example.com/lookup?phone={phone} vrátí:

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

K systémovému promptu agenta se připojí blok obalený XML pojmenovaný podle akce:

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

Nemusíte agentovi říkat, jak jej použít — LLM kontext převezme přirozeně. Volitelně se o pre-fetch zmiňte ve svém systémovém promptu: "If <call_context> contains a customer name, greet them by name."

Důležitá omezení

Pouze telefonní hovory. Pre-fetch neběží u widget (webových) hovorů — není k dispozici žádné telefonní číslo pro šablonování.
Limit 8 KB na tělo odpovědi — cokoli delšího je před vložením oříznuto. Limit chrání váš rozpočet tokenů promptu a omezuje dosah škodlivého endpointu.
Žádné vyhodnocování condition — pre-fetch se spustí vždy, když je aktivní. Zatím neexistuje žádný přepis, vůči kterému by se dalo vyhodnocovat.

tip

Použijte GET s vyhledávacím endpointem klíčovaným podle telefonu. Udržujte odpovědi malé a strukturované (JSON objekt se 3–5 poli). Agent nepotřebuje váš kompletní zákaznický záznam — jen ty části, které mění konverzaci.

Nástroje živého hovoru

Tyto běží během konverzace. AI rozhoduje, kdy který nástroj zavolat, na základě jeho popisu a aktuálního dialogu.

Dostupné nástroje

Nástroj	Účel	Kdy použít
Přepojení hovoru	Přepojení na živého operátora	Zákazník žádá o osobu, složité problémy
Google Calendar	Kontrola dostupnosti a rezervace schůzek	Zákazník si chce naplánovat schůzku
Outlook Calendar	Totéž, přes Microsoft Outlook	Zákazník si chce naplánovat schůzku
API Tool RAG	Načtení živých dat z externího API	Potřeba informací v reálném čase (objednávky, sklad, stav účtu)
Přepojení na agenta	Přepojení na jiného hlasového agenta	Volající potřebuje jiné oddělení nebo specialistu
HubSpot CRM	Čtení/zápis kontaktů a obchodů v HubSpotu	Zaznamenání hovoru do HubSpotu, vyhledání leadu
MCP servery	Zpřístupnění nástrojů z libovolného vašeho registrovaného MCP serveru	Provozujete server nástrojů kompatibilní s MCP a chcete, aby agent jeho nástroje používal uprostřed konverzace

Přepojení hovoru

Přepojení hovorů na člověka, když jsou splněny konkrétní podmínky.

Nastavení	Popis	Příklad
Name	Povinné. Jméno osoby nebo oddělení	`"Sales Manager"`
Forwarding Number	Výchozí telefonní číslo, na které přepojit	`"+49 123 456 789"`
Trigger Condition	Kdy má agent přepojit	`"Customer asks for manager or issue cannot be resolved"`
Conditional Routing Numbers	Mapování podmínka–číslo pro směrování	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Jak to funguje:

Během konverzace AI vyhodnocuje Trigger Condition.
Pokud jsou nastavena podmíněná směrovací čísla, odpovídající podmínka určuje, na které číslo volat.
Jinak se použije Forwarding Number.
Agent informuje volajícího o přepojení.
Hovor je přepojen — pokud nikdo nezvedne, vrátí se zpět k agentovi.

tip

Můžete přidat více nástrojů Přepojení hovoru pro různá oddělení — jeden pro „Sales“ a další pro „Technical Support“ s odlišnými podmínkami a čísly.

Google Calendar

Připojte svůj Google Calendar, aby agent mohl během hovorů kontrolovat dostupnost a rezervovat schůzky.

Nastavení:

Přejděte do Integration → Calendars a nejprve připojte svůj účet Google.
Přidejte nástroj Google Calendar na kartě Akce agenta.
Vyberte kalendář, který se má použít.
Nakonfigurujte nastavení dostupnosti.

Nastavení	Popis	Výchozí
Calendar	Povinné. Který kalendář použít	Váš primární kalendář
Timezone	Časové pásmo pro schůzky (formát IANA)	Automaticky detekováno
Work Start Time	Začátek pracovní doby	9:00
Work End Time	Konec pracovní doby	18:00
Slot Duration	Délka schůzky v minutách	30
Working Days	Dostupné dny v týdnu	Pondělí–pátek
Buffer Between Appointments	Rezerva mezi schůzkami (0–60 min)	0

Podporované délky slotů: 15, 30, 45, 60, 75, 90, 105, 120 minut.

tip

Nastavte svou pracovní dobu a dny přesně — agent bude nabízet pouze časové sloty v rámci vaší nakonfigurované dostupnosti.

Outlook Calendar

Připojte svůj Outlook Calendar pro plánování schůzek během hovorů. Funguje stejně jako Google Calendar.

Nastavení:

Přejděte do Integration → Calendars a nejprve připojte svůj účet Outlook.
Přidejte nástroj Outlook Calendar na kartě Akce agenta.
Vyberte kalendář, který se má použít.
Nakonfigurujte nastavení dostupnosti.

Nastavení jsou totožná s Google Calendar (časové pásmo, pracovní doba, délka slotu, pracovní dny, rezerva).

Přepojení na agenta

Přepojení hovoru na jiného hlasového agenta na vašem účtu. Užitečné, když máte specializované agenty pro různá oddělení.

Nastavení	Popis
Target Agent	Povinné. Vyberte, na kterého agenta přepojit
Trigger Condition	Kdy přepojit (např. „Volající se ptá na technickou podporu“)

Příklad: Agent recepce přepojuje volající na obchodního agenta, když se ptají na ceny, nebo na agenta podpory, když mají technický problém.

HubSpot CRM

Čtení a zápis do vašeho HubSpot CRM během hovoru. Umožňuje agentovi zaznamenávat interakce, vyhledat kontakt podle telefonu nebo odesílat aktualizace obchodů, aniž byste museli sami psát volání API.

Nastavení:

Přejděte na stránku Integrations a připojte svůj účet HubSpot.
Přidejte nástroj HubSpot CRM na kartě Akce agenta.
Vyberte, kterých pipeline a vlastností se agent smí dotýkat.

Po přidání nástroje může AI přiřadit volajícího ke kontaktu v HubSpotu podle telefonu, načíst fázi obchodu a aktualizovat pole — to vše přímo z živé konverzace.

MCP servery

Zpřístupněte nástroje z libovolného MCP-kompatibilního serveru, který jste připojili k Hanc.AI. Jeden agent může čerpat z více MCP serverů; jeden MCP server může obsluhovat více agentů.

Nastavení:

Připojte své MCP servery jednou v části Integration → MCP servers. Kompletní kroky registrace najdete na samostatné stránce MCP Servery.
Přidejte položku MCP servery na kartu Akce tohoto agenta — v rozbalovací nabídce Add Action je seskupena pod Živý hovor.
Zapněte přepínačem, ke kterým z vašich registrovaných připojení má tento agent mít přístup.
Přidejte krátkou instrukci „Kdy to použít“, aby agent věděl, kdy po těchto nástrojích sáhnout.

Agent znovu objeví sadu nástrojů z každého povoleného MCP serveru na začátku každého hovoru, takže změny, které provedete na straně serveru, se automaticky projeví při dalším hovoru. Nástroje jsou přejmenovány s předponou v podobě štítku připojení, aby podobně pojmenované nástroje z různých serverů nekolidovaly.

API Tool RAG

Připojte se k externím API a načítejte informace v reálném čase během hovorů — vyhledávejte objednávky, kontrolujte sklad, ověřujte účty nebo přistupujte k jakýmkoli datům dostupným přes API.

Nastavení	Popis	Příklad
Name	Povinné. Název nástroje	`"Order Lookup"`
Description / When to Use	Povinné. Kdy se má dotázat API	`"Customer asks about order status"`
API URL	Povinné. Endpoint API. Může obsahovat tokeny `{placeholder}`, které se nahradí hodnotami z Body Parameters Schema (viz níže).	`"https://api.yourshop.com/orders/{order_id}"`
HTTP Method	Povinné. HTTP metoda	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Loading Message	Co agent říká, zatímco čeká	`"Let me check that for you..."`
Timeout	Maximální doba čekání (ms)	`5000` (výchozí)
Headers	Statické HTTP hlavičky odesílané s každým požadavkem	`{"Authorization": "Bearer KEY"}`
Query Parameters	Statické parametry query stringu přidané ke každému požadavku	`{"apiVersion": "v2"}`
Body Parameters Schema	Povinné. JSON Schema popisující argumenty, které má AI z konverzace extrahovat a předat nástroji. Viz Psaní Body Parameters Schema.	JSON Schema objekt

tip

Vždy nastavte Loading Message — ticho během volání API působí na volajícího jako porucha.

poznámka

Starý zaškrtávací box „Run on call start“ u API Tool RAG byl nahrazen samostatnou položkou Pre fetch. Pre fetch použijte, když chcete data ještě před zahájením konverzace; API Tool RAG použijte, když má agent rozhodnout během hovoru, zda data načíst.

Psaní Body Parameters Schema

Navzdory názvu Body Parameters Schema není surové tělo požadavku. Je to JSON Schema popisující, co má AI z konverzace extrahovat a předat vašemu nástroji. V závislosti na HTTP metodě a šabloně URL tyto hodnoty skončí v URL, v query stringu, nebo v JSON těle:

HTTP metoda	Kam extrahované hodnoty jdou
URL obsahuje `{name}`	Odpovídající hodnota se dosadí do URL
`GET`, `DELETE`	Zbývající hodnoty se připojí k URL jako `?key=value`
`POST`, `PUT`, `PATCH`	Zbývající hodnoty se odešlou jako JSON tělo

Minimální struktura

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

Kořenový type je vždy "object". properties vypisuje jednotlivé argumenty. required označuje, které z nich musí AI vždy poskytnout — pokud je zákazník ještě neuvedl, AI se před voláním nástroje zeptá.

Referenční přehled polí

Pole	Účel
`type`	JSON typ hodnoty: `"string"`, `"number"`, `"integer"`, `"boolean"`, `"array"`, `"object"`
`description`	Nejdůležitější. Říká AI, co hodnota znamená, jaký formát použít a kdy ji poskytnout. Kdykoli je to možné, přidejte příklady.
`enum`	Omezuje hodnotu na jednu z pevného seznamu. AI namapuje přirozenou řeč na nejbližší možnost (např. `"the blue one"` → `"blue"`).
`minimum`, `maximum`	Číselné meze. AI odmítne/ořízne hodnoty mimo rozsah.
`default`	Hodnota použitá, když AI toto pole nepředá. Není povinné, ale dokumentuje implicitní hodnotu.
`format`	Nápověda pro validaci, např. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Příklady

Vyhledávání produktů (pouze klíčové slovo):

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product search keyword — e.g. \"phone\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

Použito s URL https://dummyjson.com/products/search?q={query}&limit=5 a GET: hodnota query jde do zástupného symbolu v URL. Do těla nic nejde.

Vyhledání objednávky podle ID:

{
  "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"]
}

Použito s URL https://api.example.com/orders/{order_id} a GET.

Rezervace s více povinnými poli:

{
  "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"]
}

Použito s POST https://api.example.com/reservations: čtyři hodnoty jdou do JSON těla. AI se zákazníka zeptá na chybějící required pole, než nástroj zavolá.

Nástroj bez parametrů:

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

Použijte, když je endpoint plně statický (např. GET /store/hours) a AI nemusí nic předávat.

Osvědčené postupy pro hlasové agenty

Udržujte schéma ploché. Vnořené objekty a pole fungují, ale AI může při telefonování chybovat. Preferujte maximálně 3–5 polí na nejvyšší úrovni.
Vždy napište description pro každé pole. Zahrňte příklady (e.g. "phone", "laptop") — příklady vedou AI spolehlivěji než abstraktní definice.
Použijte enum, kdykoli máte pevný seznam hodnot. Odstraní to riziko, že si AI hodnoty vymyslí nebo odešle "Electronics" místo "electronics".
Označte pole jako required jen tehdy, když bez něj nástroj nemůže fungovat. Vše ostatní je volitelné a AI to přeskočí, když se o tom zákazník nezmínil — žádné trapné otázky navíc.
Používejte názvy ve snake_case a přesně je párujte s libovolnými tokeny {placeholder} v URL.
Zdokumentujte v description chování pro chybějící hodnoty — např. "Omit if no budget limit", "Default 5".

Akce živých zpráv

(v2.4) Send SMS live a Send Email live umožňují agentovi odeslat textovou zprávu nebo e-mail uprostřed hovoru, zatímco stále mluví s volajícím — nejen po skončení hovoru jako jejich protějšky po hovoru. Použijte je k odeslání odkazu, potvrzení rezervace, kódu nebo souhrnu, na který může volající zareagovat ještě před zavěšením.

AI tyto akce spouští sama, v daný okamžik, na základě popisu akce a konverzace — stejně jako se rozhoduje volat kterýkoli jiný živý nástroj.

Akce	Spouští se	Odesílá na
Send SMS live	Během hovoru	Telefonní číslo volajícího
Send Email live	Během hovoru	E-mail volajícího

Limit odeslání na hovor

Každý kanál je omezen na 3 odeslání na kanál na hovor. Agent může v jediném hovoru odeslat až tři živé SMS a až tři živé e-maily; čtvrté odeslání na kanálu je odmítnuto. To brání ukecané nebo zacyklené konverzaci ve spamování volajícího.

Matice odmítnutí

Živé odeslání je odmítnuto (a agentovi je sděleno proč, aby se mohl elegantně zotavit), když:

Podmínka	Výsledek
Neplatný nebo chybějící e-mail (pro Send Email live)	Odmítnuto — agent požádá volajícího o potvrzení e-mailu
Neplatný nebo chybějící telefon (pro Send SMS live)	Odmítnuto — agent požádá volajícího o potvrzení čísla
Tělo delší než 160 znaků	Odmítnuto — zpráva je příliš dlouhá na odeslání v této podobě
Dosažen limit kanálu (již 3 odeslání v tomto hovoru)	Odmítnuto — žádná další odeslání na tomto kanálu

Protože agent dostane důvod odmítnutí zpět, může problém vyřešit v konverzaci („Můžete mi ten e-mail vyhláskovat?“) a zkusit to znovu, místo aby tiše selhal.

Zaznamenávání do časové osy CRM

Každé živé odeslání je zaznamenáno do časové osy CRM kontaktu, takže zpráva, kterou agent odeslal uprostřed hovoru, se objeví vedle záznamu o hovoru — přesně vidíte, co bylo odesláno, na který kanál a kdy.

Chytré řetězení formulář–kanál

Když webový volající odešle formulář widgetu jen s některými kontaktními údaji, agent použije pouze kanál, který skutečně má:

Volající odešle pouze e-mail → agent spustí Send Email live (nikdy SMS).
Volající odešle pouze telefon → agent spustí Send SMS live (nikdy e-mail).
Volající odešle oboje → agent může použít kterýkoli kanál, jak si konverzace vyžádá.

To znamená, že se agent nikdy nepokusí poslat SMS volajícímu, který uvedl jen e-mail, ani e-mail tomu, kdo uvedl jen číslo — dostupná data z formuláře určují, která živá akce je ve hře.

Akce po hovoru

Akce po hovoru se spustí, jakmile hovor skončí a analytický řetězec vyprodukuje souhrn, sentiment a extrahované proměnné. Spotřebovávají data o hovoru — nemluví se zákazníkem.

Dostupné akce

Akce	Účel
Send Email	Odeslání strukturovaného souhrnu e-mailem vašemu týmu nebo zákazníkovi
Send SMS	Textové potvrzení volajícímu
Send WhatsApp	Zpráva nebo šablona WhatsApp (funguje uvnitř i mimo 24hodinové okno)
API Call	Odeslání kompletních dat o hovoru do externího API (CRM, webhook, váš datový sklad)

Send Email

Nastavení	Popis
Name	Povinné. Identifikátor akce
Subject	Povinné. Předmět e-mailu
Message Body	Povinné. Tělo e-mailu — může obsahovat proměnné pro získávání dat
Trigger Condition	Kdy odeslat (prázdné = vždy)
Recipients	Povinné. E-mailové adresy, které e-mail dostávají vždy
Conditional Recipients	Mapování podmínka–příjemce

Použití proměnných v e-mailu:

New lead from phone call:

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

Send SMS

Nastavení	Popis
Name	Povinné. Identifikátor akce
Sender Name	Zobrazované jméno odesílatele
Message	Povinné. Obsah SMS (může obsahovat proměnné)
Trigger Condition	Kdy odeslat
Recipients	Povinné. Telefonní čísla, která SMS dostávají vždy
Conditional Recipients	Mapování podmínka–číslo

Send WhatsApp

Zasílání zpráv přes WhatsApp na HANC používá předem schválené šablony z centrálního účtu Twilio Content — Template SID nevkládáte ručně. Editor akce zobrazí rozbalovací nabídku všech šablon, které jsou aktuálně aktivní a schválené, a jednu z nich vyberete. Zástupné symboly uvnitř šablony ({{1}}, {{2}}, …) se poté vyplní přímo z proměnných hovoru nebo ze statického textu, který namapujete v editoru.

Nastavení	Popis
Name	Povinné. Identifikátor akce
Trigger Condition	Kdy odeslat
Recipients	Povinné. Telefonní čísla, která zprávu dostávají vždy
Conditional Recipients	Mapování podmínka–číslo
Template	Povinné. Rozbalovací výběr předem schválených šablon WhatsApp synchronizovaných z centrálního účtu Twilio Content. Každá položka zobrazuje název šablony, jazyk a náhled těla, abyste věděli, kterou vybrat.
Template Variables	Pro vybranou šablonu editor vypíše každý zástupný symbol (`{{1}}`, `{{2}}`, …) a umožní vám jej namapovat na proměnnou hovoru (viz níže) nebo statický řetězec.

Dostupné proměnné hovoru, které můžete namapovat do zástupných symbolů šablony:

Proměnná	Popis
`{{call_from}}`	Telefonní číslo volajícího
`{{call_to}}`	Číslo, na které bylo voláno
`{{call_summary}}`	Souhrn hovoru vygenerovaný AI
`{{call_sentiment}}`	Sentiment (pozitivní/neutrální/negativní)
`{{call_task_achieved}}`	Zda byl úkol hovoru splněn
`{{call_transcription}}`	Kompletní přepis hovoru

Proč výběr, ne volný text

WhatsApp vyžaduje, aby každá firmou iniciovaná zpráva mimo 24hodinové okno zákaznického servisu používala předem schválenou šablonu. HANC synchronizuje seznam schválených šablon ze sdíleného účtu Twilio Content, takže rozbalovací nabídka vždy zobrazuje přesně to, co je právě teď způsobilé k odeslání — nemůžete omylem vybrat koncept, zamítnutou šablonu nebo SID, který neexistuje. Chcete-li přidat novou šablonu, kontaktujte podporu; jakmile ji WhatsApp schválí, objeví se v nabídce automaticky.

API Call

Akce API Call po hovoru je váš univerzální webhook do zbytku vašeho technologického stacku. Vyberte metodu, nastavte URL a my odešleme kompletní data o hovoru — váš endpoint obdrží strukturovaný JSON objekt popisující, co se stalo.

Nastavení	Popis
Name	Povinné. Identifikátor akce
Trigger Condition	Kdy spustit (prázdné = každý hovor). Vyhodnocuje LLM vůči přepisu.
API URL	Povinné. URL endpointu API
HTTP Method	Povinné. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Headers	Volitelné hlavičky požadavku
Query Parameters	Volitelné parametry query stringu

Co váš endpoint obdrží

Pro POST / PUT / PATCH váš endpoint dostane JSON objekt v těle požadavku. Vaše nakonfigurované body parametry se sloučí s kompletními daty o hovoru:

{
  "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
}

Pro GET / DELETE se stejná pole zploští do query stringu — ale vnořené hodnoty jako transcription, sentiment a custom_analysis_data jsou vynechány (URL neumí rozumně nést strukturovaná data). Pokud potřebujete přepis, použijte POST/PUT/PATCH.

Každý požadavek také dostane hlavičku X-Correlation-Id pro trasování a vyprší po 30 sekundách.

Pre-fetch vs API Call po hovoru

Pre fetch šablonuje {phone} atd. do URL/hlaviček/query/těla. Vrací se do promptu, před hovorem.
API Call po hovoru odesílá kompletní výpis hovoru v těle nebo query. Žádné šablonování URL — váš endpoint dostane statickou URL + dynamické tělo.

Proměnné pro získávání dat

Proměnné pro získávání dat jsou vlastní datová pole, která AI automaticky extrahuje z konverzací. Agent například může zachytit jméno volajícího, e-mail, telefonní číslo nebo jakoukoli jinou informaci, kterou definujete.

Výchozí proměnné

Každý nový agent je vytvořen se dvěma výchozími proměnnými pro získávání dat:

Proměnná	Typ	Popis
Email	Email	E-mailová adresa volajícího
Phone	Phone	Telefonní číslo volajícího

Ty jsou ve výchozím stavu povolené a zobrazené ve formuláři widgetu hovoru. Můžete je upravit nebo odebrat a přidat vlastní proměnné.

Typy proměnných

Typ	Případ použití	Příklad
Text	Jména, adresy, poznámky, volný vstup	Jméno zákazníka, dodací adresa
Number	Množství, rozpočty, ID	Množství objednávky, výše rozpočtu
Email	E-mailové adresy s validací	E-mail zákazníka
Phone	Telefonní čísla s validací	Telefonní číslo zákazníka
Selector	Výběr z předdefinovaných možností	Preferovaný tarif (Basic/Pro/Enterprise)
Checkbox	Souhlas nebo potvrzení ano/ne	„Souhlasím se zasíláním marketingových e-mailů“

Konfigurace proměnné

Pole	Popis	Příklad
Variable Name	Povinné. Identifikátor proměnné	`customer_email`
Instructions for AI	Povinné. Instrukce pro AI, kdy a jak tuto hodnotu extrahovat	`"The customer's email address. Ask if not provided."`
Example Format	(Volitelné) Příklad očekávaného formátu	`"john@example.com"`
Options (for Selector)	(Pouze Selector) Seznam povolených možností	`["Basic", "Pro", "Enterprise"]`
Show in Form	Zda toto pole zobrazit ve formuláři widgetu hovoru	Ve výchozím stavu povoleno

Show in Form

Když je Show in Form povoleno, proměnná se před hovorem a během hovoru zobrazí jako viditelné vstupní pole ve webovém widgetu. To umožňuje volajícím vyplnit své údaje přímo, kromě toho, že je AI extrahuje z konverzace.

tip

AI se během konverzace přirozeně zeptá na chybějící informace. Nastavte jasný popis jako „E-mailová adresa zákazníka, zdvořile se zeptejte, pokud není uvedena“ a agent se o to postará.

Přidávání nástrojů a akcí

Přejděte na kartu Akce svého agenta.
Klikněte na Add Tool.
Vyberte správnou fázi z rozbalovací nabídky — Pre fetch, Živý hovor, nebo Po hovoru.
Nakonfigurujte nastavení.
Uložte — změny se projeví při dalším hovoru.

Všechny položky jsou vypsány společně v tabulce Akce. Kliknutím na libovolný řádek jej upravíte, nebo použijte ikonu koše k odstranění.

Související

Přehled hlasových agentů
Prompt engineering — Odkazování na nástroje ve vašem promptu
Znalostní báze — Zdroje informací
Integrace — Externí systémy, se kterými mohou vaše nástroje komunikovat

Tři fáze​

Pre fetch​

Kdy jej použít​

Jak to funguje​

Konfigurace​

Dostupné proměnné​

Co se dostane do promptu​

Důležitá omezení​

Nástroje živého hovoru​

Dostupné nástroje​

Přepojení hovoru​

Google Calendar​

Outlook Calendar​

Přepojení na agenta​

HubSpot CRM​

MCP servery​

API Tool RAG​

Psaní Body Parameters Schema​

Minimální struktura​

Referenční přehled polí​

Příklady​

Osvědčené postupy pro hlasové agenty​

Akce živých zpráv​

Limit odeslání na hovor​

Matice odmítnutí​

Zaznamenávání do časové osy CRM​

Chytré řetězení formulář–kanál​

Akce po hovoru​

Dostupné akce​

Send Email​

Send SMS​

Send WhatsApp​

API Call​

Co váš endpoint obdrží​

Proměnné pro získávání dat​

Výchozí proměnné​

Typy proměnných​

Konfigurace proměnné​

Show in Form​

Přidávání nástrojů a akcí​

Související​

Tři fáze

Pre fetch

Kdy jej použít

Jak to funguje

Konfigurace

Dostupné proměnné

Co se dostane do promptu

Důležitá omezení

Nástroje živého hovoru

Dostupné nástroje

Přepojení hovoru

Google Calendar

Outlook Calendar

Přepojení na agenta

HubSpot CRM

MCP servery

API Tool RAG

Psaní Body Parameters Schema

Minimální struktura

Referenční přehled polí

Příklady

Osvědčené postupy pro hlasové agenty

Akce živých zpráv

Limit odeslání na hovor

Matice odmítnutí

Zaznamenávání do časové osy CRM

Chytré řetězení formulář–kanál

Akce po hovoru

Dostupné akce

Send Email

Send SMS

Send WhatsApp

API Call

Co váš endpoint obdrží

Proměnné pro získávání dat

Výchozí proměnné

Typy proměnných

Konfigurace proměnné

Show in Form

Přidávání nástrojů a akcí

Související