Passa al contenuto principale

Integrazione con OpenAPI in SmartFlow

Introduzione​

SmartFlow consente l'integrazione di API esterne tramite lo standard OpenAPI. Questa funzionalità offre un'enorme flessibilità per collegare i tuoi flussi di lavoro a servizi di terze parti, automatizzare compiti complessi e arricchire i tuoi processi aziendali.

Perché utilizzare OpenAPI in SmartFlow?​

  • Interoperabilità: Collega SmartFlow a qualsiasi sistema compatibile con OpenAPI.
  • Automazione avanzata: Effettua chiamate API per inviare o recuperare dati in tempo reale.
  • Risparmio di tempo: Importa collezioni OpenAPI per utilizzare endpoint predefiniti senza configurazioni complesse.

Screenshot: [Includi uno screenshot che mostra l'interfaccia per importare una collezione OpenAPI dalla pagina delle impostazioni del chatbot.]

Aggiungere un'integrazione OpenAPI​

1. Importa una collezione OpenAPI​

  1. Accedi alla pagina delle impostazioni del chatbot: Naviga nella scheda "Impostazioni" del chatbot pertinente.
  2. Importa un file o configura dall'interfaccia: Clicca su "Aggiungi una collezione OpenAPI" e seleziona un file JSON o YAML, oppure configura gli endpoint direttamente dall'interfaccia.
  3. Validazione: Gli endpoint vengono automaticamente ordinati per collezione e validati.
  4. Salva: Una volta validati, gli endpoint diventano disponibili come azioni di tipo "API" in SmartFlow.

Screenshot: [Mostra l'interfaccia di configurazione nella pagina delle impostazioni del chatbot.]

2. Usa le azioni API in SmartFlow​

  1. Aggiungi un'azione: Nel tuo flusso di lavoro SmartFlow, vai alla scheda Azioni e seleziona "API".
  2. Scegli un endpoint: Gli endpoint sono ordinati per collezione e disponibili per tutti i tipi di SmartFlow.
  3. Definisci i parametri: Configura i campi richiesti per la chiamata (headers, body, ecc.).
  4. Osservazione predefinita: Per impostazione predefinita, ogni azione API restituisce il risultato della chiamata come un'osservazione in modalità "Conversation Tool", consentendo all'AI di prendere automaticamente la decisione successiva.

Screenshot: [Inserisci uno screenshot che mostra un endpoint utilizzato come azione API in SmartFlow.]

Esempio di Utilizzo​

Scenario: Sincronizzazione con un CRM esterno​

  1. Obiettivo: Aggiornare le informazioni sui clienti nel tuo CRM quando viene inviato un modulo.
  2. Flusso di lavoro:
    • Attivazione: Un utente compila un modulo tramite SmartForm.
    • Azione API: Invia i dati del modulo all'API del tuo CRM.
    • Osservazione: Il risultato della chiamata viene automaticamente restituito come un'osservazione in modalità "Strumento di Conversazione".
  3. Vantaggi: Risparmio di tempo e riduzione degli errori manuali.

Screenshot: [Mostra un flusso di lavoro completo con una chiamata API collegata a un CRM.]

Scenario: Recupero dei dati utente​

  1. Obiettivo: Personalizzare la risposta di un chatbot in base ai dati dell'utente.
  2. Flusso di lavoro:
    • Attivazione: Una richiesta dell'utente nel chatbot.
    • Azione API: Interroga un'API esterna per ottenere informazioni sull'utente.
    • Osservazione: Utilizza i dati restituiti come un'osservazione per decidere la prossima risposta del chatbot.

Screenshot: [Illustra un'interazione tra un chatbot e un'API esterna.]

Best Practices​

  • Import verified collections: Assicurati che i tuoi file OpenAPI siano conformi agli standard per evitare errori di importazione.
  • Testa regolarmente: Valida le tue chiamate API per assicurarti che funzionino come previsto.
  • Documenta le tue integrazioni: Aggiungi descrizioni chiare per ciascun endpoint per facilitare la loro gestione.

Con questa integrazione, SmartFlow diventa una piattaforma ancora più potente per connettere i tuoi strumenti e automatizzare i tuoi processi. Passa alla sezione successiva per scoprire il Template Store e condividere i tuoi flussi di lavoro!