> 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 uruchomić zaawansowany marketing e-mail i SMS dla Twojego biznesu rezerwacyjnego.

{% hint style="success" %}
**Istnieją dwa sposoby połączenia Klaviyo.** Ta [Aplikacja Klaviyo](https://help.sesami.co/pl/apps-integrations/klaviyo/klaviyo-app.md) wysyła zdarzenia rezerwacji bez klucza API i bez konfiguracji webhooka. Ta strona opisuje Sesami Flows, które używają własnego klucza API Klaviyo i obsługują także przypomnienia przed wizytą. Zobacz [Klaviyo](https://help.sesami.co/pl/apps-integrations/klaviyo.md) aby wiedzieć, którego użyć i kiedy.
{% endhint %}

## Czym jest Klaviyo?

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

## Po co 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ż używają Klaviyo do wysyłania potwierdzeń zamówień, wiadomości marketingowych SMS i innych komunikatów, wysyłanie potwierdzeń rezerwacji oraz przypomnień o wizytach również przez Klaviyo tworzy spójne doświadczenie klienta.

### Typowe przypadki użycia

**Ścieżki e-mail i SMS:**

* Ścieżka potwierdzenia wizyty
* Ścieżka zmiany terminu wizyty
* Ścieżka anulowania wizyty
* Ścieżka przypomnienia o wizycie (24 godziny wcześniej lub w niestandardowym czasie)
* Ścieżka zakończenia wizyty

**Połączone integracje:**

* Proś o opinie klientów za pomocą platform recenzji (Okendo, Yotpo, Trustpilot itp.)
* Zachęcaj do programów lojalnościowych po wizycie lub śledź je (LoyaltyLion, Swell itp.)
* Personalizuj e-maile dotyczące wizyt (Limespot, Nosto itp.)

## Jak to działa

Sesami używa **Sesami Flows** do wysyłania zdarzeń rezerwacji do Klaviyo w czasie rzeczywistym. Gdy wizyta zostanie utworzona, przełożona, potwierdzona na miejscu, rozpoczęta, anulowana lub oznaczona jako niepojawienie się, Sesami przesyła te dane zdarzenia do Klaviyo jako niestandardową metrykę. Następnie tworzysz Flows 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. Sesami Flow uruchamia się i wysyła dane zdarzenia do Klaviyo za pomocą webhooka
3. Klaviyo otrzymuje zdarzenie jako niestandardową metrykę (np. „Sesami Appointment Created”)
4. Flow Klaviyo uruchamia się na podstawie tej metryki
5. Klient otrzymuje e-mail lub SMS ze szczegółami wizyty

## Instrukcje konfiguracji

### Krok 1: Utwórz Flow w Sesami

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

### Krok 2: Wybierz preset Klaviyo

Wybierz spośród dostępnych presetów Flow 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 przypomnień Flow, ile potrzebujesz, duplikując preset przypomnienia i zmieniając czas wyzwalacza.
{% 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 Flow

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

### Krok 4: Pobierz prywatny klucz API Klaviyo

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

1. Zaloguj się do swojego **konta Klaviyo**
2. Przejdź do **Ustawienia > Klucze API**
3. Kliknij **Utwórz prywatny klucz API**
4. Nazwij go „Sesami Integration” i wybierz **Klucz pełnego dostępu**
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 Flow

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

<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 Flow Klaviyo.

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

Działanie testowe musi odpowiadać wyzwalaczowi Flow:

* Utworzenie wizyty → Utwórz nową testową wizytę.
* Przełożenie wizyty → Przełóż istniejącą wizytę.
* Klient odprawiony → Odpraw klienta na jego wizytę.
* Rozpoczęcie wizyty → Poczekaj, aż wizyta się rozpocznie.
* Anulowanie wizyty → Anuluj istniejącą wizytę.
* Nieobecność → Oznacz wizytę jako nieobecność.
  {% endhint %}

## Konfigurowanie Flow w Klaviyo

Gdy Sesami wysyła zdarzenia do Klaviyo, musisz utworzyć Flow w Klaviyo, aby wysyłać komunikaty do klientów.

### Krok 1: Utwórz Flow w Klaviyo

1. Zaloguj się do **Klaviyo**
2. Przejdź do **Przepływy**
3. Kliknij **Utwórz Flow** 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 metryki

1. Wybierz **Metryka** jako typ wyzwalacza
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 edytowania treści e-maila lub SMS-a możesz uzyskać dostęp do wszystkich właściwości związanych z rezerwacją, używając składni pokazanej w powyższej tabeli. 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 }}` - Zapewnia link, dzięki któremu klienci mogą przełożyć lub anulować wizytę

### Krok 5: Ustaw swój Flow jako aktywny

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

{% hint style="info" %}
**Oznacz swoje Flow w Klaviyo jako transakcyjne.** Potwierdzenia rezerwacji, przypomnienia, powiadomienia o zmianie terminu/anulowaniu oraz podobne komunikaty dotyczące wizyt są transakcyjne — nie marketingowe. Oznaczenie ich w Klaviyo jako transakcyjnych zapewnia, że są wysyłane do wszystkich klientów niezależnie od zgody marketingowej, i utrzymuje wysoką dostarczalność marketingową.

W Klaviyo otwórz akcję wiadomości Flow, przejdź do **Dodatkowe opcje**, a następnie przełącz **Smart Sending** wyłącz 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 **Metryce**
3. Sprawdź, czy wszystkie właściwości wizyty wypełniają się poprawnie
4. Przetestuj swój Flow Klaviyo, aby upewnić się, że e-maile/SMS są wysyłane prawidłowo
5. Sprawdź treść, aby upewnić się, że wszystkie dynamiczne właściwości wyświetlają się poprawnie

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

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

Gdy Sesami wysyła dane wizyty do Klaviyo, następujące właściwości są uwzględnione i mogą być używane 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ę przydzielonego członka zespołu                   |
| `{{ event.team_member_description }}`  | David ma dziesięć lat doświadczenia | Biogram członka zespołu                               |
| `{{ event.team_member_email }}`        | <david@email.com>                   | E-mail członka zespołu                                |
| `{{ event.team_member_phone }}`        | 0000000000                          | Telefon członka zespołu                               |
| `{{ event.variant_title }}`            | 30 minut                            | Tytuł wariantu produktu                               |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>          | Link, dzięki któremu klient może zarządzać rezerwacją |
| `{{ event.line_item_properties }}`     | Pary pytanie/odpowiedź              | Odpowiedzi z formularza niestandardowego              |

## FAQ

<details>

<summary>Co jeśli muszę ustawić więcej niż jeden Flow przypomnienia?</summary>

Możesz utworzyć dowolną liczbę Flow przypomnień, tworząc nowe Flow z użyciem presetu przypomnienia Klaviyo i zmieniając czas wyzwalania w konfiguracji Flow. 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 zarówno do SMS-ów, jak i e-maili?</summary>

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

</details>

<details>

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

Od 12 czerwca 2024 r. Sesami zaktualizowało wszystkie presety Flow, aby używały prywatnego klucza API Klaviyo zamiast klucza publicznego, 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 prywatny klucz API Klaviyo jest poprawny i ma pełny dostęp
* Upewnij się, że Flow jest włączony w Sesami
* Sprawdź, czy po skonfigurowaniu Flow wykonałeś testową rezerwację
* Przejrzyj logi Sesami Flow, aby sprawdzić, czy webhook został wysłany pomyślnie
* Sprawdź Strumień aktywności Klaviyo, aby zobaczyć, czy zdarzenia są odbierane

</details>

## Powiązane

* [Sesami Flows](https://help.sesami.co/pl/automatyzacje/sesami-flows.md) - Przegląd systemu automatyzacji Sesami
* [Akcje e-mail i webhook](https://help.sesami.co/pl/automatyzacje/email-and-webhook-as-action-types.md) - Zrozumienie typów akcji
* [Przegląd integracji Klaviyo](https://help.sesami.co/pl/apps-integrations/klaviyo.md) - Ogólne wzorce Klaviyo
* [E-maile powiadomień](https://help.sesami.co/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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
