> 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-omnisend.md).
# Sesami Flows en Omnisend
Integreer Sesami met Omnisend om geavanceerde e-mail- en sms-marketing voor uw boekingsbedrijf mogelijk te maken.
## Wat is Omnisend?
Omnisend is een marketingautomatiseringsplatform dat gespecialiseerd is in e-mail- en sms-marketing voor e-commercebedrijven. Het biedt een reeks tools en functies die zijn ontworpen om e-commercebedrijven te helpen hun klanten te betrekken, de verkoop te verhogen en de algehele marketingefficiëntie te verbeteren.
## Waarom Sesami integreren met Omnisend?
Je kunt al je klantgerichte interacties stroomlijnen door Sesami-gebeurtenisgegevens in Omnisend te voeden en alle communicatie (e-mail of sms) via Omnisend te activeren. Voor veel bedrijven die Omnisend al gebruiken om orderbevestigingen, sms-marketingberichten en andere communicatie te verzenden, creëert het ook via Omnisend versturen van boekingsbevestigingen en afspraakherinneringen een uniforme klantervaring.
### Veelvoorkomende gebruiksscenario's
**E-mail- en sms-workflows:**
* Flow voor afspraakbevestiging
* Flow voor het verzetten van afspraken
* Flow voor afspraakannulering
* Flow voor afspraakherinnering (24 uur van tevoren, of aangepaste timing)
* Flow voor voltooiing van de afspraak
## Hoe het werkt
Sesami gebruikt **Sesami Flows** om boekingsgebeurtenissen realtime naar Omnisend te sturen. Wanneer een afspraak wordt aangemaakt, verplaatst, ingecheckt, gestart, geannuleerd of gemarkeerd als no-show, stuurt Sesami die gebeurtenisgegevens via webhook naar Omnisend naar een aangepast event dat je hebt aangemaakt. Vervolgens maak je in Omnisend workflows die e-mail- of sms-berichten activeren op basis van deze aangepaste gebeurtenissen.
### De gegevensstroom
1. Klant boekt een afspraak in Sesami
2. Sesami Flow wordt geactiveerd en stuurt gebeurtenisgegevens via webhook naar Omnisend
3. Omnisend ontvangt de gebeurtenis als een aangepast event (bijv. "Afspraak aangemaakt")
4. Omnisend-workflow wordt geactiveerd op basis van die gebeurtenis
5. Klant ontvangt een e-mail of sms met afspraakgegevens
## Installatie-instructies
### Deel 1: Stel Omnisend in
#### Stap 1: Installeer en koppel Omnisend
1. Installeer de **Omnisend-app** uit de Shopify App Store
2. Volg de installatiestappen van de app om je winkel te koppelen
3. Voltooi het onboardingproces van Omnisend
#### Stap 2: Maak een API-sleutel aan (KPI Key)
1. Klik in Omnisend op je **profieltabblad**
2. Navigeer naar **Winkelinstellingen**
3. Klik op **API-sleutels** tabblad
4. Klik op **Maak een private API-sleutel aan**
5. Noem deze "Sesami-integratie" (of iets dergelijks)
6. Configureer machtigingen - selecteer het volgende:
* **Campagnes** - maakt het mogelijk om rapporten en ontvangerslijsten te downloaden
* **Contacten** - maakt het mogelijk om abonnees aan te maken, te bewerken, te downloaden en te verwijderen
* **Bestellingen** - maakt het mogelijk om bestellingen aan te maken, te bewerken, te downloaden en te verwijderen
* **Producten** - maakt het mogelijk om producten aan te maken, te bewerken, te downloaden en te verwijderen
* **Winkelwagens** - maakt het mogelijk om winkelwagens aan te maken, te bewerken, te downloaden en te verwijderen
* **Gebeurtenissen** - maakt het mogelijk om aangepaste gebeurtenissen op te halen en te activeren (**Vereist**)
7. Kopieer de gegenereerde API-sleutel en bewaar deze veilig
{% hint style="warning" %}
**Belangrijk**: Je hebt voor elk uniek gebeurtenistype een aparte API-sleutel nodig (afspraak aangemaakt, verplaatst, geannuleerd, enz.).
{% endhint %}
Raadpleeg voor meer details [de API-documentatie van Omnisend](https://api-docs.omnisend.com/).
#### Stap 3: Maak aangepaste events aan in Omnisend
Maak voor elk type afspraakgebeurtenis dat je wilt volgen een aangepast event aan:
1. Ga in Omnisend naar **Winkelinstellingen > Aangepaste events**
2. Klik op **Aangepast event aanmaken**
3. Configureer het event:
* **Eventnaam**: Kies een beschrijvende naam (bijv. "Afspraak aangemaakt", "Afspraak verplaatst")
* **Systeemnaam**: Deze wordt automatisch gegenereerd op basis van de eventnaam
* **Aangepaste eventvelden**: Definieer de boekingsgegevens die je wilt gebruiken in je e-mails/sms:
* `CustomerName` - Naam van de klant
* `ServiceName` - Naam van de geboekte service
* `DateTimeInCustomerTimezone` - Datum/tijd van de afspraak
* `CustomerManagementLink` - Link waarmee de klant de boeking kan beheren
* `AppointmentID` - Unieke afspraak-ID
* `TeamMember` - Naam van toegewezen personeelslid
* Voeg indien nodig andere velden toe
4. Voeg klant **e-mail** en **telefoon** velden toe (vereist om berichten te verzenden)
5. Sla het aangepaste event op
6. **Kopieer de Event-ID** - die heb je nodig voor de webhook-URL van Sesami Flow
{% hint style="info" %}
Herhaal dit proces voor elk gebeurtenistype dat je wilt volgen (aangemaakt, verplaatst, geannuleerd, voltooid, herinnering).
{% endhint %}
Zie voor gedetailleerde instructies [de documentatie over aangepaste events van Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).
### Deel 2: Configureer Sesami Flows
#### Stap 1: Maak een Flow aan in Sesami
1. Open de [Sesami Admin Portal](https://help.sesami.co/admin/sesami-admin-portal)
2. Navigeer naar **Flows**
3. Klik op **Maak Flow aan**
#### Stap 2: Configureer de Flow-trigger
1. Kies je triggergebeurtenis:
* Afspraak aangemaakt
* Afspraak verplaatst
* Klant heeft ingecheckt
* Afspraak gestart
* Afspraak geannuleerd
* Niet verschenen
2. Stel **Wanneer** in op **Onmiddellijk**, of naar een tijd vóór of na de gebeurtenis (bijv. 24 uur vóór de afspraak voor een herinnering)
3. Configureer indien nodig extra voorwaarden
#### Stap 3: Voeg een webhookactie toe
1. Stel **Actie** type naar **Webhook**
2. Configureer de webhook:
* **Doel-URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
* Vervang `[EVENT_ID]` door de Event-ID die je uit Omnisend hebt gekopieerd
* **Wanneer**: Stel in op "Onmiddellijk" (of configureer timing voor herinneringen)
#### Stap 4: Configureer webhook-headers
Voeg in de sectie met webhook-headers toe:
```json
{
"Content-Type": "application/json",
"X-API-KEY": "YOUR_OMNISEND_API_KEY"
}
```
Vervang `YOUR_OMNISEND_API_KEY` met de daadwerkelijke API-sleutel die je in Omnisend hebt aangemaakt.
#### Stap 5: Configureer de webhook-body
Koppel in het body-gedeelte van de webhook de boekingsgegevens van Sesami aan je aangepaste Omnisend-velden:
```json
{
"fields": {
"CustomerName": "{{CustomerName}}",
"ServiceName": "{{ServiceName}}",
"DateTimeInCustomerTimezone": "{{DateTimeInCustomerTimezone}}",
"CustomerManagementLink": "{{CustomerManagementLink}}",
"AppointmentID": "{{AppointmentID}}",
"TeamMember": "{{TeamMember}}"
},
"email": "{{CustomerEmail}}",
"phone": "{{CustomerPhone}}"
}
```
{% hint style="info" %}
De veldnamen in `"fields"` moeten exact overeenkomen met de aangepaste velden die je hebt gedefinieerd in je Omnisend-aangepaste event.
{% endhint %}
#### Stap 6: Sla de Flow op en schakel deze in
1. Geef je Flow een beschrijvende naam (bijv. "Omnisend - Afspraak aangemaakt")
2. **Sla** de Flow op
3. Schakel de Flow in
Herhaal stappen 1-6 voor elk gebeurtenistype dat je naar Omnisend wilt verzenden.
### Deel 3: Maak workflows aan in Omnisend
#### Stap 1: Maak een aangepaste workflow aan
1. Log in op **Omnisend**
2. Navigeer naar **Automatisering > Workflows**
3. Klik op **Nieuwe workflow**
4. Selecteer **Maak aangepaste workflow aan**
#### Stap 2: Configureer de trigger
1. Selecteer voor de trigger je aangepaste event (bijv. "Afspraak aangemaakt")
2. De workflow wordt geactiveerd telkens wanneer Sesami gegevens naar dit event verzendt
#### Stap 3: Voeg e-mail- of sms-acties toe
1. Klik op **Actie toevoegen** in de workflow
2. Kies **E-mail** of **sms**
3. Ontwerp je berichtsjabloon
#### Stap 4: Gebruik aangepaste velden in je sjabloon
Wanneer je de inhoud van je e-mail of sms bewerkt, kun je de boekingsgegevens benaderen met de syntaxis voor aangepaste velden:
* `[[custom_event.CustomerName]]` - Naam van de klant
* `[[custom_event.ServiceName]]` - Naam van de service
* `[[custom_event.DateTimeInCustomerTimezone]]` - Datum/tijd van de afspraak
* `[[custom_event.CustomerManagementLink]]` - Link voor boekingsbeheer
* `[[custom_event.TeamMember]]` - Toegewezen teamlid
#### Stap 5: Configureer aanvullende workflowinstellingen
1. Stel **Frequentie** regels (bijv. "Activeer de workflow niet opnieuw voor contacten die al in deze automatisering hebben gezeten")
2. Voeg toe **Uittreedvoorwaarden** indien nodig
3. Configureer eventuele tijdsvertragingen of conditionele splitsingen
#### Stap 6: Activeer de workflow
Zodra je je workflow hebt ontworpen en getest, klik op **Inschakelen** om deze live te zetten.
## Je integratie testen
Test de integratie voordat je live gaat:
1. Maak een testboeking aan in Sesami
2. Controleer of de gebeurtenis in Omnisend verschijnt onder **Winkelinstellingen > Aangepaste events** (bekijk de gebeurtenisactiviteit)
3. Controleer of alle afspraakgegevens correct worden ingevuld
4. Test je Omnisend-workflow om te zorgen dat e-mails/sms correct worden verzonden
5. Controleer de inhoud om te zorgen dat alle aangepaste velden correct worden weergegeven
{% hint style="success" %}
**Tip van de pro**: Maak een test-e-mailadres en telefoonnummer voor een klant aan, en doe vervolgens testboekingen om de volledige klantervaring te controleren voordat je workflows inschakelt voor echte klanten.
{% endhint %}
## FAQ
Heb ik een aparte API-sleutel nodig voor elk gebeurtenistype?
Ja, Omnisend vereist een unieke API-sleutel voor elk aangepast event dat je aanmaakt. Dus als je gebeurtenissen voor aangemaakte, verplaatste en geannuleerde afspraken bijhoudt, heb je drie aparte API-sleutels nodig.
Kan ik Omnisend gebruiken voor sms én e-mail?
Ja! Omnisend ondersteunt zowel e-mail als sms. Zorg ervoor dat je:
* Neem het `telefoon` veld op in je webhook-body
* Sms is ingeschakeld in je Omnisend-account
* Telefoonnummers van klanten hebt verzameld met de juiste toestemming
* Sms-acties configureert in je Omnisend-workflows
Zie voor meer details [de sms-documentatie van Omnisend](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).
Wat als ik meerdere herinneringsworkflows nodig heb?
Je kunt meerdere herinnerings-Flows in Sesami aanmaken, elk met een andere timing:
* 7 dagen voor de afspraak
* 24 uur voor de afspraak
* 2 uur voor de afspraak
Elke Flow kan naar hetzelfde aangepaste event in Omnisend sturen, of je kunt aparte aangepaste events aanmaken voor verschillende herinneringstijden.
Gebeurtenissen verschijnen niet in Omnisend. Wat moet ik controleren?
* Controleer of je Omnisend-API-sleutel correct is en of de machtiging "Events" is ingeschakeld
* Controleer of de Event-ID in je webhook-URL overeenkomt met je aangepaste event
* Controleer of de Flow is ingeschakeld in Sesami
* Controleer of je een testboeking hebt gemaakt nadat je de Flow hebt ingesteld
* Bekijk de logs van Sesami Flow om te zien of de webhook succesvol is verzonden
* Controleer de activiteit van het aangepaste event in Omnisend (Winkelinstellingen > Aangepaste events)
* Zorg ervoor dat alle verplichte velden (e-mail of telefoon) zijn opgenomen in de webhook-body
Kan ik vertalingen voor verschillende talen gebruiken?
Ja! Omnisend ondersteunt vertalingen voor campagnes en geautomatiseerde e-mails. Je kunt gelokaliseerde versies van je workflows maken op basis van de taalvoorkeuren van klanten. Zie [de vertalingsdocumentatie van Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).
## Gerelateerd
* [Sesami Flows](/help-center-live-nl/automatiseringen/sesami-flows.md) - Overzicht van het automatiseringssysteem van Sesami
* [E-mail- en webhookacties](/help-center-live-nl/automatiseringen/email-and-webhook-as-action-types.md) - Inzicht in actietypen
* [Sesami Flows en Klaviyo](/help-center-live-nl/automatiseringen/sesami-flows-and-klaviyo.md) - Alternatieve ESP-integratie
* [Notificatie-e-mails](/help-center-live-nl/meldingen/notification-emails.md) - Standaard notificatiesysteem 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-omnisend.md?ask=&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.