# 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 darauf ausgelegt sind, E-Commerce-Unternehmen dabei zu helfen, mit ihren Kunden zu interagieren, den Umsatz zu steigern und die allgemeine Marketingeffizienz zu verbessern.

## Warum Sesami mit Omnisend integrieren?

Sie können all Ihre kundenorientierten Interaktionen optimieren, indem Sie Sesami-Ereignisdaten in Omnisend einspeisen und alle Kommunikationsvorgänge (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 verwenden, sorgt der Versand von Buchungsbestätigungen und Terminerinnerungen ebenfalls über Omnisend für ein einheitliches Kundenerlebnis.

### Häufige Anwendungsfälle

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

* Flow für Terminbestätigung
* Flow für Terminverschiebung
* Flow für Terminabsage
* Flow für Terminerinnerung (24 Stunden vorher oder nach benutzerdefiniertem Timing)
* Flow für Terminabschluss

## So funktioniert es

Sesami verwendet **Sesami Flows** um Buchungsereignisse in Echtzeit an Omnisend zu senden. Wenn ein Termin erstellt, verschoben, storniert oder abgeschlossen wird, sendet 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 löst Ereignisdaten aus und sendet sie per Webhook an Omnisend
3. Omnisend empfängt das Ereignis als benutzerdefiniertes Ereignis (z. B. „Termin erstellt“)
4. Omnisend-Workflow wird basierend auf diesem Ereignis 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: Einen 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 **Private 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ängerlisten
   * **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
   * **Veranstaltungen** - 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 Termin-Ereignistyp, 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 basierend auf dem Ereignisnamen generiert
   * **Benutzerdefinierte Ereignisfelder**: Definieren Sie die Buchungseigenschaften, die Sie in Ihren E-Mails/SMS verwenden möchten:
     * `CustomerName` - Name des Kunden
     * `ServiceName` - Name des gebuchten Services
     * `DateTimeInCustomerTimezone` - Termin-Datum/-Uhrzeit
     * `CustomerManagementLink` - Link, über den der Kunde die Buchung verwalten kann
     * `AppointmentID` - Eindeutige Terminkennung
     * `TeamMember` - Name des zugewiesenen Mitarbeiters
     * Fügen Sie bei Bedarf weitere Felder hinzu
4. Kunden hinzufügen **E-Mail** und **Telefon** Felder (erforderlich für den Versand von Nachrichten)
5. Speichern Sie das benutzerdefinierte Ereignis
6. **Kopieren Sie die Ereignis-ID** - Sie benötigen sie für die Webhook-URL des Sesami Flows

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

Detaillierte Anweisungen finden Sie unter [der Dokumentation zu benutzerdefinierten Ereignissen von Omnisend](https://support.omnisend.com/en/articles/6791819-custom-events).

### Teil 2: Sesami Flows konfigurieren

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

1. Öffnen Sie **Sesami** in Ihrem Shopify-Adminbereich
2. Navigieren Sie zu **Einstellungen > Flows**
3. Klicken Sie auf **Einen Flow erstellen**

#### Schritt 2: Den Flow-Trigger konfigurieren

1. Wählen Sie Ihr Trigger-Ereignis:
   * Termin erstellt
   * Termin verschoben
   * Termin storniert
   * Termin abgeschlossen
   * Zeitbasierte Erinnerung (z. B. 24 Stunden vor dem Termin)
2. Konfigurieren Sie bei Bedarf zusätzliche Bedingungen

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

1. Setzen Sie den **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
   * **Wenn**: Auf „Sofort“ setzen (oder das Timing für Erinnerungen konfigurieren)

#### Schritt 4: Webhook-Header konfigurieren

Fügen Sie im Bereich Webhook-Header Folgendes hinzu:

```json
{
  "Content-Type": "application/json",
  "X-API-KEY": "IHR_OMNISEND_API_SCHLÜSSEL"
}
```

Ersetzen Sie `IHR_OMNISEND_API_SCHLÜSSEL` durch den tatsächlichen API-Schlüssel, den Sie in Omnisend erstellt haben.

#### Schritt 5: Webhook-Body konfigurieren

Ordnen Sie im Bereich Webhook-Body 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 genau 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** 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 mithilfe der Syntax für benutzerdefinierte Felder auf die Buchungseigenschaften zugreifen:

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

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

1. Setzen Sie den **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 eventuelle Zeitverzögerungen oder bedingte Aufteilungen

#### Schritt 6: Den Workflow aktivieren

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

## Testen Ihrer Integration

Testen Sie die Integration, bevor Sie live gehen:

1. Erstellen Sie eine Testbuchung in Sesami
2. Prüfen Sie, ob das Ereignis in Omnisend unter **Shop-Einstellungen > Benutzerdefinierte Ereignisse** angezeigt wird (die Ereignisaktivität anzeigen)
3. Stellen Sie sicher, dass 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" %}
**Tipp**: Erstellen Sie eine Test-E-Mail-Adresse und Telefonnummer für einen Kunden und nehmen Sie dann Testbuchungen vor, 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 erfordert einen eindeutigen API-Schlüssel für jedes benutzerdefinierte Ereignis, das Sie erstellen. Das bedeutet: Wenn Sie die Ereignisse „Termin erstellt“, „Termin verschoben“ und „Termin storniert“ verfolgen, benötigen Sie drei separate API-Schlüssel.

</details>

<details>

<summary>Kann ich Omnisend sowohl für SMS als auch für E-Mail verwenden?</summary>

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

* Fügen Sie das `Telefon` Feld in Ihren Webhook-Body ein
* SMS in Ihrem Omnisend-Konto aktiviert haben
* Kundentelefonnummern mit ordnungsgemäßer Einwilligung erfasst haben
* SMS-Aktionen in Ihren Omnisend-Workflows konfigurieren

Weitere Details finden Sie in [der SMS-Dokumentation von Omnisend](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 benutzerdefinierte Omnisend-Ereignis 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 überprüfen?</summary>

* Stellen Sie sicher, dass Ihr Omnisend-API-Schlüssel korrekt ist und die Berechtigung „Events“ aktiviert ist
* Vergewissern Sie sich, 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 der Einrichtung des Flows eine Testbuchung vorgenommen haben
* Überprü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 Webhook-Body 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 basierend auf den Sprachpräferenzen der Kunden erstellen. Siehe [die Übersetzungsdokumentation von Omnisend](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Verwandt

* [Sesami Flows](/de/automatisierungen/sesami-flows.md) - Überblick über das Automatisierungssystem von Sesami
* [E-Mail- und Webhook-Aktionen](/de/automatisierungen/email-and-webhook-as-action-types.md) - Aktionstypen verstehen
* [Sesami Flows und Klaviyo](/de/automatisierungen/sesami-flows-and-klaviyo.md) - Alternative ESP-Integration
* [Benachrichtigungs-E-Mails](/de/benachrichtigungen/notification-emails.md) - Standard-Benachrichtigungssystem von Sesami


---

# Agent Instructions: 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:

```
GET https://help.sesami.co/de/automatisierungen/sesami-flows-and-omnisend.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
