## 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
  1. Andate a Aftership Admin Dashboard.
  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.
  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.