API SMSPoradniki

SMS w gastronomii: zamówienia, odbiór i opóźnienia

Jak wykorzystać API SMS w platformie zamawiania jedzenia: wybór zdarzeń, przykładowe wiadomości, test i pomiar efektów.

To projekt zastosowania, nie opis wyników konkretnego klienta. SMS uzupełnia panel restauracji wtedy, gdy odbiorca potrzebuje szybkiej informacji o swoim zamówieniu.

Od którego powiadomienia zacząć?

Zacznij od alertu do restauracji o zamówieniu, które czeka na przyjęcie, albo od informacji dla klienta o potwierdzonym opóźnieniu. Ustal jedno zdarzenie i jedną grupę odbiorców; dopiero po ocenie efektu dodawaj kolejne wysyłki.

ZdarzenieOdbiorcaPrzykład treści
Zamówienie nieprzyjęte przez 2 minutyObsługa restauracjiNowe zamówienie nr 123 czeka na przyjęcie. Sprawdź panel restauracji.
Potwierdzona zmiana czasu dostawyZamawiającyPrzepraszamy, dostawa zamówienia nr 123 się opóźni. Nowy przewidywany czas: 18:50.
Gotowe do odbioru osobistegoZamawiającyZamówienie nr 123 jest gotowe do odbioru w restauracji. Zapraszamy!

Jak podłączyć zdarzenie do API?

  1. System zamówień przekazuje identyfikator, aktualny status i numer uprawnionego odbiorcy do adaptera.
  2. Adapter sprawdza, czy zamówienie nadal wymaga powiadomienia. Nie wysyła alertu po anulowaniu ani po zmianie statusu.
  3. Wywołuje POST /v1/messages z Authorization: Bearer pk_…. Klucz przechowuje po stronie serwera.
  4. Zapisuje identyfikator wiadomości i przetwarza raport doręczenia. Ponowienia dla tego samego zdarzenia używają tego samego Idempotency-Key.
{
  "to": "+48600100200",
  "text": "Zamówienie nr 123 jest gotowe do odbioru. Zapraszamy!",
  "from": "PRZYPOMINAM",
  "reference": "order-123-ready"
}

Numer jest przykładowy - zastąp go swoim zweryfikowanym numerem przed próbą. Pole reference pomaga znaleźć wysyłkę w historii; nie zastępuje kontroli powtórzeń. Pełny kontrakt i odpowiedzi błędów znajdziesz w dokumentacji API.

Ile kosztuje powiadomienie?

Cena zależy od progu doładowania, liczby części SMS i kierunku. Polskie znaki oraz emoji mogą zwiększyć liczbę części. Przed wysyłką sprawdź podgląd w panelu i aktualny cennik. Koszt adaptera i systemu restauracyjnego jest osobny.

Jak sprawdzić, czy pomaga?

Porównaj czas przyjęcia zamówienia, liczbę telefonów o status oraz czas od przygotowania do odbioru. Zapisuj koszt wiadomości; nie traktuj samego doręczenia SMS jako dowodu przeczytania. Dobierz porównywalne okresy i uwzględnij liczbę zamówień.

Pierwsza próba bez integracji

W panelu wybierz „Co nowego” i „Wypróbuj treść”. Dopasuj tekst, potwierdź własny numer i wykonaj test. To nie uruchamia automatyzacji w restauracji.

Załóż konto testowe

Wdrożenie może korzystać z n8n, Make lub własnego adaptera - pod warunkiem dostępu do zdarzeń systemu zamówień. Zobacz też powiadomienia w WooCommerce.