Integrácia s OpenAPI v SmartFlow
Úvod
SmartFlow umožňuje integráciu externých API prostredníctvom štandardu OpenAPI. Táto funkcia vám poskytuje obrovskú flexibilitu na prepojenie vašich pracovných tokov s externými službami, automatizáciu zložitých úloh a obohatenie vašich obchodných procesov.
Prečo používať OpenAPI v SmartFlow?
- Interoperabilita: Prepojte SmartFlow s akýmkoľvek systémom kompatibilným s OpenAPI.
- Pokročilá automatizácia: Vykonávajte API volania na odosielanie alebo získavanie údajov v reálnom čase.
- Úspora času: Importujte OpenAPI kolekcie na použitie preddefinovaných koncových bodov bez zložitej konfigurácie.
Screenshot: [Zahrňte snímku obrazovky zobrazujúcu rozhranie na importovanie OpenAPI kolekcie z nastavení chatbota.]
Pridanie integrácie OpenAPI
1. Importovanie OpenAPI kolekcie
- Prístup na stránku nastavení chatbota: Prejdite na kartu "Nastavenia" príslušného chatbota.
- Importovanie súboru alebo konfigurácia z rozhrania: Kliknite na "Pridať OpenAPI kolekciu" a vyberte súbor JSON alebo YAML, alebo nakonfigurujte koncové body priamo z rozhrania.
- Validácia: Koncové body sú automaticky zoradené podľa kolekcie a validované.
- Uložiť: Po validácii sa koncové body stanú dostupnými ako akcie typu "API" v SmartFlow.
Screenshot: [Zobrazte konfiguračné rozhranie na stránke nastavení chatbota.]
2. Použitie API akcií v SmartFlow
- Pridať akciu: Vo vašom pracovnom toku SmartFlow prejdite na kartu Akcie a vyberte "API".
- Vyberte koncový bod: Koncové body sú zoradené podľa kolekcie a dostupné pre všetky typy SmartFlow.
- Definujte parametre: Nakonfigurujte požadované polia pre volanie (hlavičky, telo atď.).
- Predvolená pozorovanie: Predvolene každá API akcia vracia výsledok volania ako pozorovanie v režime "Nástroj na konverzáciu", čo umožňuje AI automaticky urobiť ďalšie rozhodnutie.
Screenshot: [Vložte snímku obrazovky zobrazujúcu koncový bod použitý ako API akciu v SmartFlow.]
Príklad použitia
Scenár: Synchronizácia s externým CRM
- Cieľ: Aktualizovať informácie o zákazníkovi vo vašom CRM, keď je formulár odoslaný.
- Pracovný tok:
- Spúšťač: Používateľ vyplní formulár prostredníctvom SmartForm.
- API akcia: Odoslať údaje formulára do API vášho CRM.
- Pozorovanie: Výsledok volania je automaticky vrátený ako pozorovanie v režime "Nástroj na konverzáciu".
- Výhody: Úspora času a zníženie manuálnych chýb.
Screenshot: [Zobrazte kompletný pracovný tok s API volaním prepojeným na CRM.]
Scenár: Získavanie údajov o používateľovi
- Cieľ: Personalizovať odpoveď chatbota na základe údajov o používateľovi.
- Pracovný tok:
- Spúšťač: Požiadavka používateľa v chatbote.
- API akcia: Dotaz na externé API na získanie informácií o používateľovi.
- Pozorovanie: Použite vrátené údaje ako pozorovanie na rozhodovanie o ďalšej odpovedi chatbota.
Screenshot: [Ilustrujte interakciu medzi chatbotom a externým API.]
Najlepšie praktiky
- Importujte overené kolekcie: Uistite sa, že vaše OpenAPI súbory sú v súlade so štandardmi, aby ste predišli chybám pri importe.
- Pravidelne testujte: Overte svoje API volania, aby ste sa uistili, že fungujú podľa očakávania.
- Dokumentujte svoje integrácie: Pridajte jasné popisy pre každý koncový bod, aby ste uľahčili ich správu.
S touto integráciou sa SmartFlow stáva ešte mocnejšou platformou na prepojenie vašich nástrojov a automatizáciu vašich procesov. Prejdite na ďalšiu sekciu a objavte Template Store a zdieľajte svoje pracovné toky!