> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnilinker.pl/llms.txt
> Use this file to discover all available pages before exploring further.

# Szablony

> Teksty, które Omnilinker uzupełnia danymi z zamówienia, gdy pisze do kupującego: szablony startowe, pola, których możesz użyć, i zasady, jakie musi spełniać szablon.

Szablon to treść wiadomości z polami, które Omnilinker uzupełnia danymi z zamówienia. **Napisz do kupującego**,
**Powiadom kupujących o opóźnieniu** i wiadomości automatyczne piszą z szablonów. Szablon ma przeznaczenie, na przykład
**Opóźnienie**, i treść dla każdego kanału oraz języka, w którym można go wysłać.

## Szablony startowe

Każda organizacja zaczyna z pięcioma szablonami. Ich nazwy zależą od domyślnego języka organizacji.

| Szablon | Przeznaczenie | Kanały | Co mówi |
| - | - | - | - |
| **Opóźnienie wysyłki** | Opóźnienie | E-mail, SMS | Zamówienie wyjdzie później, niż planowano; podaje nowy termin wysyłki i jak zrezygnować, odpisując. |
| **Gotowe do odbioru** | Gotowe do odbioru | E-mail, SMS | Zamówienie czeka w sklepie; podaje adres odbioru i godziny otwarcia. |
| **Oferta wysłana** | Oferta | E-mail | W załączeniu oferta z numerem i datą, do której jest ważna. |
| **Podziękowanie za zakupy** | Podziękowanie | E-mail | Dziękujemy za zamówienie, z nazwą Twojego sklepu w podpisie. |
| **Prośba o opinię** | Prośba o opinię | E-mail | Pyta ogólnie, jak poszły zakupy. Nigdy nie prosi o konkretną ocenę. |

Istnieją po polsku i po angielsku. Wiadomość używa domyślnego języka organizacji, gdy szablon ma w nim treść, a gdy nie ma,
polskiego. **Opóźnienie wysyłki** ma też treść dla Allegro; Omnilinker nie wysyła jeszcze wiadomości do kupujących z
Allegro, więc na razie jest nieużywana. Wszystkich pięciu możesz używać bez zmian, zmieniać je albo usuwać. Usunięty szablon
startowy nie wraca.

E-maile **Podziękowanie za zakupy** i **Prośba o opinię** mają link do wypisania się. Omnilinker dodaje link i jego zdanie
sam, więc nie wstawiaj linków do tych dwóch treści. Zobacz
[Zgoda i rezygnacja](https://docs.omnilinker.pl/pl/customer-service/consent-and-opting-out#linki-do-wypisania-się).

Treści **Gotowe do odbioru** i **Opóźnienie wysyłki** podpisują się nazwą Twojego sklepu, a treść o odbiorze podaje adres
odbioru i godziny otwarcia. Najpierw uzupełnij je w **Dane sklepu**; zobacz
[Ustawienia obsługi klienta](https://docs.omnilinker.pl/pl/customer-service/settings#dane-sklepu).

## Strona Szablony

Otwórz **Obsługa klienta** > **Szablony** albo przejdź na `/messaging/templates`. Aby otworzyć stronę, potrzebujesz
uprawnienia **Przeglądanie szablonów**, a aby cokolwiek zmieniać, **Tworzenie i zmiana szablonów i wiadomości
automatycznych**. Bez drugiego możesz czytać każdy szablon, ale strona mówi: „Możesz czytać szablony, ale nie możesz ich
zmieniać.”

Strona nazywa się **Szablony i wiadomości automatyczne** i ma trzy karty: **Szablony**, **Wiadomości automatyczne** i
**Nadawcy**. Każda karta pokazuje się tylko, gdy możesz ją otworzyć, a **Wiadomości automatyczne** tylko wtedy, gdy
Automatyzacje są włączone. Zobacz [Wiadomości automatyczne](https://docs.omnilinker.pl/pl/customer-service/automatic-messages).

Po lewej lista grupuje szablony według przeznaczenia. Wiersz pokazuje nazwę szablonu, jego kanały i języki oraz „Zmieniono”
z datą. Wpisz w **Znajdź szablon**, by zawęzić listę. Kliknij **Nowy szablon**, by zacząć nowy.

Po prawej otwiera się edytor wybranego szablonu:

* **Nazwa**, **Do czego służy** (przeznaczenie) i **Skrót** (opcjonalny, wpisywany po `/` w polu odpowiedzi).
* **Teksty tego szablonu**: jedna karta dla każdego kanału i języka. Usuń treść przyciskiem **Usuń ten tekst** albo dodaj ją
  przez **Dodaj tekst dla** oraz kanał i język. Treść e-maila ma też **Temat**.
* **Wstaw**: kliknij pole, by wstawić je w treści w miejscu kursora. Każde pole pokazuje przykład swojej wartości.
* **Podgląd**: treść uzupełniona przykładowymi wartościami. Wpisz **Numer zamówienia** (na przykład `10495` albo `#10495`)
  i kliknij **Pokaż z tym zamówieniem**, by zobaczyć ją uzupełnioną dla prawdziwego zamówienia i które pola to zamówienie
  może wypełnić. **Pokaż z przykładami** wraca do przykładów. Podgląd na zamówieniu wymaga dostępu do **Zamówień** oprócz
  uprawnienia do szablonów. Podgląd nigdy nie pokazuje adresu ani telefonu kupującego.
* Pod podglądem SMS pokazuje liczbę części („2 SMS-y”) i liczbę znaków w części, z ostrzeżeniem wskazującym litery, przez
  które to SMS w Unicode. Inne treści pokazują „123 z 20000 znaków”. Treść dla Allegro lub OLX pokazuje też, które zasady
  marketplace'u łamie.

Kliknij **Utwórz szablon** albo **Zapisz zmiany**, **Odrzuć zmiany**, by porzucić edycję, albo **Usuń**, by usunąć szablon
(wysłane już wiadomości zachowują swój tekst). Jeśli ktoś inny zapisał szablon, gdy go edytowałeś, nic nie jest nadpisane:
edytor mówi o tym i proponuje **Wczytaj ponownie**.

### Gdy szablonu używa wiadomość automatyczna

Dopóki włączona wiadomość automatyczna wysyła szablon, edytor ją wymienia („Wiadomości automatyczne wysyłające ten szablon:
…”). Nie możesz wtedy usunąć szablonu, zmienić jego przeznaczenia ani usunąć kanału, którym wiadomość wysyła. Najpierw wyłącz
wiadomość automatyczną albo zachowaj przeznaczenie i kanały, których używa.

## Pola, których możesz użyć

Pole zapisuje się w podwójnych nawiasach klamrowych, na przykład `{{ order.number }}`. Szablon z polem, którego Omnilinker
nie zna, jest odrzucany przy zapisie.

| Pole | Uzupełnia |
| - | - |
| `order.number` | Numer zamówienia |
| `order.external_id` | Numer zamówienia w serwisie sprzedaży |
| `order.status_for_customer` | Status zamówienia (dla klienta) |
| `order.promised_date` | Obiecana data dostawy |
| `order.new_ship_date` | Nowa data wysyłki (data wybierana w informacji o opóźnieniu) |
| `buyer.first_name` | Imię klienta |
| `product.name` | Nazwa produktu |
| `shipment.carrier`, `shipment.tracking_number`, `shipment.status` | Przewoźnik, numer przesyłki, status przesyłki |
| `invoice.number`, `invoice.ksef_number` | Numer faktury, numer KSeF |
| `seller.name` | Nazwa sklepu: **Nazwa sklepu w wiadomościach** z ustawień, a gdy jej nie ma, nazwa Twojej organizacji |
| `seller.pickup_address`, `seller.opening_hours` | **Adres odbioru** i **Godziny otwarcia** z ustawień. Puste, dopóki ich nie uzupełnisz |
| `agent.first_name` | Twoje imię |
| `quote.number`, `quote.valid_until`, `company.name` | Numer oferty, data ważności oferty, firma klienta |

Jeśli zamówienie nie ma wartości pola, którego używa szablon, Omnilinker nie wysyła wiadomości z pustym miejscem:
**Napisz do kupującego** mówi „Uzupełnij: …”, a wysyłka zbiorcza lub automatyzacja pomija zamówienie i podaje brakującą
wartość.

## Zasady, jakie musi spełniać szablon

Szablon jest sprawdzany przy zapisie i jeszcze raz przy wysyłce wiadomości. Jest odrzucany, gdy:

* inny szablon ma już ten sam skrót (małe litery, cyfry, myślniki lub podkreślenia, do 32 znaków);
* nie wybrano przeznaczenia albo żaden kanał nie ma treści;
* brakuje polskiej treści dla kanału, którego używa (polski jest językiem zapasowym), albo dwie treści mają ten sam kanał i
  język;
* treść e-maila nie ma tematu (do 255 znaków);
* treść jest za długa: 20 000 znaków dla e-maila, 1000 dla SMS-a, 2000 dla wiadomości Allegro;
* jego uzupełnianie trwa dłużej niż dwie sekundy;
* treść przeznaczona dla Allegro lub OLX zawiera link, adres e-mail, numer telefonu, zachętę do pisania poza marketplace'em
  albo prośbę o zmianę oceny.

Szablonu nie można wysłać kanałem, na którym jego przeznaczenie jest niedozwolone. Nazwa ma do 128 znaków.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.