Questa sezione presenta esempi concreti di Actions implementate con successo in diversi settori, fornendo configurazioni dettagliate e casi d'uso reali per ispirare le tue implementazioni.
Esempio 1: E-commerce - Gestione ordini e resi
Scenario
Un negozio online vuole automatizzare la gestione delle richieste di reso e il controllo stato ordini tramite l'assistente.
Action: Controllo stato ordine
Nome: Controlla Stato Ordine
Descrizione: Utilizza questa Action quando l'utente vuole verificare lo stato di un ordine esistente. Richiede il numero ordine o l'email associata all'ordine.
URL: https://api.mionegozio.com/orders/status
Metodo: GET
Autenticazione: API Key nell'header (X-API-Key)
Parametri:
- order_number (obbligatorio): Numero dell'ordine
- customer_email (opzionale): Email per verifica aggiuntiva
Action: Richiesta reso
Nome: Crea Richiesta Reso
Descrizione: Crea una richiesta di reso per un ordine esistente. Richiede numero ordine, motivo del reso e dettagli del prodotto.
URL: https://api.mionegozio.com/returns
Metodo: POST
Content-Type: application/json
Parametri:
- order_number (obbligatorio): Numero ordine originale
- customer_email (obbligatorio): Email del cliente
- reason (obbligatorio): Motivo del reso
- product_ids (obbligatorio): ID prodotti da rendere
- notes (opzionale): Note aggiuntive
Conversazione esempio
Cliente: "Ciao, vorrei controllare lo stato del mio ordine #ORD-12345"
Assistente: "Controllo immediatamente lo stato del tuo ordine... L'ordine #ORD-12345 è stato spedito ieri e arriverà domani entro le 18:00. Hai ricevuto il tracking via email."
Cliente: "In realtà ho cambiato idea su uno dei prodotti, posso fare un reso?"
Assistente: "Certamente! Posso aiutarti a creare la richiesta di reso. Quale prodotto vorresti rendere e qual è il motivo?"
Cliente: "La maglietta blu, taglia M. Ho ordinato la taglia sbagliata."
Assistente: "Perfetto! Ho creato la richiesta di reso #RET-7890 per la maglietta blu taglia M. Riceverai l'etichetta di spedizione via email entro 30 minuti."
Esempio 2: Servizi professionali - Prenotazione consulenze
Scenario
Uno studio legale vuole automatizzare la prenotazione di consulenze e la qualificazione iniziale dei clienti.
Action: Verifica disponibilità
Nome: Controlla Disponibilità Avvocato
Descrizione: Verifica gli slot disponibili per consulenze legali in base alla data e al tipo di consulenza richiesta.
URL: https://calendar.studiolegal.com/api/availability
Metodo: GET
Parametri:
- date (obbligatorio): Data desiderata (YYYY-MM-DD)
- consultation_type (obbligatorio): Tipo consulenza (civile, penale, societario)
- duration (opzionale, default: 60): Durata in minuti
Action: Prenota consulenza
Nome: Prenota Consulenza Legale
Descrizione: Crea una prenotazione per consulenza legale dopo aver verificato la disponibilità.
URL: https://calendar.studiolegal.com/api/bookings
Metodo: POST
Parametri:
- client_name (obbligatorio): Nome completo del cliente
- client_email (obbligatorio): Email del cliente
- client_phone (obbligatorio): Telefono del cliente
- appointment_date (obbligatorio): Data e ora appuntamento
- consultation_type (obbligatorio): Tipo di consulenza
- case_description (obbligatorio): Breve descrizione del caso
- urgency (opzionale): Livello di urgenza (normale, alta, urgente)
Conversazione esempio
Cliente: "Buongiorno, avrei bisogno di una consulenza per una questione di diritto del lavoro"
Assistente: "Buongiorno! Sarò felice di aiutarla a prenotare una consulenza. Per quando vorrebbe l'appuntamento?"
Cliente: "Possibilmente questa settimana, il prima possibile"
Assistente: "Ho controllato le disponibilità: posso proporle giovedì 15 marzo alle 14:30 o venerdì 16 marzo alle 10:00. Quale preferisce?"
Cliente: "Giovedì alle 14:30 va benissimo"
Assistente: "Perfetto! Per completare la prenotazione ho bisogno di alcuni dati... Ho prenotato la sua consulenza per giovedì 15 marzo alle 14:30. Riceverà una email di conferma con tutti i dettagli."
Esempio 3: Supporto tecnico - Creazione ticket e escalation
Scenario
Un'azienda software vuole automatizzare la creazione di ticket di supporto e l'escalation per problemi critici.
Action: Crea ticket supporto
Nome: Crea Ticket Supporto Tecnico
Descrizione: Crea un nuovo ticket nel sistema Zendesk quando l'utente riporta un problema tecnico.
URL: https://azienda.zendesk.com/api/v2/tickets.json
Metodo: POST
Autenticazione: Basic Auth (username/token)
Content-Type: application/json
Parametri:
- customer_email (obbligatorio): Email del cliente
- subject (obbligatorio): Oggetto del problema
- description (obbligatorio): Descrizione dettagliata
- priority (opzionale, default: normal): normal, high, urgent, low
- category (obbligatorio): login, payment, bug, feature_request
- product_version (opzionale): Versione del prodotto
Action: Escalation urgente
Nome: Escalation Supporto Urgente
Descrizione: Invia notifica immediata al team di supporto per problemi critici che bloccano il servizio.
URL: https://hooks.slack.com/services/T00/B00/XXX
Metodo: POST
Parametri:
- ticket_id (obbligatorio): ID del ticket creato
- customer_info (obbligatorio): Informazioni cliente
- issue_summary (obbligatorio): Riassunto del problema
- impact_level (obbligatorio): Livello di impatto sul business
Esempio 4: Marketing - Lead generation e follow-up
Scenario
Un'agenzia di marketing vuole catturare lead qualificati e inserirli automaticamente nel CRM con follow-up personalizzato.
Action: Crea lead in CRM
Nome: Aggiungi Lead a HubSpot
Descrizione: Crea un nuovo contatto in HubSpot quando un visitatore mostra interesse per i servizi.
URL: https://api.hubapi.com/crm/v3/objects/contacts
Metodo: POST
Autenticazione: Bearer Token
Parametri:
- email (obbligatorio): Email del contatto
- firstname (obbligatorio): Nome
- lastname (obbligatorio): Cognome
- company (opzionale): Nome azienda
- phone (opzionale): Numero telefono
- lead_source (obbligatorio): chatbot
- interest_area (obbligatorio): Area di interesse
- budget_range (opzionale): Range di budget
Action: Email di benvenuto
Nome: Invia Email Benvenuto Lead
Descrizione: Invia automaticamente email di benvenuto personalizzata ai nuovi lead.
URL: https://api.mailgun.com/v3/domain.com/messages
Metodo: POST
Autenticazione: Basic Auth (api:API_KEY)
Parametri:
- to_email (obbligatorio): Destinatario
- to_name (obbligatorio): Nome destinatario
- interest_area (obbligatorio): Per personalizzare il contenuto
- company_name (opzionale): Per personalizzazione aggiuntiva
Esempio 5: Hospitality - Gestione prenotazioni ristorante
Scenario
Un ristorante vuole automatizzare le prenotazioni e la gestione di richieste speciali tramite l'assistente sul sito web.
Action: Controlla disponibilità tavoli
Nome: Verifica Disponibilità Ristorante
Descrizione: Controlla i tavoli disponibili per data, ora e numero di persone specificati.
URL: https://booking.mioristrante.com/api/availability
Metodo: GET
Parametri:
- date (obbligatorio): Data prenotazione (YYYY-MM-DD)
- time (obbligatorio): Ora desiderata (HH:MM)
- guests (obbligatorio): Numero di persone
- special_requirements (opzionale): Richieste speciali
Action: Crea prenotazione
Nome: Prenota Tavolo Ristorante
Descrizione: Effettua una prenotazione confermata dopo aver verificato la disponibilità.
URL: https://booking.mioristrante.com/api/reservations
Metodo: POST
Parametri:
- customer_name (obbligatorio): Nome per la prenotazione
- customer_email (obbligatorio): Email di contatto
- customer_phone (obbligatorio): Telefono
- reservation_date (obbligatorio): Data e ora
- guests_count (obbligatorio): Numero commensali
- special_requests (opzionale): Richieste speciali
- table_preference (opzionale): Preferenza tavolo
Considerazioni per l'implementazione
Sicurezza e privacy
- Validazione dati: Sempre validare i parametri prima dell'invio alle API
- Dati sensibili: Non loggare informazioni personali o finanziarie
- Rate limiting: Rispettare i limiti delle API esterne
- Error handling: Gestire gracefully gli errori senza esporre dettagli tecnici
User experience
- Feedback immediato: Confermare sempre quando un'azione è stata completata
- Informazioni chiare: Fornire dettagli utili (numeri di riferimento, tempi, ecc.)
- Recupero errori: Offrire alternative quando un'azione fallisce
- Conferme importanti: Richiedere conferma per azioni irreversibili
Monitoraggio e manutenzione
- Log delle azioni: Tenere traccia di tutte le chiamate API
- Metriche di successo: Monitorare tassi di successo e tempi di risposta
- Alerting: Configurare avvisi per errori ricorrenti
- Documentazione: Mantenere documentazione aggiornata per ogni integrazione