AI Actions

Cosa sono le AI Actions?

Le AI Actions sono azioni che il tuo chatbot può FARE durante una conversazione - non solo dire. Un'azione può mostrare un modulo di contatto, cercare nel tuo catalogo prodotti, verificare un ordine, avviare una live chat o chiamare la tua API. Per le azioni guidate dall'IA, il modello decide quando richiedere l'azione in base alle tue istruzioni e alla conversazione. Le azioni denominate "after X messages" utilizzano invece un trigger basato sul conteggio dei messaggi. L'attivazione di un'azione non garantisce che verrà eseguita per ogni domanda corrispondente.

Ricorri alle AI Actions quando desideri automatizzare ciò che accade nella chat oltre a rispondere alle domande - ad esempio raccogliere un lead quando un visitatore mostra interesse per l'acquisto o passare la conversazione a un operatore umano quando il bot non può essere d'aiuto.

Se non hai ancora un bot, crea il tuo primo chatbot. Configura la relativa funzionalità di raccolta lead, modulo di contatto umano o live chat prima di abilitare la relativa azione.

Dove trovare le AI Actions

Seleziona il tuo chatbot e vai su Settings > Actions (Impostazioni > Azioni).

Comprendere i riquadri delle azioni

Ogni azione è visualizzata sotto forma di riquadro che mostra il suo nome, una breve descrizione e lo stato attuale. Le azioni possono avere tre stati:

• Active (Attivo - badge verde) - L'azione è abilitata e il chatbot può utilizzarla durante le conversazioni. Le azioni attive mostrano un pulsante Edit (Modifica - matita) e un pulsante Remove (Rimuovi - X).

• Inactive (Inattivo - badge grigio) - L'azione è disponibile ma attualmente non è abilitata. Fai clic sull'icona più (+) Aggiungi presente sul riquadro per abilitarla.

• Not connected (Non connesso - riquadro disattivato in grigio) - L'azione richiede un elemento non ancora configurato, come un'integrazione collegata o un piano che include la funzionalità. Passa il cursore sul riquadro per vedere esattamente cosa richiede e fai clic sul pulsante Connect/Setup (Connetti/Configura - spina) per accedere alla pagina in cui configurare l'elemento mancante - per l'e-commerce e le piattaforme aziendali si tratta della scheda Connect (Connetti).

Filtrare per piattaforma

La barra laterale Filter by Platform (Filtra per piattaforma) sulla destra ti consente di limitare l'elenco delle azioni a una piattaforma o categoria specifica. I filtri disponibili dipendono dalle tue integrazioni e funzionalità. Tra gli esempi figurano:

• AI Search, Hospitality e Feed XML - Azioni di ricerca di prodotti e camere, se configurate
• Custom forms (Moduli personalizzati) - Azioni che mostrano i tuoi moduli
• Custom APIs (API personalizzate) - Azioni relative alle tue integrazioni API personalizzate
• Human Support (Supporto umano) - Trigger per il modulo di contatto con un operatore umano
• Lead collection (Raccolta lead) - Azioni di acquisizione lead
• Live Chat - Trigger per il passaggio a un operatore via Live Chat
• Piattaforme e-commerce - Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart, Wix, Abicart
• Piattaforme aziendali - BaseLinker, Beds24, Freshdesk, Hostfully, Hotres, IdoBooking, KWHotel, Mews, NFHotel, Previo, THTG

Fai clic su Show All (Mostra tutto) per visualizzare tutte le azioni.

---

Abilitare e configurare un'azione

Passaggio 1: Attiva l'azione

Trova l'azione che desideri utilizzare e fai clic sull'icona Aggiungi (+) sul suo riquadro. Si aprirà una finestra di dialogo di configurazione.

Passaggio 2: Configura l'azione

La finestra di dialogo di configurazione contiene diverse sezioni, a seconda del tipo di azione.

When to use this action (Quando usare questa azione) - Descrive le circostanze in cui l'IA deve attivare questa azione. Le azioni predefinite includono impostazioni standard sensate. Per le azioni personalizzate, scrivi istruzioni chiare che spieghino gli scenari della conversazione che dovrebbero attivare l'azione.

Esempio:

Use this action when the customer asks about product availability, pricing, or specifications. Trigger phrases include "do you have...", "how much is...", or "tell me about a product".

Display action label (Mostra etichetta azione) - Un selettore che controlla se mostrare un messaggio di stato nella chat durante l'esecuzione dell'azione. Quando è abilitato, inserisci una breve etichetta come "Ricerca prodotti in corso..." o "Verifica disponibilità..." che il visitatore visualizzerà durante l'elaborazione.

Advanced Settings (Impostazioni avanzate - sezione espandibile):

• AI Action Definition (Definizione dell'azione IA) - Definisce il comportamento tecnico dell'azione. Nelle azioni predefinite questo campo è configurato automaticamente. Per le azioni API personalizzate, descrivi lo scopo della funzione e indica i parametri che il chatbot deve raccogliere dalla conversazione. Non includere dettagli tecnici di integrazione come URL o metodi HTTP - descrivi solo cosa fa la funzione e di quali parametri ha bisogno.

• AI Action internal name (Nome interno dell'azione IA) - Un identificatore di sola lettura utilizzato internamente dal modello di IA. Utile come riferimento nei prompt di attivazione (ad es. "Usa l'azione getProductDetails quando...").

Fai clic su Enable (Abilita, per le nuove attivazioni) o su Update (Aggiorna, per le modifiche) per salvare i cambiamenti.

---

Categorie di azioni predefinite

Supporto umano

• AI Driven human contact form (modulo di contatto con operatore basato su IA) - Mostra automaticamente il modulo di contatto per il supporto umano quando l'IA rileva che il visitatore ha bisogno dell'aiuto di un operatore
• Human contact form after X messages (modulo di contatto con operatore dopo X messaggi) - Mostra il modulo di contatto dopo un numero definito di messaggi

Raccolta lead

• Lead collection after X messages (raccolta lead dopo X messaggi) - Mostra il modulo di raccolta lead dopo un numero definito di messaggi
• AI driven lead collection (raccolta lead basata su IA) - L'IA sceglie il momento migliore per richiedere i dati di contatto
• Smart AI lead detection (rilevamento intelligente dei lead con IA) - Rileva in modo discreto le informazioni di contatto dal testo della conversazione

Live Chat

• AI triggered live chat (live chat attivata da IA) - Richiede il passaggio a un operatore quando l'IA determina che il visitatore ha bisogno di supporto in tempo reale. La funzione Live Chat deve essere configurata e disponibile; un operatore deve comunque entrare nella chat.

Integrazioni e-commerce

Azioni di ricerca prodotti e tracciamento ordini per Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart, Wix e Abicart. Richiedono che la relativa integrazione sia prima collegata (Connect [Connetti]).

Integrazioni con piattaforme aziendali

Azioni per BaseLinker, Beds24, Freshdesk, Hostfully, Hotres, IdoBooking, KWHotel, NFHotel, Previo e THTG. Includono dettagli degli ordini, gestione dei ticket, ricerca di camere e appartamenti, verifica della disponibilità delle prenotazioni e consultazione delle prenotazioni.

---

Azioni API personalizzate

Puoi creare azioni personalizzate che chiamano API esterne.

1. Vai su Custom Integrations (Integrazioni personalizzate) nel menu principale per definire l'endpoint API, il metodo HTTP, gli header e i parametri (consulta Integrazioni API personalizzate per la guida completa)

2. Torna in Settings > Actions del tuo bot - le tue azioni API personalizzate compariranno nell'elenco sotto il filtro Custom APIs

3. Attivale e configurale esattamente come le azioni predefinite

Quando scrivi la AI Action Definition per le azioni personalizzate, concentrati sul descrivere cosa fa la funzione e quali parametri il chatbot deve raccogliere dalla conversazione. Non ripetere i dettagli di integrazione (URL, header, autenticazione) che sono già configurati nella pagina Custom Integrations.

---

Azioni per moduli personalizzati e limiti delle azioni

Per mostrare un modulo durante una conversazione, crealo prima in Settings > Forms (Impostazioni > Moduli), quindi usa Add action for custom form (Aggiungi azione per modulo personalizzato) in Settings > Actions (Impostazioni > Azioni). Scegli il modulo e descrivi quando deve essere visualizzato. Consulta Moduli personalizzati per la procedura di configurazione completa.

Alcune finestre di dialogo delle azioni includono anche impostazioni di sicurezza e privacy. Dove disponibile, la limitazione della frequenza (Rate limiting) stabilisce una soglia massima per i tentativi per conversazione o per intervallo di tempo per visitatore; l'offuscamento dei dati personali (Personal data masking) maschera i campi personali supportati nei risultati delle azioni prima che l'IA li riceva. La disponibilità e i valori predefiniti variano a seconda dell'azione. Queste opzioni non sostituiscono l'autorizzazione nell'API collegata.

Best practice

• Sii specifico nei prompt di attivazione - Descrivi chiaramente lo scenario esatto e includi frasi di esempio degli utenti
• Evita sovrapposizioni tra i trigger - Assicurati che azioni diverse abbiano condizioni di attivazione distinte, in modo che l'IA scelga quella corretta
• Mantieni brevi le etichette delle azioni - Indica un'attività in corso ("Ricerca prodotti in corso...", "Controllo dello stato dell'ordine...") e resta sotto i 50 caratteri
• Attiva solo ciò di cui hai bisogno - Troppe azioni attive possono confondere l'IA su quale utilizzare
• Esegui i test in Overview (Panoramica) - Avvia una nuova conversazione di prova, richiedi l'azione usando un linguaggio realistico, fornisci i dettagli necessari e controlla sia la risposta del bot sia il risultato nel sistema collegato. I test possono eseguire operazioni API reali.
• Usa Reset instructions (Ripristina istruzioni) - Se il tuo prompt personalizzato non funziona come previsto, fai clic su Reset instructions per ripristinare il valore predefinito e ripartire da zero

Articoli correlati

• Integrazioni API personalizzate
• Raccolta lead
• Live Chat
• Modulo di contatto per l'assistenza umana