## 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
- Przejdź do Aftership Admin Dashboard.
- Przejdź do
Developers
-> API Keys
.
- Kliknij
Create API Key
, nazwij swój klucz i wybierz Save
.
- Skopiuj i wklej swój klucz API w bezpiecznym miejscu, będziesz go potrzebować podczas konfiguracji Botpress .
Webhook i Secret
- Przejdź do Tracking Dashboard -> Notifications -> Webhooks.
- Skopiuj swój Webhook Secret i wklej go w bezpiecznym miejscu. Będzie on potrzebny podczas konfiguracji Botpress .
- Kliknij
Add Webhook
.
- Ustaw wersję webhook na domyślną "Legacy".
- Wklej adres URL Webhook z integracji Botpress Aftership do pola
Webhook URL
.
- Zapisz ustawienia webhook .
Botpress Konfiguracja
- Skopiuj i wklej klucz API Aftership z ustawień Aftership do pola
API Key
.
- Skopiuj i wklej swój
Webhook Secret
z Aftership Setup do pola Secret
.
## 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`.