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

# 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 nettbutikker. Den tilbyr en pakke med verktøy og funksjoner som er utviklet for å hjelpe nettbutikker med å engasjere kundene sine, øke salget og forbedre den samlede markedsføringseffektiviteten.

## Hvorfor integrere Sesami med Omnisend?

Du kan effektivisere alle kundevendte interaksjoner ved å sende Sesami-hendelsesdata inn i Omnisend og utløse all kommunikasjon (e-post eller SMS) via Omnisend. For mange virksomheter som allerede bruker Omnisend til å sende ordrebekreftelser, SMS-markedsføringsmeldinger og annen kommunikasjon, skaper det en samlet kundeopplevelse å også sende bookingbekreftelser og påminnelser om avtaler gjennom Omnisend.

### Vanlige bruksområder

**Arbeidsflyter for e-post og SMS:**

* Arbeidsflyt for avtalebekreftelse
* Arbeidsflyt for ombooking av avtale
* Arbeidsflyt for kansellering av avtale
* Arbeidsflyt for avtalereminder (24 timer før, eller tilpasset tidspunkt)
* Arbeidsflyt for fullført avtale

## Slik fungerer det

Sesami bruker **Sesami-flyter** for å sende bookinghendelser til Omnisend i sanntid. Når en avtale opprettes, ombookes, kunden sjekker inn, startes, kanselleres eller markeres som uteblivelse, 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 bestiller en avtale i Sesami
2. Sesami-flyten utløses 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

## Oppsettinstruksjoner

### Del 1: Sett opp Omnisend

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

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

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

1. I Omnisend klikker du på **profilfanen din**
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 og mottakerlister
   * **Kontakter** - tillater å opprette, redigere, laste ned og slette abonnenter
   * **Bestillinger** - tillater å opprette, redigere, laste ned og slette bestillinger
   * **Produkter** - tillater å opprette, redigere, laste ned og slette produkter
   * **Handlekurver** - tillater å opprette, redigere, laste ned og slette handlekurver
   * **Hendelser** - tillater å hente og utløse egendefinerte hendelser (**Påkrevd**)
7. Kopier den genererte API-nøkkelen og lagre den sikkert

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

For flere detaljer, 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 går 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
   * **Tilpassede felter for hendelsen**: Definer bookingegenskapene du vil bruke i e-postene/SMS-ene dine:
     * `CustomerName` - kundens navn
     * `ServiceName` - navnet på tjenesten som er bestilt
     * `DateTimeInCustomerTimezone` - dato/tid for avtalen
     * `CustomerManagementLink` - lenke der kunden kan administrere bookingen
     * `AppointmentID` - unik avtaleidentifikator
     * `TeamMember` - navn på tildelt medarbeider
     * Legg til andre felter etter behov
4. Legg til kunde **e-post** og **telefon** felter (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, kansellert, 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-flyter

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

1. Åpne [Sesami Admin Portal](https://help.sesami.co/admin/sesami-admin-portal)
2. Gå til **Flyter**
3. Klikk **Opprett flyt**

#### Trinn 2: Konfigurer utløseren for flyten

1. Velg utløsende hendelse:
   * Avtale opprettet
   * Avtale ombooket
   * Kunden sjekket inn
   * Avtalen startet
   * Avtalen ble kansellert
   * Uteblivelse
2. Sett **Når** til **Umiddelbart**, eller til et tidspunkt før eller etter hendelsen (f.eks. 24 timer før avtalen for en påminnelse)
3. Konfigurer eventuelle अतिरिक्त forhold hvis nødvendig

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

1. Sett **Handling** type til **Webhook**
2. Konfigurer webhook-en:
   * **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-hoder

I Headers-delen av webhook-en legger du til:

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

Erstatt `YOUR_OMNISEND_API_KEY` med den faktiske API-nøkkelen du opprettet i Omnisend.

#### Trinn 5: Konfigurer webhook-brødteksten

I Body-delen av webhook-en mapper du Sesami-bookingsdata til de egendefinerte feltene i Omnisend:

```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 den egendefinerte hendelsen din i Omnisend.
{% endhint %}

#### Trinn 6: Lagre og aktiver flyten

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

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 den egendefinerte hendelsen din (f.eks. "Avtale opprettet")
2. Arbeidsflyten utløses hver gang Sesami sender data til denne hendelsen

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

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

#### Trinn 4: Bruk egendefinerte felter 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 felter:

* `[[custom_event.CustomerName]]` - kundens navn
* `[[custom_event.ServiceName]]` - tjenestenavn
* `[[custom_event.DateTimeInCustomerTimezone]]` - dato/tid for avtalen
* `[[custom_event.CustomerManagementLink]]` - lenke for bookingadministrasjon
* `[[custom_event.TeamMember]]` - tildelt teammedlem

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

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

#### Trinn 6: Aktiver arbeidsflyten

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

## Testing av integrasjonen din

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

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

{% hint style="success" %}
**Tips**: 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 ekte 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 kansellert, trenger du tre separate API-nøkler.

</details>

<details>

<summary>Kan jeg bruke Omnisend til SMS i tillegg til e-post?</summary>

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

* Inkluderer `telefon` feltet i webhook-brødteksten din
* Har aktivert SMS i Omnisend-kontoen din
* Har samlet inn kundens telefonnumre med gyldig samtykke
* Konfigurerer SMS-handlinger i Omnisend-arbeidsflytene dine

For flere detaljer, 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åminnelsesflyter 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 hendelsen i Omnisend, eller du kan opprette separate egendefinerte hendelser for ulike tidspunkter for påminnelser.

</details>

<details>

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

* Bekreft at Omnisend API-nøkkelen er riktig og at tillatelsen for "Hendelser" er aktivert
* Sørg for at hendelses-ID-en i webhook-URL-en samsvarer med den egendefinerte hendelsen din
* Sjekk at flyten er aktivert i Sesami
* Bekreft at du har gjort en testbooking etter at du satte opp flyten
* Se gjennom Sesami-flytloggene for å se om webhook-en ble sendt vellykket
* Sjekk aktiviteten for den egendefinerte hendelsen i Omnisend (Butikkinnstillinger > Egendefinerte hendelser)
* Sørg for at alle nødvendige felter (e-post eller telefon) er inkludert i webhook-brødteksten

</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å kundens språkpreferanser. Se [Omnisends dokumentasjon for oversettelser](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Relatert

* [Sesami-flyter](https://help.sesami.co/no/automatiseringer/sesami-flows.md) - oversikt over Sesamis automatiseringssystem
* [E-post- og webhook-handlinger](https://help.sesami.co/no/automatiseringer/email-and-webhook-as-action-types.md) - forstå handlingstyper
* [Sesami-flyter og Klaviyo](https://help.sesami.co/no/automatiseringer/sesami-flows-and-klaviyo.md) - alternativ ESP-integrasjon
* [Varslings-e-poster](https://help.sesami.co/no/varsler/notification-emails.md) - Sesamis standard varslingssystem


---

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