Passa al contenuto principale

AI Action (Flow Builder)

Le AI Action permettono di integrare API esterne con il tuo chatbot Neoagent, abilitando funzionalità avanzate e personalizzate attraverso il Flow Builder.

Requisito Account

È necessario un account Professional per utilizzare le AI Action. Verifica il tuo piano di abbonamento prima di procedere.

Panoramica​

Le AI Action consentono al tuo chatbot di:

  • Connettere API esterne per estendere le funzionalità
  • Processare dati complessi tramite servizi esterni
  • Integrare sistemi CRM e database
  • Automatizzare workflow business-critical

Configurazione​

1. Accesso Account Professional​

Effettua il login al tuo account Professional per accedere alle funzionalità AI Action avanzate.

Account Professionale Richiesto

Le AI Action sono disponibili solo per gli account Professional. Verifica il tuo piano di abbonamento prima di procedere.

2. Compila le Informazioni API​

Inserisci le informazioni necessarie per la richiesta API:

Configurazione API

Elementi da Configurare:

  • URL dell'API: Endpoint della tua API esterna
  • Parametri: Dati da inviare con la richiesta
  • Autenticazione: Credenziali o token di accesso
  • Metodo HTTP: GET, POST, PUT, DELETE, etc.

Formato Risposta API​

Struttura Richiesta​

La risposta della tua API deve seguire questa struttura specifica per essere processata correttamente:

{
  "Success": true,
  "Code": 200,
  "Message": "This is a message",
  "Data": {
    // Il campo 'Data' viene utilizzato per memorizzare i dati.
  } 
}

Spiegazione dei Campi:

  • Success: Booleano che indica se la richiesta è stata elaborata con successo
  • Code: Codice di stato HTTP della risposta
  • Message: Messaggio descrittivo del risultato
  • Data: Oggetto contenente i dati effettivi della risposta
Importante

La risposta dell'interfaccia deve seguire rigorosamente la struttura soprastante per funzionare correttamente.

Verifica e Test​

3. Verifica API​

Clicca il pulsante "Verify API" per testare la configurazione. Se l'interfaccia funziona correttamente e restituisce la risposta attesa, la validazione sarà superata.

✅ Validazione Automatica: Il sistema verificherà automaticamente che la tua API risponda nel formato corretto e che tutti i parametri siano configurati correttamente.

4. Test Chiamata GPT API​

Testa la chiamata GPT API per verificare che funzioni correttamente:

Test GPT API

Test Completo: Il test verificherà l'integrazione completa tra il chatbot AI e la tua API esterna, assicurando che i dati vengano scambiati correttamente.

Casi d'Uso delle AI Action​

Integrazione CRM​

Connetti il chatbot al tuo CRM per creare, aggiornare e recuperare informazioni sui clienti

API di Pagamento​

Integra servizi di pagamento per processare transazioni direttamente nella chat

Servizi Esterni​

Collega servizi terzi come calendari, sistemi di prenotazione o database

Elaborazione Dati​

Processa e analizza dati complessi tramite API di machine learning

Best Practices​

Sicurezza e Autenticazione​

  • ✅ Utilizza sempre HTTPS per le chiamate API
  • ✅ Implementa autenticazione robusta (API keys, OAuth, JWT)
  • ✅ Non esporre credenziali sensibili nei parametri URL
  • ✅ Valida sempre i dati in input e output

Performance e Affidabilità​

  • ✅ Implementa timeout appropriati per le chiamate API
  • ✅ Gestisci gli errori e fornisci messaggi di fallback
  • ✅ Ottimizza le risposte per ridurre la latenza
  • ✅ Testa l'API sotto carico per verificare la scalabilità

Esempi di Integrazione​

Integrazione CRM Base​

{
  "Success": true,
  "Code": 200,
  "Message": "Cliente trovato",
  "Data": {
    "customerId": "12345",
    "name": "Mario Rossi",
    "email": "mario@example.com",
    "phone": "+39123456789",
    "status": "active"
  }
}

Risposta Sistema di Prenotazione​

{
  "Success": true,
  "Code": 200,
  "Message": "Appuntamento prenotato",
  "Data": {
    "appointmentId": "apt_789",
    "date": "2024-01-15",
    "time": "14:30",
    "duration": 60,
    "status": "confirmed"
  }
}
Successo

Una volta configurata correttamente, la tua AI Action permetterà al chatbot di interagire con API esterne, offrendo un'esperienza utente più ricca e integrata con i tuoi sistemi business.