> 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/de/automatisierungen/sesami-flows-and-omnisend.md).

# Sesami Flows und Omnisend

Integrieren Sie Sesami mit Omnisend, um fortschrittliches E-Mail- und SMS-Marketing für Ihr Buchungsgeschäft zu ermöglichen.

## Was ist Omnisend?

Omnisend ist eine Marketing-Automatisierungsplattform, die sich auf E-Mail- und SMS-Marketing für E-Commerce-Unternehmen spezialisiert hat. Sie bietet eine Reihe von Tools und Funktionen, die E-Commerce-Unternehmen dabei helfen sollen, mit ihren Kunden in Kontakt zu treten, den Umsatz zu steigern und die gesamte Marketingeffizienz zu verbessern.

## Warum Sesami mit Omnisend integrieren?

Sie können alle kundenbezogenen Interaktionen optimieren, indem Sie Sesami-Ereignisdaten an Omnisend übergeben und alle Mitteilungen (E-Mail oder SMS) über Omnisend auslösen. Für viele Unternehmen, die Omnisend bereits für den Versand von Bestellbestätigungen, SMS-Marketingnachrichten und anderen Mitteilungen nutzen, schafft auch der Versand von Buchungsbestätigungen und Terminerinnerungen über Omnisend ein einheitliches Kundenerlebnis.

### Häufige Anwendungsfälle

**E-Mail- und SMS-Workflows:**

* Ablauf für Terminbestätigung
* Ablauf für Terminverschiebung
* Ablauf für Terminabsage
* Ablauf für Terminerinnerung (24 Stunden vorher oder benutzerdefinierter Zeitpunkt)
* Ablauf für Terminabschluss

## So funktioniert es

Sesami verwendet **Sesami Flows** um Buchungsereignisse in Echtzeit an Omnisend zu senden. Wenn ein Termin erstellt, verschoben, eingecheckt, begonnen, storniert oder als nicht wahrgenommen markiert wird, übermittelt Sesami diese Ereignisdaten per Webhook an Omnisend zu einem benutzerdefinierten Ereignis, das Sie erstellt haben. Anschließend erstellen Sie in Omnisend Workflows, die E-Mail- oder SMS-Nachrichten basierend auf diesen benutzerdefinierten Ereignissen auslösen.

### Der Datenfluss

1. Kunde bucht einen Termin in Sesami
2. Sesami Flow wird ausgelöst und sendet Ereignisdaten per Webhook an Omnisend
3. Omnisend empfängt das Ereignis als benutzerdefiniertes Ereignis (z. B. „Termin erstellt“)
4. Der Omnisend-Workflow wird auf Grundlage dieses Ereignisses ausgelöst
5. Kunde erhält eine E-Mail oder SMS mit Termindetails

## Einrichtungsanleitung

### Teil 1: Omnisend einrichten

#### Schritt 1: Omnisend installieren und verbinden

1. Installieren Sie die **Omnisend-App** aus dem Shopify App Store
2. Folgen Sie den Einrichtungsschritten der App, um Ihren Shop zu verbinden
3. Schließen Sie den Onboarding-Prozess von Omnisend ab

#### Schritt 2: API-Schlüssel erstellen (KPI-Schlüssel)

1. Klicken Sie in Omnisend auf Ihren **Profil-Tab**
2. Navigieren Sie zu **Shop-Einstellungen**
3. Klicken Sie auf den **API-Schlüssel** Tab
4. Klicken Sie auf **Privaten API-Schlüssel erstellen**
5. Benennen Sie ihn „Sesami-Integration“ (oder ähnlich)
6. Berechtigungen konfigurieren – wählen Sie Folgendes aus:
   * **Kampagnen** - ermöglicht das Herunterladen von Berichten und Empfängerliste
   * **Kontakte** - ermöglicht das Erstellen, Bearbeiten, Herunterladen und Löschen von Abonnenten
   * **Bestellungen** - ermöglicht das Erstellen, Bearbeiten, Herunterladen und Löschen von Bestellungen
   * **Produkte** - ermöglicht das Erstellen, Bearbeiten, Herunterladen und Löschen von Produkten
   * **Warenkörbe** - ermöglicht das Erstellen, Bearbeiten, Herunterladen und Löschen von Warenkörben
   * **Ereignisse** - ermöglicht das Abrufen und Auslösen benutzerdefinierter Ereignisse (**Erforderlich**)
7. Kopieren Sie den generierten API-Schlüssel und bewahren Sie ihn sicher auf

{% hint style="warning" %}
**Wichtig**: Sie benötigen für jeden eindeutigen Ereignistyp einen separaten API-Schlüssel (Termin erstellt, verschoben, storniert usw.).
{% endhint %}

Weitere Details finden Sie in der [Omnisend-API-Dokumentation](https://api-docs.omnisend.com/).

#### Schritt 3: Benutzerdefinierte Ereignisse in Omnisend erstellen

Erstellen Sie für jeden Terminereignistyp, den Sie verfolgen möchten, ein benutzerdefiniertes Ereignis:

1. Navigieren Sie in Omnisend zu **Shop-Einstellungen > Benutzerdefinierte Ereignisse**
2. Klicken Sie auf **Benutzerdefiniertes Ereignis erstellen**
3. Konfigurieren Sie das Ereignis:
   * **Ereignisname**: Wählen Sie einen aussagekräftigen Namen (z. B. „Termin erstellt“, „Termin verschoben“)
   * **Systemname**: Dieser wird automatisch auf Grundlage des Ereignisnamens generiert
   * **Benutzerdefinierte Ereignisfelder**: Definieren Sie die Buchungseigenschaften, die Sie in Ihren E-Mails/SMS verwenden möchten:
     * `CustomerName` - Name des Kunden
     * `ServiceName` - Name der gebuchten Dienstleistung
     * `DateTimeInCustomerTimezone` - Datum/Uhrzeit des Termins
     * `CustomerManagementLink` - Link, über den der Kunde die Buchung verwalten kann
     * `AppointmentID` - Eindeutige Termin-ID
     * `TeamMember` - Name des zugewiesenen Mitarbeiters
     * Fügen Sie bei Bedarf weitere Felder hinzu
4. Kunden- **E-Mail** und **Telefon** Felder (erforderlich für den Versand von Nachrichten)
5. Speichern Sie das benutzerdefinierte Ereignis
6. **Kopieren Sie die Ereignis-ID** - diese benötigen Sie für die Sesami-Flow-Webhook-URL

{% hint style="info" %}
Wiederholen Sie diesen Vorgang für jeden Ereignistyp, den Sie verfolgen möchten (erstellt, verschoben, storniert, abgeschlossen, Erinnerung).
{% endhint %}

Ausführliche Anweisungen finden Sie unter [Omnisends Dokumentation zu benutzerdefinierten Ereignissen](https://support.omnisend.com/en/articles/6791819-custom-events).

### Teil 2: Sesami Flows konfigurieren

#### Schritt 1: Einen Flow in Sesami erstellen

1. Öffnen Sie das [Sesami-Admin-Portal](https://help.sesami.co/admin/sesami-admin-portal)
2. Navigieren Sie zu **Flows**
3. Klicken Sie auf **Flow erstellen**

#### Schritt 2: Flow-Trigger konfigurieren

1. Wählen Sie Ihr Trigger-Ereignis aus:
   * Termin erstellt
   * Termin verschoben
   * Kunde eingecheckt
   * Termin gestartet
   * Termin storniert
   * Nicht wahrgenommen
2. Festlegen **Wann** auf **Sofort**, oder zu einem Zeitpunkt vor oder nach dem Ereignis (z. B. 24 Stunden vor dem Termin für eine Erinnerung)
3. Konfigurieren Sie bei Bedarf zusätzliche Bedingungen

#### Schritt 3: Eine Webhook-Aktion hinzufügen

1. Festlegen **Aktion** Typ auf **Webhook**
2. Konfigurieren Sie den Webhook:
   * **Ziel-URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Ersetzen Sie `[EVENT_ID]` durch die Ereignis-ID, die Sie aus Omnisend kopiert haben
   * **Wann**: Auf „Sofort“ setzen (oder Timing für Erinnerungen konfigurieren)

#### Schritt 4: Webhook-Header konfigurieren

Fügen Sie im Abschnitt „Header“ des Webhooks Folgendes hinzu:

```json
{
  "Content-Type": "application/json",
  "X-API-KEY": "IHRE_OMNISEND_API_KEY"
}
```

Ersetzen Sie `IHRE_OMNISEND_API_KEY` mit dem tatsächlichen API-Schlüssel, den Sie in Omnisend erstellt haben.

#### Schritt 5: Webhook-Body konfigurieren

Ordnen Sie im Abschnitt „Body“ des Webhooks die Sesami-Buchungsdaten Ihren benutzerdefinierten Omnisend-Feldern zu:

```json
{
  "fields": {
    "CustomerName": "{{CustomerName}}",
    "ServiceName": "{{ServiceName}}",
    "DateTimeInCustomerTimezone": "{{DateTimeInCustomerTimezone}}",
    "CustomerManagementLink": "{{CustomerManagementLink}}",
    "AppointmentID": "{{AppointmentID}}",
    "TeamMember": "{{TeamMember}}"
  },
  "email": "{{CustomerEmail}}",
  "phone": "{{CustomerPhone}}"
}
```

{% hint style="info" %}
Die Feldnamen in `"fields"` müssen exakt mit den benutzerdefinierten Feldern übereinstimmen, die Sie in Ihrem Omnisend-Benutzerereignis definiert haben.
{% endhint %}

#### Schritt 6: Den Flow speichern und aktivieren

1. Geben Sie Ihrem Flow einen aussagekräftigen Namen (z. B. „Omnisend - Termin erstellt“)
2. **Speichern** Sie den Flow
3. Aktivieren Sie den Flow

Wiederholen Sie die Schritte 1–6 für jeden Ereignistyp, den Sie an Omnisend senden möchten.

### Teil 3: Workflows in Omnisend erstellen

#### Schritt 1: Einen benutzerdefinierten Workflow erstellen

1. Melden Sie sich an bei **Omnisend**
2. Navigieren Sie zu **Automatisierung > Workflows**
3. Klicken Sie auf **Neuer Workflow**
4. Wählen Sie **Benutzerdefinierten Workflow erstellen**

#### Schritt 2: Den Trigger konfigurieren

1. Wählen Sie für den Trigger Ihr benutzerdefiniertes Ereignis aus (z. B. „Termin erstellt“)
2. Der Workflow wird jedes Mal ausgelöst, wenn Sesami Daten an dieses Ereignis sendet

#### Schritt 3: E-Mail- oder SMS-Aktionen hinzufügen

1. Klicken Sie auf **Aktion hinzufügen** im Workflow
2. Wählen Sie **E-Mail** oder **SMS**
3. Gestalten Sie Ihre Nachrichtenvorlage

#### Schritt 4: Benutzerdefinierte Felder in Ihrer Vorlage verwenden

Beim Bearbeiten Ihrer E-Mail- oder SMS-Inhalte können Sie über die Syntax für benutzerdefinierte Felder auf die Buchungseigenschaften zugreifen:

* `[[custom_event.CustomerName]]` - Name des Kunden
* `[[custom_event.ServiceName]]` - Name der Dienstleistung
* `[[custom_event.DateTimeInCustomerTimezone]]` - Datum/Uhrzeit des Termins
* `[[custom_event.CustomerManagementLink]]` - Link zur Buchungsverwaltung
* `[[custom_event.TeamMember]]` - Zugewiesenes Teammitglied

#### Schritt 5: Zusätzliche Workflow-Einstellungen konfigurieren

1. Festlegen **Häufigkeit** Regeln (z. B. „Workflow für Kontakte, die bereits in dieser Automatisierung waren, nicht erneut auslösen“)
2. Hinzufügen **Ausstiegsbedingungen** falls erforderlich
3. Konfigurieren Sie etwaige Zeitverzögerungen oder bedingte Verzweigungen

#### Schritt 6: Den Workflow aktivieren

Nachdem Sie Ihren Workflow entworfen und getestet haben, klicken Sie auf **Aktivieren** um ihn live zu schalten.

## Testen Ihrer Integration

Bevor Sie live gehen, testen Sie die Integration:

1. Erstellen Sie eine Testbuchung in Sesami
2. Prüfen Sie, ob das Ereignis in Omnisend unter **Shop-Einstellungen > Benutzerdefinierte Ereignisse** angezeigt wird (Ereignisaktivität anzeigen)
3. Überprüfen Sie, ob alle Termineigenschaften korrekt befüllt werden
4. Testen Sie Ihren Omnisend-Workflow, um sicherzustellen, dass E-Mails/SMS korrekt gesendet werden
5. Überprüfen Sie den Inhalt, um sicherzustellen, dass alle benutzerdefinierten Felder korrekt angezeigt werden

{% hint style="success" %}
**Profi-Tipp**: Erstellen Sie eine Test-E-Mail-Adresse und Telefonnummer für Kunden und führen Sie dann Testbuchungen durch, um das vollständige Kundenerlebnis zu überprüfen, bevor Sie Workflows für Live-Kunden aktivieren.
{% endhint %}

## FAQ

<details>

<summary>Benötige ich für jeden Ereignistyp einen separaten API-Schlüssel?</summary>

Ja, Omnisend benötigt für jedes benutzerdefinierte Ereignis, das Sie erstellen, einen eindeutigen API-Schlüssel. Das bedeutet: Wenn Sie die Ereignisse „Termin erstellt“, „verschoben“ und „storniert“ verfolgen, benötigen Sie drei separate API-Schlüssel.

</details>

<details>

<summary>Kann ich Omnisend auch für SMS sowie für E-Mails verwenden?</summary>

Ja! Omnisend unterstützt sowohl E-Mail als auch SMS. Stellen Sie sicher, dass Sie:

* Fügen Sie das `Telefon` Feld in den Body Ihres Webhooks ein
* SMS in Ihrem Omnisend-Konto aktiviert haben
* Kundentelefonnummern mit der entsprechenden Einwilligung erfasst haben
* SMS-Aktionen in Ihren Omnisend-Workflows konfigurieren

Weitere Details finden Sie unter [Omnisends SMS-Dokumentation](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>Was ist, wenn ich mehrere Erinnerungs-Workflows benötige?</summary>

Sie können in Sesami mehrere Erinnerungs-Flows erstellen, jeweils mit unterschiedlichem Timing:

* 7 Tage vor dem Termin
* 24 Stunden vor dem Termin
* 2 Stunden vor dem Termin

Jeder kann an dasselbe Omnisend-Benutzerereignis senden, oder Sie können separate benutzerdefinierte Ereignisse für unterschiedliche Erinnerungszeitpunkte erstellen.

</details>

<details>

<summary>Ereignisse werden in Omnisend nicht angezeigt. Was sollte ich prüfen?</summary>

* Prüfen Sie, ob Ihr Omnisend-API-Schlüssel korrekt ist und die Berechtigung „Events“ aktiviert ist
* Stellen Sie sicher, dass die Ereignis-ID in Ihrer Webhook-URL mit Ihrem benutzerdefinierten Ereignis übereinstimmt
* Prüfen Sie, ob der Flow in Sesami aktiviert ist
* Stellen Sie sicher, dass Sie nach dem Einrichten des Flows eine Testbuchung vorgenommen haben
* Prüfen Sie die Sesami-Flow-Protokolle, um zu sehen, ob der Webhook erfolgreich gesendet wurde
* Prüfen Sie die Aktivität des benutzerdefinierten Ereignisses in Omnisend (Shop-Einstellungen > Benutzerdefinierte Ereignisse)
* Stellen Sie sicher, dass alle erforderlichen Felder (E-Mail oder Telefon) im Body des Webhooks enthalten sind

</details>

<details>

<summary>Kann ich Übersetzungen für verschiedene Sprachen verwenden?</summary>

Ja! Omnisend unterstützt Übersetzungen für Kampagnen und automatisierte E-Mails. Sie können lokalisierte Versionen Ihrer Workflows auf Grundlage der Sprachpräferenzen Ihrer Kunden erstellen. Siehe [Omnisends Übersetzungsdokumentation](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Verwandt

* [Sesami Flows](https://help.sesami.co/de/automatisierungen/sesami-flows.md) - Überblick über das Automatisierungssystem von Sesami
* [E-Mail- und Webhook-Aktionen](https://help.sesami.co/de/automatisierungen/email-and-webhook-as-action-types.md) - Aktionsarten verstehen
* [Sesami Flows und Klaviyo](https://help.sesami.co/de/automatisierungen/sesami-flows-and-klaviyo.md) - Alternative ESP-Integration
* [Benachrichtigungs-E-Mails](https://help.sesami.co/de/benachrichtigungen/notification-emails.md) - Standard-Benachrichtigungssystem von 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/de/automatisierungen/sesami-flows-and-omnisend.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.
