> 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/aloita/quickstart.md).

# Pika-aloitus

Tämä opas vie sinut vaiheesta "asennettu" ensimmäiseen varaukseen mahdollisimman vähillä vaiheilla.

## Mitä otat käyttöön

* **Palvelut** - Shopify-tuotteet, jotka edustavat varattavia palveluita
* **Resurssit** - Palveluiden tuottamiseen tarvittavat tiimin jäsenet, huoneet, laitteet tai muut resurssit
* **Saatavuus** - Resurssien työajat ja aikataulutussäännöt
* **Verkkokaupan integrointi** - Varauspainikkeet ja kalenteri verkkokaupassasi

{% hint style="info" %}
**Arvioitu aika**: 15–30 minuuttia perusasetusten määrittämiseen yhdelle palvelulle ja yhdelle tiimin jäsenelle.
{% endhint %}

### Ennen aloittamista <a href="#before-you-start" id="before-you-start"></a>

Varmista, että sinulla on:

* **Järjestelmänvalvojan käyttöoikeudet** Shopify-kauppaasi
* **Luettelo palveluista** joita haluat tarjota:
  * Palvelun nimi (esim. ”60 minuutin hieronta”, ”Koiran trimmaus”)
  * Kesto (esim. 30 minuuttia, 1 tunti, 2 tuntia)
  * Hinta
* **Resurssien tiedot**:
  * Tiimin jäsenten nimet ja heidän työaikansa
  * Huone- tai laitevaatimukset (tarvittaessa)

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FPOzJuZclHQ9ht21ebfhi%2FScreenshot%202026-05-19%20at%2012.32.43.png?alt=media&amp;token=0af2ba25-c752-4d94-9321-5c521e556175" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### **Palvelun lisääminen Sesamiin**

**Voit luoda palvelun suoraan Sesamissa tai lisätä olemassa olevan tuotteen Shopify-kaupasta.**

#### **- Sesamissa**&#x20;

1. Anna selkeä **otsikko** (esim. ”Hiustenleikkaus”, ”Hieronta”, ”Konsultaatio”)

   Pidä otsikko yksinkertaisena – se näkyy varausvahvistuksissa ja kalentereissa
2. Lisää **kuvaus**
3. Lisää **variantti ”kesto”, yksikkö** ja **hinta**\
   Luo variantteja, kuten ”30 minuuttia”, ”1 tunti” ja ”90 minuuttia”
4. Napsauta **luodaksesi palvelun**

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fi8WFIIRFXECjiCk8G2oT%2FScreenshot%202026-05-19%20at%2013.37.41.png?alt=media&amp;token=51871ee8-eaea-4c5d-a8ae-0420dc556a38" alt=""><figcaption></figcaption></figure>

#### **- Shopifyssa**

1. Siirry Shopify Adminissa kohtaan **Products > Add product**
2. Anna selkeä tuotteen nimi, joka kuvaa palvelua, kuten *Hiustenleikkaus*, *Hieronta*, tai *Konsultaatio*
3. Napsauta **Add variant** ja luo ”**Kesto”-variantti** ja sen vaihtoehdot, kuten *30 minuuttia*, *1 tunti*, tai *90 minuuttia*
4. Aseta hinta kullekin kestoasetukselle
5. Valitse **Tallenna** luodaksesi tuotteen

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FKoVL1Uvm6QHvzAJEzmoD%2FScreenshot%202026-05-19%20at%2013.35.29.png?alt=media&amp;token=25c95196-9a90-4b96-83a1-e8a21369ed4c" alt=""><figcaption></figcaption></figure>

Toista tämä jokaiselle palvelutyypille, jota haluat tarjota.

{% hint style="success" %}
**Hyvä käytäntö**: Käytä variantteja saman palvelun eri kestoille. Luo esimerkiksi yksi tuote ”Hieronta”, jossa on variantit ”30 minuuttia”, ”1 tunti” ja ”90 minuuttia”, sen sijaan että loisit kolme erillistä tuotetta.
{% endhint %}
{% endstep %}

{% step %}

### **Luo resursseja ja määritä niiden saatavuus**

Resurssit ovat asioita, joita palvelun toteuttamiseen tarvitaan – esimerkiksi tiimin jäsenet, huoneet ja laitteet. Luo resurssit ja määritä niiden saatavuus.

{% hint style="info" %}
**Huomaa**: Shopify Adminin nykyisessä käyttöliittymässä resurssien nimitys on ”Tiimin jäsenet”. Nimitys muutetaan muotoon ”Resurssit” tulevassa julkaisussa.
{% endhint %}

1. Lisää resurssin **nimi** ja **resurssityyppi**
   * Henkilöstö: Lisää jokainen tiimin jäsen nimellä (esim. ”Sarah”, ”Alex”, ”Jamie”)
   * Huoneet/laitteet: Lisää ne toistaiseksi tiimin jäseniksi (esim. ”Huone 1”, ”Kamerapaketti A”)
2. Määritä sen **työajat** ja lisää saatavuussäännöt (esim. maanantaista perjantaihin klo 9.00–17.00)
3. **Luo resurssi valitsemalla**&#x20;

**Esimerkki määrityksistä:**

* Tiimin jäsen ”Sarah” → Saatavilla maanantaista perjantaihin klo 9–17
* Huone ”Hoitohuone 1” → Saatavilla maanantaista lauantaihin klo 8–20

{% hint style="info" %}
**Hyvä tietää:** Älä huoli, vaikka et olisi vielä määrittänyt kaikkia resurssejasi. Voit määrittää nyt yhden resurssin saatavuuden ja luoda myöhemmin lisää resursseja tai päivittää olemassa olevien resurssien saatavuutta kohdassa [**Hallintaportaali: Resurssit**](https://help.sesami.co/fi/yllapito/resources.md).
{% endhint %}

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FrRx0NMMOiOSmrfHMOggl%2FScreenshot%202026-05-19%20at%2017.08.58.png?alt=media&amp;token=53d42e8e-0196-4123-9c44-f93882601844" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### **Lisää varaus verkkokauppaasi**

Tee varauskalenteri asiakkaiden käytettäväksi verkkokaupassasi

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F3izuy705a4B12sMY4pp8%2FScreenshot%202026-05-22%20at%2011.34.45.png?alt=media&amp;token=1bfc3440-9cf9-4385-b396-c45110428933" alt=""><figcaption></figcaption></figure>

**Teeman sovellusupotus (suositus – modernit teemat) – Useimmat Shopify 2.0 -teemat tukevat sovellusupotuksia**

{% hint style="info" %}
**Valinnainen:** Jos käytössäsi on vanhempi Shopify-teema, headless-verkkokauppa (kuten Hydrogen) tai mukautettu verkkosivusto, voit ohittaa tämän vaiheen ja katsoa integrointiohjeet [kehittäjädokumentaatiostamme](https://sesami.dev/docs/sesami-experience/shopify-integration/intro/) .
{% endhint %}

#### **Vaihe 1: Ota sovellusupotus käyttöön**

1. Valitse Sesami-hallintapaneelissa **Mukauta teemaa** kohdasta **Upota varauskokemus** .
2. Tämä avaa teemaeditorin, jossa on **Sovellusupotukset** -paneeli (yleensä vasemmassa sivupalkissa tai teeman asetuksissa)
3. Etsi **Sesami Booking App** ja ota valitsin käyttöön, jotta sovellus voidaan upottaa teemaasi.
4. **Tallenna**

<div><figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F5IZDWEsFIoEA1zsWNOIA%2FScreenshot%202026-05-22%20at%2011.34.56.png?alt=media&amp;token=9e65bd06-2cc0-4e10-8d22-8068100088ce" alt=""><figcaption></figcaption></figure> <figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FJaRozYLGOsgaXbP4n4Wv%2FScreenshot%202026-05-22%20at%2012.30.06.png?alt=media&amp;token=40d823c3-e4a9-45e5-b40b-8ebbe9bddb91" alt=""><figcaption></figcaption></figure></div>

#### **Vaihe 2: Lisää tuotteeseen**

1. Lisää seuraavaksi Sesami-varauslohko tuotemalliisi avaamalla tuotemalli
2. osiossa **Tuotetiedot** napsauta **Lisää lohko** ja valitse **Sesami-varauspainike**
3. Sijoita lohko Osta-painikkeiden yläpuolelle
4. **Tallenna** teeman muutokset.

Varauswidget näkyy nyt kauppasi tuotesivuilla, ja asiakkaat voivat valita vapaita varausaikoja.

<div><figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2F9vxmbQjJF6Do7CZirEZn%2FScreenshot%202026-05-22%20at%2011.36.23.png?alt=media&amp;token=fe4f7d85-dc75-4ee1-a6cf-f1ed32b66261" alt=""><figcaption></figcaption></figure> <figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2FqkGvhl600ImCpipWkDfQ%2FScreenshot%202026-05-22%20at%2012.30.33.png?alt=media&amp;token=48acdafc-5195-4376-b7f5-6c8e41046668" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Manuaalinen integrointi (vanhemmat teemat)**

Vanhemmat teemat, jotka eivät tue sovelluksen upottamista:

1. Lisää teemaeditorissa painike tai linkki tuotesivuille
2. Linkitä tuotesivulle, jolla Sesami-kalenteri on käytössä
3. Tai pyydä tuelta apua teemakohtaiseen integrointiin

Katso: [Shopifyn verkkokaupan käyttöönotto](https://help.sesami.co/fi/apps-integrations/shopify/online-store.md)
{% endhint %}

{% hint style="success" %}
**Vinkki**: Lisää päävalikkoon ”Varaa nyt” -linkki, joka osoittaa kaikkien varattavien palveluiden kokoelmaan.
{% endhint %}
{% endstep %}

{% step %}
**Testaa koko varausprosessi**

Testaa koko varausprosessi ennen julkaisua:

1. **Avaa kauppasi** yksityisessä tai incognito-selausikkunassa (nähdäksesi asiakkaan näkymän)
2. **Siirry palvelutuotteen tuotesivulle**
3. **Tarkista, että varauskalenteri näkyy** ja että siinä on vapaita aikoja
4. **Valitse päivämäärä ja kellonaika**
5. **Lisää tuote ostoskoriin** ja siirry kassalle
6. **Suorita ostos loppuun** (käytä Shopifyn testitilaa tai tee oikea varaus)
7. **Varmista, että varaus näkyy** Sesami Adminin Varaukset-osiossa
8. **Tarkista mobiililaitteella** – Testaa sama prosessi mobiililaitteella

**Tarkista seuraavat asiat:**

* Vapaat ajat vastaavat resurssiesi saatavuutta
* Oikea aikavyöhyke näkyy
* Varaus on liitetty oikeaan resurssiin
* Varausajat eivät mene päällekkäin, kun varaat useita aikoja

{% hint style="warning" %}
**Jos vapaita aikoja ei näy**, katso alla oleva vianmääritysosio.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Vianmääritys

<details>

<summary>Kalenteri ei näy tuotesivulla</summary>

Tarkista:

1. **Sesami-sovelluksen upotus on käytössä** teeman asetuksissa
2. **Tuotteella on sesami-service-tunniste** Shopifyssa
3. **Sesami on käytössä** Sesamin asetuksissa
4. Katselet **julkaistua teemaa** (et luonnosta tai julkaisemattomasta versiosta)
5. **Palvelu on määritetty** Sesamissa ja linkitetty tuotteeseen

</details>

<details>

<summary>Palvelu ei toimi tai näyttää virheitä</summary>

Tarkista:

1. **Tuote on lisätty palveluksi** Sesamissa
2. **Resurssit on määritetty** palvelulle
3. **Vaaditut resurssit ovat käytössä** (ei poistettu käytöstä)
4. **Keston variantin muoto** on oikea (esim. "30 Minutes", "1 Hour" – ei ylimääräisiä välilyöntejä, englanniksi)
5. **"Tuotteella ei ole Duration-vaihtoehtoa" –** Keston variantti on kirjoitettava englanniksi ilman kirjoitusvirheitä.

</details>

<details>

<summary>Vapaita aikoja ei näy</summary>

Yleisin ongelma! Tarkista:

1. **Resurssit on määritetty** palvelulle (vaihe 2)
2. **Saatavuus on määritetty** määritetyille resursseille (vaihe 2)
3. **Varausikkuna** sallii tulevat varaukset (tarkista lisäasetukset)
4. **Ei estoja** jotka kattaisivat kaikki vapaat päivämäärät
5. **Ostopainikkeet on piilotettu tai poistettu tuotesivulta**

Katso: [Saatavuus puuttuu](https://help.sesami.co/fi/aloita/onboarding/troubleshooting/no-availability.md)

</details>

<details>

<summary>Virhe: "Jokin meni pieleen. Lataa sivu uudelleen ja yritä uudelleen"</summary>

Käytettäessä keston variantteja vaihtoehdon nimen on oltava täsmälleen **`Duration`** englanniksi, ilman kirjoitusvirheitä, lisäsanoja, käännöksiä tai välilyöntejä ennen nimeä tai sen jälkeen.

Sesami käyttää tätä avainsanaa varauksen keston tunnistamiseen. Jos se on määritetty väärin, varausprosessi ei välttämättä toimi odotetusti.\
\
*\*Keston voi kääntää myöhemmin.*

<figure><img src="https://1941800691-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnDgiM1CWSLWRIbhORANO%2Fuploads%2Fx6BZKDk5nIQ8cNHvE58z%2FScreenshot%202026-11-13%20at%2013.03.52.png?alt=media&amp;token=6ef86b60-4eed-4c8d-95d3-f0a7db0be081" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Aikavyöhyke näyttää väärältä</summary>

1. Siirry kohtaan **Sesami > Asetukset > Aikavyöhyke**
2. Varmista, että kauppasi aikavyöhyke vastaa fyysistä sijaintiasi
3. Tarkista, että resurssien saatavuus on määritetty oikeassa aikavyöhykkeessä
4. Tyhjennä selaimen välimuisti ja testaa yksityisessä selaustilassa

Katso: [Aikavyöhykkeiden ristiriita](https://help.sesami.co/fi/aloita/onboarding/troubleshooting/timezone-mismatch.md)

</details>

<details>

<summary>Kassalla tapahtuu odottamattomia asioita</summary>

Jos kassalle siirtyminen ohitetaan, vaikka odotit sen tapahtuvan (tai päinvastoin):

1. Tarkista, onko **Välitön varaus** käytössä (ohittaa kassalle siirtymisen)
2. Tarkista **ennakkomaksuasetukset** (voivat muuttaa kassalle siirtymisen kulkua)
3. Tarkista tuotteen **hinnoittelu** (maksuttomien tuotteiden kohdalla kassalle siirtyminen voidaan ohittaa)

Katso: [Välitön varaus](https://help.sesami.co/fi/varaus/booking-features/instant-booking.md) | [Ennakkomaksut](https://help.sesami.co/fi/maksut/deposits.md)

</details>

<details>

<summary>Varauksessa näkyy "Määritetty: Ei kenellekään"</summary>

Näin käy, kun vapaita aikoja ei ole enää saatavilla kassalle siirryttäessä:

1. Ota käyttöön **Varausjakso** Sesamin asetuksissa
2. Ota käyttöön **Ostoskorin vahvistus** saatavuuden tarkistamiseksi ennen kassalle siirtymistä

Katso: [Vianmääritys: Määritetty ei kenellekään](https://help.sesami.co/fi/aloita/onboarding/troubleshooting/troubleshooting-assigned-to-no-one-caused-by-invalid-order.md)

</details>

<details>

<summary>Asiakkaat näkevät virheilmoituksen "Istunto on vanhentunut" tai "Virheellinen linkki"</summary>

Yleisiä syitä:

1. **Linkit ovat vanhentuneet** – Asiakas yritti muuttaa tai peruuttaa varausta määräajan jälkeen
2. **Selaimen evästeet on estetty** – Tarkista selaimen asetukset, erityisesti Safarin
3. **Välimuistiongelmat** – Tyhjennä selaimen välimuisti ja yritä uudelleen

Katso: [Istunto on vanhentunut](https://help.sesami.co/fi/aloita/onboarding/troubleshooting/session-expired.md) | [Safarin evästeet](https://help.sesami.co/fi/aloita/onboarding/troubleshooting/safari-cookies.md) | [Virheellinen linkki -virhe](https://help.sesami.co/fi/aloita/onboarding/troubleshooting/as-a-customer-why-am-i-seeing-an-invalid-link-error-page.md)

</details>

***

## Seuraavat vaiheet

Kun perusvaraustoiminnot ovat käytössä, harkitse seuraavia ominaisuuksia:

* [**Sähköposti-ilmoitukset**](https://help.sesami.co/fi/ilmoitukset/notification-emails.md) – Ota käyttöön vahvistus- ja muistutussähköpostit
* [**Google Kalenterin synkronointi**](https://help.sesami.co/fi/apps-integrations/google-calendar.md) – Kaksisuuntainen synkronointi tiimin jäsenten kalentereiden kanssa
* [**Asiakkaan tekemä ajanvarauksen muutos**](https://help.sesami.co/fi/varaus/booking-features/cancellations-rescheduling.md) – Salli asiakkaiden muuttaa tai peruuttaa varauksensa
* [**Ryhmäajanvaraukset**](https://help.sesami.co/fi/varaus/booking-features/group-appointments.md) – Salli useat varaukset samalle aikavälille
* [**Ennakkomaksut**](https://help.sesami.co/fi/maksut/deposits.md) – Kerää osa maksusta varauksen yhteydessä
* [**Myyntipiste**](https://help.sesami.co/fi/apps-integrations/shopify/pos.md) – Ota varauksia vastaan paikan päällä

***

## Tarvitsetko apua?

* [**Maksuton perehdytyspuhelu**](https://help.sesami.co/fi/aloita/onboarding/onboarding-call.md) - Varaa tapaaminen asiakastukitiimimme kanssa
* [**Avaimet käteen -asennuspalvelu**](https://help.sesami.co/fi/aloita/onboarding/white-glove-setup.md) - Saat ammattilaisen apua teeman integrointiin ja käyttöönottoon
* [**Asiantuntijapalvelut**](https://help.sesami.co/fi/aloita/onboarding/professional-services.md) - Räätälöity kehitys yksilöllisiin tarpeisiin
* [**Tuki**](mailto:help@sesami.co) - Pyydä apua sähköpostitse osoitteesta <help@sesami.co>

## Aiheeseen liittyvää

* [Resurssiopas](https://help.sesami.co/fi/yllapito/resources.md) - Resurssien yksityiskohtainen määritys
* [Saatavuuden määritys](https://help.sesami.co/fi/varaus/availability/resource-availability.md) - Edistyneet saatavuusasetukset
* [Sesamin hallintaportaali](https://help.sesami.co/fi/yllapito/sesami-admin-portal.md) - Yleiskatsaus hallintakäyttöliittymään
* [Palveluiden määritys](https://help.sesami.co/fi/yllapito/services.md) - Palveluiden lisäasetukset


---

# 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/aloita/quickstart.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.
