# Sesami Flows och Omnisend

Integrera Sesami med Omnisend för att driva avancerad e-post- och SMS-marknadsföring för din bokningsverksamhet.

## Vad är Omnisend?

Omnisend är en marknadsföringsautomationsplattform som specialiserar sig på e-post- och SMS-marknadsföring för e-handelsföretag. Den erbjuder en uppsättning verktyg och funktioner som är utformade för att hjälpa e-handelsföretag att engagera sina kunder, öka försäljningen och förbättra den övergripande marknadsföringseffektiviteten.

## Varför integrera Sesami med Omnisend?

Du kan effektivisera all din kundnära kommunikation genom att mata in Sesamis händelsedata i Omnisend och utlösa all kommunikation (e-post eller SMS) via Omnisend. För många företag som redan använder Omnisend för att skicka orderbekräftelser, SMS-marknadsföringsmeddelanden och annan kommunikation skapar det en enhetlig kundupplevelse att även skicka bokningsbekräftelser och påminnelser om möten via Omnisend.

### Vanliga användningsområden

**Arbetsflöden för e-post och SMS:**

* Flöde för bokningsbekräftelse
* Flöde för ombokning av tid
* Flöde för avbokning av tid
* Flöde för påminnelse om tid (24 timmar i förväg, eller anpassad tidpunkt)
* Flöde för slutförd bokning

## Så fungerar det

Sesami använder **Sesami Flows** för att skicka bokningshändelser till Omnisend i realtid. När en bokning skapas, ombokas, avbokas eller slutförs skickar Sesami dessa händelsedata till Omnisend via webhook till en anpassad händelse som du har skapat. Du skapar sedan arbetsflöden i Omnisend som utlöser e-post- eller SMS-meddelanden baserat på dessa anpassade händelser.

### Dataflödet

1. Kunden bokar en tid i Sesami
2. Sesami Flow utlöser och skickar händelsedata till Omnisend via webhook
3. Omnisend tar emot händelsen som en anpassad händelse (t.ex. "Bokning skapad")
4. Omnisends arbetsflöde utlöses baserat på den händelsen
5. Kunden får e-post eller SMS med bokningsdetaljer

## Installationsinstruktioner

### Del 1: Konfigurera Omnisend

#### Steg 1: Installera och anslut Omnisend

1. Installera **Omnisend-appen** från Shopify App Store
2. Följ appens installationssteg för att ansluta din butik
3. Slutför Omnisends onboardingprocess

#### Steg 2: Skapa en API-nyckel (KPI-nyckel)

1. I Omnisend klickar du på din **profilflik**
2. Navigera till **Butiksinställningar**
3. Klicka på **API-nycklar** fliken
4. Klicka på **Skapa privat API-nyckel**
5. Namnge den "Sesami Integration" (eller liknande)
6. Konfigurera behörigheter - välj följande:
   * **Kampanjer** - gör det möjligt att ladda ner rapporter, mottagarlistor
   * **Kontakter** - gör det möjligt att skapa, redigera, ladda ner, radera prenumeranter
   * **Beställningar** - gör det möjligt att skapa, redigera, ladda ner, radera ordrar
   * **Produkter** - gör det möjligt att skapa, redigera, ladda ner, radera produkter
   * **Kundvagnar** - gör det möjligt att skapa, redigera, ladda ner, radera kundvagnar
   * **Evenemang** - gör det möjligt att hämta och utlösa anpassade händelser (**Krävs**)
7. Kopiera den genererade API-nyckeln och förvara den säkert

{% hint style="warning" %}
**Viktigt**: Du behöver en separat API-nyckel för varje unik händelsetyp (bokning skapad, ombokad, avbokad osv.).
{% endhint %}

För mer information, se [Omnisends API-dokumentation](https://api-docs.omnisend.com/).

#### Steg 3: Skapa anpassade händelser i Omnisend

För varje typ av bokningshändelse du vill spåra, skapa en anpassad händelse:

1. I Omnisend, navigera till **Butiksinställningar > Anpassade händelser**
2. Klicka på **Skapa anpassad händelse**
3. Konfigurera händelsen:
   * **Händelsenamn**: Välj ett beskrivande namn (t.ex. "Bokning skapad", "Bokning ombokad")
   * **Systemnamn**: Detta genereras automatiskt baserat på händelsenamnet
   * **Anpassade fält för händelsen**: Definiera de bokningsegenskaper du vill använda i dina e-post-/SMS-meddelanden:
     * `CustomerName` - Kundens namn
     * `ServiceName` - Namn på den bokade tjänsten
     * `DateTimeInCustomerTimezone` - Datum/tid för bokningen
     * `CustomerManagementLink` - Länk där kunden kan hantera bokningen
     * `AppointmentID` - Unik identifierare för bokningen
     * `TeamMember` - Namn på tilldelad medarbetare
     * Lägg till andra fält vid behov
4. Lägg till kund **e-post** och **telefon** fält (krävs för att skicka meddelanden)
5. Spara den anpassade händelsen
6. **Kopiera händelse-ID:t** - du behöver detta för Sesami Flow-webhook-URL:en

{% hint style="info" %}
Upprepa denna process för varje händelsetyp du vill spåra (skapad, ombokad, avbokad, slutförd, påminnelse).
{% endhint %}

För detaljerade instruktioner, se [Omnisends dokumentation om anpassade händelser](https://support.omnisend.com/en/articles/6791819-custom-events).

### Del 2: Konfigurera Sesami Flows

#### Steg 1: Skapa ett flöde i Sesami

1. Öppna **Sesami** i din Shopify-admin
2. Navigera till **Inställningar > Flöden**
3. Klicka på **Skapa ett flöde**

#### Steg 2: Konfigurera Flow-utlösaren

1. Välj din utlösande händelse:
   * Bokning skapad
   * Bokning ombokad
   * Bokning avbokad
   * Bokning slutförd
   * Tidsbaserad påminnelse (t.ex. 24 timmar före bokningen)
2. Konfigurera eventuella ytterligare villkor vid behov

#### Steg 3: Lägg till en webhook-åtgärd

1. Ställ in **Åtgärd** typ till **Webhook**
2. Konfigurera webhooken:
   * **Mål-URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Ersätt `[EVENT_ID]` med händelse-ID:t som du kopierade från Omnisend
   * **När**: Ställ in på "Omedelbart" (eller konfigurera timing för påminnelser)

#### Steg 4: Konfigurera webhook-huvuden

I webhookens Headers-sektion, lägg till:

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

Ersätt `DIN_OMNISEND_API_NYCKEL` med den faktiska API-nyckel du skapade i Omnisend.

#### Steg 5: Konfigurera webhook-body

I webhookens Body-sektion mappar du Sesamis bokningsdata till dina anpassade fält i Omnisend:

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

{% hint style="info" %}
Fältnamnen i `"fields"` måste matcha exakt med de anpassade fält du definierade i din anpassade Omnisend-händelse.
{% endhint %}

#### Steg 6: Spara och aktivera Flow

1. Ge ditt Flow ett beskrivande namn (t.ex. "Omnisend - Bokning skapad")
2. **Spara** flödet
3. Aktivera Flow

Upprepa steg 1-6 för varje händelsetyp du vill skicka till Omnisend.

### Del 3: Skapa arbetsflöden i Omnisend

#### Steg 1: Skapa ett anpassat arbetsflöde

1. Logga in på **Omnisend**
2. Navigera till **Automatisering > Arbetsflöden**
3. Klicka på **Nytt arbetsflöde**
4. Välj **Skapa anpassat arbetsflöde**

#### Steg 2: Konfigurera utlösaren

1. För utlösaren, välj din anpassade händelse (t.ex. "Bokning skapad")
2. Arbetsflödet utlöses varje gång Sesami skickar data till denna händelse

#### Steg 3: Lägg till e-post- eller SMS-åtgärder

1. Klicka på **Lägg till åtgärd** i arbetsflödet
2. Välj **E-post** eller **SMS**
3. Utforma din meddelandemall

#### Steg 4: Använd anpassade fält i din mall

När du redigerar innehållet i din e-post eller ditt SMS kan du komma åt bokningsegenskaperna med hjälp av syntaxen för anpassade fält:

* `[[custom_event.CustomerName]]` - Kundens namn
* `[[custom_event.ServiceName]]` - Tjänstens namn
* `[[custom_event.DateTimeInCustomerTimezone]]` - Datum/tid för bokningen
* `[[custom_event.CustomerManagementLink]]` - Länk för att hantera bokningen
* `[[custom_event.TeamMember]]` - Tilldelad teammedlem

#### Steg 5: Konfigurera ytterligare inställningar för arbetsflödet

1. Ställ in **Frekvens** regler (t.ex. "Utlös inte arbetsflödet igen för kontakter som redan har varit i denna automation")
2. Lägg till **Avslutningsvillkor** vid behov
3. Konfigurera eventuella tidsfördröjningar eller villkorliga förgreningar

#### Steg 6: Aktivera arbetsflödet

När du har utformat och testat ditt arbetsflöde klickar du på **Aktivera** för att göra det live.

## Testa din integration

Innan du går live, testa integrationen:

1. Skapa en testbokning i Sesami
2. Kontrollera att händelsen visas i Omnisend under **Butiksinställningar > Anpassade händelser** (visa händelseaktiviteten)
3. Verifiera att alla bokningsegenskaper fylls i korrekt
4. Testa ditt Omnisend-arbetsflöde för att säkerställa att e-post/SMS skickas korrekt
5. Granska innehållet för att säkerställa att alla anpassade fält visas korrekt

{% hint style="success" %}
**Proffstips**: Skapa en testad e-postadress och ett testnummer för kunden, och gör sedan testbokningar för att verifiera hela kundupplevelsen innan du aktiverar arbetsflöden för verkliga kunder.
{% endhint %}

## Vanliga frågor

<details>

<summary>Behöver jag en separat API-nyckel för varje händelsetyp?</summary>

Ja, Omnisend kräver en unik API-nyckel för varje anpassad händelse du skapar. Det betyder att om du spårar händelser för bokning skapad, ombokad och avbokad behöver du tre separata API-nycklar.

</details>

<details>

<summary>Kan jag använda Omnisend för SMS såväl som e-post?</summary>

Ja! Omnisend stöder både e-post och SMS. Se till att du:

* Inkluderar `telefon` fältet i din webhook-body
* Har aktiverat SMS i ditt Omnisend-konto
* Har samlat in kunders telefonnummer med korrekt samtycke
* Konfigurerar SMS-åtgärder i dina Omnisend-arbetsflöden

För mer information, se [Omnisends SMS-dokumentation](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>Vad händer om jag behöver flera påminnelsearbetsflöden?</summary>

Du kan skapa flera påminnelse-Flows i Sesami, var och en med olika timing:

* 7 dagar före bokningen
* 24 timmar före bokningen
* 2 timmar före bokningen

Var och en kan skicka till samma anpassade Omnisend-händelse, eller så kan du skapa separata anpassade händelser för olika påminnelsetider.

</details>

<details>

<summary>Händelser visas inte i Omnisend. Vad bör jag kontrollera?</summary>

* Verifiera att din Omnisend API-nyckel är korrekt och har behörigheten "Events" aktiverad
* Säkerställ att händelse-ID:t i din webhook-URL matchar din anpassade händelse
* Kontrollera att Flow är aktiverat i Sesami
* Verifiera att du har gjort en testbokning efter att du konfigurerade Flow
* Granska Sesamis flödesloggar för att se om webhooken skickades framgångsrikt
* Kontrollera aktiviteten för den anpassade händelsen i Omnisend (Butiksinställningar > Anpassade händelser)
* Säkerställ att alla obligatoriska fält (e-post eller telefon) ingår i webhook-body

</details>

<details>

<summary>Kan jag använda översättningar för olika språk?</summary>

Ja! Omnisend stöder översättningar för kampanjer och automatiserade e-postmeddelanden. Du kan skapa lokaliserade versioner av dina arbetsflöden baserat på kundens språkinställningar. Se [Omnisends dokumentation om översättningar](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Relaterat

* [Sesami Flows](/se/automatiseringar/sesami-flows.md) - Översikt över Sesamis automationssystem
* [Åtgärder för e-post och webhook](/se/automatiseringar/email-and-webhook-as-action-types.md) - Förståelse av åtgärdstyper
* [Sesami Flows och Klaviyo](/se/automatiseringar/sesami-flows-and-klaviyo.md) - Alternativ ESP-integration
* [Aviseringsmejl](/se/aviseringar/notification-emails.md) - Sesamis standardsystem för aviseringar


---

# 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/se/automatiseringar/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.
