> 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-klaviyo.md).

# Sesami-työnkulut ja Klaviyo

Integroi Sesami Klaviyoon, jotta voit tehostaa varausliiketoimintasi edistynyttä sähköposti- ja SMS-markkinointia.

{% hint style="success" %}
**Klaviyoon voi yhdistää kahdella tavalla.** Se [Klaviyo-sovellus](https://help.sesami.co/fi/apps-integrations/klaviyo/klaviyo-app.md) lähettää varaus­tapahtumat ilman API-avainta tai webhookin määrittämistä. Tämä sivu käsittelee Sesami Flowsia, joka käyttää omaa Klaviyo API -avaintasi ja hoitaa myös muistutukset ennen käyntiä. Katso [Klaviyo](https://help.sesami.co/fi/apps-integrations/klaviyo.md) mihin sitä käytetään milloinkin.
{% endhint %}

## Mikä on Klaviyo?

Klaviyo on markkinoinnin automaatioalusta, jota käytetään ensisijaisesti sähköposti- ja SMS-markkinointiin. Sesamin strategisena kumppanina Klaviyo tarjoaa tehokkaita asiakasviestintätyökaluja ajanvarauspohjaisille yrityksille.

## Miksi integroida Sesami Klaviyoon?

Voit virtaviivaistaa kaikki asiakasrajapinnan vuorovaikutukset syöttämällä Sesamin tapahtumadataa Klaviyoon ja käynnistämällä kaiken viestinnän (sähköposti tai SMS) Klaviyon kautta. Monille yrityksille, jotka jo käyttävät Klaviyota tilausvahvistusten, SMS-markkinointiviestien ja muun viestinnän lähettämiseen, myös varausvahvistusten ja ajanvarausmuistutusten lähettäminen Klaviyon kautta luo yhtenäisen asiakaskokemuksen.

### Yleisiä käyttötapauksia

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

* Ajanvarauksen vahvistusprosessi
* Ajanvarauksen uudelleenajoitusprosessi
* Ajanvarauksen peruutusprosessi
* Ajanvarausmuistutusprosessi (24 tuntia ennen tai mukautettu ajoitus)
* Ajanvarauksen päättymisprosessi

**Yhdistetyt integraatiot:**

* Pyydä asiakasarvosteluja arvostelualustojen kautta (Okendo, Yotpo, Trustpilot jne.)
* Kutsu asiakkaat kanta-asiakasohjelmiin tai seuraa niitä ajanvarauksen jälkeen (LoyaltyLion, Swell jne.)
* Personoi ajanvarausviestejä (Limespot, Nosto jne.)

## Miten se toimii

Sesami käyttää **Sesami Flowsia** lähettääkseen varaus­tapahtumat Klaviyoon reaaliajassa. Kun ajanvaraus luodaan, siirretään uudelleen, asiakas kirjautuu sisään, aloitetaan, peruutetaan tai merkitään saapumatta jätetyksi, Sesami lähettää kyseisen tapahtumatiedon Klaviyoon mukautettuna mittarina. Sen jälkeen luot Klaviyossa Flowsit, jotka käynnistävät sähköposti- tai SMS-viestejä näiden mittareiden perusteella.

### Datan kulku

1. Asiakas varaa ajan Sesamissa
2. Sesami Flow käynnistyy ja lähettää tapahtumatiedot Klaviyoon webhookin kautta
3. Klaviyo vastaanottaa tapahtuman mukautettuna mittarina (esim. "Sesami Appointment Created")
4. Klaviyo Flow käynnistyy kyseisen mittarin perusteella
5. Asiakas saa sähköposti- tai SMS-viestin, jossa on ajanvarauksen tiedot

## Asennusohjeet

### Vaihe 1: Luo Flow Sesamissa

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

### Vaihe 2: Valitse Klaviyo-valmiusasetus

Valitse saatavilla olevista Klaviyo Flow -valmiusasetuksista:

* **Klaviyo-tapahtuma, ajanvaraus luotu**
* **Klaviyo-tapahtuma, ajanvaraus siirretty**
* **Klaviyo-tapahtuma, ajanvaraus peruutettu**
* **Klaviyo-tapahtuma, ajanvaraus suoritettu**
* **Klaviyo-tapahtuma, ajanvarausmuistutus 24 tuntia etukäteen**

{% hint style="info" %}
Voit luoda niin monta muistutusFlow'ta kuin tarvitset kopioimalla muistutusvalmiusasetuksen ja muuttamalla käynnistysajankohtaa.
{% endhint %}

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FuxdHvTIRYlwCWGpBwGIH%2FScreenshot%202026-08-27%20at%2013.33.08.png?alt=media&amp;token=2071f95d-dbf7-4dcf-a786-e0d1c0e5434d" alt=""><figcaption></figcaption></figure>

### Vaihe 3: Tarkista Flow-asetukset

Tarkista Flow'n yleiset asetukset ymmärtääksesi käynnistysehdot ja webhook-määritykset.

### Vaihe 4: Hanki Klaviyon yksityinen API-avain

{% hint style="warning" %}
**Tärkeää**: 12. kesäkuuta 2024 alkaen Sesami Flows käyttää Klaviyon yksityistä API-avainta (ei julkista avainta). Varmista, että luot yksityisen avaimen.
{% endhint %}

1. Kirjaudu sisään **Klaviyo-tilillesi**
2. Siirry kohtaan **Asetukset > API-avaimet**
3. Napsauta **Luo yksityinen API-avain**
4. Nimeä se "Sesami Integration" ja valitse **Täyden käyttöoikeuden avain**
5. **Kopioi luotu yksityinen API-avain**

<div><figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJQQrLNJF0Wc1v55x5pw6%2FScreenshot%202026-08-27%20at%2013.37.52.png?alt=media&amp;token=2482f74f-2bd7-416a-b74c-e617cbd40076" alt=""><figcaption></figcaption></figure> <figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FtDaqzIIZt1JaRJaFN2Zo%2FScreenshot%202026-08-27%20at%2013.43.28.png?alt=media&amp;token=bdf7fd77-bbd9-4867-aa5c-dd62512056bf" alt=""><figcaption></figcaption></figure></div>

### Vaihe 5: Lisää API-avaimesi Flow'hun

1. Etsi Sesami Flow'n asetuksista paikkamerkki `KLAVIYO_PRIVATE_API_KEY`
2. Korvaa se varsinaisella Klaviyon yksityisellä API-avaimellasi
3. **Tallenna** Flow

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi5oTyjoqq0PXgNihjLCt%2FScreenshot%202026-08-27%20at%2013.46.46.png?alt=media&amp;token=cf59b1ba-62f8-4910-aef2-a545e114fd05" alt=""><figcaption></figcaption></figure>

### Vaihe 6: Luo ja testaa varaus

1. Luo testiajanvaraus Sesamissa yhdistääksesi Sesamin Klaviyoon ja lähettääksesi tapahtumatiedot.<br>
2. Kun testi on valmis, vastaava tapahtuma ja sen ominaisuudet tulevat saataville Klaviyossa. Voit sitten jatkaa Klaviyo Flow'n määrityksen seuraaviin vaiheisiin.

{% hint style="info" %}
**Huom:** Testiajanvarauksen luominen on tarpeen yhteyden muodostamiseksi juuri määritetyn Sesami Flow'n ja Klaviyo API:n välille.

Testitoiminnon on vastattava Flow'n käynnistintä:

* Ajanvaraus luotu → Luo uusi testiajanvaraus.
* Ajanvaraus siirretty → Siirrä olemassa oleva ajanvaraus.
* Asiakas kirjautui sisään → Kirjaa asiakas sisään hänen ajanvaraustaan varten.
* Ajanvaraus alkanut → Odota, että ajanvaraus alkaa.
* Ajanvaraus peruutettu → Peruuta olemassa oleva ajanvaraus.
* Ei saapunut → Merkitse ajanvaraus ei saapuneeksi.
  {% endhint %}

## Flow'iden määrittäminen Klaviyossa

Kun Sesami lähettää tapahtumia Klaviyoon, sinun on luotava Klaviyossa Flow't, jotta voit lähettää viestejä asiakkaille.

### Vaihe 1: Luo Flow Klaviyossa

1. Kirjaudu sisään **Klaviyo**
2. Siirry kohtaan **Flows**
3. Napsauta **Luo Flow** ja sitten **Rakenna omasi**

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FgF1uw6IQslc07hlOzuBD%2FScreenshot%202026-08-27%20at%2014.23.17.png?alt=media&amp;token=daee427d-8831-4abc-979c-0f87e44b10ff" alt=""><figcaption></figcaption></figure>

### Vaihe 2: Valitse mittarikäynnistin

1. Valitse **Mittari** käynnistintyypiksesi
2. Napsauta API
3. Etsi "Sesami" ja valitse sopiva mittari.

<div><figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FdeylxlHLsqqiXcWoO3pb%2FScreenshot%202026-08-27%20at%2014.26.23.png?alt=media&amp;token=8c59d1a1-ec7f-413b-ae5c-b61baf23116c" alt=""><figcaption></figcaption></figure> <figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5XGdGYX0ttyeANtcq58A%2FScreenshot%202026-08-27%20at%2014.30.23.png?alt=media&amp;token=c9c3fb06-9ad7-4f05-bc2b-9b6aa25f767f" alt=""><figcaption></figcaption></figure></div>

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

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

### Vaihe 4: Käytä tapahtumaominaisuuksia mallissasi

Kun muokkaat sähköposti- tai SMS-sisältöäsi, voit käyttää kaikkia varaukseen liittyviä ominaisuuksia yllä olevassa taulukossa esitetyn syntaksin avulla. Esimerkiksi:

* `{{ event.datetime }}` - Näyttää ajanvarauksen päivämäärän ja kellonajan
* `{{ event.service_name }}` - Näyttää palvelun nimen
* `{{ event.team_member }}` - Näyttää nimetyn tiimin jäsenen
* `{{ event.customer_management_link }}` - Tarjoaa linkin, jonka kautta asiakkaat voivat siirtää tai peruuttaa ajanvarauksen

### Vaihe 5: Julkaise Flow

Kun olet suunnitellut viestisi ja testannut sen, aseta Flow'n tilaksi **Julkaistu** aloittaaksesi automatisoitujen viestien lähettämisen.

{% hint style="info" %}
**Merkitse Klaviyo Flow't tapahtumaviestinnäksi.** Varausvahvistukset, muistutukset, ajan siirtämis- ja peruutusilmoitukset sekä vastaavat ajanvarausviestit ovat tapahtumaviestintää – eivät markkinointia. Kun merkitset ne Klaviyossa tapahtumaviestinnäksi, ne lähetetään kaikille asiakkaille markkinointisuostumuksesta riippumatta, ja markkinointiviestiesi toimitettavuus pysyy hyvänä.

Avaa Klaviyossa Flow'n viestitoiminto ja siirry kohtaan **Lisäasetukset**, ja kytke **Smart Sending** pois käytöstä ja aseta viestityypiksi **Tapahtumaviesti**.
{% endhint %}

## Integraation testaaminen

Testaa integraatio ennen käyttöönottoa:

1. Luo testivaraus Sesamissa
2. Tarkista, että tapahtuma näkyy Klaviyon **Toimintasyötteessä** tai **Mittarit**
3. Varmista, että kaikki ajanvarauksen ominaisuudet täyttyvät oikein
4. Testaa Klaviyo Flow'si varmistaaksesi, että sähköpostit/SMS-viestit lähetetään oikein
5. Tarkista sisältö varmistaaksesi, että kaikki dynaamiset ominaisuudet näkyvät oikein

{% hint style="success" %}
**Vinkki**: Luo testiasiakkaan sähköpostiosoite ja tee testivarauksia varmistaaksesi koko asiakaskokemuksen ennen Flow'iden ottamista käyttöön oikeille asiakkaille.
{% endhint %}

## Käytettävissä olevat tapahtumaominaisuudet

Kun Sesami lähettää ajanvarauksen tiedot Klaviyoon, seuraavat ominaisuudet sisältyvät niihin ja niitä voidaan käyttää Klaviyon sähköposti- tai SMS-malleissa:

| Ominaisuus                             | Esimerkkiarvo                         | Kuvaus                                            |
| -------------------------------------- | ------------------------------------- | ------------------------------------------------- |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55              | Yksilöllinen ajanvarauksen tunnus                 |
| `{{ event.datetime }}`                 | 29. heinäkuuta 2022 klo 16.30         | Ajanvarauksen päivämäärä ja kellonaika            |
| `{{ event.order_id }}`                 | 4447608111157                         | Shopify-tilauksen tunnus                          |
| `{{ event.quantity }}`                 | 1                                     | Varausten määrä                                   |
| `{{ event.service_name }}`             | Tatuoinnin poisto                     | Palvelun nimi                                     |
| `{{ event.service_description }}`      | Saavu paikalle 15 minuuttia etuajassa | Palvelun ohjeet                                   |
| `{{ event.service_duration }}`         | 30                                    | Kesto minuuteissa                                 |
| `{{ event.service_price }}`            | 149                                   | Palvelun hinta                                    |
| `{{ event.service_location }}`         | 100 Beverly Hills, LA                 | Palvelun sijainti                                 |
| `{{ event.service_image_url }}`        | <https://cdn.shopify.com/>...         | Palvelun kuvan URL                                |
| `{{ event.team_member }}`              | David                                 | Nimetyn tiimin jäsenen nimi                       |
| `{{ event.team_member_description }}`  | Davidilla on kymmenen vuoden kokemus  | Tiimin jäsenen esittely                           |
| `{{ event.team_member_email }}`        | <david@email.com>                     | Tiimin jäsenen sähköposti                         |
| `{{ event.team_member_phone }}`        | 0000000000                            | Tiimin jäsenen puhelinnumero                      |
| `{{ event.variant_title }}`            | 30 minuuttia                          | Tuotevariantin nimi                               |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>            | Linkki, jonka kautta asiakas voi hallita varausta |
| `{{ event.line_item_properties }}`     | Kysymys/vastaus-parit                 | Mukautetun lomakkeen vastaukset                   |

## UKK

<details>

<summary>Entä jos minun täytyy määrittää useampi kuin yksi muistutusflow?</summary>

Voit rakentaa niin monta muistutusflow'ta kuin haluat luomalla uusia Flow'ta käyttämällä Klaviyon muistutusvalmiusasetusta ja muuttamalla käynnistysajankohtaa Flow'n määrityksissä. Esimerkiksi voit lähettää muistutuksia:

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

</details>

<details>

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

Kyllä! Klaviyo tukee sekä sähköpostia että SMS:ää. Kunhan SMS on käytössä Klaviyo-tililläsi ja olet kerännyt asiakkaiden puhelinnumerot suostumuksella, voit käyttää SMS-toimintoja Klaviyo Flow'ssasi.

</details>

<details>

<summary>Mitä tapahtui julkisen API-avaimen vaatimukselle?</summary>

12\. kesäkuuta 2024 alkaen Sesami päivitti kaikki Flow-valmiusasetukset käyttämään Klaviyon yksityistä API-avainta julkisen avaimen sijaan Klaviyon päivitettyjen API-vaatimusten mukaisesti. Käytä aina yksityistä avainta uusia integraatioita määrittäessäsi.

</details>

<details>

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

* Varmista, että Klaviyon yksityinen API-avain on oikea ja siinä on täysi käyttöoikeus
* Varmista, että Flow on käytössä Sesamissa
* Tarkista, että olet tehnyt testivarauksen Flow'n määrittämisen jälkeen
* Tarkista Sesami Flow'n lokit nähdäksesi, lähetettiinkö webhook onnistuneesti
* Tarkista Klaviyon toimintasyöte nähdäksesi, vastaanotetaanko tapahtumia

</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
* [Klaviyo-integraation yleiskatsaus](https://help.sesami.co/fi/apps-integrations/klaviyo.md) - Yleiset Klaviyo-mallit
* [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-klaviyo.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.
