## 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](https://github.com/SimplyGreatBots/aftership) ### 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] (https://admin.aftership.com/). 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] (https://admin.aftership.com/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`.
