## Co to jest Po prostu świetna integracja do połączenia konta Aftership z botem Botpress . Śledź przesyłki w czasie rzeczywistym i powiadamiaj użytkowników bezpośrednio przez bota, gdy pojawią się aktualizacje.

Jak to działa

Po włączeniu integracji subskrypcja Webhook jest konfigurowana dla konta Aftership przy użyciu dostarczonego API Key. Ta strona webhook wysyła aktualizacje do integracji za każdym razem, gdy nastąpi znacząca zmiana w statusie śledzenia przesyłki. Akcja Track Shipment może być użyta do zainicjowania śledzenia przesyłki. Wymaga ona Numeru śledzenia i wykorzystuje API Aftership do pobierania i monitorowania statusu przesyłki, osadzając unikalny Identyfikator rozmowy wewnątrz danych śledzenia. Ten identyfikator jest następnie używany do wyzwalania Aftership Event w ramach konwersacji, umożliwiając botowi reagowanie na aktualizacje wysyłki.

Conversation Id jest unikalnym identyfikatorem dla każdej konwersacji. Możesz przekazać do tego pola, aby osadzić swój identyfikator. Po otrzymaniu aktualizacji Aftership można użyć w polu Conversation ID opcji zaawansowanych Aftership Event Trigger. Spowoduje to skierowanie aktualizacji do odpowiedniej konwersacji.

Możesz zobaczyć pełny kod integracji na stronie Simply Great Bots Git: Aftership Repo

Konfiguracja Aftership

Wymagania wstępne

Musisz mieć plan Aftership Pro lub wyższy, aby otrzymywać zdarzenia webhook do śledzenia.

Uzyskiwanie klucza API
  1. Przejdź do Aftership Admin Dashboard.
  2. Przejdź do Developers -> API Keys.
  3. Kliknij Create API Key, nazwij swój klucz i wybierz Save.
  4. Skopiuj i wklej swój klucz API w bezpiecznym miejscu, będziesz go potrzebować podczas konfiguracji Botpress .
Webhook i Secret
  1. Przejdź do Tracking Dashboard -> Notifications -> Webhooks.
  2. Skopiuj swój Webhook Secret i wklej go w bezpiecznym miejscu. Będzie on potrzebny podczas konfiguracji Botpress .
  3. Kliknij Add Webhook.
  4. Ustaw wersję webhook na domyślną "Legacy".
  5. Wklej adres URL Webhook z integracji Botpress Aftership do pola Webhook URL.
  6. Zapisz ustawienia webhook .

Botpress Konfiguracja

  1. Skopiuj i wklej klucz API Aftership z ustawień Aftership do pola API Key.
  2. Skopiuj i wklej swój Webhook Secret z Aftership Setup do pola Secret.