# Sesami Flows og Omnisend

Integrer Sesami med Omnisend for å drive avansert e-post- og SMS-markedsføring for bookingvirksomheten din.

## Hva er Omnisend?

Omnisend er en markedsføringsautomatiseringsplattform som spesialiserer seg på e-post- og SMS-markedsføring for netthandelsbedrifter. Den tilbyr en pakke med verktøy og funksjoner som er utviklet for å hjelpe netthandelsbedrifter med å engasjere kundene sine, øke salget og forbedre den samlede markedsføringseffektiviteten.

## Hvorfor integrere Sesami med Omnisend?

Du kan strømlinjeforme alle kundeinteraksjonene dine ved å sende Sesami-hendelsesdata inn i Omnisend og utløse all kommunikasjon (e-post eller SMS) via Omnisend. For mange bedrifter som allerede bruker Omnisend til å sende ordrebekreftelser, SMS-markedsføringsmeldinger og annen kommunikasjon, gir det en samlet kundeopplevelse å også sende bookingbekreftelser og påminnelser om avtaler via Omnisend.

### Vanlige bruksområder

**E-post- og SMS-arbeidsflyter:**

* Flyt for avtalebekreftelse
* Flyt for ombooking av avtale
* Flyt for kansellering av avtale
* Flyt for påminnelse om avtale (24 timer før, eller tilpasset tidspunkt)
* Flyt for fullført avtale

## Slik fungerer det

Sesami bruker **Sesami Flows** for å sende bookinghendelser til Omnisend i sanntid. Når en avtale opprettes, ombookes, avlyses eller fullføres, sender Sesami disse hendelsesdataene til Omnisend via webhook til en egendefinert hendelse du har opprettet. Deretter oppretter du arbeidsflyter i Omnisend som utløser e-post- eller SMS-meldinger basert på disse egendefinerte hendelsene.

### Dataflyten

1. Kunden booker en avtale i Sesami
2. Sesami Flow utløser og sender hendelsesdata til Omnisend via webhook
3. Omnisend mottar hendelsen som en egendefinert hendelse (f.eks. "Avtale opprettet")
4. Omnisend-arbeidsflyten utløses basert på den hendelsen
5. Kunden mottar e-post eller SMS med detaljer om avtalen

## Oppsettsinstruksjoner

### Del 1: Sett opp Omnisend

#### Trinn 1: Installer og koble til Omnisend

1. Installer **Omnisend-appen** fra Shopify App Store
2. Følg appens oppsettssteg for å koble til butikken din
3. Fullfør Omnisends onboarding-prosess

#### Trinn 2: Opprett en API-nøkkel (KPI-nøkkel)

1. I Omnisend klikker du på **profilfanen**
2. Gå til **Butikkinnstillinger**
3. Klikk på **API-nøkler** fanen
4. Klikk **Opprett privat API-nøkkel**
5. Gi den navnet "Sesami Integration" (eller lignende)
6. Konfigurer tillatelser – velg følgende:
   * **Kampanjer** - tillater nedlasting av rapporter, lister over mottakere
   * **Kontakter** - tillater oppretting, redigering, nedlasting og sletting av abonnenter
   * **Ordre** - tillater oppretting, redigering, nedlasting og sletting av bestillinger
   * **Produkter** - tillater oppretting, redigering, nedlasting og sletting av produkter
   * **Handlekurver** - tillater oppretting, redigering, nedlasting og sletting av handlekurver
   * **Arrangementer** - tillater å hente og utløse egendefinerte hendelser (**Påkrevd**)
7. Kopier den genererte API-nøkkelen og oppbevar den sikkert

{% hint style="warning" %}
**Viktig**: Du trenger en egen API-nøkkel for hver unike hendelsestype (avtale opprettet, ombooket, avlyst osv.).
{% endhint %}

For mer informasjon, se [Omnisends API-dokumentasjon](https://api-docs.omnisend.com/).

#### Trinn 3: Opprett egendefinerte hendelser i Omnisend

For hver type avtalehendelse du vil spore, opprett en egendefinert hendelse:

1. I Omnisend navigerer du til **Butikkinnstillinger > Egendefinerte hendelser**
2. Klikk **Opprett egendefinert hendelse**
3. Konfigurer hendelsen:
   * **Hendelsesnavn**: Velg et beskrivende navn (f.eks. "Avtale opprettet", "Avtale ombooket")
   * **Systemnavn**: Dette genereres automatisk basert på hendelsesnavnet
   * **Egendefinerte felt for hendelsen**: Definer bookingegenskapene du vil bruke i e-postene/SMS-ene dine:
     * `CustomerName` - Kundens navn
     * `ServiceName` - Navnet på tjenesten som ble bestilt
     * `DateTimeInCustomerTimezone` - Dato/tid for avtalen
     * `CustomerManagementLink` - Lenke der kunden kan administrere bookingen
     * `AppointmentID` - Unik avtaleidentifikator
     * `TeamMember` - Navn på tildelt medarbeider
     * Legg til andre felt etter behov
4. Legg til kunde **e-post** og **telefon** felt (påkrevd for å sende meldinger)
5. Lagre den egendefinerte hendelsen
6. **Kopier hendelses-ID-en** - du trenger denne for Sesami Flow-webhook-URL-en

{% hint style="info" %}
Gjenta denne prosessen for hver hendelsestype du vil spore (opprettet, ombooket, avlyst, fullført, påminnelse).
{% endhint %}

For detaljerte instruksjoner, se [Omnisends dokumentasjon for egendefinerte hendelser](https://support.omnisend.com/en/articles/6791819-custom-events).

### Del 2: Konfigurer Sesami Flows

#### Trinn 1: Opprett en Flow i Sesami

1. Åpne **Sesami** i Shopify-administrasjonen din
2. Gå til **Innstillinger > Flyter**
3. Klikk **Opprett en Flow**

#### Trinn 2: Konfigurer Flow-utløseren

1. Velg utløserhendelsen din:
   * Avtale opprettet
   * Avtale ombooket
   * Avtale avlyst
   * Avtale fullført
   * Tidsbasert påminnelse (f.eks. 24 timer før avtalen)
2. Konfigurer eventuelle ekstra betingelser om nødvendig

#### Trinn 3: Legg til en Webhook-handling

1. Sett **Handling** typen til **Webhook**
2. Konfigurer webhooken:
   * **Mål-URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Erstatt `[EVENT_ID]` med hendelses-ID-en du kopierte fra Omnisend
   * **Når**: Sett til "Umiddelbart" (eller konfigurer timing for påminnelser)

#### Trinn 4: Konfigurer webhook-headere

I delen Headere for webhooken, legg til:

```json
{
  "Content-Type": "application/json",
  "X-API-KEY": "DIN_OMNISEND_API_NØKKEL"
}
```

Erstatt `DIN_OMNISEND_API_NØKKEL` med den faktiske API-nøkkelen du opprettet i Omnisend.

#### Trinn 5: Konfigurer webhook-body

I delen Body for webhooken mapper du Sesami-bookingdata til dine egendefinerte Omnisend-felt:

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

{% hint style="info" %}
Feltnavnene i `"fields"` må samsvare nøyaktig med de egendefinerte feltene du definerte i ditt Omnisend-egendefinerte hendelse.
{% endhint %}

#### Trinn 6: Lagre og aktiver Flowen

1. Gi Flowen et beskrivende navn (f.eks. "Omnisend - Avtale opprettet")
2. **Lagre** Flowen
3. Aktiver Flowen

Gjenta trinn 1–6 for hver hendelsestype du vil sende til Omnisend.

### Del 3: Opprett arbeidsflyter i Omnisend

#### Trinn 1: Opprett en egendefinert arbeidsflyt

1. Logg inn på **Omnisend**
2. Gå til **Automatisering > Arbeidsflyter**
3. Klikk **Ny arbeidsflyt**
4. Velg **Opprett egendefinert arbeidsflyt**

#### Trinn 2: Konfigurer utløseren

1. For utløseren velger du din egendefinerte hendelse (f.eks. "Avtale opprettet")
2. Arbeidsflyten vil utløses hver gang Sesami sender data til denne hendelsen

#### Trinn 3: Legg til handlinger for e-post eller SMS

1. Klikk **Legg til handling** i arbeidsflyten
2. Velg **E-post** eller **SMS**
3. Design meldingsmalen din

#### Trinn 4: Bruk egendefinerte felt i malen din

Når du redigerer innholdet i e-posten eller SMS-en, kan du få tilgang til bookingegenskapene ved å bruke syntaksen for egendefinerte felt:

* `[[custom_event.CustomerName]]` - Kundens navn
* `[[custom_event.ServiceName]]` - Tjenestenavn
* `[[custom_event.DateTimeInCustomerTimezone]]` - Dato/tid for avtalen
* `[[custom_event.CustomerManagementLink]]` - Lenke til administrasjon av booking
* `[[custom_event.TeamMember]]` - Tildelt teammedlem

#### Trinn 5: Konfigurer ekstra innstillinger for arbeidsflyten

1. Sett **Frekvens** regler (f.eks. "Ikke utløst arbeidsflyten på nytt for kontakter som allerede har vært i denne automatiseringen")
2. Legg til **Avslutningsbetingelser** om nødvendig
3. Konfigurer eventuelle tidsforsinkelser eller betingede delinger

#### Trinn 6: Aktiver arbeidsflyten

Når du har utformet og testet arbeidsflyten, klikker du på **Aktiver** for å gjøre den aktiv.

## Teste integrasjonen din

Før du går live, test integrasjonen:

1. Opprett en testbooking i Sesami
2. Kontroller at hendelsen vises i Omnisend under **Butikkinnstillinger > Egendefinerte hendelser** (se hendelsesaktiviteten)
3. Bekreft at alle avtaleegenskaper fylles ut riktig
4. Test Omnisend-arbeidsflyten din for å sikre at e-post/SMS sendes riktig
5. Se gjennom innholdet for å sikre at alle egendefinerte felt vises riktig

{% hint style="success" %}
**Profftips**: Opprett en test-e-postadresse og et testtelefonnummer for kunden, og gjør deretter testbookinger for å verifisere hele kundeopplevelsen før du aktiverer arbeidsflyter for live-kunder.
{% endhint %}

## Vanlige spørsmål

<details>

<summary>Trenger jeg en egen API-nøkkel for hver hendelsestype?</summary>

Ja, Omnisend krever en unik API-nøkkel for hver egendefinerte hendelse du oppretter. Det betyr at hvis du sporer hendelser for avtale opprettet, ombooket og avlyst, trenger du tre separate API-nøkler.

</details>

<details>

<summary>Kan jeg bruke Omnisend for SMS så vel som e-post?</summary>

Ja! Omnisend støtter både e-post og SMS. Sørg for at du:

* Inkluderer `telefon` feltet i webhook-bodyen din
* Har aktivert SMS i Omnisend-kontoen din
* Har samlet inn kundenes telefonnumre med korrekt samtykke
* Konfigurerer SMS-handlinger i Omnisend-arbeidsflytene dine

For mer informasjon, se [Omnisends SMS-dokumentasjon](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>Hva om jeg trenger flere påminnelsesarbeidsflyter?</summary>

Du kan opprette flere påminnelses-Flows i Sesami, hver med ulik timing:

* 7 dager før avtalen
* 24 timer før avtalen
* 2 timer før avtalen

Hver av dem kan sende til den samme egendefinerte Omnisend-hendelsen, eller du kan opprette separate egendefinerte hendelser for ulike påminnelsestidspunkter.

</details>

<details>

<summary>Hendelser vises ikke i Omnisend. Hva bør jeg sjekke?</summary>

* Bekreft at Omnisend-API-nøkkelen din er riktig og har "Events"-tillatelse aktivert
* Sørg for at hendelses-ID-en i webhook-URL-en din samsvarer med den egendefinerte hendelsen din
* Sjekk at Flowen er aktivert i Sesami
* Bekreft at du har gjort en testbooking etter at du satte opp Flowen
* Gå gjennom Sesami Flow-loggene for å se om webhooken ble sendt vellykket
* Sjekk aktiviteten for den egendefinerte hendelsen i Omnisend (Butikkinnstillinger > Egendefinerte hendelser)
* Sørg for at alle påkrevde felt (e-post eller telefon) er inkludert i webhook-bodyen

</details>

<details>

<summary>Kan jeg bruke oversettelser for ulike språk?</summary>

Ja! Omnisend støtter oversettelser for kampanjer og automatiserte e-poster. Du kan opprette lokaliserte versjoner av arbeidsflytene dine basert på kundenes språkpref. Se [Omnisends dokumentasjon for oversettelser](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Relatert

* [Sesami Flows](/no/automatiseringer/sesami-flows.md) - Oversikt over Sesamis automatiseringssystem
* [Handlinger for e-post og webhook](/no/automatiseringer/email-and-webhook-as-action-types.md) - Forstå handlingstyper
* [Sesami Flows og Klaviyo](/no/automatiseringer/sesami-flows-and-klaviyo.md) - Alternativ ESP-integrasjon
* [Varslings-e-poster](/no/varsler/notification-emails.md) - Standard Sesami-varslingssystem


---

# 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/no/automatiseringer/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.
