Come configurare un'integrazione API personalizzata con AI Assist

Le istruzioni seguenti sono valide solo per desktop e laptop.

AI Assist di tawk.to ti consente di collegare la chat live ai tuoi sistemi backend, offrendo ai clienti un accesso rapido alle informazioni in tempo reale su prodotti e ordini. In questo modo, i clienti possono navigare nel tuo inventario, effettuare e tracciare ordini, programmare appuntamenti e molto altro.

Puoi anche sfruttare i dati dei clienti per personalizzare le interazioni, come salutare i clienti per nome e consigliare prodotti in base ai loro acquisti precedenti.

Le integrazioni API possono ampliare le funzionalità della chat live, migliorare l'esperienza del cliente e ridurre il carico di lavoro del team di supporto.

Se utilizzi più agenti AI, questi condivideranno le stesse integrazioni API, garantendo informazioni accurate e coerenti su tutti i canali.

In questa guida, ti mostreremo i passaggi fondamentali per integrare AI Assist con altre API utilizzando OpenAPI.

Per prima cosa, devi avere a disposizione il tuo schema OpenAPI, un file JSON (.json) o YAML (.yaml) che definisce la comunicazione tra l’API e AI Assist. Lo schema OpenAPI contiene i modelli di dati dell’API, gli endpoint, i parametri di richiesta e i formati di risposta.

Assicurati che il tuo schema sia nel formato OpenAPI 3.0. Puoi trovare maggiori informazioni su OpenAPI 3.0 qui. Per un esempio di schema OpenAPI 3.0 clicca qui.

Se l’API che desideri integrare non ha già una specifica OpenAPI, potresti doverne creare una. Puoi utilizzare editor come Postman o Swagger Editor per scrivere le specifiche e convalidarle utilizzando il validator di Swagger o altri strumenti online.

Scopri di più sulla creazione di specifiche OpenAPI qui.

Successivamente, ospita il tuo schema OpenAPI su un server accessibile pubblicamente. Puoi utilizzare repository come GitHub, servizi di archiviazione cloud come Amazon S3 o qualsiasi servizio di hosting web.

Prendi nota dell’URL del file, perché ti servirà nel passaggio successivo.

Nota: Se aggiorni il file dello schema OpenAPI e ricevi un nuovo URL dopo aver configurato l’integrazione, dovrai eliminare l’integrazione e aggiungerla nuovamente con il nuovo URL.

Segui questi passaggi per configurare la tua integrazione:

1. Accedi al tuo account tawk.to.
2. Nella dashboard, seleziona la proprietà per la quale desideri integrare AI Assist. Passa il mouse sopra il nome della proprietà per assicurarti di aver selezionato quella corretta.

1. Fai clic su Add-ons nel menu in alto.

1. Fai clic su Settings sotto AI Assist.

1. Seleziona il tuo agente AI.

1. Fai clic su Integration/API.

1. Fai clic su Add Tool sotto API.

1. Inserisci l'URL del tuo file di specifiche OpenAPI nel campo Schema File URL. Puoi ottenere questo URL dal repository o dall'archivio in cui è ospitato il tuo file di specifiche OpenAPI. Assicurati che l'URL sia accessibile pubblicamente e punti correttamente al file di specifiche.

Esempio:
https://petstore.swagger.io/v2/swagger.json

Nota: Se aggiorni il file dello schema OpenAPI e ottieni un nuovo URL, dovrai eliminare l'integrazione e aggiungerla nuovamente con il nuovo Schema File URL.

1. Inserisci l'API Base URL. Questo è l'URL di base dell'API e può essere ottenuto dal provider dell'API. Gli endpoint, le richieste e le risposte specificate nel tuo file OpenAPI saranno accessibili tramite questo URL.

Assicurati che gli endpoint nel tuo file di specifiche corrispondano a quelli dell'API per evitare errori.

Esempio:
https://petstore.swagger.io/v2

1. Imposta il metodo di autenticazione appropriato per l'API. Se l'API non richiede autenticazione, seleziona No Auth.

Se selezioni API Key, inserisci la Chiave API e il Valore. Puoi ottenere queste informazioni dal provider dell'API. Assicurati di utilizzare la chiave API corretta per evitare errori di autenticazione.

Se selezioni Basic, inserisci il tuo username e la password.

AI Assist utilizza le tue fonti di dati, incluse le integrazioni API, per rispondere ai clienti.

Per garantire risposte accurate, segui questi suggerimenti:

 Assicurati che lo schema API contenga descrizioni dettagliate degli endpoint e dei parametri utilizzati nell’integrazione.

Aggiorna il Base Prompt nella pagina delle impostazioni per istruire AI Assist su quando effettuare una richiesta API e quali informazioni recuperare.

Esempio:

• Se il cliente chiede lo stato di un ordine, eseguire [API call] per ottenere le informazioni pertinenti.

 È importante menzionare l'API call esattamente come definita nel tuo schema API.

Scopri di più su come impostare il Base Prompt qui.

 L'API Base URL può essere modificato, ma l’URL del file dello schema non può essere modificato. Se aggiorni il file dello schema OpenAPI e ottieni un nuovo URL, dovrai eliminare l’integrazione e aggiungerla nuovamente con il nuovo Schema File URL.

 Quando AI Assist esegue una richiesta API, le informazioni ottenute hanno priorità su altre fonti di dati e vengono utilizzate per generare una risposta ai clienti.

 Puoi personalizzare le risposte di AI Assist tramite le istruzioni del Base Prompt, ad esempio:

• Impostando il tono della risposta
• Includendo pulsanti interattivi per i clienti

Ogni richiesta API ha un ID univoco ed è indipendente dalle richieste e risposte precedenti. AI Assist non si riferisce alle richieste API passate quando ne esegue una nuova.

 Le conversazioni molto lunghe potrebbero essere troncate, e AI Assist potrebbe non essere in grado di fare riferimento a informazioni menzionate all'inizio della chat.

Testa l’integrazione per verificare precisione, latenza e sicurezza. Segui le migliori pratiche per l’autenticazione API e la crittografia dei dati.

Ottimizza l’integrazione per offrire un’esperienza di chat fluida e reattiva ai clienti.

 Assicurati che la tua integrazione sia scalabile per gestire un numero crescente di chat man mano che la tua attività cresce.

Contattaci via live chat
Prenota una chiamata con il nostro team
Visita la nostra community