SMSAPI i n8n: nowa integracja do automatycznej wysyłki SMS

Integracja SMSAPI z n8n pozwala wysyłać SMS-y bezpośrednio z workflow. Akcja Send SMS otrzymuje numer i treść wiadomości, a warunki kontaktu ustala się we wcześniejszych krokach automatyzacji.

Klient złożył zamówienie, ale po 24 godzinach nadal go nie opłacił. Zamiast ręcznie wyszukiwać numer i przygotowywać przypomnienie, można sprawdzić płatność w n8n i wysłać SMS tylko wtedy, gdy zamówienie wciąż na nią czeka. Ten sam mechanizm przydaje się przy dostawach, wizytach i umowach.

W Velmancie przygotowaliśmy we współpracy z SMSAPI wtyczkę dostępną w katalogu jako SMS API – Send an SMS. Node został zweryfikowany przez n8n i można go dołączyć do własnych przepływów. Nie wymaga HubSpot.

1. Co umożliwia integracja SMSAPI z n8n?

Wtyczka udostępnia akcję wysyłki SMS. Pozostałe kroki dobiera się do systemów używanych w firmie. Dane mogą pochodzić ze sklepu, CRM, Google Sheets, bazy lub webhooka, jeżeli są dostępne w workflow.

W praktyce najczęściej chodzi o jeden z czterech momentów: zamówienie zmienia status, płatność nie wpłynęła, zbliża się termin wizyty albo dokument czeka na podpis. W każdym z tych przypadków warto ponownie sprawdzić stan sprawy tuż przed wysyłką. Klient mógł już zapłacić, zmienić termin lub podpisać umowę.

Szersze zastosowania platformy opisujemy w artykule o automatyzacji procesów i integracjach w n8n. Tutaj skupiamy się na dołączeniu SMS-a do konkretnego przepływu.

2. Przykład: SMS po 24 godzinach bez płatności

Załóżmy, że sklep udostępnia numer telefonu kupującego, identyfikator zamówienia i status płatności. Chcemy wysłać jedno przypomnienie po 24 godzinach. Poniżej pokazujemy modelowy proces do skonfigurowania — nie jest to gotowy szablon dołączony do wtyczki.

1. 01

   Odbierz zamówienie

   Zapisz jego identyfikator i dane pozwalające później pobrać aktualny status.

2. 02

   Wyznacz moment kontroli

   Użyj oczekiwania w n8n albo cyklicznie wyszukuj zamówienia, dla których minął ustalony czas.

3. 03

   Sprawdź płatność i anulowanie

   Pobierz aktualne dane ze sklepu. Nie opieraj decyzji na statusie sprzed 24 godzin.

4. 04

   Zakwalifikuj wiadomość do wysyłki

   Sprawdź numer, reguły kontaktu i wcześniejsze przypomnienia dla tego zamówienia.

5. 05

   Wyślij SMS przez SMSAPI

   Przekaż do akcji Send SMS numer odbiorcy i treść przygotowaną z danych zamówienia.

6. 06

   Zapisz wynik operacji

   Powiąż odpowiedź SMSAPI z zamówieniem, aby można było sprawdzić przebieg wysyłki i wrócić do błędów.

Jeśli sklep udostępnia bezpośredni link do dokończenia płatności, można umieścić go w wiadomości. Wtedy trzeba sprawdzić jego poprawność i długość SMS-a po podstawieniu danych.

Zabezpieczenie przed powtórną wysyłką wymaga osobnej logiki. Dwa równoległe wykonania mogą jednocześnie odczytać brak wcześniejszego przypomnienia. W takim procesie trzeba kontrolować także równoczesną obsługę tego samego zamówienia.

3. Jak połączyć SMSAPI z n8n?

Do pierwszego testu potrzebujesz działającego n8n, konta SMSAPI z możliwością wysyłki, tokenu OAuth API oraz własnego numeru telefonu. Na koncie SMSAPI muszą być środki lub rozliczenie pozwalające nadać wiadomość. CRM i dodatkowa baza danych nie są potrzebne do samego testu.

1. 01

   Znajdź SMS API – Send an SMS

   Otwórz panel dodawania node’ów w n8n, wyszukaj integrację i wybierz pozycję z oznaczeniem Verified. Instalację wykonuje właściciel lub administrator instancji.

2. 02

   Dodaj poświadczenia SMSAPI

   Wygeneruj token OAuth API na koncie SMSAPI i zapisz go w konfiguracji credentials w n8n. Tokenu nie należy umieszczać w treści wiadomości ani w arkuszu odbiorców.

3. 03

   Ustaw numer i treść

   Zacznij od własnego numeru z kodem kraju i krótkiego komunikatu. Dopiero po udanym teście podstaw dane z wcześniejszych kroków workflow.

4. 04

   Przetestuj i uruchom proces

   Sprawdź wynik akcji i odbiór wiadomości. Następnie przetestuj warunki wysyłki oraz błędy w całym przepływie, zanim uruchomisz go dla klientów.

Jeśli node nie pojawia się w wyszukiwarce, sprawdź dostępność verified community nodes na swojej instancji i uprawnienia konta. Procedurę opisuje dokumentacja instalacji zweryfikowanych node’ów n8n.

4. Jakie dane przekazać do wysyłki?

Dobrze zachować powiązanie wiadomości z konkretnym zamówieniem lub dokumentem. Sam numer telefonu nie wystarczy, gdy klient ma kilka otwartych spraw. Poniższe nazwy są przykładowymi kluczami danych workflow, a nie nazwami pól wymaganymi przez wtyczkę.

Brak numeru powinien skierować sprawę do obsługi, a nie kończyć się nieudaną próbą wysyłki. Przy brakującym imieniu można użyć neutralnego początku wiadomości. Jeśli brakuje linku potrzebnego do wykonania działania, lepiej zatrzymać tę ścieżkę i wyjaśnić brak danych.

Pole nadawcy jest pobierane z konfiguracji konta SMSAPI. Jeżeli ma pokazywać nazwę firmy, przygotuj odpowiednie ustawienie po stronie tego konta.

5. Status wysyłki, doręczenie i wynik sprzedaży

Poprawne wykonanie akcji Send SMS nie potwierdza jeszcze doręczenia wiadomości. Odpowiedź bramki może informować o przyjęciu zlecenia do kolejki. Późniejszy raport doręczenia opisuje kolejny etap.

SMSAPI udostępnia aktualizacje statusów przez callback. Aby odbierać je w n8n, trzeba osobno skonfigurować adres odbioru, dopasowanie raportu do wysłanej wiadomości i zapis wyniku. To rozszerzenie procesu, a nie automatyczna funkcja akcji Send SMS.

Historię w CRM lub arkuszu zapisuje kolejny krok workflow. Wtyczka nie ma własnego dashboardu. Przy raportowaniu płatności porównuj wysyłki z danymi sklepu; zakup po SMS-ie sam w sobie nie dowodzi, że wiadomość go spowodowała.

6. Co sprawdzić przy błędach i ponownym uruchomieniu?

Najwięcej problemów pojawia się wtedy, gdy test na jednym numerze zostaje uznany za zakończone wdrożenie. Trzeba jeszcze ustalić, kto otrzyma informację o błędzie i jak wróci do nieobsłużonej sprawy.

Kontrola powtórzeń, obsługa błędów i ponowienia są częścią projektu workflow. Nie należy zakładać, że sama instalacja node’a zapewnia wszystkie te mechanizmy.

7. Koszty, długość wiadomości i większe wysyłki

Budżet obejmuje wysyłkę w SMSAPI, środowisko n8n oraz ewentualne przygotowanie i utrzymanie integracji. Koszt zależy od wariantu korzystania z n8n, liczby wiadomości i zakresu wdrożenia. Warunki ustala się dla wybranego procesu.

Długość wiadomości sprawdzaj po dodaniu imienia, numeru zamówienia i linku. Jeden SMS mieści zwykle do 160 znaków GSM-7 albo 70 przy kodowaniu Unicode. W wiadomościach wieloczęściowych limity wynoszą odpowiednio 153 i 67 na część. Niektóre znaki zajmują więcej miejsca.

Wtyczka obsługuje polskie znaki. Przy dłuższej treści koszt może obejmować kilka segmentów SMS, dlatego warto przetestować najdłuższe warianty personalizacji. Zasady segmentacji opisuje regulamin SMSAPI.

Przy większej liczbie odbiorców znaczenie mają czas wykonania, limity usług i sposób przetwarzania danych. Wiadomości są obsługiwane kolejno. Test na kilku numerach nie potwierdza wydajności dużej kampanii; przed nią trzeba sprawdzić docelowy wolumen.

8. Kiedy wybrać n8n, HubSpot lub panel SMSAPI?

Wybierz n8n, gdy reguły kontaktu zależą od kilku aplikacji albo platforma już obsługuje Twoje automatyzacje. Możesz wtedy połączyć dane sklepu, płatności, CRM i dokumentów w jednym przepływie.

Jeżeli cały scenariusz działa w workflow HubSpot, warto rozważyć naszą integrację SMSAPI dla tego CRM. Przykład opisujemy w artykule o automatyzacji SMS na Black Friday w HubSpot.

Do jednorazowej wysyłki może wystarczyć panel SMSAPI. Własne wywołania API mają sens, gdy komunikacja jest częścią rozwijanej aplikacji i wymaga szerszej kontroli. Gotowy node przydaje się tam, gdzie wysyłka ma być krokiem w n8n.

Ustal też, który system odpowiada za dany komunikat. Jeśli tę samą wiadomość mogą uruchomić n8n i HubSpot, łatwo wysłać klientowi dwa przypomnienia.

Najczęstsze pytania o SMSAPI i n8n

Porozmawiajmy o Twoim procesie

Jeśli Twój zespół ręcznie wysyła informacje o zamówieniach lub przypomnienia, zacznijmy od jednego takiego procesu. W Velmancie pomożemy połączyć źródło danych z n8n, ustalić warunki wysyłki i obsługę wyjątków.

Na rozmowę przygotuj nazwę systemu, z którego pochodzą dane, i krótki opis sytuacji, w której klient powinien dostać wiadomość.

Umów darmową konsultację