SMS w Zapier: Webhooks, JSON i potwierdzenia dla klientów

Wybierz zdarzenie, które naprawdę wymaga wiadomości

Przykładem jest zmiana zamówienia na „gotowe do odbioru”. Wyzwalacz „dowolna aktualizacja” jest zbyt szeroki: edycja notatki mogłaby wysłać następne powiadomienie. Dodaj filtr po statusie i sprawdź, czy rekord ma numer telefonu oraz czy SMS dla tego zdarzenia nie został już przyjęty.

Zachowaj ID rekordu i rodzaj zdarzenia. Pozwoli to rozróżnić potwierdzenie zamówienia od osobnej informacji o odbiorze. Dostępność Webhooks oraz liczba zadań zależą od konta Zapier — sprawdź je przed uruchomieniem automatyzacji.

Skonfiguruj Webhooks by Zapier

Dodaj akcję POST. Ustaw URL https://api.przypominamy.com/v1/messages, Payload Type JSON oraz pola to, text i opcjonalne reference. Numer mapuj do to, treść do text. Nie używaj starego endpointu /v1/sms ani pola message.

{
  "to": "+48600100200",
  "text": "Zamowienie 4711 jest gotowe do odbioru.",
  "reference": "odbior-4711"
}

W nagłówkach ustaw Authorization: Bearer TWÓJ_KLUCZ i Idempotency-Key: zapier-odbior-4711. Przykładowe wartości zamień na mapowane dane. Ogranicz dostęp do edycji Zapa i nie publikuj konfiguracji zawierającej token.

Przetestuj mapowanie przed publikacją Zapa

Pierwszy test skieruj na własny numer zweryfikowany na koncie testowym. Przycisk testu akcji wykonuje prawdziwe żądanie i może wysłać SMS. Sprawdź pełną treść, numer z prefiksem kraju oraz odpowiedź API. Błąd JSON zwykle oznacza niepoprawne mapowanie lub ręczne sklejenie tekstu z cudzysłowami.

Zapisz identyfikator wiadomości przy zamówieniu w kolejnym kroku. Dzięki temu obsługa zobaczy, że powiadomienie przyjęto, a kolejna aktualizacja rekordu może zostać odfiltrowana. Status doręczenia odczytuj osobno; przyjęcie przez API nie oznacza, że telefon odebrał wiadomość.

Zadbaj o replay i błędy częściowego wykonania

Jeśli SMS został przyjęty, ale zapis w aplikacji źródłowej nie powiódł się, cały Zap może wyglądać na nieudany. Przy replay zachowaj ten sam klucz operacji oraz dane wiadomości. Po utracie odpowiedzi sprawdź historię, zanim zlecisz nowy SMS. Nie zakładaj, że identyfikator będzie chronił ponowienie bezterminowo: zakończone odpowiedzi API są przechowywane przez 24 godziny.

Odróżnij błędny numer od braku salda i limitu wywołań. Pierwsze dwa przypadki wymagają poprawienia danych lub konta, a nie szybkiej pętli ponowień. Dla dużej liczby rekordów rozważ scenariusz z trwałą kolejką i kontrolą tempa.

Najczęstsze pytania