Shopify i SMS: powiadomienie o realizacji zamówienia

Dopasuj aplikację do sklepu

Ustal model instalacji i uprawnienia wymagane do odczytu zamówienia oraz danych odbiorcy. Poradnik opisuje integrację przez API, a nie opublikowaną aplikację Shopify App Store. Dostęp do danych klientów może wymagać dodatkowej konfiguracji aplikacji.

Zweryfikuj webhook i odczytaj stan

Skonfiguruj właściwy temat webhooka zgodnie z aktualną dokumentacją Shopify. Odbiornik musi weryfikować autentyczność żądania na surowym body, szybko potwierdzać odbiór i przekazywać pracę do kolejki. Nie uznawaj każdego zdarzenia zamówienia za sygnał do nadania paczki.

Powtórzone lub dostarczone z opóźnieniem zdarzenie może dotyczyć już nieaktualnego stanu. Przed SMS sprawdź bieżącą realizację. Częściowa wysyłka zamówienia wymaga innej treści niż realizacja wszystkich pozycji.

Zbuduj wiadomość i rejestr operacji

Wyślij POST /v1/messages z numerem w to, komunikatem w text i identyfikatorem biznesowym w reference. Dodaj Authorization: Bearer TWÓJ_KLUCZ oraz Idempotency-Key. Operację powiąż ze sklepem, realizacją i rodzajem komunikatu.

Przykład: „Czesc zamowienia 4711 zostala przekazana do realizacji. Szczegoly znajdziesz w statusie zamowienia”. Treść musi odpowiadać rzeczywistemu procesowi sklepu. Zachowaj prefiks zagranicznego numeru i uwzględnij koszt jego kierunku.

Sprawdź powtórzenia i dane odbiorcy

Testuj brak telefonu, częściową realizację, ponowiony webhook, anulowanie i błąd zapisu po przyjęciu SMS. Przy nierozstrzygniętym żądaniu sprawdź historię; nie twórz nowej operacji tylko z powodu timeoutu.

Zapisuj identyfikator SMS i późniejszy status doręczenia. Ogranicz liczbę komunikatów na zamówienie. Aktualizacja integracji powinna uwzględniać cykl wersji API Shopify i zmiany uprawnień.

Najczęstsze pytania