Shoper i SMS: powiadomienie o gotowości zamówienia
Powiadomienie o odbiorze zamówienia skraca drogę od przygotowania paczki do wizyty klienta w punkcie. W Shoper połączenie przez API warto zacząć od jednego statusu i jednego SMS. Ten poradnik opisuje projekt automatyzacji wymagającej konfiguracji po stronie sklepu.
Ustal znaczenie statusu
Zapisz identyfikator statusu „gotowe do odbioru” i sprawdź, kto ustawia go w obsłudze zamówień. Utworzenie etykiety lub faktury nie musi oznaczać gotowości towaru. W przypadku odbiorów w kilku punktach treść powinna zawierać adres właściwego miejsca i godziny pracy.
Połącz zdarzenie z REST API
Dokumentacja Shoper obejmuje REST API zamówień oraz webhooki. Wybierz zdarzenie dostępne dla danego procesu i uprawnienia aplikacji. Odbiornik zapisuje zdarzenie, a następnie pobiera aktualne zamówienie. Sprawdź dostępność mechanizmu w swoim sklepie; poradnik nie instaluje gotowej aplikacji Appstore.
Gdy nie możesz użyć webhooka, zastosuj harmonogram z paginacją i trwałym zapisem obsłużonych zamówień. Nie wysyłaj ponownie tylko dlatego, że zamówienie nadal ma ten sam status.
Wyślij krótką wiadomość
Do POST /v1/messages przekaż to, text i reference. Przykład: „Zamowienie 4711 czeka w punkcie przy ul. Krotkiej 2. Odbior dzis do 18:00”. Użyj nagłówka Authorization: Bearer TWÓJ_KLUCZ i Idempotency-Key, np. shoper-sklep7-4711-odbior. Mapuj dane przez strukturę JSON, aby adres lub cudzysłów nie uszkodził żądania.
Zweryfikuj pełny cykl zamówienia
Sprawdź pierwsze zdarzenie, ponowienie webhooka, cofnięcie statusu i brak telefonu. Po timeoutcie zachowaj ten sam identyfikator i treść; nie oznaczaj wyniku jako doręczonego bez raportu. Zapisz identyfikator SMS przy operacji.
Zmierz liczbę zamówień kwalifikowanych, pominiętych i przyjętych SMS. Koszt zależy od części i kierunku; długi adres może zwiększyć długość wiadomości. Dla zagranicznego odbiorcy zachowaj jego prefiks kraju.
Najczęstsze pytania
Jak zacząć bez wysyłki do klientów?
Przygotuj pojedynczy rekord testowy z własnym zweryfikowanym numerem. Włącz produkcję dopiero po sprawdzeniu powtórzeń i błędów.
Dokumentacja narzędzia
Interfejs i dostępność funkcji sprawdzaj na swoim koncie narzędzia.