Vlastní API integrace
Vlastní API integrace umožní asistentovi volat váš systém. Například odeslat poptávku do CRM, ověřit volný termín prohlídky, nebo dohledat stav zakázky. Nastavení je technické. Pokud váš systém spravuje programátor, požádejte ho o adresu API, přístupový klíč a popis dostupných funkcí.
Založení integrace
Sekce “Založení integrace”- V menu projektu klikněte na Integrace → Nová integrace a vyberte vlastní API.
- Vyplňte Název integrace, například „Náš CRM“.
- V části Konfigurace API vyplňte:
- Adresa API (base URL), například
https://api.vase-firma.cz. - Název autentizačního headeru a Hodnota headeru (secret): přístupový klíč k vašemu API. Klíč je uložený šifrovaně a zpátky ho už neuvidíte.
- Adresa API (base URL), například
- Klikněte na Uložit konfiguraci.
Akce
Sekce “Akce”Akce je jedna věc, kterou asistent umí ve vašem systému udělat. U každé akce vyplňte:
| Pole | Význam |
|---|---|
| Název akce | Krátký technický název, například send_contact_form. |
| Kdy má AI akci zavolat (popis) | Popis pro asistenta, například „Odešle kontaktní formulář, když návštěvník chce zanechat poptávku.“ Podle tohoto textu se asistent rozhoduje, takže ho pište jasně. |
| Typ akce | Čtení dat (jen zjišťuje), nebo Odeslání dat (něco ve vašem systému mění). |
| Metoda a Cesta | Kam se má volání poslat, například /leads nebo /orders/{orderId}. |
| Potvrzení | Vyžadovat potvrzení: návštěvník musí akci potvrdit, než se provede. Bez potvrzení: provede se hned. U odesílání dat doporučujeme potvrzení. |
| Zobrazovaný titulek (pro návštěvníka) | Co návštěvník uvidí na potvrzovací kartě, například „Odeslání poptávky“. |
| Vyžaduje ověřenou identitu návštěvníka | Akce se provede, jen když asistent ví, kdo návštěvník je. Zapněte u všeho, co pracuje s osobními údaji. |
Parametry
Sekce “Parametry”Parametry jsou údaje, které akce potřebuje. Tlačítkem Přidat parametr přidáte nový. U každého nastavíte:
- Název parametru, Typ a Umístění (kam se hodnota pošle).
- Zdroj: Vyplní AI (asistent zjistí hodnotu z konverzace), Pevná hodnota (vždy stejná), nebo E-mail (e-mail návštěvníka).
- Popis pro AI: formát a význam hodnoty, například „Datum ve formátu RRRR-MM-DD“.
- Povinné: bez této hodnoty se akce neprovede.
Test
Sekce “Test”Tlačítkem Otestovat akci akci vyzkoušíte. Vyplňte Ukázkové parametry (JSON) a klikněte na Spustit test. Uvidíte Odpověď API.