# Sesami Flows ja Omnisend

Integroi Sesami Omnisendin kanssa tehostaaksesi edistynyttä sähköposti- ja SMS-markkinointia varausyrityksellesi.

## Mikä on Omnisend?

Omnisend on markkinoinnin automaatioalusta, joka on erikoistunut sähköposti- ja SMS-markkinointiin verkkokauppayrityksille. Se tarjoaa joukon työkaluja ja ominaisuuksia, joiden tarkoituksena on auttaa verkkokauppayrityksiä sitouttamaan asiakkaitaan, lisäämään myyntiä ja parantamaan kokonaisvaltaista markkinoinnin tehokkuutta.

## Miksi integroida Sesami Omnisendiin?

Voit sujuvoittaa kaikki asiakaskohtaamisesi syöttämällä Sesamin tapahtumatiedot Omnisendiin ja käynnistämällä kaikki viestinnät (sähköposti tai SMS) Omnisendin kautta. Monille yrityksille, jotka jo käyttävät Omnisendiä tilausvahvistusten, SMS-markkinointiviestien ja muun viestinnän 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 siirto-/uudelleenajovirta
* Ajanvarauksen peruutusvirta
* Ajanvarauksen muistutusvirta (24 tuntia etukäteen tai mukautettu ajoitus)
* Ajanvarauksen valmistumisvirta

## Miten se toimii

Sesami käyttää **Sesami Flows** lähettääksesi varaustapahtumat reaaliajassa Omnisendiin. Kun aika varataan, siirretään, perutaan tai suoritetaan loppuun, Sesami lähettää kyseisen tapahtuman tiedot Omnisendiin webhookin kautta mukautettuun tapahtumaan, jonka olet luonut. Tämän jälkeen luot Omnisendiin työnkulkuja, jotka käynnistävät sähköposti- tai SMS-viestejä näiden mukautettujen tapahtumien perusteella.

### Datan kulku

1. Asiakas varaa ajan Sesamissa
2. Sesami Flow laukaisee 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 vastaanottaa sähköposti- tai SMS-viestin, jossa on ajanvarauksen tiedot

## Asennusohjeet

### Osa 1: Ota Omnisend käyttöön

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

1. Asenna **Omnisend-sovellus** Shopify App Storesta
2. Seuraa sovelluksen asennusvaiheita yhdistääksesi verkkokauppasi
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 Private API -avain**
5. Nimeä se "Sesami-integraatio" (tai vastaava)
6. Määritä käyttöoikeudet - valitse seuraavat:
   * **Kampanjat** - mahdollistaa raporttien ja vastaanottajalistojen lataamisen
   * **Kontaktit** - mahdollistaa tilaajien luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Tilaukset** - mahdollistaa tilausten luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Tuotteet** - mahdollistaa tuotteiden luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Ostoskorit** - mahdollistaa ostoskorien luomisen, muokkaamisen, lataamisen ja poistamisen
   * **Tapahtumat** - mahdollistaa mukautettujen tapahtumien hakemisen ja laukaisemisen (**Vaaditaan**)
7. Kopioi luotu API-avain ja säilytä se turvallisesti

{% hint style="warning" %}
**Tärkeää**: Tarvitset erillisen API-avaimen jokaiselle ainutlaatuiselle tapahtumatyypille (ajanvaraus luotu, siirretty, peruttu jne.).
{% endhint %}

Lisätietoja saat tarkistamalla [Omnisendin API-dokumentaation](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ä varaustiedot, joita haluat käyttää sähköposteissasi/SMS-viesteissäsi:
     * `CustomerName` - Asiakkaan nimi
     * `ServiceName` - Varatun palvelun nimi
     * `DateTimeInCustomerTimezone` - Ajanvarauksen päivämäärä/aika
     * `CustomerManagementLink` - Linkki, jolla asiakas voi hallinnoida varausta
     * `AppointmentID` - Ainutkertainen ajanvarauksen tunniste
     * `TeamMember` - Nimetyn henkilöstön jäsenen nimi
     * 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 tapahtumatunnus** - tarvitset sitä Sesami Flow -webhook-osoitetta varten

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

Katso yksityiskohtaiset ohjeet kohdasta [Omnisendin mukautettujen tapahtumien dokumentaatio](https://support.omnisend.com/en/articles/6791819-custom-events).

### Osa 2: Määritä Sesami-työnkulut

#### Vaihe 1: Luo Flow Sesamissa

1. Avaa **Sesami** Shopify Adminissa
2. Siirry kohtaan **Asetukset > Flows**
3. Napsauta **Luo Flow**

#### Vaihe 2: Määritä työnkulun käynnistin

1. Valitse käynnistintapahtuma:
   * Ajanvaraus luotu
   * Ajanvaraus siirretty
   * Ajanvaraus peruttu
   * Ajanvaraus suoritettu
   * Aikaperusteinen muistutus (esim. 24 tuntia ennen ajanvarausta)
2. Määritä tarvittaessa lisäehdot

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

1. Aseta **Toiminto** tyypiksi **Webhook**
2. Määritä webhook:
   * **Kohde-URL**: `https://api.omnisend.com/v3/events/[EVENT_ID]`
     * Korvaa `[EVENT_ID]` Omnisendistä kopioimallasi tapahtumatunnuksella
   * **Kun**: Aseta arvoksi "Välittömästi" (tai määritä ajoitus muistutuksia varten)

#### Vaihe 4: Määritä webhookin otsakkeet

Lisää webhookin otsakkeet-osioon:

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

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

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

Määritä webhookin Body-osiossa 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 `"fields"` täytyy täsmätä täsmälleen Omnisendin mukautetussa tapahtumassa määrittämiesi mukautettujen kenttien kanssa.
{% endhint %}

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

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

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

### Osa 3: Luo työnkulut Omnisendiin

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

1. Kirjaudu sisään **Omnisend**
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 viestipohjasi

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

Kun muokkaat sähköposti- tai SMS-sisältöäsi, voit käyttää varaustietoja mukautettujen kenttien syntaksilla:

* `[[custom_event.CustomerName]]` - Asiakkaan nimi
* `[[custom_event.ServiceName]]` - Palvelun nimi
* `[[custom_event.DateTimeInCustomerTimezone]]` - Ajanvarauksen päivämäärä/aika
* `[[custom_event.CustomerManagementLink]]` - Varauksen hallintalinkki
* `[[custom_event.TeamMember]]` - Nimetty tiimin jäsen

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

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 viiveet tai ehdolliset haarat

#### Vaihe 6: Aktivoi työnkulku

Kun olet suunnitellut ja testannut työnkulkusi, napsauta **Ota käyttöön** tehdäksesi siitä aktiivisen.

## Integraation testaaminen

Ennen kuin julkaiset sen, 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 testiasiakkaalle sähköpostiosoite ja puhelinnumero, tee sitten testivarauksia varmistaaksesi täydellisen asiakaskokemuksen ennen kuin otat työnkulut käyttöön oikeille asiakkaille.
{% endhint %}

## Usein kysytyt kysymykset

<details>

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

Kyllä, Omnisend vaatii yksilöllisen API-avaimen jokaista luomaasi mukautettua tapahtumaa varten. 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-viesteihin että sähköpostiin?</summary>

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

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

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

</details>

<details>

<summary>Entä jos tarvitsen useita muistutus-työnkulkuja?</summary>

Voit luoda useita muistutus-Flow’eja Sesamissa, jokaisella 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 erilliset mukautetut tapahtumat eri muistutusajoille.

</details>

<details>

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

* Varmista, että Omnisendin API-avaimesi on oikea ja että "Events"-käyttöoikeus on otettu käyttöön
* Varmista, että webhook-URL-osoitteesi tapahtumatunnus vastaa mukautettua tapahtumaasi
* Tarkista, että Flow on otettu käyttöön Sesamissa
* Varmista, että teit testivarauksen työnkulun 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 automatisoitujen sähköpostien käännöksiä. Voit luoda työnkuluistasi lokalisoidut versiot asiakkaan 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 Flows](/fi/automaatio/sesami-flows.md) - Yleiskatsaus Sesamin automaatiojärjestelmään
* [Sähköposti- ja webhook-toiminnot](/fi/automaatio/email-and-webhook-as-action-types.md) - Toimintotyyppien ymmärtäminen
* [Sesami Flows ja Klaviyo](/fi/automaatio/sesami-flows-and-klaviyo.md) - Vaihtoehtoinen ESP-integraatio
* [Ilmoitussähköpostit](/fi/ilmoitukset/notification-emails.md) - Sesamin oletusilmoitusjärjestelmä


---

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