Integrarea cu OpenAPI în SmartFlow
Introducere
SmartFlow permite integrarea API-urilor externe prin standardul OpenAPI. Această caracteristică vă oferă o flexibilitate imensă pentru a conecta fluxurile de lucru la servicii terțe, a automatiza sarcini complexe și a îmbogăți procesele de afaceri.
De ce să folosiți OpenAPI în SmartFlow?
- Interoperabilitate: Conectați SmartFlow la orice sistem compatibil cu OpenAPI.
- Automatizare avansată: Faceți apeluri API pentru a trimite sau a recupera date în timp real.
- Economisirea timpului: Importați colecții OpenAPI pentru a utiliza puncte finale predefinite fără configurații complexe.
Screenshot: [Includeți o captură de ecran care arată interfața pentru importarea unei colecții OpenAPI din pagina de Setări a chatbot-ului.]
Adăugarea unei Integrări OpenAPI
1. Importați o Colecție OpenAPI
- Accesați pagina de Setări a Chatbot-ului: Navigați la tab-ul "Setări" al chatbot-ului relevant.
- Importați un fișier sau configurați din interfață: Faceți clic pe "Adăugați o colecție OpenAPI" și selectați un fișier JSON sau YAML, sau configurați punctele finale direct din interfață.
- Validare: Punctele finale sunt sortate automat pe colecție și validate.
- Salvați: Odată validate, punctele finale devin disponibile ca acțiuni de tip "API" în SmartFlow.
Screenshot: [Arătați interfața de configurare în pagina de Setări a Chatbot-ului.]
2. Utilizați Acțiuni API în SmartFlow
- Adăugați o acțiune: În fluxul de lucru SmartFlow, accesați tab-ul Acțiuni și selectați "API".
- Alegeți un punct final: Punctele finale sunt sortate pe colecție și disponibile pentru toate tipurile de SmartFlow-uri.
- Definiți parametrii: Configurați câmpurile necesare pentru apel (headers, body, etc.).
- Observație implicită: Implicit, fiecare acțiune API returnează rezultatul apelului ca o observație în modul "Conversation Tool", permițând AI-ului să ia automat următoarea decizie.
Screenshot: [Introduceți o captură de ecran care arată un punct final folosit ca o acțiune API în SmartFlow.]
Exemplu de Utilizare
Scenariul: Sincronizare cu un CRM extern
- Obiectiv: Actualizați informațiile despre clienți în CRM-ul dvs. atunci când un formular este trimis.
- Flux de lucru:
- Declanșator: Un utilizator completează un formular prin SmartForm.
- Acțiune API: Trimiteți datele formularului către API-ul CRM-ului dvs.
- Observație: Rezultatul apelului este returnat automat ca o observație în modul "Conversation Tool".
- Beneficii: Economisirea timpului și reducerea erorilor manuale.
Screenshot: [Arătați un flux de lucru complet cu un apel API legat de un CRM.]
Scenariul: Recuperarea datelor utilizatorului
- Obiectiv: Personalizați un răspuns al chatbot-ului pe baza datelor utilizatorului.
- Flux de lucru:
- Declanșator: O solicitare a utilizatorului în chatbot.
- Acțiune API: Interogați un API extern pentru a obține informații despre utilizator.
- Observație: Utilizați datele returnate ca o observație pentru a decide următorul răspuns al chatbot-ului.
Screenshot: [Ilustrați o interacțiune între un chatbot și un API extern.]
Cele mai bune practici
- Importați colecții verificate: Asigurați-vă că fișierele dumneavoastră OpenAPI respectă standardele pentru a evita erorile de import.
- Testați regulat: Validați apelurile API pentru a vă asigura că funcționează conform intenției.
- Documentați integrările dumneavoastră: Adăugați descrieri clare pentru fiecare endpoint pentru a facilita gestionarea acestora.
Cu această integrare, SmartFlow devine o platformă și mai puternică pentru a conecta instrumentele dumneavoastră și a automatiza procesele. Treceți la secțiunea următoare pentru a descoperi Magazinul de Șabloane și a împărtăși fluxurile de lucru!