Base (BaseLinker) i SMS: powiadomienia o statusie zamówienia
W sklepie SMS najlepiej powiązać z konkretną zmianą, na którą czeka kupujący: gotowością do odbioru lub przekazaniem przesyłki przewoźnikowi. Base, znany wcześniej jako BaseLinker, udostępnia API do pracy z zamówieniami. Połączenie z Przypominamy.com wymaga automatyzacji dopasowanej do statusów sklepu.
Wybierz zdarzenie, które odpowiada rzeczywistości
Spisz identyfikator jednego statusu i jego znaczenie. „Gotowe do odbioru” powinno oznaczać fizyczną dostępność towaru. Samo utworzenie etykiety kurierskiej nie potwierdza nadania paczki. Przetestuj proces z obsługą magazynu, zanim SMS otrzymają klienci.
Pobieraj zamówienia przez API Base
Oficjalne API używa https://api.baselinker.com/connector.php oraz nagłówka X-BLToken. Metoda getOrders służy do pobrania zamówień; pola i filtry sprawdź w jej dokumentacji. Ustaw paginację lub punkt kontynuacji zgodnie z kontraktem. Sekret trzymaj po stronie serwera albo w połączeniu automatyzacji.
Przy odpytywaniu po statusie zapisuj trwały stan obsłużonych zdarzeń. Zamówienie może pozostać w tym samym statusie przez kilka dni. Nie wysyłaj SMS przy każdym pojawieniu się rekordu na liście. Ustal również, czy ponowne wejście do statusu stanowi nowe zdarzenie.
Zmapuj telefon, treść i identyfikator
Numer pobierz z właściwego pola danych odbiorcy. Zachowaj prefiks kraju; do numerów zagranicznych nie dopisuj +48. Wyślij JSON do POST /v1/messages z polami to, text i reference. Przykładowa treść: „Zamowienie 4711 jest gotowe do odbioru w punkcie przy ul. Krotkiej 2. Zapraszamy do 18:00”.
Operację nazwij np. base-4711-odbior-v1 i użyj jej w nagłówku Idempotency-Key. Zapisz identyfikator SMS przy zamówieniu lub w bazie automatyzacji. Kod odpowiedzi z API potwierdza przyjęcie, a doręczenie wymaga późniejszego statusu.
Uruchom próbę i ogranicz liczbę powiadomień
Podstaw własny numer w zamówieniu testowym. Sprawdź pierwszą zmianę statusu, drugi odczyt tej samej listy, cofnięcie statusu, brak telefonu i timeout. Po niepewnym wyniku nie generuj nowego identyfikatora wysyłki. Ustal limit wiadomości na zamówienie, aby kolejne statusy nie zamieniły się w serię zbędnych powiadomień.
Przykład budżetu: 100 zamówień × 1 powiadomienie × 1 część daje 100 płatnych części. Polskie znaki i długość tekstu mogą zmienić liczbę części. Dostęp do API i koszty Base sprawdź na swoim koncie; opłaty SMS są oddzielne.
Najczęstsze pytania
Czy poradnik instaluje moduł w Base?
Nie. Opisuje połączenie przez publiczne API, które wymaga konfiguracji automatyzacji.
Czy można wysyłać do klientów zagranicznych?
Tak, gdy kierunek jest dostępny. Zachowaj prefiks kraju i sprawdź stawkę przed uruchomieniem.
Dokumentacja narzędzia
Interfejs i dostępność funkcji sprawdzaj na swoim koncie narzędzia.