# Sesami Flows ja Klaviyo

Integroi Sesami Klaviyon kanssa tehostaaksesi edistynyttä sähköposti- ja SMS-markkinointia ajanvarausyrityksessäsi.

## Mikä on Klaviyo?

Klaviyo on markkinoinnin automaatioalusta, jota käytetään pääasiassa 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 vuorovaikutukset syöttämällä Sesamin tapahtumatiedot Klaviyoihin 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 muun viestinnän lähettämiseen, myös varausten vahvistusten ja ajanvarausmuistutusten lähettäminen Klaviyon kautta luo yhtenäisen asiakaskokemuksen.

### Yleisiä käyttötapauksia

**Sähköposti- ja SMS-virrat:**

* Ajanvarauksen vahvistusvirta
* Ajanvarauksen siirto-/uudelleenajovirta
* Ajanvarauksen peruutusvirta
* Ajanvarauksen muistutusvirta (24 tuntia etukäteen tai mukautettu ajoitus)
* Ajanvarauksen valmistumisvirta

**Yhdistetyt integraatiot:**

* Pyydä asiakasarvosteluja arvostelualustoilla (Okendo, Yotpo, Trustpilot jne.)
* Kutsu kanta-asiakasohjelmaan tai seuraa sitä ajanvarauksen jälkeen (LoyaltyLion, Swell jne.)
* Personoi ajanvarausviestejä (Limespot, Nosto jne.)

## Miten se toimii

Sesami käyttää **Sesami Flows** lähettääkseen varaus­tapahtumat Klaviyolle reaaliajassa. Kun ajanvaraus luodaan, siirretään, peruutetaan tai se merkitään suoritetuksi, Sesami lähettää kyseisen tapahtumatiedon Klaviyolle mukautettuna mittarina. Sen jälkeen luot Klaviyossa Flows-virtoja, 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 laukeaa ja lähettää tapahtumatiedot Klaviyolle webhookin kautta
3. Klaviyo vastaanottaa tapahtuman mukautettuna mittarina (esim. "Sesami Appointment Created")
4. Klaviyo Flow laukeaa kyseisen mittarin perusteella
5. Asiakas vastaanottaa sähköposti- tai SMS-viestin, jossa on ajanvarauksen tiedot

## Asennusohjeet

### Vaihe 1: Luo Flow Sesamissa

1. Avaa **Sesami** Shopify Adminissa
2. Siirry kohtaan **Asetukset > 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 muistutusvirtaa kuin tarvitset kopioimalla muistutusvalmiusasetuksen ja muuttamalla käynnistyksen ajoitusta.
{% endhint %}

### Vaihe 3: Tarkista Flow-asetukset

Tarkista yleiset Flow-asetukset ymmärtääksesi käynnistysolosuhteet ja webhook-määrityksen.

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

{% hint style="warning" %}
**Tärkeää**: 12. kesäkuuta 2024 alkaen Sesami Flows käyttää Klaviyon Private 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 Private API -avain**
4. Nimeä se "Sesami Integration" ja valitse **Full Access Key**
5. Kopioi luotu Private API -avain

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

1. Etsi Sesami Flow -asetuksistasi paikkamerkki `KLAVIYO_PRIVATE_API_KEY`
2. Korvaa se omalla Klaviyon Private API -avaimellasi
3. **Tallenna** Flow

Siinä kaikki! Toista nämä vaiheet jokaiselle Klaviyo-tapahtumalle, jonka haluat lähettää Klaviyoon.

## Saatavilla olevat tapahtumaominaisuudet

Kun Sesami lähettää ajanvaraustiedot Klaviyolle, seuraavat ominaisuudet sisällytetään, ja niitä voidaan käyttää Klaviyon sähköposti- tai SMS-malleissasi:

| Ominaisuus                             | Esimerkkiarvo                        | Kuvaus                                              |
| -------------------------------------- | ------------------------------------ | --------------------------------------------------- |
| `{{ event.appointment_id }}`           | 62e144124a6d0b9ed42ffb55             | Ainutlaatuinen ajanvarauksen tunnus                 |
| `{{ event.datetime }}`                 | 29. heinäkuuta 2022 klo 16.30        | Ajanvarauksen päivämäärä ja aika                    |
| `{{ event.order_id }}`                 | 4447608111157                        | Shopify-tilauksen tunnus                            |
| `{{ event.quantity }}`                 | 1                                    | Varausten määrä                                     |
| `{{ event.service_name }}`             | Tatuoinnin poisto                    | Palvelun nimi                                       |
| `{{ event.service_description }}`      | Saavuthan 15 minuuttia etuajassa     | Palvelun ohjeet                                     |
| `{{ event.service_duration }}`         | 30                                   | Kesto minuutteina                                   |
| `{{ 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 puhelin                              |
| `{{ event.variant_title }}`            | 30 minuuttia                         | Tuotevariantin nimi                                 |
| `{{ event.customer_management_link }}` | <https://r.sesami.co/1234>           | Linkki, jonka kautta asiakas voi hallita varaustaan |
| `{{ event.line_item_properties }}`     | Kysymys/vastaus-parit                | Mukautetun lomakkeen vastaukset                     |

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

Kun Sesami lähettää tapahtumat Klaviyolle, sinun täytyy luoda Klaviyossa Flows-virtoja asiakasviestien lähettämistä varten.

### Vaihe 1: Luo Flow Klaviyossa

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

### Vaihe 2: Valitse mittarilaukaisin

1. Valitse **Mittari** käynnistystyypiksesi
2. Etsi "Sesami" mittarivalikosta
3. Valitse sopiva mittari:
   * **Sesami Appointment Created**
   * **Sesami Appointment Rescheduled**
   * **Sesami Appointment Canceled**
   * **Sesami Appointment Completed**
   * **Sesami Appointment Reminder**

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

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

### 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 näytetyllä syntaksilla. Esimerkiksi:

* `{{ event.datetime }}` - Näyttää ajanvarauksen päivämäärän ja ajan
* `{{ 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-tilaksi **Live** aloittaaksesi automaattisten viestien lähettämisen.

{% hint style="info" %}
**Merkitse Klaviyo Flow'si transaktionaalisiksi.** Varausvahvistukset, muistutukset, siirto-/peruutusilmoitukset ja vastaava ajanvarausviestintä ovat transaktionaalisia — eivät markkinointia. Kun merkitset ne Klaviyossa transaktionaalisiksi, varmistat, että ne lähetetään kaikille asiakkaille markkinointisuostumuksesta riippumatta, ja pidät markkinointitoimitettavuutesi siistinä.

Avaa Klaviyossa Flow'n viestitoiminto ja siirry kohtaan **Lisäasetukset**, ja kytke **Smart Sending** pois päältä ja aseta viestin tyypiksi **Transactional**.
{% endhint %}

## Integraation testaaminen

Ennen kuin julkaiset sen, testaa integraatio:

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

## Usein kysytyt kysymykset

<details>

<summary>Entä jos minun täytyy asettaa useampi kuin yksi muistutusvirta?</summary>

Voit rakentaa niin monta muistutusvirtaa kuin haluat luomalla uusia Flows-virtoja Klaviyon muistutusvalmiusasetusta käyttäen ja muuttamalla käynnistyksen ajoitusta Flow-määrityksessä. Voit esimerkiksi lähettää muistutuksia:

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

</details>

<details>

<summary>Voinko käyttää Klaviyota myös SMS-viesteihin sähköpostin lisäksi?</summary>

Kyllä! Klaviyo tukee sekä sähköpostia että SMS-viestejä. Niin kauan kuin SMS on käytössä Klaviyo-tililläsi ja olet kerännyt asiakkaiden puhelinnumerot suostumuksella, voit käyttää SMS-toimintoja Klaviyo Flows -virroissasi.

</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 Private API -avainta julkisen avaimen sijaan, mikä vastaa Klaviyon päivitettyjä API-vaatimuksia. Käytä aina Private-avainta, kun otat käyttöön uusia integraatioita.

</details>

<details>

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

* Varmista, että Klaviyon Private API -avaimesi on oikein ja sillä 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 -lokit nähdäksesi, lähetettiinkö webhook onnistuneesti
* Tarkista Klaviyon Activity Feed nähdäksesi, vastaanotetaanko tapahtumia

</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
* [Klaviyo-integraation yleiskatsaus](/fi/apps-integrations/klaviyo.md) - Klaviyon yleiset toimintamallit
* [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-klaviyo.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.
