Akce a nástroje

Karta Akce je místem, kde spravujete všechno, co může váš agent dělat nad rámec konverzace — nástroje, které agent volá během živé konverzace, předběžné háčky, které běží před zahájením hovoru, a akce po hovoru, které se spouštějí, jakmile hovor skončí. Proměnné pro získávání dat (datová pole, která agent extrahuje z každé konverzace) žijí ve stejné kartě.

Všechny plány

Všechny nástroje, akce a nový předběžný háček jsou k dispozici na každém plánu, včetně Free.

Tři fáze

Každý záznam na kartě Akce patří do jedné ze tří fází životního cyklu. Rozevírací nabídka Přidat nástroj je seskupuje, takže je jasné, kdy se každá věc spouští:

Fáze	Kdy	Příklady
Pre fetch	Před tím, než agent pozdraví	Najít volajícího ve vašem CRM podle telefonu, načíst nejnovější objednávku, načíst personalizovaný pozdrav z vašeho backendu
Live call	Během konverzace, spouštěno AI, když je správná chvíle	Přepojit hovor na člověka, zkontrolovat dostupnost kalendáře, přepojit na jiného agenta, dotázat externí API na data
Post call	Po skončení hovoru	Odeslat shrnující e-mail, spustit SMS potvrzení, odeslat payload hovoru do vašeho CRM

Rozevírací nabídka se otevírá s Pre fetch nahoře, protože každá jiná fáze už má spoustu možností — nový předběžný záznam je věc, kterou pravděpodobně nejvíce hledáte.

Pre fetch

Předběžné háčky umožňují vašemu agentovi zahájit hovor s vědomím, kdo volá. Běží paralelně s nastavením hovoru a injektují odpověď do systémového promptu agenta předtím, než je vyřčeno první slovo.

Kdy to použít

Rozpoznat vracejícího se zákazníka podle telefonního čísla a oslovit ho jménem
Načíst otevřenou objednávku volajícího, poslední schůzku nebo členskou úroveň
Předem načíst obchodní kontext, který závisí na tom, na jakou linku bylo voláno
Injektovat poznámky CRM, aby agent znal fázi a historii leadu

Jak to funguje

Platforma vyřeší telefon volajícího (ze SIP pro příchozí, z cíle vytáčení pro odchozí).
Každá aktivní akce Pre fetch se spouští paralelně s tvrdý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 je čte ve svém prvním tahu.
Selhání jsou tichá — pomalý nebo rozbitý endpoint nikdy neblokuje pozdrav. Agent prostě začne mluvit bez toho bloku.

Konfigurace

Pole	Popis
Jméno	Povinné. Interní label a název bloku v promptu — udržujte krátký a popisný (např. `crm_lookup`, `vip_check`).
API URL	Povinné. Endpoint pro načtení. Podporuje placeholdery `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}`.
HTTP metoda	`GET` je výchozí a nejvhodnější. Funguje také `POST` / `PUT` / `PATCH` / `DELETE`.
Hlavičky	Volitelné. Statické nebo šablonované (placeholdery zde také fungují).
Query parametry	Volitelné. Pro nové předběžné akce se předvyplňuje `phone={phone}`.

Dostupné proměnné

Tyto tokeny jsou nahrazeny v URL, hlavičkách a query/body parametrech v době požadavku:

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

Neznámé placeholdery zůstávají doslovně — špatné šablonování nikdy nezhroutí hovor.

Co se objeví v promptu

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

{ "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 to použít — LLM kontext vyzvedne přirozeně. Volitelně zmiňte předběžnou akci ve svém systémovém promptu: "Pokud <call_context> obsahuje jméno zákazníka, oslovte ho jménem."

Důležitá omezení

Pouze telefonní hovory. Pre-fetch se nespouští pro widget (webové) hovory — není telefonní číslo, proti kterému šablonovat.
Strop 8 KB na tělo odpovědi — cokoli delšího je před injekcí oříznuto. Strop chrání váš rozpočet tokenů promptu a omezuje dopad maliciózního endpointu.
Žádné vyhodnocení condition — pre-fetch se vždy spouští, když je aktivní. Není ještě transkripce, proti které vyhodnocovat.

tip

Použijte GET s lookup endpointem klíčovaným podle telefonu. Udržujte odpovědi malé a strukturované (JSON objekt s 3-5 poli). Agent nepotřebuje váš celý záznam zákazníka — jen části, které mění konverzaci.

Nástroje pro živý hovor

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

Dostupné nástroje

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

Přepojení hovorů

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

Nastavení	Popis	Příklad
Jméno	Povinné. Jméno osoby nebo oddělení	`"Prodejní manažer"`
Číslo pro přepojení	Výchozí telefonní číslo pro přepojení	`"+49 123 456 789"`
Spouštěcí podmínka	Kdy by měl agent přepojit	`"Zákazník žádá manažera nebo problém nelze vyřešit"`
Podmíněná směrovací čísla	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 Spouštěcí podmínku.
Pokud jsou nastavena podmíněná směrovací čísla, odpovídající podmínka určuje, na které číslo volat.
Jinak se použije Číslo pro přepojení.
Agent informuje volajícího o přepojení.
Hovor je přepojen — pokud není odpověď, vrátí se k agentovi.

tip

Můžete přidat více nástrojů Přepojení hovorů pro různá oddělení — jeden pro "Prodej" a další pro "Technickou podporu" s různý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í:

Nejprve přejděte na Integrace → Kalendáře a připojte svůj Google účet.
Přidejte nástroj Google Calendar v kartě Akce agenta.
Vyberte kalendář k použití.
Konfigurujte nastavení dostupnosti.

Nastavení	Popis	Výchozí
Kalendář	Povinné. Který kalendář použít	Váš primární kalendář
Časové pásmo	Časové pásmo pro schůzky (formát IANA)	Automaticky detekováno
Začátek pracovní doby	Začátek pracovních hodin	9:00
Konec pracovní doby	Konec pracovních hodin	18:00
Délka slotu	Délka schůzky v minutách	30
Pracovní dny	Dostupné dny v týdnu	Pondělí–pátek
Rezerva mezi schůzkami	Rezerva mezi schůzkami (0–60 min)	0

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

tip

Nastavte své pracovní hodiny 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í:

Nejprve přejděte na Integrace → Kalendáře a připojte svůj Outlook účet.
Přidejte nástroj Outlook Calendar v kartě Akce agenta.
Vyberte kalendář k použití.
Konfigurujte nastavení dostupnosti.

Nastavení jsou identická s Google Calendar (časové pásmo, pracovní hodiny, délka slotu, pracovní dny, rezerva).

Přepojení na agenta

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

Nastavení	Popis
Cílový agent	Povinné. Vyberte, na kterého agenta přepojit
Spouštěcí podmínka	Kdy přepojit (např. "Volající se ptá na technickou podporu")

Příklad: Recepční agent přepojuje volající na prodejní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 logovat interakce, vyhledávat kontakt podle telefonu nebo odesílat aktualizace obchodů, aniž byste museli skriptovat API volání.

Nastavení:

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

Po přidání nástroje může AI spárovat volajícího s HubSpot kontaktem podle telefonu, načíst fázi obchodu a aktualizovat pole — to vše z živé konverzace.

MCP servery

Zpřístupněte nástroje z jakéhokoli 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 Integrace → MCP servery. Viz vyhrazená stránka MCP servery pro úplné kroky registrace.
Přidejte záznam MCP servery do karty Akce tohoto agenta — je seskupen pod Live call v rozevírací nabídce Přidat akci.
Zapněte, ke kterým ze svých registrovaných připojení by tento agent měl mít přístup.
Přidejte krátkou instrukci "Kdy to použít", aby agent věděl, kdy sáhnout po těchto nástrojích.

Agent znovu objevuje 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 objeví při dalším hovoru. Nástroje jsou přejmenovány s labelem připojení jako prefixem, aby si nástroje s podobnými názvy z různých serverů nepřekážely.

API Tool RAG

Připojení k externím API pro načítání informací v reálném čase během hovorů — vyhledat objednávky, zkontrolovat sklad, ověřit účty nebo přistoupit k jakýmkoli datům dostupným přes API.

Nastavení	Popis	Příklad
Jméno	Povinné. Název nástroje	`"Vyhledání objednávky"`
Popis / Kdy použít	Povinné. Kdy dotazovat API	`"Zákazník se ptá na stav objednávky"`
API URL	Povinné. API endpoint. Může obsahovat tokeny `{placeholder}`, které budou nahrazeny hodnotami ze Schématu parametrů těla (viz níže).	`"https://api.yourshop.com/orders/{order_id}"`
HTTP metoda	Povinné. HTTP metoda	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Zpráva načítání	Co agent řekne během čekání	`"Dovolte mi to zkontrolovat..."`
Časový limit	Maximální čas čekání (ms)	`5000` (výchozí)
Hlavičky	Statické HTTP hlavičky odesílané s každým požadavkem	`{"Authorization": "Bearer KEY"}`
Query parametry	Statické parametry query stringu přidané ke každému požadavku	`{"apiVersion": "v2"}`
Schéma parametrů těla	Povinné. JSON Schema popisující argumenty, které by AI měla extrahovat z konverzace a předat nástroji. Viz Psaní schématu parametrů těla.	Objekt JSON Schema

tip

Vždy nastavte Zprávu načítání — ticho během API volání působí na volajícího jako rozbité.

poznámka

Stará zaškrtávací políčka "Run on call start" na API Tool RAG byla nahrazena vyhrazeným záznamem Pre fetch. Použijte Pre fetch, když chcete data před zahájením konverzace; použijte API Tool RAG, když by agent měl rozhodnout během hovoru, zda načítat.

Psaní schématu parametrů těla

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

HTTP metoda	Kam jdou extrahované hodnoty
URL obsahuje `{name}`	Odpovídající hodnota je nahrazena v URL
`GET`, `DELETE`	Zbývající hodnoty jsou připojeny k URL jako `?key=value`
`POST`, `PUT`, `PATCH`	Zbývající hodnoty jsou odeslány 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 každý argument. required označuje, které musí AI vždy poskytnout — pokud to zákazník ještě neřekl, AI se zeptá před voláním nástroje.

Reference 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. Přidejte příklady, kdykoli je to možné.
`enum`	Omezuje hodnotu na jednu z pevného seznamu. AI mapuje přirozenou řeč na nejbližší možnost (např. `"ten modrý"` → `"blue"`).
`minimum`, `maximum`	Číselné hranice. AI odmítne/sevře hodnoty mimo rozsah.
`default`	Hodnota použitá, když AI toto pole nepředá. Není povinné, ale dokumentuje implicitní hodnotu.
`format`	Validační nápověda, např. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Příklady

Vyhledávání produktu (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 URL placeholderu. V těle nic nekončí.

Vyhledává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 zeptá zákazníka na chybějící required pole před voláním nástroje.

Nástroj bez parametrů:

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

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

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

Udržujte schéma ploché. Vnořené objekty a pole fungují, ale AI může uklouznout, když mluví na telefonu. Preferujte maximálně 3–5 polí na nejvyšší úrovni.
Vždy napište description pro každé pole. Zahrňte příklady (např. "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 vymyslí hodnoty nebo odešle "Electronics" místo "electronics".
Označte pole required pouze, pokud nástroj nemůže fungovat bez něj. Vše ostatní je volitelné a AI ho přeskočí, když to zákazník nezmínil — žádné nepříjemné dodatečné otázky.
Použijte názvy snake_case a přesně sladťte s jakýmikoli {placeholder} tokeny v URL.
Dokumentujte chování pro chybějící hodnoty v description — např. "Omit if no budget limit", "Default 5".

Akce po hovoru

Akce po hovoru se spouštějí, jakmile hovor skončí a analytický řetězec vyprodukoval shrnutí, sentiment a extrahované proměnné. Konzumují data hovoru — nemluví se zákazníkem.

Dostupné akce

Akce	Účel
Odeslat e-mail	E-mail strukturovaného shrnutí vašemu týmu nebo zákazníkovi
Odeslat SMS	Textové potvrzení volajícímu
Odeslat WhatsApp	WhatsApp zpráva nebo šablona (funguje uvnitř i mimo 24hodinové okno)
API volání	Odeslání úplného payloadu hovoru do externího API (CRM, webhook, váš datový sklad)

Odeslat e-mail

Nastavení	Popis
Jméno	Povinné. Identifikátor akce
Předmět	Povinné. Předmět e-mailu
Tělo zprávy	Povinné. Tělo e-mailu — může obsahovat proměnné pro získávání dat
Spouštěcí podmínka	Kdy odeslat (prázdné = vždy)
Příjemci	Povinné. E-mailové adresy, které vždy obdrží e-mail
Podmíněné příjemci	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}}

Odeslat SMS

Nastavení	Popis
Jméno	Povinné. Identifikátor akce
Jméno odesílatele	Zobrazené jméno odesílatele
Zpráva	Povinné. Obsah SMS (může obsahovat proměnné)
Spouštěcí podmínka	Kdy odeslat
Příjemci	Povinné. Telefonní čísla, která vždy obdrží SMS
Podmíněné příjemci	Mapování podmínka-číslo

Odeslat WhatsApp

WhatsApp zprávy na HANC používají předem schválené šablony z centrálního Twilio Content účtu — Template SID nevkládáte ručně. Editor akcí zobrazuje rozevírací nabídku všech aktuálně aktivních a schválených šablon a vy vyberete jednu. Placeholdery uvnitř šablony ({{1}}, {{2}}, …) jsou poté inline vyplňovány z proměnných hovoru nebo statického textu, který mapujete v editoru.

Nastavení	Popis
Jméno	Povinné. Identifikátor akce
Spouštěcí podmínka	Kdy odeslat
Příjemci	Povinné. Telefonní čísla, která vždy obdrží zprávu
Podmíněné příjemci	Mapování podmínka-číslo
Šablona	Povinné. Rozevírací výběr předem schválených WhatsApp šablon synchronizovaných z centrálního Twilio Content účtu. Každý záznam zobrazuje název šablony, jazyk a náhled těla, takže víte, kterou vybrat.
Proměnné šablony	Pro šablonu, kterou jste vybrali, editor vypisuje každý placeholder (`{{1}}`, `{{2}}`, …) a umožňuje vám ho namapovat na proměnnou hovoru (viz níže) nebo statický řetězec.

Dostupné proměnné hovoru, které můžete namapovat do placeholderů šablony:

Proměnná	Popis
`{{call_from}}`	Telefonní číslo volajícího
`{{call_to}}`	Číslo, na které bylo voláno
`{{call_summary}}`	AI-generované shrnutí hovoru
`{{call_sentiment}}`	Sentiment (positive/neutral/negative)
`{{call_task_achieved}}`	Zda byl úkol hovoru splněn
`{{call_transcription}}`	Úplná transkripce hovoru

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

WhatsApp vyžaduje, aby každá obchodní zpráva mimo 24hodinové okno zákaznické služby používala předem schválenou šablonu. HANC synchronizuje seznam schválených šablon ze sdíleného Twilio Content účtu, takže rozevírací nabídka vždy ukazuje přesně to, co je oprávněno k odeslání právě teď — nemůžete náhodně vybrat koncept, zamítnutou šablonu nebo SID, které neexistuje. Pro přidání nové šablony kontaktujte podporu; jakmile je schválena WhatsAppem, automaticky se objeví v rozevíracím seznamu.

API volání

Akce API volání po hovoru je váš obecný webhook do zbytku vašeho stacku. Vyberte metodu, nastavte URL a odešleme celý payload hovoru — váš endpoint obdrží strukturovaný JSON objekt popisující, co se stalo.

Nastavení	Popis
Jméno	Povinné. Identifikátor akce
Spouštěcí podmínka	Kdy spustit (prázdné = každý hovor). Vyhodnocováno LLM proti transkripci.
API URL	Povinné. URL API endpointu
HTTP metoda	Povinné. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Hlavičky	Volitelné hlavičky požadavku
Query parametry	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 jsou sloučeny s úplným payloadem 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 jsou stejná pole sloučena do query stringu — ale vnořené hodnoty jako transcription, sentiment a custom_analysis_data jsou zahozeny (URL nemohou nést strukturovaná data rozumně). Použijte POST/PUT/PATCH, pokud potřebujete přepis.

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

Pre-fetch vs Post-call API volání

Pre fetch šablonuje {phone} atd. do URL/hlaviček/query/body. Vrací do promptu, před hovorem.
Post call API volání odesílá celý 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í. Například agent může zachytit jméno volajícího, e-mail, telefonní číslo nebo jakékoli jiné informace, které 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

Tyto jsou povoleny ve výchozím nastavení a zobrazeny ve formuláři widgetu hovoru. Můžete je upravit nebo odstranit a přidat vlastní proměnné.

Typy proměnných

Typ	Případ použití	Příklad
Text	Jména, adresy, poznámky, vstup ve volné formě	Jméno zákazníka, doručovací 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ý plán (Basic/Pro/Enterprise)
Checkbox	Souhlas nebo potvrzení ano/ne	"Souhlasím s přijímáním marketingových e-mailů"

Konfigurace proměnné

Pole	Popis	Příklad
Název proměnné	Povinné. Identifikátor proměnné	`customer_email`
Pokyny pro AI	Povinné. Pokyny pro AI, kdy a jak extrahovat tuto hodnotu	`"E-mailová adresa zákazníka. Zeptat se, pokud neuvedeno."`
Příklad formátu	(Volitelné) Příklad očekávaného formátu	`"john@example.com"`
Možnosti (pro Selector)	(Pouze Selector) Seznam povolených možností	`["Basic", "Pro", "Enterprise"]`
Zobrazit ve formuláři	Zda zobrazit toto pole ve formuláři widgetu hovoru	Povoleno ve výchozím nastavení

Zobrazit ve formuláři

Když je Zobrazit ve formuláři povoleno, proměnná se objeví jako viditelné vstupní pole v webovém widgetu před a během hovoru. To umožňuje volajícím vyplnit své informace přímo, kromě toho, že je AI extrahuje z konverzace.

tip

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

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

Přejděte na kartu Akce vašeho agenta.
Klikněte na Přidat nástroj.
Vyberte správnou fázi z rozevírací nabídky — Pre fetch, Live call nebo Post call.
Konfigurujte nastavení.
Uložte — změny se projeví při dalším hovoru.

Všechny záznamy jsou společně uvedeny v tabulce Akce. Klikněte na jakýkoli řádek pro úpravu nebo použijte ikonu koše pro smazání.

Související

Přehled AI hlasových agentů
Inženýrství promptů — Reference nástrojů ve vašem promptu
Znalostní báze — Zdroje informací
Integrace — Externí systémy, se kterými vaše nástroje mohou mluvit

Tři fáze​

Pre fetch​

Kdy to použít​

Jak to funguje​

Konfigurace​

Dostupné proměnné​

Co se objeví v promptu​

Důležitá omezení​

Nástroje pro živý hovor​

Dostupné nástroje​

Přepojení hovorů​

Google Calendar​

Outlook Calendar​

Přepojení na agenta​

HubSpot CRM​

MCP servery​

API Tool RAG​

Psaní schématu parametrů těla​

Minimální struktura​

Reference polí​

Příklady​

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

Akce po hovoru​

Dostupné akce​

Odeslat e-mail​

Odeslat SMS​

Odeslat WhatsApp​

API volání​

Co váš endpoint obdrží​

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

Výchozí proměnné​

Typy proměnných​

Konfigurace proměnné​

Zobrazit ve formuláři​

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

Související​

Tři fáze

Pre fetch

Kdy to použít

Jak to funguje

Konfigurace

Dostupné proměnné

Co se objeví v promptu

Důležitá omezení

Nástroje pro živý hovor

Dostupné nástroje

Přepojení hovorů

Google Calendar

Outlook Calendar

Přepojení na agenta

HubSpot CRM

MCP servery

API Tool RAG

Psaní schématu parametrů těla

Minimální struktura

Reference polí

Příklady

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

Akce po hovoru

Dostupné akce

Odeslat e-mail

Odeslat SMS

Odeslat WhatsApp

API volání

Co váš endpoint obdrží

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

Výchozí proměnné

Typy proměnných

Konfigurace proměnné

Zobrazit ve formuláři

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

Související