La differenza tra sapere e andare a controllare
Ci sono due tipi di domande dai clienti. Il primo tipo è generale: Qual è la vostra politica di reso? Quanto dura la spedizione? Spedite in Germania? Una base di conoscenza ben fornita gestisce queste domande.
Il secondo tipo è specifico: Dov’è il mio ordine #4521? La versione blu è ancora disponibile? Quanto mi resta sul piano questo mese? Queste non vivono in una base di conoscenza. Vivono nei tuoi sistemi — gestione ordini, inventario, fatturazione — e cambiano ogni secondo.
Un chatbot che gestisce solo il primo tipo è un FAQ ben vestito. Un chatbot che gestisce anche il secondo è un assistente. La differenza tra i due è l’accesso a un’API.
Perché questo divario ti costa clienti
La maggior parte delle «AI chat» di oggi è costruita esclusivamente su una base di conoscenza. Sanno parafrasare la tua politica di spedizione in diciassette lingue, ma non sanno dire al cliente dov’è davvero il suo pacco proprio adesso. Quindi il cliente chiede, il bot schiva, e il cliente o si arrende o aspetta un operatore che andrà a consultare gli stessi dati che il bot avrebbe potuto recuperare in millisecondi.
Quello è il soffitto del chatbot. Ogni «mi lasci verificare» è un’occasione persa di rispondere in pochi secondi, al primo messaggio, mentre l’intenzione del cliente è ancora calda.
Cosa fanno davvero le connessioni API
In enuchat, una connessione API è un collegamento configurato tra la chat e uno dei tuoi servizi backend. La definisci una volta: l’URL di base, il metodo di autenticazione e una manciata di endpoint con i loro parametri e il modo di mappare la risposta.
Da quel momento in poi, l’AI può chiamare quegli endpoint durante una conversazione. Quando un visitatore chiede di un ordine, l’AI estrae il numero, chiama il tuo endpoint ordini, legge lo stato in tempo reale e lo intreccia nella risposta. Il visitatore vede una sola frase: «Il tuo ordine #4521 è stato spedito ieri e dovrebbe arrivare giovedì.» Dietro quella frase è avvenuta una chiamata API reale.
Il cliente non vede l’impianto idraulico. Vede solo che la chat sa davvero.
Cinque metodi di autenticazione, senza codice personalizzato
La maggior parte delle API che vorresti collegare usa già un’autenticazione standard. enuchat ne supporta cinque pronte all’uso:
- Nessuna — per API pubbliche che non richiedono autenticazione
- API Key — inviata come header o parametro di query
- Bearer Token — autenticazione semplice basata su token
- Basic Auth — per sistemi legacy
- OAuth 2.0 client credentials — per fornitori moderni come Salesforce, HubSpot o il tuo server OAuth
Per OAuth 2.0, enuchat gestisce il ciclo di vita del token in automatico — lo recupera alla prima chiamata, lo tiene in cache fino alla scadenza, lo rinnova quando serve. Configuri le credenziali una volta e te ne dimentichi. Tutte le credenziali sono cifrate a riposo con libsodium e non compaiono mai nelle risposte API.
Variabili, template e mapping della risposta
Gli endpoint sono definiti come template. Un percorso come /orders/{orderId} o un corpo JSON che fa riferimento a {customerId} interpola valori dalle variabili di sessione — variabili che l’AI o una regola statica possono impostare durante la conversazione.
Quando l’API risponde, mappi i campi della risposta JSON di nuovo su variabili di sessione con la notazione a punti. data.status diventa order_status. data.shipping.eta diventa delivery_eta. L’AI poi intreccia quei valori in una risposta in linguaggio naturale — nella lingua del visitatore.
Tre schemi che coprono la maggior parte dei casi
In pratica, la maggior parte delle integrazioni API ricade in una di tre forme.
Consulta e rispondi
Il visitatore fa una domanda a cui si può rispondere con una sola chiamata API. La regola spara CALL_API seguito da REPLY_AI. L’AI usa i dati recuperati per comporre una risposta contestuale e fondata. Stato dell’ordine, saldo del conto, disponibilità di stanza, prezzi attuali, tracking pacchi — tutto questo rientra qui.
Consulta e instrada
La chiamata API restituisce informazioni sufficienti per decidere cosa fare dopo. Un account premium viene escalato a un agente senior. Un abbonamento scaduto viene instradato alla fatturazione. L’AI usa CALL_API seguito da ASSIGN_TO_OPERATOR per prendere decisioni di routing su dati reali del cliente, non a tentoni.
Flussi a più passaggi
Il primo messaggio etichetta la conversazione con SET_VARIABLE, il secondo innesca la chiamata API quando c’è abbastanza contesto, e il terzo compone la risposta. Utile quando devi confermare l’intento prima di chiamare il backend, o quando la query dipende da qualcosa che il visitatore ha detto due messaggi prima.
Sicurezza integrata
Collegare backend a un widget di chat innervosisce alcuni team — e a ragione. enuchat fornisce diversi livelli di protezione di default:
- Prevenzione SSRF blocca chiamate verso localhost, IP privati e nomi host interni
- Timeout di 5 secondi impedisce che un’API lenta blocchi la conversazione
- Isolamento per tenant significa nessuna fuga di dati tra tenant — i tuoi endpoint sono visibili solo ai tuoi widget
- Pulsanti di test verificano in modo indipendente la connessione e ogni endpoint prima di collegarli alle regole
- Credenziali cifrate non tornano mai in chiaro nella dashboard
Cosa cambia per i tuoi clienti
La chat passa da «mi faccia trovare qualcuno che possa verificarlo» a «verificato, ecco la risposta» — in una qualsiasi delle 60+ lingue, una domenica alle 3 del mattino, mentre il tuo team di supporto dorme. I clienti che avrebbero abbandonato carrello, ordine o piano restano, perché la risposta arriva mentre stanno ancora chiedendo.
Questa è la differenza tra un chatbot e un assistente. Ed è la differenza che i tuoi clienti sentono davvero.
Come iniziare
Se hai già configurato enuchat, le connessioni API si trovano in Impostazioni → Connessioni API. Scegli un endpoint che risponda a una domanda che il tuo team digita cento volte a settimana — lo stato dell’ordine è di solito il punto di partenza con la leva più alta. Configura la connessione, aggiungi l’endpoint, collegalo a una regola e testalo una volta prima di andare in produzione. Vedi la guida alle Connessioni API per il percorso completo.
Se sei nuovo su enuchat, registrati su enuchat.com. Il piano gratuito include le connessioni API dal primo giorno — niente carta, nessuna tariffa per conversazione, nessuna scadenza di prova.
Cinque minuti per collegare il primo endpoint. La prima risposta utile di solito arriva lo stesso giorno.