> ## 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 wiadomości

> Zmień treść powiadomień w dzwonku i w e-mailach, osobno dla każdego rodzaju i języka.

Szablony wiadomości decydują o słowach, które widzą ludzie: o tytule i treści powiadomienia w dzwonku i w skrzynce
oraz o temacie i treści e-maili z powiadomieniami, skrótów i dziennych podsumowań. „Każdy szablon zaczyna od
działającej wersji domyślnej; zmień tylko to, czego potrzebujesz.”

Potrzebujesz uprawnienia **Zarządzanie szablonami wiadomości** w grupie **Centrum powiadomień**. Otwórz
**Powiadomienia** > **Jak dostaję powiadomienia** i w sekcji **Przestrzeń** wybierz **Szablony wiadomości**.

## Wybór szablonu

Pasek u góry wybiera jeden szablon:

* **Rodzaj powiadomienia**: których powiadomień dotyczy.
* **Dzwonek** albo **E-mail**: kanał. Skróty i podsumowania mają tylko szablon e-mail.
* **Angielski** albo **Polski**: język. Kropka oznacza język, w którym zmieniono szablon.

Po prawej **Domyślny** oznacza, że szablon jest niezmieniony, a **Zmieniony · różni się od domyślnego**, że go
zmieniono.

| Rodzaj powiadomienia | Dotyczy |
| - | - |
| **Alerty cenowe**, **MAP i naruszenia**, **Nieaktualne dane**, **Zmiany u konkurencji**, **Zgodność** | Alertów z reguł alertów Pricing Intelligence, według typu alertu reguły. |
| **Magazyn, marketplace'y i zamówienia** | Wszystkich pozostałych powiadomień: magazynu, marketplace'ów, zamówień, drukowania, automatyzacji, kluczy API, spraw zgodności przekazanych opiekunowi klienta oraz testowych alertów z polityk eskalacji. |
| **Eskalacja** | Kopii, którą dostają osoby, gdy alert jest do nich eskalowany. |
| **Skrót** | E-maila ze skrótem. |
| **Podsumowanie dzienne** | E-maila z dziennym podsumowaniem. |

Każda osoba dostaje szablony w swoim języku. „Szablonów zmienionych tylko w jednym języku: N. Osoby używające drugiego
języka dostają jego tekst domyślny.” Zmieniaj oba języki, aby były spójne.

## Edycja szablonu

<Steps>
  <Step title="Zmień tekst">
    Dla e-maila edytuj **Temat** i **Treść (HTML)**. Dla dzwonka edytuj **Tytuł** i **Treść**.

    Szablony używają składni Scriban: zmienną zapisuje się w podwójnych nawiasach klamrowych, na przykład
    `{{ title }}`, i można używać `{{ if … }} … {{ end }}` oraz `{{ for … }} … {{ end }}`.
  </Step>

  <Step title="Wstaw zmienne">
    W sekcji **Wstaw zmienną** kliknij zmienną, aby dodać ją do tekstu. Każda pokazuje przykładową wartość.
  </Step>

  <Step title="Sprawdź podgląd">
    **Podgląd na żywo** po prawej pokazuje wynik w trakcie pisania. Dla rodzaju alertu wybierz w polu **Podgląd z**
    jedno ze swoich ostatnich powiadomień, aby zobaczyć prawdziwe wartości; w przeciwnym razie podgląd używa
    przykładowych. Pod tekstem komunikat „Kompiluje się · zmiennych: N · wartości są escapowane automatycznie” oznacza,
    że szablon działa; w razie błędu pojawia się jego opis.
  </Step>

  <Step title="Wyślij sobie test, dla e-maila">
    Kliknij **Wyślij test do mnie**. „Test wysłano na Twój adres e-mail.”
  </Step>

  <Step title="Zapisz">
    Kliknij **Zapisz szablon**. Szablonu, który się nie kompiluje, nie można zapisać.
  </Step>
</Steps>

Gdy przełączasz się na inny szablon z niezapisanymi zmianami, Omnilinker pyta „Odrzucić niezapisane zmiany w tym
szablonie?”.

Aby wrócić do tekstu dostarczonego z Omnilinkerem, kliknij **Przywróć domyślny** i potwierdź „Zastąpić ten szablon
tekstem domyślnym?”.

### Zmienne

Szablony alertów mogą używać:

| Zmienna | Wartość |
| - | - |
| `title` | Własny tytuł powiadomienia, w brzmieniu modułu |
| `body` | Własna treść powiadomienia |
| `severity` | Jego poziom, na przykład **Krytyczny** |
| `sourceLabel` | Moduł, z którego pochodzi, na przykład **Pricing Intelligence** |
| `recipientFirstName`, `recipientName` | Osoba, do której jest kierowane |
| `actionUrl` | Strona, której dotyczy |
| `occurrenceCount` | Ile razy zgłoszono je w oknie duplikatów |
| `inboxUrl` | Powiadomienie w skrzynce |
| `settingsUrl` | **Jak dostaję powiadomienia** |
| `facts` | Szczegóły przesłane przez źródło, jako lista `label` i `value` |

Typy alertów Pricing Intelligence mają też `productName`, `merchantName`, `newPrice`, `previousPrice`,
`priceChangePercent`, `ruleName` i `offerUrl`.

Szablony skrótu i podsumowania mają `recipientFirstName`, `recipientName`, `count` (powiadomienia), `threadCount`
(tematy), `periodLabel` (na przykład „między 13:00 a 14:00”), `inboxUrl`, `settingsUrl` oraz listę wątków. Sposób ich
wypisania pokazuje tekst domyślny.

W treści e-maili każda wartość jest escapowana jako HTML przed wstawieniem, więc tekst ze źródła, na przykład nazwa
konkurenta, nigdy nie doda znaczników do e-maila.

## Na co wpływa zmiana szablonu

* **Szablon dzwonka** jest stosowany w chwili nadejścia powiadomienia, a skrzynka zachowuje ten tekst: „Skrzynka
  przechowuje ten sam wyrenderowany tekst, więc dzwonek, skrzynka i e-mail zawsze się zgadzają.” Zmiana dotyczy
  powiadomień, które nadejdą po zapisaniu; te, które już są w skrzynkach, zachowują swój tekst.
* **Szablony e-mail** dotyczą każdego e-maila wysłanego po zapisaniu.

Jeśli szablonu dzwonka nie da się zastosować, powiadomienie zachowuje własny tekst modułu, więc zepsuty szablon nigdy
nie wstrzymuje powiadomień.

Szablon musi skończyć się w ciągu 10 sekund, powtórzyć pętlę najwyżej 50 000 razy i zapisać najwyżej 1 000 000 znaków.
Szablon, który robi więcej, jest przerywany: „Przerwano: szablon musi skończyć w … s, powtarzać pętlę najwyżej … razy i
zapisać najwyżej … znaków.”

## Rozwiązywanie problemów

<AccordionGroup>
  <Accordion title="„Szablon się nie kompiluje: …”">
    Tekst po dwukropku opisuje problem i jego wiersz, na przykład brakujące `{{ end }}`. Popraw go; podgląd pokaże wynik,
    gdy szablon się skompiluje.
  </Accordion>

  <Accordion title="„Ta osoba nie ma adresu e-mail.”">
    Test idzie na adres z Twojego konta. Dodaj adres e-mail do konta i wyślij test ponownie.
  </Accordion>

  <Accordion title="Ludzie nadal widzą stary tekst">
    Powiadomienia, które już są w skrzynce, zachowują tekst, z którym przyszły. Sprawdź też, czy zmieniłeś język, którego
    te osoby używają.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Kanały powiadomień" href="/pl/notifications/channels">
    Skonfiguruj e-mail, którym wysyłane są szablony.
  </Card>

  <Card title="Skrzynka powiadomień" href="/pl/notifications/inbox">
    Tu pojawia się tekst z dzwonka.
  </Card>
</CardGroup>


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