Použít integrace

Pro propojení vašich API Integrations s dialog flow vašeho AI Agent musíte použít moduly Integration uvnitř vašeho dialog flow builderu. Integrace se spustí v okamžiku, kdy je tento modul dosažen v dialog flow (kde jste umístili a propojili váš modul integrace).

**📝 Poznámka**

Tento článek předpokládá základní znalost sestavování Dialog Flow a alespoň jeden nakonfigurovaný endpoint v sekci API Integrations.

Typy integrací: Blocking vs Async

Existují dva typy integračních modulů a výběr správného závisí na tom, jak rychle vaše API odpovídá a jaký typ bota stavíte.

Modul API Integration

Tento modul čeká na odpověď před pokračováním.

• Ideální pro: Chatboty, Emailboty nebo rychlá API
• Dialog se zde zastaví, dokud není přijata odpověď nebo nevyprší timeout
• Poté flow pokračuje přes výstupní port Success nebo Failure

**📝 Poznámka**

Vyhněte se používání tohoto modulu s pomalými API u voicebotů. Dlouhá zpoždění mohou narušit průběh hovoru a zákaznickou zkušenost. Místo toho použijte Async/Await verzi modulu.

Modul API Integration (Async + Await)

Tato metoda je neblokující. Odděluje odeslání požadavku a kontrolu výsledku do dvou samostatných modulů, které musíte použít a propojit:

1. API Integration (Async) — odešle požadavek a okamžitě přechází na další propojený modul ve vašem dialog flow bez čekání na odpověď (namapované $context ještě nejsou vytvořeny)

2. API Integration (Await) — později kontroluje, zda odpověď dorazila. Pokud ne, čeká specifikovanou dobu a poté pokračuje příslušným výstupním portem.

3. Obvykle se používá pouze pro Voiceboty

4. Umožňuje vám pokračovat v konverzaci, zatímco integrace běží na pozadí (mezitím bot klade další otázky nebo jen informuje uživatele, že na tom pracujeme)
5. Modul Await čeká na odpověď, když dialog flow dosáhne tohoto modulu. Pokud výsledek stále není připraven, pozastaví se na definovanou dobu timeoutu a poté pokračuje cestou Waiting for response, pokud odpověď stále nebyla přijata. Můžete dialog vrátit zpět k tomuto modulu pro opakování nebo zvolit náhradní dialog.

Jak používat moduly Integration

Použití základního modulu "API Integration"

1. V sekci Advanced panelu modulů přetáhněte modul API Integration do vašeho flow.
2. Klikněte na modul pro otevření panelu nastavení.
3. Z rozbalovacího menu vyberte endpoint, který chcete použít.
4. Volitelně přidejte vlastní dynamické výstupní porty (pokud jste je definovali ve správě API Integrations)
5. Propojte výstupy Success a Failure (a vlastní porty, pokud jsou) pro definici toho, co se stane dál.

Použití Async verze

Krok 1: API Integration (Async)

• Umístěte modul API Integration (Async) do vašeho flow.
• Vyberte endpoint k volání.
• Propojte další kroky — toto se stane okamžitě
• Poznámka: Jakýkoliv vstupní $context potřebný pro integraci musí v tomto bodě existovat — bot je potřebuje pro odeslání požadavku

Krok 2: API Integration (Await)

• Použijte modul Await dále ve flow, kde chcete zkontrolovat, zda odpověď dorazila a předpokládáte, že uplynulo dostatek času pro její přijetí.
• Nastavte timeout modulu (jak dlouho by měl bot čekat na odpověď, pokud ještě nebyla přijata). Uvědomte si, že timeout nastavený pro tento endpoint ve správě API Integrations je stále vynucován (pro zabránění nekonečných smyček), takže se ujistěte, že timeout modulu není delší než timeout endpointu.

• Propojte:

• Success → odpověď je připravena, namapované kontexty lze použít

• Waiting for response → odpověď není připravena včas (můžete zkusit znovu, ale ujistěte se, že nevytváříte nekonečnou smyčku — použijte modul Counter pro odklonění opakovaných timeoutů)
• Failure → došlo k chybě
• Poznámka: Mezi moduly Async a Await musí být červená šipka nebo jiný typ pauzy. Bot zpracovává všechny moduly propojené zelenými šipkami současně, takže bez pauzy by neměl dostatek času na přijetí odpovědi.