Nachschiff

  ## Was es ist
Eine einfach großartige Integration, um Ihr Aftership-Konto mit Ihrem Botpress Bot zu verbinden. Verfolgen Sie Sendungen in Echtzeit und benachrichtigen Sie Nutzer direkt über Ihren Bot, wenn Updates auftreten.

## Wie es funktioniert
Wenn Sie die Integration aktivieren, wird ein Webhook Abonnement für Ihr Aftership-Konto mit dem bereitgestellten API-Schlüssel konfiguriert. Dieses webhook sendet Aktualisierungen an die Integration, sobald sich der Status der Sendungsverfolgung einer Sendung wesentlich ändert.
Die Aktion "Sendung verfolgen" kann verwendet werden, um die Verfolgung einer Sendung einzuleiten. Sie erfordert eine Sendungsnummer und nutzt die API von Aftership zum Abrufen und Überwachen des Sendungsstatus, wobei eine eindeutige Gesprächskennung in die Sendungsdaten eingebettet wird. Diese Id wird dann verwendet, um das "Aftership-Ereignis" innerhalb der Konversation auszulösen, so dass Ihr Bot auf Versandaktualisierungen reagieren kann.

Die "Conversation Id" ist ein eindeutiger Bezeichner für jede Konversation. Sie können `` in dieses Feld eingeben, um Ihre ID einzubetten. Wenn Sie ein Aftership-Update erhalten, können Sie `` im Feld `Conversation ID` der erweiterten Optionen des `Aftership Event Trigger` verwenden. Dadurch wird die Aktualisierung an die entsprechende Konversation weitergeleitet.

Sie können den vollständigen Integrationscode auf der Git-Seite von Simply Great Bots einsehen: [Aftership Repo](https://github.com/SimplyGreatBots/aftership)

### Aftership-Einrichtung

#### Voraussetzung 
Sie müssen einen Aftership Pro Plan oder höher haben, um webhook Ereignisse zur Verfolgung zu erhalten.

#### API-Schlüssel erhalten
1. Gehen Sie zu [Aftership Admin Dashboard] (https://admin.aftership.com/).
2. Navigieren Sie zu `Entwickler` -> `API-Schlüssel`.
3. Klicken Sie auf "API-Schlüssel erstellen", benennen Sie Ihren Schlüssel und wählen Sie "Speichern".
4. Kopieren Sie Ihren API-Schlüssel und fügen Sie ihn an einem sicheren Ort ein, da Sie ihn während der Einrichtung von Botpress benötigen.

#### Webhook und Geheimnis
1. Navigieren Sie zu [Tracking Dashboard -> Benachrichtigungen -> Webhooks] (https://admin.aftership.com/notifications/webhooks#).
2. Kopieren Sie Ihr Webhook Geheimnis und fügen Sie es an einem sicheren Ort ein. Sie benötigen es während der Einrichtung von Botpress .
3. Klicken Sie auf `Add Webhook`.
4. Setzen Sie die Version von webhook auf die Standardversion "Legacy".
5. Fügen Sie die Webhook URL von Ihrer Botpress Aftership-Integration in das Feld "Webhook URL" ein.
6. Speichern Sie die webhook Einstellungen.

### Botpress Einrichtung
1. Kopieren Sie Ihren Aftership-API-Schlüssel aus dem Aftership-Setup und fügen Sie ihn in das Feld `API-Schlüssel` ein.
2. Kopieren Sie Ihr "Webhook Secret" aus der Aftership-Einrichtung und fügen Sie es in das Feld "Secret" ein.