SMS w Make: konfiguracja modułu HTTP krok po kroku

Zaprojektuj scenariusz formularz → SMS

Przygotuj wyzwalacz pobierający nowe zgłoszenie, filtr z poprawnym numerem oraz moduł HTTP. Zachowaj trwały identyfikator zgłoszenia. W bazie źródłowej lub magazynie danych scenariusza zapisz później identyfikator SMS. Samo ponowne pobranie tego samego rekordu nie powinno ponownie uruchamiać wysyłki.

Najpierw podstaw własny zweryfikowany numer. Nie uruchamiaj od razu istniejącej kolejki zgłoszeń: ogranicz test do jednego rekordu i sprawdź, czy wyzwalacz nie pobiera również historycznych danych.

Ustaw HTTP → Make a request

W aktualnym module HTTP użyj dedykowanych Credentials typu API key. Ustaw przekazywanie w nagłówku Authorization z wartością Bearer TWÓJ_KLUCZ. Przechowuj sekret w połączeniu, a nie w zwykłym polu scenariusza. Wybierz metodę POST, adres https://api.przypominamy.com/v1/messages i typ body application/json.

Do body wybierz strukturę danych z tekstowymi polami to, text i reference. Mapowanie przez strukturę chroni przed uszkodzeniem JSON przez cudzysłów lub znak nowej linii w danych wejściowych.

{
  "to": "+48600100200",
  "text": "Otrzymalismy zgloszenie 4711. Skontaktujemy sie z Toba.",
  "reference": "zgloszenie-4711"
}

Dodaj identyfikator i zapisz odpowiedź

Dodaj nagłówek Idempotency-Key z wartością wynikającą ze zgłoszenia, np. make-zgloszenie-4711. Pole reference pomaga szukać wiadomości, ale samo nie zapobiega duplikatom. Przy retry zachowaj identyczny klucz i payload.

Po wykonaniu modułu zapisz identyfikator wiadomości i stan przyjęcia. Odpowiedź queued lub sent nie potwierdza doręczenia. Do późniejszego sprawdzenia służy historia panelu lub odczyt wiadomości w API. Nie oznaczaj klientowi zgłoszenia jako „SMS doręczony” na podstawie samego HTTP 200.

Obsłuż błędy przed włączeniem harmonogramu

Błędny numer wymaga poprawienia rekordu; brak salda wymaga interwencji właściciela konta. Dla limitu żądań zastosuj opóźnienie i ogranicz tempo całego scenariusza. Po timeoutcie najpierw sprawdź historię: brak odpowiedzi nie jest równoznaczny z brakiem wysyłki. Nie dodawaj bezwarunkowego retry z nowym identyfikatorem.

Wykonaj test poprawnego numeru, pustego pola, dwukrotnego pobrania zgłoszenia i awarii po żądaniu. Rozliczenie operacji Make jest niezależne od kosztu części SMS. Sprawdź dostępność modułów i limity własnego konta przed ustaleniem częstotliwości.

Najczęstsze pytania