Instrukcja

Powiadomienia SMS do kupujących w NavyFlame: szablony i warunki

Instrukcja dla sklepu, który chce wysyłać kupującym SMS po opłaceniu zamówienia i po nadaniu paczki: podłączenie bramki, szablon ze zmiennymi, koszt segmentu, warunki dla kanału i konta, tryb shadow oraz odczyt historii wysyłek.

Co ustawiasz i co dostaje kupujący

NavyFlame wysyła kupującemu SMS przy dwóch zdarzeniach: gdy zamówienie zostanie opłacone i gdy paczka dostanie numer przesyłki. Wiadomość wychodzi z Twojego konta w bramce SMSAPI.pl albo SerwerSMS.pl. Opłatę nalicza bramka według swojej taryfy, a NavyFlame nie sprzedaje pakietów SMS i nie zna ceny przed wysyłką.

Wszystko ustawiasz w sekcji Automatyzacje, w zakładce Powiadomienia SMS. Instrukcja opisuje panel z 11 listopada 2026 r. Ten sam układ obejrzysz bez logowania w demo automatyzacji.

Zanim zaczniesz

  • Konto w bramce SMS ze środkami na wysyłkę: SMSAPI.pl albo SerwerSMS.pl.
  • Token API wygenerowany w panelu bramki. W SerwerSMS.pl token tworzysz w Ustawienia interfejsów → HTTPS API → Tokeny API (dokumentacja SerwerSMS, sprawdzone 11.11.2026). W SMSAPI.pl token tworzysz w panelu, w sekcji tokenów API, i nadajesz mu uprawnienie do wysyłki SMS. Skopiuj go od razu po utworzeniu i wklej w NavyFlame.
  • Nazwa nadawcy, jeśli SMS ma przychodzić z nazwą sklepu zamiast z numeru. Bramka musi ją wcześniej zatwierdzić. Według dokumentacji SerwerSMS (sprawdzone 11.11.2026) pusty nadawca oznacza tańszy SMS ECO, a polskie znaki obsługuje tylko SMS FULL, który wymaga zatwierdzonej nazwy nadawcy.
  • Numer telefonu w zamówieniu. NavyFlame przyjmuje różne zapisy, na przykład „601 234 567” albo „0048601234567”. Dziewięć cyfr bez kierunkowego traktuje jako numer polski. Numer krótszy niż 8 albo dłuższy niż 15 cyfr odrzuca, zamiast zgadywać odbiorcę.
  • Uprawnienie do edycji SMS w roli Twojego użytkownika. Z samym prawem odczytu zobaczysz szablony i historię, ale nie zmienisz ustawień.

Krok 1. Podłącz bramkę

Otwórz Integracje i wybierz kategorię SMS. Dla SMSAPI.pl wpisujesz Token dostępowy (OAuth) i opcjonalnie Nazwę nadawcy. Dla SerwerSMS.pl wpisujesz Token API i opcjonalnie Nazwę nadawcy. Dopóki żadna bramka nie jest aktywna, zakładka Powiadomienia SMS pokazuje komunikat „Bramka SMS nie jest podłączona”. Szablony możesz przygotować wcześniej, ale nic nie wyjdzie.

Jeśli masz konta w obu bramkach, w karcie Bramka SMS wybierz w polu Domyślna bramka, przez którą mają wychodzić automatyczne SMS-y. Bez wyboru wiadomości idą przez SMSAPI.pl, a gdy go nie ma, przez jedyne konto SerwerSMS.pl. Wybrana bramka nigdy nie przechodzi po cichu na drugą. Gdy jej konto przestanie działać, wysyłka zatrzyma się z powodem w historii.

Krok 2. Dodaj szablon

Kliknij Dodaj szablon. W oknie Nowy szablon SMS wypełniasz:

PoleCo oznacza
NazwaTwoja nazwa, na przykład „Paczka nadana”. Musi być unikalna
ZdarzenieZamówienie opłacone, Paczka nadana albo Tylko reguły SMS. Ostatnia opcja nie wysyła się sama, używają jej tylko reguły SMS opisane niżej
TreśćTekst SMS-a ze zmiennymi, do 1600 znaków
Rodzaj wiadomościTransakcyjny (realizacja zamówienia) albo Marketingowy (wymaga zgody klienta)
Nazwa nadawcy (opcjonalnie)Zastępuje nadawcę z ustawień bramki. Puste pole oznacza wysyłkę z numeru
Zamieniaj polskie znaki na podstawoweTaniej, ale bez ogonków
Szablon włączonyWyłączony szablon zostaje zapisany, ale nie wysyła

Zmienne wstawiasz kliknięciem pod polem treści:

ZmiennaCo podstawia
{{order.number}}Numer zamówienia
{{order.total}} i {{order.currency}}Kwotę i walutę
{{order.items}}Produkty z ilościami, najwyżej 100 znaków
{{order.itemNames}}Same nazwy produktów, najwyżej 100 znaków
{{customer.firstName}} i {{customer.name}}Imię albo imię i nazwisko
{{shipment.trackingNumber}}Numer przesyłki
{{shipment.trackingUrl}}Link do śledzenia
{{shipment.courier}}Przewoźnika

W automatycznym SMS-ie zmienna bez wartości zostaje pusta. Jeśli kurier nie przekazał linku do śledzenia, w zdaniu z {{shipment.trackingUrl}} zostanie puste miejsce. Dlatego w szablonie Paczka nadana opieraj się na numerze przesyłki, który przy tym zdarzeniu jest zawsze dostępny.

Krok 3. Sprawdź koszt pod polem treści

Bramka rozlicza SMS za segmenty. Bez polskich znaków jeden segment mieści 160 znaków, a w wiadomości wieloczęściowej 153 na część. Jedna litera spoza alfabetu GSM-7, na przykład „ą”, przełącza całą wiadomość na kodowanie UCS-2: wtedy segment ma 70 znaków, a część wiadomości wieloczęściowej 67.

Licznik pod polem Treść pokazuje liczbę znaków, segmentów i kodowanie oraz znaki, które wymuszają droższe kodowanie. Gdy treść bez nich zmieściłaby się w mniejszej liczbie segmentów, licznik to pisze.

Przykład: treść o długości 95 znaków z jednym „ó” to dwa segmenty, bo przekracza 70 znaków. Ta sama treść bez ogonków to jeden segment.

Licznik liczy treść szablonu razem ze znacznikami zmiennych. Prawdziwą długość ustalają dopiero podstawione dane, na przykład długi link do śledzenia. Segmenty rozliczone przez bramkę zobaczysz w historii, w kolumnie Segm.

Kiedy SMS faktycznie wychodzi

  • Zamówienie opłacone. SMS wychodzi, gdy NavyFlame pobierze z kanału świeżo opłacone zamówienie. Import historii zamówień nie wysyła SMS-ów, więc dawni klienci nie dostaną wiadomości o paczce sprzed roku.
  • Paczka nadana. SMS wychodzi, gdy etykietę tworzysz w NavyFlame i kurier potwierdzi numer przesyłki. Paczka nadana poza NavyFlame, na przykład w panelu kuriera, nie uruchomi tego SMS-a. Więcej o samym numerze przesyłki piszemy w artykule o automatycznym trackingu.
  • Jedno zamówienie, jeden SMS na zdarzenie. Ponowne pobranie zamówienia ani druga etykieta nie wyślą drugiej wiadomości.

Gdy dla zdarzenia masz kilka włączonych szablonów, NavyFlame bierze pierwszy, od najstarszego, który pasuje do źródła i konta zamówienia. Jeśli po drodze trafi na szablon, którego warunku nie da się rozstrzygnąć, zatrzymuje wysyłkę z powodem w historii i nie sprawdza kolejnych.

Warunki dla kanału i konta

W oknie szablonu jest sekcja Źródło i konto zamówienia z czterema polami: Kanał, Warunek kanału, Konto źródłowe i Warunek konta. Warunek może brzmieć „= jest wybranym kanałem” albo „!= jest innym kanałem”, a dla konta analogicznie. Gdy ustawisz oba, muszą być spełnione łącznie. Brak warunków obejmuje wszystkie źródła.

Przykład: masz sklep na Shopify i dwa konta Allegro. Szablon A ma Kanał Shopify, szablon B ma Konto źródłowe równe pierwszemu kontu Allegro. Zamówienie z drugiego konta Allegro nie pasuje do żadnego z nich, więc nie dostanie SMS-a, a w historii pojawi się powód.

Przycisk Pomiń Allegro ustawia warunek „!= Allegro” jednym kliknięciem. Przycisk Podgląd warunków liczy na próbce do 200 ostatnich zamówień, ile warunek obejmuje, ile wyklucza i ilu nie da się rozstrzygnąć. Podgląd niczego nie wysyła.

Gdy szablon ma warunek konta, a konta zamówienia nie da się ustalić, wysyłka zatrzymuje się z powodem w historii. Nieznane konto nie spełnia też warunku „!=”. To celowe: SMS do niewłaściwej grupy klientów jest gorszy niż SMS niewysłany.

Allegro wysyła kupującym własne powiadomienia o płatności i wysyłce, a od 2 marca 2026 r. nie doręcza wiadomości sprzedawców, które je powtarzają. Co wolno napisać kupującemu z Allegro, opisuje artykuł o kontakcie z kupującym z Allegro. Jeśli nie chcesz dublować tych powiadomień SMS-em, w tej samej zakładce włącz Ochronę powiadomień Allegro albo dodaj warunek Pomiń Allegro. Ochrona jest domyślnie wyłączona.

Historia: tabela Ostatnie wiadomości

Na dole zakładki jest tabela z kolumnami Data, Odbiorca, Treść, Status, Bramka, Segm. i Koszt. Nad szablonami widać podsumowanie: liczbę wiadomości przyjętych przez bramkę, segmenty potwierdzone przez bramkę i koszt według bramki (przy SMSAPI.pl w punktach).

Wiadomość pominięta też trafia do tabeli, ze statusem Pominięty i powodem. Najczęstsze powody:

Powód w historiiCo zrobić
Zamówienie nie zawiera numeru telefonu.Sprawdź, czy kanał przekazuje telefon kupującego
Brak zgody klienta na SMS marketingowy.Zmień Rodzaj wiadomości na transakcyjny, jeśli to powiadomienie o zamówieniu
Klient jest zablokowany w kartotece.Blokada wygrywa także z SMS-em transakcyjnym
Żaden włączony automat SMS nie pasuje do źródła i konta zamówienia.Popraw warunki albo dodaj szablon dla tego kanału
Nie można jednoznacznie rozstrzygnąć warunku źródła lub konta.Sprawdź, czy konto zamówienia jest nadal podłączone
Ochrona Allegro: pominięto automatyczną wiadomość dublującą powiadomienie platformy.Tak działa włączona ochrona

Jeden przypadek nie zostawia śladu: gdy dla zdarzenia nie ma żadnego włączonego szablonu. NavyFlame uznaje wtedy, że nie chcesz SMS-a, i nie zapełnia historii wpisami przy każdym zamówieniu.

Zgodę na SMS marketingowy NavyFlame czyta z kartoteki klienta, gdzie widać ją jako „SMS: Tak” albo „SMS: Nie”. Klient bez takiej informacji jest traktowany jak klient bez zgody. Według stanu panelu z 11 listopada 2026 r. tej zgody nie da się w NavyFlame zapisać: nie przychodzi z kanałów sprzedaży ani z importu kartoteki i nie ma jej w formularzu klienta. Szablon marketingowy zostanie więc pominięty u każdego odbiorcy. Zasady zbierania zgód opisuje artykuł o zgodach marketingowych. To nie jest porada prawna.

Test bez wysyłki: tryb shadow

Jeśli powiadomienia wysyła jeszcze inny system, a chcesz najpierw zobaczyć, co wysłałby NavyFlame, włącz Tryb shadow powiadomień (podgląd bez wysyłki). Automatyczne SMS-y i e-maile do kupujących są wtedy przygotowywane z tymi samymi szablonami, zgodami i warunkami, ale nie trafiają do bramki. W historii mają pełną treść i status trybu shadow z dopiskiem, że wiadomości nie wysłano. Po wyłączeniu trybu shadow te wiadomości nie zostaną wysłane później.

Tryb shadow nie obejmuje SMS-ów wysyłanych ręcznie z karty zamówienia ani wysyłek przez publiczne API. Nie łączy się też z bramką, więc nie sprawdzi poprawności tokenu.

SMS ręcznie z karty zamówienia

Na stronie zamówienia jest sekcja SMS do klienta z przyciskiem Napisz SMS. Wybierasz Konto bramki SMS, Szablon albo Własną treść oraz Cel wiadomości, a przycisk Przygotuj podgląd pokazuje dokładny tekst, liczbę segmentów i kodowanie. Tu brakująca wartość zmiennej zatrzymuje wysyłkę, zamiast zostawić puste miejsce. Gdy wynik jest niepotwierdzony, użyj Sprawdź status zamiast wysyłać drugi raz.

Czego ta funkcja nie robi

  • Nie wysyła SMS-ów przy innych zdarzeniach niż opłacenie i nadanie. Pozostałe sytuacje obsłużysz ręcznie z karty zamówienia.
  • Nie wysyła SMS-ów z reguł automatyzacji, dopóki obsługa NavyFlame nie włączy tego dla firmy. Karta Reguły SMS w tej samej zakładce pozwala reguły przygotować, ale do tego czasu reguła SMS nie wyśle wiadomości, a panel mówi to wprost.
  • Nie zastępuje powiadomień platform i kurierów. Jeśli kurier lub marketplace sam pisze do kupującego, ustal, który kanał ma mówić o nadaniu, żeby klient nie dostawał trzech wiadomości o tej samej paczce.

Zakres funkcji w planach porównasz na stronie planów subskrypcyjnych. Opis wszystkich kanałów komunikacji z kupującym znajdziesz na stronie funkcji wiadomości.

Najczęściej zadawane pytania

Nie. SMS wychodzi z Twojego konta w SMSAPI.pl albo SerwerSMS.pl i to bramka nalicza opłatę według swojej taryfy. NavyFlame nie zna ceny przed wysyłką. W historii SMS widać segmenty i koszt, o ile bramka je zwróci.

Najczęstsze przyczyny to etykieta utworzona poza NavyFlame, brak numeru telefonu w zamówieniu, wyłączony szablon albo warunek kanału lub konta, który nie obejmuje tego zamówienia. Powód pominięcia widać w Automatyzacje, zakładka Powiadomienia SMS, w tabeli Ostatnie wiadomości. Wyjątek: gdy dla zdarzenia nie ma żadnego włączonego szablonu, NavyFlame niczego nie zapisuje.

Nie przez automaty NavyFlame. Szablon może mieć Rodzaj wiadomości Marketingowy, ale taki SMS wychodzi tylko do klienta, który ma w kartotece zapisaną zgodę na SMS. Według stanu panelu z 11 listopada 2026 r. NavyFlame takiej zgody nie zapisuje: nie przychodzi ona z kanałów sprzedaży ani z importu kartoteki i nie wpiszesz jej ręcznie. Szablon marketingowy zostanie więc pominięty z powodem w historii. Powiadomienia o zamówieniu ustawiaj jako transakcyjne.

Nie. SMS o opłaceniu wychodzi tylko dla zamówień, które NavyFlame pobiera na bieżąco jako świeżo opłacone. Import historii zamówień nie uruchamia SMS-ów. Każde zamówienie dostaje najwyżej jeden automatyczny SMS na zdarzenie.

Włącz Tryb shadow powiadomień w zakładce Powiadomienia SMS. Automatyczne SMS-y są wtedy przygotowywane jak zwykle, ale trafiają tylko do historii z pełną treścią i statusem trybu shadow, który mówi, że wiadomości nie wysłano. Wiadomości z karty zamówienia tryb shadow nie obejmuje.

Powiadomienia z jednego panelu

SMS i e-mail do kupujących z zamówień z wielu kanałów, z historią każdej wysyłki. Okres próbny i warunki planów opisuje aktualna oferta.

Ta strona korzysta z plików cookies

Niezbędne cookies zapewniają działanie strony. Analityczne i marketingowe uruchomimy tylko za zgodą. Szczegóły.

Zarządzaj preferencjami