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

# Sesami-työnkulut ja Omnisend

Integroi Sesami Omnisendin kanssa ja tehosta edistynyttä sähköposti- ja SMS-markkinointia varausliiketoiminnassasi.

## Mikä on Omnisend?

Omnisend on markkinoinnin automaatioalusta, joka on erikoistunut verkkokauppojen sähköposti- ja SMS-markkinointiin. Se tarjoaa työkalujen ja ominaisuuksien kokonaisuuden, joka on suunniteltu auttamaan verkkokauppoja sitouttamaan asiakkaitaan, kasvattamaan myyntiä ja parantamaan markkinoinnin kokonaistehokkuutta.

## Miksi integroida Sesami Omnisendin kanssa?

Voit sujuvoittaa kaikkia asiakaskohtaamisia syöttämällä Sesamin tapahtumatiedot Omnisendiin ja käynnistämällä kaikki viestit (sähköposti tai SMS) Omnisendin kautta. Monille yrityksille, jotka jo käyttävät Omnisendiä tilausvahvistusten, SMS-markkinointiviestien ja muiden viestien lähettämiseen, myös varausvahvistusten ja ajanvarausmuistutusten lähettäminen Omnisendin kautta luo yhtenäisen asiakaskokemuksen.

### Yleisiä käyttötapauksia

**Sähköposti- ja SMS-työnkulut:**

* Ajanvarauksen vahvistusvirta
* Ajanvarauksen uudelleenajastusvirta
* Ajanvarauksen peruutusvirta
* Ajanvarauksen muistutusvirta (24 tuntia etukäteen tai mukautettu ajankohta)
* Ajanvarauksen päättymisvirta

## Miten se toimii

Sesami käyttää **Sesami Flowsia** lähettääkseen varaustapahtumat reaaliajassa Omnisendiin. Kun ajanvaraus luodaan, siirretään uudelle ajankohdalle, kirjataan saapuneeksi, aloitetaan, peruutetaan tai merkitään saapumatta jääneeksi, Sesami lähettää kyseisen tapahtuman tiedot Omnisendiin webhookin kautta luomaasi mukautettuun tapahtumaan. Sen jälkeen luot Omnisendiin työnkulkuja, jotka käynnistävät sähköposti- tai SMS-viestit näiden mukautettujen tapahtumien perusteella.

### Datan kulku

1. Asiakas varaa ajan Sesamissa
2. Sesami Flow käynnistyy ja lähettää tapahtumatiedot Omnisendiin webhookin kautta
3. Omnisend vastaanottaa tapahtuman mukautettuna tapahtumana (esim. "Ajanvaraus luotu")
4. Omnisendin työnkulku käynnistyy kyseisen tapahtuman perusteella
5. Asiakas saa sähköposti- tai SMS-viestin, jossa on ajanvarauksen tiedot

## Asennusohjeet

### Osa 1: Määritä Omnisend

#### Vaihe 1: Asenna ja yhdistä Omnisend

1. Asenna **Omnisend-sovellus** Shopify App Storesta
2. Seuraa sovelluksen asennusvaiheita yhdistääksesi kauppasi
3. Suorita Omnisendin käyttöönotto loppuun

#### Vaihe 2: Luo API-avain (KPI-avain)

1. Omnisendissä napsauta **profiilivälilehteäsi**
2. Siirry kohtaan **Kaupan asetukset**
3. Napsauta **API-avaimet** välilehteä
4. Napsauta **Luo yksityinen API-avain**
5. Nimeä se "Sesami Integration" (tai vastaava)
6. Määritä käyttöoikeudet – valitse seuraavat:
   * **Kampanjat** - sallii raporttien ja vastaanottajalistojen lataamisen
   * **Yhteystiedot** - sallii tilaajien luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Tilaukset** - sallii tilausten luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Tuotteet** - sallii tuotteiden luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Ostoskorit** - sallii ostoskorien luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Tapahtumat** - sallii mukautettujen tapahtumien hakemisen ja käynnistämisen (**Vaadittu**)
7. Kopioi luotu API-avain ja säilytä se turvallisesti

{% hint style="warning" %}
**Tärkeä**: Tarvitset erillisen API-avaimen jokaista yksilöllistä tapahtumatyyppiä varten (ajanvaraus luotu, siirretty, peruutettu jne.).
{% endhint %}

Lisätietoja saat kohdasta [Omnisendin API-dokumentaatio](https://api-docs.omnisend.com/).

#### Vaihe 3: Luo mukautetut tapahtumat Omnisendiin

Luo jokaiselle seurattavalle ajanvaraustapahtumatyypille mukautettu tapahtuma:

1. Omnisendissä siirry kohtaan **Kaupan asetukset > Mukautetut tapahtumat**
2. Napsauta **Luo mukautettu tapahtuma**
3. Määritä tapahtuma:
   * **Tapahtuman nimi**: Valitse kuvaava nimi (esim. "Ajanvaraus luotu", "Ajanvaraus siirretty")
   * **Järjestelmän nimi**: Tämä luodaan automaattisesti tapahtuman nimen perusteella
   * **Tapahtuman mukautetut kentät**: Määritä varausominaisuudet, joita haluat käyttää sähköposteissasi/SMS-viesteissäsi:
     * `CustomerName` - asiakkaan nimi
     * `ServiceName` - varatun palvelun nimi
     * `DateTimeInCustomerTimezone` - ajanvarauksen päivämäärä ja aika
     * `CustomerManagementLink` - linkki, jolla asiakas voi hallita varausta
     * `AppointmentID` - ajanvarauksen yksilöllinen tunniste
     * `TeamMember` - nimetty työntekijä
     * Lisää tarvittaessa muita kenttiä
4. Lisää asiakkaan **sähköposti** ja **puhelin** kentät (vaaditaan viestien lähettämiseen)
5. Tallenna mukautettu tapahtuma
6. **Kopioi tapahtuman tunnus** - tarvitset tätä Sesami Flown webhook-osoitetta varten

{% hint style="info" %}
Toista tämä prosessi jokaiselle tapahtumatyypille, jota haluat seurata (luotu, siirretty, peruutettu, suoritettu, muistutus).
{% endhint %}

Yksityiskohtaiset ohjeet löydät kohdasta [Omnisendin mukautettujen tapahtumien dokumentaatio](https://support.omnisend.com/en/articles/6791819-custom-events).

### Osa 2: Määritä Sesami Flows

#### Vaihe 1: Luo Flow Sesamissa

1. Avaa [Sesamin hallintaportaali](https://help.sesami.co/admin/sesami-admin-portal)
2. Siirry kohtaan **Flows**
3. Napsauta **Luo Flow**

#### Vaihe 2: Määritä Flow'n käynnistin

1. Valitse käynnistystapahtumasi:
   * Ajanvaraus luotu
   * Ajanvaraus siirretty
   * Asiakas kirjautui sisään
   * Ajanvaraus aloitettu
   * Ajanvaraus peruutettu
   * Saapumatta jättäminen
2. Aseta **kohtaan** sijaan **Välittömästi**, tai aikaan ennen tai jälkeen tapahtuman (esim. 24 tuntia ennen ajanvarausta muistutusta varten)
3. Määritä tarvittaessa lisäehdot

#### Vaihe 3: Lisää webhook-toiminto

1. Aseta **Toiminnon** tyyppi **Webhook**
2. Määritä webhook:
   * **Kohde-URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Korvaa `[EVENT_ID]` Omnisendistä kopioimallasi tapahtuman tunnuksella
   * **kohtaan**: Aseta arvoksi "Välittömästi" (tai määritä muistutusten ajoitus)

#### Vaihe 4: Määritä webhook-otsikot

Lisää webhookin Otsikot-osiossa:

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

Korvaa `YOUR_OMNISEND_API_KEY` sillä varsinaisella API-avaimella, jonka loit Omnisendissä.

#### Vaihe 5: Määritä webhookin runko

Webhookin Runkо-osiossa yhdistä Sesamin varaustiedot Omnisendin mukautettuihin kenttiin:

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

{% hint style="info" %}
Kenttien nimet kohdassa `"fields"` täytyy vastata täsmälleen Omnisendin mukautetussa tapahtumassa määrittämiäsi mukautettuja kenttiä.
{% endhint %}

#### Vaihe 6: Tallenna ja ota Flow käyttöön

1. Anna Flow'llesi kuvaava nimi (esim. "Omnisend - Ajanvaraus luotu")
2. **Tallenna** Flow
3. Ota Flow käyttöön

Toista vaiheet 1–6 jokaiselle tapahtumatyypille, jonka haluat lähettää Omnisendiin.

### Osa 3: Luo työnkulkuja Omnisendiin

#### Vaihe 1: Luo mukautettu työnkulku

1. Kirjaudu sisään **Omnisendiin**
2. Siirry kohtaan **Automaatio > Työnkulut**
3. Napsauta **Uusi työnkulku**
4. Valitse **Luo mukautettu työnkulku**

#### Vaihe 2: Määritä käynnistin

1. Valitse käynnistimeksi mukautettu tapahtumasi (esim. "Ajanvaraus luotu")
2. Työnkulku käynnistyy aina, kun Sesami lähettää dataa tähän tapahtumaan

#### Vaihe 3: Lisää sähköposti- tai SMS-toimintoja

1. Napsauta **Lisää toiminto** työnkulkuun
2. Valitse **Sähköposti** tai **SMS**
3. Suunnittele viestimallisi

#### Vaihe 4: Käytä mukautettuja kenttiä mallissasi

Kun muokkaat sähköposti- tai SMS-sisältöäsi, voit käyttää varaustietoja mukautetun kenttäsyntaksin avulla:

* `[[custom_event.CustomerName]]` - asiakkaan nimi
* `[[custom_event.ServiceName]]` - palvelun nimi
* `[[custom_event.DateTimeInCustomerTimezone]]` - ajanvarauksen päivämäärä ja aika
* `[[custom_event.CustomerManagementLink]]` - varauksen hallintalinkki
* `[[custom_event.TeamMember]]` - nimetty tiimin jäsen

#### Vaihe 5: Määritä lisäasetukset työnkululle

1. Aseta **Tiheys** säännöt (esim. "Älä käynnistä työnkulkua uudelleen kontakteille, jotka ovat jo olleet tässä automaatiossa")
2. Lisää **Poistumisehdot** tarvittaessa
3. Määritä mahdolliset aikaviiveet tai ehdolliset haarat

#### Vaihe 6: Aktivoi työnkulku

Kun olet suunnitellut ja testannut työnkulun, napsauta **Ota käyttöön** ottaaksesi sen käyttöön.

## Integraation testaaminen

Ennen käyttöönottoa testaa integraatio:

1. Luo testivaraus Sesamissa
2. Tarkista, että tapahtuma näkyy Omnisendissä kohdassa **Kaupan asetukset > Mukautetut tapahtumat** (näytä tapahtuman toiminta)
3. Varmista, että kaikki ajanvarauksen ominaisuudet täyttyvät oikein
4. Testaa Omnisendin työnkulku varmistaaksesi, että sähköpostit/SMS-viestit lähetetään oikein
5. Tarkista sisältö varmistaaksesi, että kaikki mukautetut kentät näkyvät oikein

{% hint style="success" %}
**Vinkki**: Luo testiasiakkaan sähköpostiosoite ja puhelinnumero, ja tee sitten testivarauksia varmistaaksesi koko asiakaskokemuksen ennen kuin otat työnkulut käyttöön oikeille asiakkaille.
{% endhint %}

## UKK

<details>

<summary>Tarvitsenko erillisen API-avaimen jokaista tapahtumatyyppiä varten?</summary>

Kyllä, Omnisend vaatii yksilöllisen API-avaimen jokaiselle luomallesi mukautetulle tapahtumalle. Tämä tarkoittaa, että jos seuraat ajanvarauksen luonti-, siirto- ja peruutustapahtumia, tarvitset kolme erillistä API-avainta.

</details>

<details>

<summary>Voinko käyttää Omnisendiä sekä SMS- että sähköpostiviestintään?</summary>

Kyllä! Omnisend tukee sekä sähköpostia että SMS:ää. Varmista, että:

* Sisällytät `puhelin` kentän webhookin runkoon
* SMS on käytössä Omnisend-tililläsi
* Olet kerännyt asiakkaiden puhelinnumerot asianmukaisella suostumuksella
* Määrität SMS-toiminnot Omnisendin työnkuluissa

Lisätietoja löytyy kohdasta [Omnisendin SMS-dokumentaatio](https://support.omnisend.com/en/articles/1061873-sms-in-campaigns).

</details>

<details>

<summary>Entä jos tarvitsen useita muistutustyönkulkuja?</summary>

Voit luoda useita muistutus-Flow'ta Sesamissa, jokaiselle eri ajoitus:

* 7 päivää ennen ajanvarausta
* 24 tuntia ennen ajanvarausta
* 2 tuntia ennen ajanvarausta

Jokainen voi lähettää samaan Omnisendin mukautettuun tapahtumaan, tai voit luoda erillisiä mukautettuja tapahtumia eri muistutusajoituksille.

</details>

<details>

<summary>Tapahtumat eivät näy Omnisendissä. Mitä minun pitäisi tarkistaa?</summary>

* Varmista, että Omnisendin API-avain on oikea ja että "Events"-oikeus on käytössä
* Varmista, että webhook-URL-osoitteesi tapahtuman tunnus vastaa mukautettua tapahtumaasi
* Tarkista, että Flow on käytössä Sesamissa
* Varmista, että olet tehnyt testivarauksen Flow'n määrittämisen jälkeen
* Tarkista Sesami Flow -lokit nähdäksesi, lähetettiinkö webhook onnistuneesti
* Tarkista mukautetun tapahtuman toiminta Omnisendissä (Kaupan asetukset > Mukautetut tapahtumat)
* Varmista, että kaikki vaaditut kentät (sähköposti tai puhelin) sisältyvät webhookin runkoon

</details>

<details>

<summary>Voinko käyttää käännöksiä eri kielille?</summary>

Kyllä! Omnisend tukee kampanjoiden ja automaattisten sähköpostien käännöksiä. Voit luoda lokalisoituja versioita työnkuluistasi asiakkaiden kieliasetusten perusteella. Katso [Omnisendin käännösdokumentaatio](https://support.omnisend.com/en/articles/1061898-translations-for-campaigns-and-automated-emails).

</details>

## Aiheeseen liittyvät

* [Sesami Flowsia](https://help.sesami.co/fi/automatisoinnit/sesami-flows.md) - yleiskatsaus Sesamin automaatiojärjestelmään
* [Sähköposti- ja webhook-toiminnot](https://help.sesami.co/fi/automatisoinnit/email-and-webhook-as-action-types.md) - toimintotyyppien ymmärtäminen
* [Sesami Flows ja Klaviyo](https://help.sesami.co/fi/automatisoinnit/sesami-flows-and-klaviyo.md) - vaihtoehtoinen ESP-integraatio
* [Ilmoitussähköpostit](https://help.sesami.co/fi/ilmoitukset/notification-emails.md) - Sesamin oletusilmoitusjärjestelmä


---

# 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/fi/automatisoinnit/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.
