## Cos'è Un'integrazione semplicemente fantastica per collegare il vostro account Aftership con il vostro bot Botpress . Traccia le spedizioni in tempo reale e avvisa gli utenti direttamente attraverso il tuo bot quando si verificano aggiornamenti. ## Come funziona Dopo aver abilitato l'integrazione, viene configurata una sottoscrizione a Webhook per il vostro account Aftership utilizzando la `chiave API` fornita. Questo webhook invia aggiornamenti all'integrazione ogni volta che si verifica un cambiamento significativo nello stato di tracciamento di una spedizione. L'azione `Track Shipment` può essere utilizzata per avviare il tracciamento di una spedizione. Richiede un `Numero di tracciamento` e utilizza l'API di Aftership per recuperare e monitorare lo stato della spedizione, inserendo un `Id di conversazione` univoco nei dati di tracciamento. Questo ID viene poi utilizzato per attivare l'evento `Aftership` all'interno della conversazione, consentendo al bot di rispondere agli aggiornamenti sulla spedizione. L'Id della conversazione è un identificatore unico per ogni conversazione. Si può inserire `` in questo campo per incorporare il proprio ID. Quando si riceve un aggiornamento Aftership, si può usare `` nel campo `Conversation ID` delle opzioni avanzate dell' `Aftership Event Trigger`. Questo indirizza l'aggiornamento alla conversazione appropriata. È possibile visualizzare il codice completo dell'integrazione sulla pagina Git di Simply Great Bots: [Aftership Repo](https://github.com/SimplyGreatBots/aftership) ### Configurazione di Aftership #### Prerequisito È necessario disporre di un piano Aftership Pro o superiore per ricevere gli eventi webhook da tracciare. #### Ottenere la chiave API 1. Andate a [Aftership Admin Dashboard](https://admin.aftership.com/). 2. Andare a `Sviluppatori` -> `Chiavi API`. 3. Cliccare su `Create API Key`, assegnare un nome alla chiave e selezionare `Save`. 4. Copiate e incollate la vostra chiave API in un posto sicuro; vi servirà durante la configurazione di Botpress . #### Webhook e segreto 1. Navigare in [Cruscotto di monitoraggio -> Notifiche -> Webhooks](https://admin.aftership.com/notifications/webhooks#). 2. Copiare il segreto di Webhook e incollarlo in un posto sicuro. Ne avrete bisogno durante la configurazione di Botpress . 3. Fare clic su "Aggiungi Webhook". 4. Impostare la versione di webhook come "Legacy". 5. Incollare l'URL Webhook dell'integrazione Botpress Aftership nel campo `URLWebhook `. 6. Salvare le impostazioni di webhook . ### Configurazione di Botpress 1. Copiare e incollare la chiave API di Aftership dal Setup di Aftership nel campo "Chiave API". 2. Copiare e incollare il `SegretoWebhook ` dal Setup Aftership nel campo `Segreto`.
Creare incredibili esperienze di agenti AI.
