> For the complete documentation index, see [llms.txt](https://help.sesami.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sesami.co/pl/automatyzacje/sesami-flows-and-klaviyo.md).

# Sesami Flows i Klaviyo

Zintegruj Sesami z Klaviyo, aby prowadzić zaawansowany marketing e-mail i SMS dla Twojej firmy opartej na rezerwacjach.

## Czym jest Klaviyo?

Klaviyo to platforma automatyzacji marketingu używana głównie do marketingu e-mail i SMS. Jako partner strategiczny Sesami, Klaviyo zapewnia potężne narzędzia komunikacji z klientami dla firm działających w oparciu o wizyty.

## Dlaczego integrować Sesami z Klaviyo?

Możesz usprawnić wszystkie interakcje z klientami, przekazując dane zdarzeń Sesami do Klaviyo i uruchamiając całą komunikację (e-mail lub SMS) za pośrednictwem Klaviyo. Dla wielu firm, które już korzystają z Klaviyo do wysyłania potwierdzeń zamówień, wiadomości marketingowych SMS i innych komunikatów, wysyłanie potwierdzeń rezerwacji i przypomnień o wizytach również przez Klaviyo tworzy spójne doświadczenie klienta.

### Typowe zastosowania

**Przepływy e-mail i SMS:**

* Przepływ potwierdzenia wizyty
* Przepływ zmiany terminu wizyty
* Przepływ anulowania wizyty
* Przepływ przypomnienia o wizycie (24 godziny wcześniej lub w niestandardowym czasie)
* Przepływ zakończenia wizyty

**Łączone integracje:**

* Proś o recenzje klientów za pomocą platform opinii (Okendo, Yotpo, Trustpilot itd.)
* Zapraszaj do programów lojalnościowych po wizycie lub monitoruj je (LoyaltyLion, Swell itd.)
* Personalizuj e-maile dotyczące wizyt (Limespot, Nosto itd.)

## Jak to działa

Sesami używa **Sesami Flows** do wysyłania zdarzeń rezerwacji do Klaviyo w czasie rzeczywistym. Gdy wizyta jest tworzona, zmieniana, anulowana lub zakończona, Sesami przekazuje te dane zdarzenia do Klaviyo jako niestandardową metrykę. Następnie tworzysz przepływy w Klaviyo, które uruchamiają wiadomości e-mail lub SMS na podstawie tych metryk.

### Przepływ danych

1. Klient rezerwuje wizytę w Sesami
2. Przepływ Sesami uruchamia się i wysyła dane zdarzenia do Klaviyo za pośrednictwem webhooka
3. Klaviyo otrzymuje zdarzenie jako niestandardową metrykę (np. "Sesami Appointment Created")
4. Przepływ Klaviyo uruchamia się na podstawie tej metryki
5. Klient otrzymuje e-mail lub SMS z informacjami o wizycie

## Instrukcje konfiguracji

### Krok 1: Utwórz przepływ w Sesami

1. Otwórz [Portal administracyjny Sesami](https://help.sesami.co/admin/sesami-admin-portal)
2. Przejdź do **Przepływy**
3. Kliknij **Utwórz przepływ**

### Krok 2: Wybierz preset Klaviyo

Wybierz spośród dostępnych gotowych ustawień przepływu Klaviyo:

* **Zdarzenie Klaviyo: utworzenie wizyty**
* **Zdarzenie Klaviyo: zmiana terminu wizyty**
* **Zdarzenie Klaviyo: anulowanie wizyty**
* **Zdarzenie Klaviyo: zakończenie wizyty**
* **Zdarzenie Klaviyo: przypomnienie o wizycie 24 godziny wcześniej**

{% hint style="info" %}
Możesz utworzyć tyle przepływów przypomnień, ile potrzebujesz, duplikując preset przypomnienia i zmieniając czas wyzwalania.
{% endhint %}

<figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FuxdHvTIRYlwCWGpBwGIH%2FScreenshot%202026-08-27%20at%2013.33.08.png?alt=media&amp;token=2071f95d-dbf7-4dcf-a786-e0d1c0e5434d" alt=""><figcaption></figcaption></figure>

### Krok 3: Sprawdź ustawienia przepływu

Przejrzyj ogólne ustawienia przepływu, aby zrozumieć warunki wyzwalania i konfigurację webhooka.

### Krok 4: Pobierz swój prywatny klucz API Klaviyo

{% hint style="warning" %}
**Ważne**: Od 12 czerwca 2024 r. przepływy Sesami używają prywatnego klucza API Klaviyo (a nie publicznego klucza). Upewnij się, że tworzysz prywatny klucz.
{% endhint %}

1. Zaloguj się do swojego **konta Klaviyo**
2. Przejdź do **Ustawienia > Klucze API**
3. Kliknij **Utwórz prywatny klucz API**
4. Nadaj mu nazwę "Sesami Integration" i wybierz **Klucz z pełnym dostępem**
5. **Skopiuj wygenerowany prywatny klucz API**

<div><figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJQQrLNJF0Wc1v55x5pw6%2FScreenshot%202026-08-27%20at%2013.37.52.png?alt=media&amp;token=2482f74f-2bd7-416a-b74c-e617cbd40076" alt=""><figcaption></figcaption></figure> <figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FtDaqzIIZt1JaRJaFN2Zo%2FScreenshot%202026-08-27%20at%2013.43.28.png?alt=media&amp;token=bdf7fd77-bbd9-4867-aa5c-dd62512056bf" alt=""><figcaption></figcaption></figure></div>

### Krok 5: Dodaj swój klucz API do przepływu

1. W ustawieniach przepływu Sesami znajdź symbol zastępczy `KLAVIYO_PRIVATE_API_KEY`
2. Zastąp go swoim rzeczywistym prywatnym kluczem API Klaviyo
3. **Zapisz** przepływ

<figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi5oTyjoqq0PXgNihjLCt%2FScreenshot%202026-08-27%20at%2013.46.46.png?alt=media&amp;token=cf59b1ba-62f8-4910-aef2-a545e114fd05" alt=""><figcaption></figcaption></figure>

### Krok 6: Utwórz i przetestuj rezerwację

1. Utwórz testową wizytę w Sesami, aby połączyć Sesami z Klaviyo i wysłać dane zdarzenia.<br>
2. Po zakończeniu testu odpowiednie zdarzenie i jego właściwości będą dostępne w Klaviyo. Następnie możesz przejść do kolejnych kroków konfiguracji przepływu Klaviyo.

{% hint style="info" %}
**Uwaga:** Utworzenie testowej wizyty jest wymagane, aby ustanowić połączenie między nowo skonfigurowanym przepływem Sesami a API Klaviyo.

Działanie testowe musi odpowiadać wyzwalaczowi przepływu:

* Utworzenie wizyty → Utwórz nową testową wizytę.
* Zmiana terminu wizyty → Przełóż istniejącą wizytę.
* Klient zameldowany → Zamelduj klienta na wizytę.
* Rozpoczęcie wizyty → Poczekaj na rozpoczęcie wizyty.
* Anulowanie wizyty → Anuluj istniejącą wizytę.
* Niepojawienie się → Oznacz wizytę jako nieodbytą.
  {% endhint %}

## Konfiguracja przepływów w Klaviyo

Gdy Sesami zacznie wysyłać zdarzenia do Klaviyo, musisz utworzyć przepływy w Klaviyo, aby wysyłać komunikację do klientów.

### Krok 1: Utwórz przepływ w Klaviyo

1. Zaloguj się do **Klaviyo**
2. Przejdź do **Przepływy**
3. Kliknij **Utwórz przepływ** a następnie **Zbuduj własny**

<figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FgF1uw6IQslc07hlOzuBD%2FScreenshot%202026-08-27%20at%2014.23.17.png?alt=media&amp;token=daee427d-8831-4abc-979c-0f87e44b10ff" alt=""><figcaption></figcaption></figure>

### Krok 2: Wybierz wyzwalacz typu metryka

1. Wybierz **Metryka** jako typ wyzwalacza&#x20;
2. Kliknij API
3. Znajdź "Sesami" i wybierz odpowiednią metrykę.

<div><figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FdeylxlHLsqqiXcWoO3pb%2FScreenshot%202026-08-27%20at%2014.26.23.png?alt=media&amp;token=8c59d1a1-ec7f-413b-ae5c-b61baf23116c" alt=""><figcaption></figcaption></figure> <figure><img src="https://868243392-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5XGdGYX0ttyeANtcq58A%2FScreenshot%202026-08-27%20at%2014.30.23.png?alt=media&amp;token=c9c3fb06-9ad7-4f05-bc2b-9b6aa25f767f" alt=""><figcaption></figcaption></figure></div>

### Krok 3: Dodaj akcję e-mail lub SMS

1. Kliknij **Dodaj akcję**
2. Wybierz **E-mail** lub **SMS**
3. Zaprojektuj szablon wiadomości

### Krok 4: Użyj właściwości zdarzenia w swoim szablonie

Podczas edycji treści e-maila lub SMS możesz uzyskać dostęp do wszystkich właściwości związanych z rezerwacją, używając składni pokazanej w tabeli powyżej. Na przykład:

* `{{ event.datetime }}` - Pokazuje datę i godzinę wizyty
* `{{ event.service_name }}` - Pokazuje nazwę usługi
* `{{ event.team_member }}` - Pokazuje przypisanego członka zespołu
* `{{ event.customer_management_link }}` - Udostępnia link, dzięki któremu klienci mogą zmienić termin lub anulować

### Krok 5: Uaktywnij swój przepływ

Gdy zaprojektujesz wiadomość i przetestujesz ją, ustaw swój przepływ na **Aktywny** aby rozpocząć wysyłanie automatycznych wiadomości.

{% hint style="info" %}
**Oznacz swoje przepływy Klaviyo jako transakcyjne.** Potwierdzenia rezerwacji, przypomnienia, powiadomienia o zmianie terminu/anulowaniu i podobne komunikaty dotyczące wizyt są transakcyjne — nie marketingowe. Oznaczenie ich jako transakcyjnych w Klaviyo gwarantuje, że zostaną wysłane do wszystkich klientów niezależnie od zgody marketingowej, i utrzymuje czystą dostarczalność wiadomości marketingowych.

W Klaviyo otwórz akcję wiadomości przepływu, przejdź do **Dodatkowe opcje**, a następnie przełącz **Smart Sending** na wyłączone i ustaw typ wiadomości na **Transakcyjna**.
{% endhint %}

## Testowanie integracji

Przed uruchomieniem przetestuj integrację:

1. Utwórz testową rezerwację w Sesami
2. Sprawdź, czy zdarzenie pojawia się w **Strumieniu aktywności** lub **Metryki**
3. Sprawdź, czy wszystkie właściwości wizyty wypełniają się poprawnie
4. Przetestuj swój przepływ Klaviyo, aby upewnić się, że e-maile/SMS są wysyłane poprawnie
5. Przejrzyj treść, aby upewnić się, że wszystkie właściwości dynamiczne wyświetlają się poprawnie

{% hint style="success" %}
**Wskazówka**: Utwórz testowy adres e-mail klienta i wykonuj testowe rezerwacje, aby zweryfikować pełne doświadczenie klienta przed włączeniem przepływów dla rzeczywistych klientów.
{% endhint %}

## Dostępne właściwości zdarzenia

Gdy Sesami wysyła dane wizyty do Klaviyo, uwzględniane są następujące właściwości, które można wykorzystać w szablonach e-mail lub SMS w Klaviyo:

| Właściwość                             | Przykładowa wartość                 | Opis                                       |
| -------------------------------------- | ----------------------------------- | ------------------------------------------ |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55            | Unikalny identyfikator wizyty              |
| `{{ event.datetime }}`                 | 29 lipca 2022 o 16:30               | Data i godzina wizyty                      |
| `{{ event.order_id }}`                 | 4447608111157                       | Identyfikator zamówienia Shopify           |
| `{{ event.quantity }}`                 | 1                                   | Liczba rezerwacji                          |
| `{{ event.service_name }}`             | Usuwanie tatuażu                    | Nazwa usługi                               |
| `{{ event.service_description }}`      | Prosimy przybyć 15 minut wcześniej  | Instrukcje dotyczące usługi                |
| `{{ event.service_duration }}`         | 30                                  | Czas trwania w minutach                    |
| `{{ event.service_price }}`            | 149                                 | Cena usługi                                |
| `{{ event.service_location }}`         | 100 Beverly Hills, LA               | Lokalizacja usługi                         |
| `{{ event.service_image_url }}`        | <https://cdn.shopify.com/>...       | Adres URL obrazu usługi                    |
| `{{ event.team_member }}`              | David                               | Imię przypisanego członka zespołu          |
| `{{ event.team_member_description }}`  | David ma dziesięć lat doświadczenia | Biografia członka zespołu                  |
| `{{ event.team_member_email }}`        | <david@email.com>                   | Adres e-mail członka zespołu               |
| `{{ event.team_member_phone }}`        | 0000000000                          | Numer telefonu członka zespołu             |
| `{{ event.variant_title }}`            | 30 minut                            | Nazwa wariantu produktu                    |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>          | Link dla klienta do zarządzania rezerwacją |
| `{{ event.line_item_properties }}`     | Pary pytań i odpowiedzi             | Odpowiedzi z formularza niestandardowego   |

## FAQ

<details>

<summary>Co jeśli muszę ustawić więcej niż jeden przepływ przypomnień?</summary>

Możesz zbudować tyle przepływów przypomnień, ile chcesz, tworząc nowe przepływy z użyciem presetu przypomnień Klaviyo i zmieniając czas wyzwalania w konfiguracji przepływu. Na przykład możesz wysyłać przypomnienia:

* 7 dni przed wizytą
* 24 godziny przed wizytą
* 2 godziny przed wizytą

</details>

<details>

<summary>Czy mogę używać Klaviyo do SMS-ów, a także e-maili?</summary>

Tak! Klaviyo obsługuje zarówno e-mail, jak i SMS. O ile masz włączone SMS w swoim koncie Klaviyo i zebrałeś numery telefonów klientów za ich zgodą, możesz używać akcji SMS w swoich przepływach Klaviyo.

</details>

<details>

<summary>Co stało się z wymaganiem publicznego klucza API?</summary>

Od 12 czerwca 2024 r. Sesami zaktualizowało wszystkie presety przepływów tak, aby używały prywatnego klucza API Klaviyo zamiast publicznego klucza, zgodnie z zaktualizowanymi wymaganiami API Klaviyo. Zawsze używaj prywatnego klucza podczas konfigurowania nowych integracji.

</details>

<details>

<summary>Zdarzenia nie pojawiają się w Klaviyo. Co powinienem sprawdzić?</summary>

* Sprawdź, czy Twój prywatny klucz API Klaviyo jest poprawny i ma pełny dostęp
* Upewnij się, że przepływ jest włączony w Sesami
* Sprawdź, czy po skonfigurowaniu przepływu wykonano testową rezerwację
* Przejrzyj logi przepływu Sesami, aby zobaczyć, czy webhook został wysłany pomyślnie
* Sprawdź Strumień aktywności Klaviyo, aby zobaczyć, czy zdarzenia są odbierane

</details>

## Powiązane

* [Sesami Flows](/pl/automatyzacje/sesami-flows.md) - Przegląd systemu automatyzacji Sesami
* [Akcje e-mail i webhook](/pl/automatyzacje/email-and-webhook-as-action-types.md) - Zrozumienie typów akcji
* [Przegląd integracji z Klaviyo](/pl/apps-integrations/klaviyo.md) - Ogólne wzorce Klaviyo
* [E-maile powiadomień](/pl/powiadomienia/notification-emails.md) - Domyślny system powiadomień Sesami


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.sesami.co/pl/automatyzacje/sesami-flows-and-klaviyo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.