## 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
Configurazione di Aftership
Prerequisito
È necessario disporre di un piano Aftership Pro o superiore per ricevere gli eventi webhook da tracciare.
Ottenere la chiave API
- Andate a Aftership Admin Dashboard.
- Andare a
Sviluppatori
->Chiavi API
. - Cliccare su
Create API Key
, assegnare un nome alla chiave e selezionareSave
. - Copiate e incollate la vostra chiave API in un posto sicuro; vi servirà durante la configurazione di Botpress .
Webhook e segreto
- Navigare in Cruscotto di monitoraggio -> Notifiche -> Webhooks.
- Copiare il segreto di Webhook e incollarlo in un posto sicuro. Ne avrete bisogno durante la configurazione di Botpress .
- Fare clic su "Aggiungi Webhook".
- Impostare la versione di webhook come "Legacy".
- Incollare l'URL Webhook dell'integrazione Botpress Aftership nel campo
URLWebhook
. - Salvare le impostazioni di webhook .
Configurazione di Botpress
- Copiare e incollare la chiave API di Aftership dal Setup di Aftership nel campo "Chiave API".
- Copiare e incollare il
SegretoWebhook
dal Setup Aftership nel campoSegreto
.