> 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/help-center-live-nl/automatiseringen/sesami-flows-and-klaviyo.md).

# Sesami Flows en Klaviyo

Integreer Sesami met Klaviyo om geavanceerde e-mail- en sms-marketing voor je boekingsbedrijf mogelijk te maken.

## Wat is Klaviyo?

Klaviyo is een marketingautomatiseringsplatform dat voornamelijk wordt gebruikt voor e-mailmarketing en sms-marketing. Als strategische partner van Sesami biedt Klaviyo krachtige communicatietools voor bedrijven die op afspraken zijn gebaseerd.

## Waarom Sesami integreren met Klaviyo?

Je kunt al je klantgerichte interacties stroomlijnen door Sesami-gebeurtenisgegevens in Klaviyo in te voeren en alle communicatie (e-mail of sms) via Klaviyo te activeren. Voor veel bedrijven die Klaviyo al gebruiken om orderbevestigingen, sms-marketingberichten en andere communicatie te versturen, zorgt het ook via Klaviyo versturen van boekingsbevestigingen en afspraakherinneringen voor een uniforme klantbeleving.

### Veelvoorkomende gebruikssituaties

**E-mail- en sms-flows:**

* Flow voor afspraakbevestiging
* Flow voor het verzetten van afspraken
* Flow voor annulering van afspraken
* Flow voor afspraakherinnering (24 uur van tevoren, of aangepaste timing)
* Flow voor afronding van afspraken

**Gecombineerde integraties:**

* Vraag klantbeoordelingen aan met beoordelingsplatforms (Okendo, Yotpo, Trustpilot, enz.)
* Nodig klanten uit voor of volg loyaliteitsprogramma's na de afspraak (LoyaltyLion, Swell, enz.)
* Personaliseer afspraakmails (Limespot, Nosto, enz.)

## Hoe het werkt

Sesami gebruikt **Sesami Flows** om boekingsgebeurtenissen in realtime naar Klaviyo te sturen. Wanneer een afspraak wordt aangemaakt, verzet, ingecheckt, gestart, geannuleerd of gemarkeerd als no-show, pusht Sesami die gebeurtenisgegevens naar Klaviyo als een aangepaste metric. Vervolgens maak je in Klaviyo Flows die e-mail- of sms-berichten activeren op basis van deze metrics.

### De gegevensstroom

1. Klant boekt een afspraak in Sesami
2. Sesami Flow wordt geactiveerd en stuurt gebeurtenisgegevens via webhook naar Klaviyo
3. Klaviyo ontvangt de gebeurtenis als een aangepaste metric (bijv. "Sesami Appointment Created")
4. Klaviyo Flow wordt geactiveerd op basis van die metric
5. Klant ontvangt e-mail of sms met afspraakgegevens

## Installatie-instructies

### Stap 1: Maak een Flow aan in Sesami

1. Open het [Sesami Admin Portal](https://help.sesami.co/admin/sesami-admin-portal)
2. Navigeer naar **Flows**
3. Klik op **Flow aanmaken**

### Stap 2: Kies een Klaviyo-voorinstelling

Kies uit de beschikbare Klaviyo Flow-voorinstellingen:

* **Klaviyo-gebeurtenis, afspraak aangemaakt**
* **Klaviyo-gebeurtenis, afspraak verzet**
* **Klaviyo-gebeurtenis, afspraak geannuleerd**
* **Klaviyo-gebeurtenis, afspraak voltooid**
* **Klaviyo-gebeurtenis, afspraakherinnering 24 uur van tevoren**

{% hint style="info" %}
Je kunt zoveel herinneringsflows maken als nodig is door de herinneringsvoorinstelling te dupliceren en de trigger-timing te wijzigen.
{% endhint %}

<figure><img src="https://3601549086-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>

### Stap 3: Controleer de Flow-instellingen

Controleer de algemene Flow-instellingen om de triggervoorwaarden en webhookconfiguratie te begrijpen.

### Stap 4: Haal je Klaviyo Private API Key op

{% hint style="warning" %}
**Belangrijk**: Vanaf 12 juni 2024 gebruiken Sesami Flows Klaviyo's Private API Key (niet de publieke sleutel). Zorg ervoor dat je een Private key aanmaakt.
{% endhint %}

1. Log in op je **Klaviyo-account**
2. Navigeer naar **Instellingen > API-sleutels**
3. Klik op **Private API Key aanmaken**
4. Noem het "Sesami Integration" en kies **Full Access Key**
5. **Kopieer de gegenereerde Private API Key**

<div><figure><img src="https://3601549086-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://3601549086-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>

### Stap 5: Voeg je API-sleutel toe aan de Flow

1. Zoek in je Sesami Flow-instellingen de placeholder `KLAVIYO_PRIVATE_API_KEY`
2. Vervang deze door je daadwerkelijke Klaviyo Private API Key
3. **Sla** de Flow op

<figure><img src="https://3601549086-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>

### Stap 6: Maak en test een boeking

1. Maak een testafspraak in Sesami om Sesami met Klaviyo te verbinden en de gebeurtenisgegevens te versturen.<br>
2. Zodra de test is voltooid, worden de bijbehorende gebeurtenis en eigenschappen beschikbaar in Klaviyo. Je kunt dan doorgaan met de volgende stappen van de Klaviyo Flow-configuratie.

{% hint style="info" %}
**Opmerking:** Het maken van een testafspraak is vereist om de verbinding tot stand te brengen tussen de nieuw geconfigureerde Sesami Flow en de Klaviyo API.

De testactie moet overeenkomen met de trigger van de Flow:

* Afspraak aangemaakt → Maak een nieuwe testafspraak aan.
* Afspraak verzet → Verzet een bestaande afspraak.
* Klant ingecheckt → Check de klant in voor zijn/haar afspraak.
* Afspraak gestart → Wacht tot de afspraak begint.
* Afspraak geannuleerd → Annuleer een bestaande afspraak.
* No-show → Markeer de afspraak als no-show.
  {% endhint %}

## Flows instellen in Klaviyo

Zodra Sesami gebeurtenissen naar Klaviyo stuurt, moet je in Klaviyo Flows aanmaken om communicatie naar klanten te versturen.

### Stap 1: Maak een Flow aan in Klaviyo

1. Log in op **Klaviyo**
2. Navigeer naar **Flows**
3. Klik op **Flow aanmaken** en vervolgens **Bouw je eigen**

<figure><img src="https://3601549086-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>

### Stap 2: Kies een Metric-trigger

1. Selecteer **Metric** als je trigger-type
2. Klik op API
3. Zoek "Sesami" en kies de juiste metric.

<div><figure><img src="https://3601549086-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://3601549086-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>

### Stap 3: Voeg een e-mail- of sms-actie toe

1. Klik op **Actie toevoegen**
2. Kies **E-mail** of **sms**
3. Ontwerp je berichtsjabloon

### Stap 4: Gebruik gebeurteniseigenschappen in je sjabloon

Wanneer je je e-mail- of sms-inhoud bewerkt, kun je alle boekingsgerelateerde eigenschappen openen met de syntaxis die in de tabel hierboven wordt getoond. Bijvoorbeeld:

* `{{ event.datetime }}` - Toont de datum en tijd van de afspraak
* `{{ event.service_name }}` - Toont de naam van de dienst
* `{{ event.team_member }}` - Toont het toegewezen teamlid
* `{{ event.customer_management_link }}` - Biedt klanten een link om opnieuw te plannen of te annuleren

### Stap 5: Zet je Flow live

Zodra je je bericht hebt ontworpen en getest, zet je Flow op **Live** om te beginnen met het versturen van geautomatiseerde berichten.

{% hint style="info" %}
**Markeer je Klaviyo Flows als transactioneel.** Boekingsbevestigingen, herinneringen, meldingen voor verzetten/annuleren en vergelijkbare afspraakcommunicatie zijn transactioneel — niet marketing. Door ze in Klaviyo als transactioneel te markeren, worden ze naar alle klanten verzonden, ongeacht marketingtoestemming, en blijft je marketingdeliverability schoon.

Open in Klaviyo de berichtactie van de Flow, ga naar **Extra opties**, en schakel **Smart Sending** uit en zet het berichttype op **Transactioneel**.
{% endhint %}

## Je integratie testen

Test de integratie voordat je live gaat:

1. Maak een testboeking in Sesami
2. Controleer of de gebeurtenis verschijnt in Klaviyo's **Activiteitenfeed** of **Metrieken**
3. Controleer of alle afspraakeigenschappen correct worden ingevuld
4. Test je Klaviyo Flow om ervoor te zorgen dat e-mails/sms correct worden verzonden
5. Controleer de inhoud om ervoor te zorgen dat alle dynamische eigenschappen correct worden weergegeven

{% hint style="success" %}
**Tip**: Maak een test-e-mailadres voor klanten en doe testboekingen om de volledige klantervaring te controleren voordat je Flows inschakelt voor live klanten.
{% endhint %}

## Beschikbare gebeurteniseigenschappen

Wanneer Sesami afspraakgegevens naar Klaviyo stuurt, worden de volgende eigenschappen opgenomen en kunnen ze worden gebruikt in je Klaviyo e-mail- of sms-sjablonen:

| Eigenschap                             | Voorbeeldwaarde                   | Beschrijving                          |
| -------------------------------------- | --------------------------------- | ------------------------------------- |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55          | Unieke afspraak-ID                    |
| `{{ event.datetime }}`                 | 29 juli 2022 om 16:30             | Datum en tijd van de afspraak         |
| `{{ event.order_id }}`                 | 4447608111157                     | Shopify-order-ID                      |
| `{{ event.quantity }}`                 | 1                                 | Aantal boekingen                      |
| `{{ event.service_name }}`             | Tattoo Removal                    | Naam van de dienst                    |
| `{{ event.service_description }}`      | Kom alsjeblieft 15 minuten eerder | Dienstinstructies                     |
| `{{ event.service_duration }}`         | 30                                | Duur in minuten                       |
| `{{ event.service_price }}`            | 149                               | Dienstprijs                           |
| `{{ event.service_location }}`         | 100 Beverly Hills, LA             | Dienstlocatie                         |
| `{{ event.service_image_url }}`        | <https://cdn.shopify.com/>...     | URL van dienstafbeelding              |
| `{{ event.team_member }}`              | David                             | Naam van toegewezen teamlid           |
| `{{ event.team_member_description }}`  | David heeft tien jaar ervaring    | Bio van teamlid                       |
| `{{ event.team_member_email }}`        | <david@email.com>                 | E-mailadres van teamlid               |
| `{{ event.team_member_phone }}`        | 0000000000                        | Telefoonnummer van teamlid            |
| `{{ event.variant_title }}`            | 30 minuten                        | Productvarianttitel                   |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>        | Link voor klant om boeking te beheren |
| `{{ event.line_item_properties }}`     | Vraag-/antwoordparen              | Aangepaste formulierantwoorden        |

## FAQ

<details>

<summary>Wat als ik meer dan één herinneringsflow moet instellen?</summary>

Je kunt zoveel herinneringsflows maken als je wilt door nieuwe Flows te maken met de Klaviyo-herinneringsvoorinstelling en de trigger-timing in de Flow-configuratie te wijzigen. Je kunt bijvoorbeeld herinneringen versturen:

* 7 dagen vóór de afspraak
* 24 uur vóór de afspraak
* 2 uur vóór de afspraak

</details>

<details>

<summary>Kan ik Klaviyo gebruiken voor sms en e-mail?</summary>

Ja! Klaviyo ondersteunt zowel e-mail als sms. Zolang sms is ingeschakeld in je Klaviyo-account en je klanttelefoonnummers met toestemming hebt verzameld, kun je sms-acties gebruiken in je Klaviyo Flows.

</details>

<details>

<summary>Wat is er gebeurd met de vereiste voor de publieke API-sleutel?</summary>

Vanaf 12 juni 2024 heeft Sesami alle Flow-voorinstellingen bijgewerkt om Klaviyo's Private API Key te gebruiken in plaats van de publieke sleutel, in lijn met Klaviyo's bijgewerkte API-vereisten. Gebruik altijd een Private key bij het instellen van nieuwe integraties.

</details>

<details>

<summary>Gebeurtenissen verschijnen niet in Klaviyo. Wat moet ik controleren?</summary>

* Controleer of je Klaviyo Private API Key correct is en volledige toegang heeft
* Zorg ervoor dat de Flow is ingeschakeld in Sesami
* Controleer of je een testboeking hebt gemaakt nadat je de Flow hebt ingesteld
* Bekijk de logboeken van Sesami Flow om te zien of de webhook succesvol is verzonden
* Controleer Klaviyo's Activiteitenfeed om te zien of gebeurtenissen worden ontvangen

</details>

## Gerelateerd

* [Sesami Flows](/help-center-live-nl/automatiseringen/sesami-flows.md) - Overzicht van Sesami's automatiseringssysteem
* [E-mail- en webhookacties](/help-center-live-nl/automatiseringen/email-and-webhook-as-action-types.md) - Begrip van actietypen
* [Overzicht van Klaviyo-integratie](/help-center-live-nl/apps-integrations/klaviyo.md) - Algemene Klaviyo-patronen
* [Meldingsmails](/help-center-live-nl/meldingen/notification-emails.md) - Standaard meldingssysteem van 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/help-center-live-nl/automatiseringen/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.
