Come integrare AI Assist con Picqer

Le istruzioni riportate di seguito sono valide solo per computer desktop e laptop.

Collega la tua chat dal vivo al sistema di gestione del magazzino di Picqer warehouse management API per offrire ai clienti accesso in tempo reale alle informazioni su ordini e prodotti.

Con questa integrazione, i tuoi clienti potranno controllare facilmente lo stato degli ordini e le informazioni sui prodotti. Questo può contribuire a migliorare l’esperienza del cliente e a ridurre il carico di lavoro del tuo team di supporto.

In questa guida, ti accompagneremo passo dopo passo nell'integrazione di Apollo AI con Picqer utilizzando OpenAPI.

Prepara il tuo schema OpenAPI

Per prima cosa, avrai bisogno del tuo OpenAPI specifications.Può trattarsi di un file JSON o YAML che definisce la comunicazione tra l’API di Picqer e Apollo AI.

Le tue specifiche OpenAPI devono contenere gli endpoint API richiesti, i parametri delle richieste e i formati delle risposte.

Utilizza editor come Swagger Editor per scrivere le tue specifiche e validarle utilizzando strumenti come Swagger’s validator oppure qualsiasi validatore online.

Assicurati che gli endpoint presenti nelle tue specifiche OpenAPI corrispondano a quelli di Picqer e siano accessibili tramite l’URL di base di Picqer.

Ecco un esempio di file YAML con le specifiche rilevanti per ordini e prodotti:

Ospita il tuo schema OpenAPI

Successivamente, ospita il file della tua specifica OpenAPI su un server che consenta l'accesso pubblico. Puoi utilizzare un repository come GitHub, uno storage cloud come Amazon S3 o qualsiasi servizio di hosting web.

Annota l'URL del file delle specifiche; ti servirà per il passaggio successivo. Ecco un esempio di URL:

raw.githubusercontent.com/tuonomeutente/tuorepo/main/picquerschema.yaml


Integra con Apollo AI

Segui questi passaggi per configurare la tua integrazione:

  1. Accedi al tuo account su tawk.to.

  2. Nella dashboard, seleziona la proprietà per la quale desideri effettuare l'integrazione. Passa il mouse sopra il nome della proprietà per assicurarti di aver selezionato quella corretta.


3.Fai clic su Componenti aggiuntivi (Add-ons) nel menu in alto.


    4.Fai clic su Impostazioni (Settings) sotto AI Assist.


      5.Fai clic su Integrazione/API (Integration/API).


        6.Fai clic su Aggiungi strumento (Add Tool) sotto la sezione API.


          7.Inserisci l'URL del tuo file di specifica OpenAPI in Schema File URL. Puoi ottenere questo URL dal repository o dallo storage che ospita il tuo file di specifica OpenAPI.


          Assicurati che l'URL sia accessibile pubblicamente e punti correttamente al tuo file JSON o YAML.

          Ecco un esempio:
          raw.githubusercontent.com/tuonomeutente/tuorepo/main/picquerschema.yaml



          8.Inserisci l'URL dell'API di Picqer in API Base URL. Gli endpoint nella tua specifica OpenAPI saranno accessibili tramite questo URL. Assicurati che corrispondano agli endpoint dell'API di Picqer per evitare eventuali errori.


          Un esempio di URL è: your-picqer-instance.com/api/v1, dove your-picqer-instance.com è il tuo dominio Picqer.



          9.Seleziona API key e inserisci la tua Picqer API Key e il relativo Valore. Puoi ottenere questa chiave dal tuo account Picqer. Assicurati di utilizzare la chiave API corretta per evitare errori di autenticazione.


            10.Verifica i tuoi dettagli e fai clic su Salva.


            Cose da ricordare
            • Testa questa integrazione per garantire un trasferimento dei dati accurato e una corretta generazione delle risposte.

            • Dai priorità alla sicurezza dei dati. Segui le migliori pratiche per l’autenticazione API e la crittografia dei dati.

            • Ottimizza le chiamate API per ridurre la latenza e garantire un’esperienza di chat fluida per i tuoi clienti.

            • Assicurati che la tua integrazione possa gestire un volume crescente di chat man mano che la tua attività cresce.



            Se hai commenti su questo articolo, o se hai bisogno di ulteriore assistenza:

             

            L'articolo ti è stato d'aiuto?

            A 16 su 18 è piaciuto quest'articolo

            Hai ancora bisogno d'aiuto? Inviaci un messaggio