> 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 Klaviyon kanssa tehostaaksesi edistynyttä sähköposti- ja SMS-markkinointia varausyrityksessäsi.

## Mikä on Klaviyo?

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

## Miksi integroida Sesami Klaviyon kanssa?

Voit sujuvoittaa kaikki asiakasrajapinnan vuorovaikutuksesi syöttämällä Sesamin tapahtumatiedot Klaviyoon ja käynnistämällä kaikki viestit (sähköposti tai SMS) Klaviyon kautta. Monille yrityksille, jotka jo käyttävät Klaviyota tilausvahvistusten, SMS-markkinointiviestien ja muiden viestien 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-automaatiot:**

* Ajanvarausvahvistuksen automaatio
* Ajanvarauksen uudelleenajon automaatio
* Ajanvarauksen peruutuksen automaatio
* Ajanvarausmuistutuksen automaatio (24 tuntia etukäteen tai mukautettu ajoitus)
* Ajanvarauksen valmistumisen automaatio

**Yhdistetyt integraatiot:**

* Pyydä asiakasarvosteluja arvostelualustojen avulla (Okendo, Yotpo, Trustpilot jne.)
* Kutsu kanta-asiakasohjelmiin tai seuraa niitä ajanvarauksen jälkeen (LoyaltyLion, Swell jne.)
* Personoi ajanvarauksen sähköpostit (Limespot, Nosto jne.)

## Miten se toimii

Sesami käyttää **Sesami Flows** lähettääkseen varaukseen liittyvät tapahtumat Klaviyoon reaaliajassa. Kun ajanvaraus luodaan, siirretään, peruutetaan tai merkitään valmiiksi, Sesami lähettää kyseiset tapahtumatiedot Klaviyoon mukautettuna mittarina. Tämän jälkeen luot Klaviyoon Flows-automaatioita, jotka käynnistävät sähköposti- tai SMS-viestejä näiden mittareiden perusteella.

### Tiedon 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 vastaanottaa sähköposti- tai SMS-viestin ajanvarauksen tiedoilla

## Asennusohjeet

### Vaihe 1: Luo Flow Sesamissa

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

### Vaihe 2: Valitse Klaviyo-esiasetus

Valitse saatavilla olevista Klaviyo Flow -esiasetuksista:

* **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 muistutus-Flow'ta kuin tarvitset kopioimalla muistutusesiasetuksen ja muuttamalla käynnistysajoitusta.
{% 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-konfiguraation.

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

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

1. Kirjaudu sisään **Klaviyo-tilillesi**
2. Siirry kohtaan **Asetukset > API-avaimet**
3. Klikkaa **Luo Private API -avain**
4. Nimeä se "Sesami Integration" ja valitse **Full Access -avain**
5. **Kopioi luotu Private 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 Klaviyo Private 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 sen jälkeen jatkaa Klaviyo Flow'n määrityksen seuraaviin vaiheisiin.

{% hint style="info" %}
**Huom:** Testiajanvarauksen luominen vaaditaan uuden Sesami Flow'n ja Klaviyo API:n välisen yhteyden muodostamiseksi.

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 ajanvaraustaan varten.
* Ajanvaraus aloitettu → Odota, että ajanvaraus alkaa.
* Ajanvaraus peruutettu → Peruuta olemassa oleva ajanvaraus.
* Saapumatta jättäminen → Merkitse ajanvaraus saapumatta jääneeksi.
  {% endhint %}

## Flows-automaatioiden määrittäminen Klaviyossa

Kun Sesami lähettää tapahtumia Klaviyoon, sinun on luotava Klaviyoon Flows-automaatioita viestien lähettämiseksi asiakkaille.

### Vaihe 1: Luo Flow Klaviyossa

1. Kirjaudu sisään **Klaviyo**
2. Siirry kohtaan **Flows**
3. Klikkaa **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 Metric-käynnistin

1. Valitse **Metric** käynnistintyypiksi&#x20;
2. Klikkaa 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. Klikkaa **Lisää toiminto**
2. Valitse **Sähköposti** tai **SMS**
3. Suunnittele viestimallisi

### Vaihe 4: Käytä tapahtuman ominaisuuksia mallissasi

Kun muokkaat sähköposti- tai SMS-sisältöäsi, voit käyttää kaikkia varaukseen liittyviä ominaisuuksia yllä olevassa taulukossa näytetyllä syntaksilla. 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 asiakkaille ajanvarauksen siirtämistä tai peruuttamista varten

### Vaihe 5: Ota Flow käyttöön

Kun olet suunnitellut viestisi ja testannut sen, aseta Flow'n tilaksi **Käytössä** aloittaaksesi automaattisten viestien lähettämisen.

{% hint style="info" %}
**Merkitse Klaviyo Flows -automaatiot transaktionaalisiksi.** Varausvahvistukset, muistutukset, siirto-/peruutusilmoitukset ja vastaavat ajanvarausviestit ovat transaktionaalisia — eivät markkinointia. Niiden merkitseminen transaktionaalisiksi Klaviyossa varmistaa, että ne lähetetään kaikille asiakkaille markkinointiluvasta riippumatta, ja pitää markkinointiviestien toimitettavuuden puhtaana.

Avaa Klaviyossa Flow'n viestitoiminto ja siirry kohtaan **Lisäasetukset**, ja vaihda **Smart Sending** pois päältä ja aseta viestityypiksi **Transaktionaalinen**.
{% endhint %}

## Integraation testaaminen

Testaa integraatio ennen käyttöönottoa:

1. Luo testivaraus Sesamissa
2. Tarkista, että tapahtuma näkyy Klaviyon **Activity Feedissä** tai **Metricsissä**
3. Varmista, että kaikki ajanvarauksen ominaisuudet täyttyvät oikein
4. Testaa Klaviyo Flow'si varmistaaksesi, että sähköposti-/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 testivarausia varmistaaksesi koko asiakaskokemuksen ennen kuin otat Flows-automaatioita käyttöön oikeille asiakkaille.
{% endhint %}

## Saatavilla olevat tapahtumaominaisuudet

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

| Ominaisuus                             | Esimerkkiarvo                            | Kuvaus                                       |
| -------------------------------------- | ---------------------------------------- | -------------------------------------------- |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55                 | Ajanvarauksen yksilöllinen tunniste          |
| `{{ event.datetime }}`                 | 29. heinäkuuta 2022 klo 16.30            | Ajanvarauksen päivämäärä ja kellonaika       |
| `{{ event.order_id }}`                 | 4447608111157                            | Shopify-tilauksen tunniste                   |
| `{{ event.quantity }}`                 | 1                                        | Varausten määrä                              |
| `{{ event.service_name }}`             | Tatuoinnin poisto                        | Palvelun nimi                                |
| `{{ event.service_description }}`      | Ole hyvä ja saavu 15 minuuttia etuajassa | Palveluohjeet                                |
| `{{ 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                             | Tuoteversion nimi                            |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>               | Linkki, jolla asiakas voi hallita varaustaan |
| `{{ event.line_item_properties }}`     | Kysymys/vastaus-parit                    | Mukautetun lomakkeen vastaukset              |

## UKK

<details>

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

Voit rakentaa niin monta muistutus-Flow'ta kuin haluat luomalla uusia Flow'ita Klaviyon muistutusesiasetuksella ja muuttamalla käynnistysajoitusta Flow'n asetuksissa. 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:ään että sähköpostiin?</summary>

Kyllä! Klaviyo tukee sekä sähköpostia että SMS:ää. Kunhan SMS on otettu käyttöön Klaviyo-tililläsi ja olet kerännyt asiakkaiden puhelinnumerot suostumuksella, voit käyttää SMS-toimintoja Klaviyo Flows -automaatioissasi.

</details>

<details>

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

12\. kesäkuuta 2024 alkaen Sesami päivitti kaikki Flow-esiasetukset käyttämään Klaviyon Private API -avainta julkisen avaimen sijaan, jotta ne vastaavat Klaviyon päivitettyjä API-vaatimuksia. Käytä aina Private-avainta uusia integraatioita määrittäessäsi.

</details>

<details>

<summary>Tapahtumia ei näy Klaviyossa. Mitä minun pitäisi tarkistaa?</summary>

* Varmista, että Klaviyon Private API -avain on oikea ja että siinä on Full Access
* 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 Activity Feed nähdäksesi, vastaanotetaanko tapahtumia

</details>

## Aiheeseen liittyvät

* [Sesami Flows](/fi/automatisoinnit/sesami-flows.md) - Yleiskatsaus Sesamin automaatiojärjestelmään
* [Sähköposti- ja webhook-toiminnot](/fi/automatisoinnit/email-and-webhook-as-action-types.md) - Toimintotyyppien ymmärtäminen
* [Klaviyo-integraation yleiskatsaus](/fi/apps-integrations/klaviyo.md) - Yleiset Klaviyo-mallit
* [Ilmoitussähköpostit](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.sesami.co/fi/automatisoinnit/sesami-flows-and-klaviyo.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.