## Wat het is Een gewoonweg geweldige integratie om je Aftership-account te verbinden met je Botpress Bot. Volg zendingen in realtime en stel gebruikers direct via je bot op de hoogte van updates.

Hoe het werkt

Na het inschakelen van de integratie wordt een Webhook Abonnement geconfigureerd voor je Aftership account met behulp van de meegeleverde API Key. Deze webhook stuurt updates naar de integratie wanneer er een significante verandering is in de tracking status van een zending. De actie Track Zending kan worden gebruikt om het volgen van een zending te starten. Hiervoor is een Tracking Number nodig en wordt de API van Aftership gebruikt om de status van de zending op te halen en te volgen, waarbij een unieke Conversation Id in de trackinggegevens wordt ingesloten. Deze id wordt vervolgens gebruikt om het Aftership Event te triggeren binnen de conversatie, waardoor je bot kan reageren op updates van de verzending.

De Conversation Id is een unieke identifier voor elke conversatie. U kunt in dit veld invoeren om uw ID in te sluiten. Wanneer u een Aftership update ontvangt, kunt u gebruiken in het Conversation ID veld van de Aftership Event Trigger. Dit leidt de update naar de juiste conversatie.

Je kunt de volledige integratiecode bekijken op de Simply Great Bots Git pagina: Aftership Repo

Aftership instellen

Voorwaarde

Je moet een Aftership Pro-abonnement of hoger hebben om webhook gebeurtenissen te ontvangen voor tracering.

API-sleutel verkrijgen
  1. Ga naar Aftership Admin Dashboard.
  2. Navigeer naar Ontwikkelaars -> API Sleutels.
  3. Klik op Create API Key, geef je sleutel een naam en selecteer Save.
  4. Kopieer en plak je API Key ergens veilig, je hebt hem nodig tijdens de Botpress setup.
Webhook en Geheim
  1. Navigeer naar Tracking Dashboard -> Meldingen -> Webhooks.
  2. Kopieer je Webhook Secret en plak het ergens veilig. Je hebt dit nodig tijdens de installatie van Botpress .
  3. Klik op Toevoegen Webhook.
  4. Stel de webhook versie in op de standaard "Legacy".
  5. Plak de Webhook URL van uw Botpress Aftership integratie in het Webhook URL veld.
  6. Sla de webhook instellingen op.

Botpress Instellingen

  1. Kopieer en plak je Aftership API-sleutel van de Aftership Setup in het veld API Key.
  2. Kopieer en plak je Webhook Secret van de Aftership Setup in het Secret veld.