Lausekkeet

Botti tukee tällä hetkellä kahta lauseketyyppiä:

• Smoc-lausekkeet: Käytetään päätöselementeissä päättämään, mihin siirrytään seuraavaksi. Smoc-lausekkeet palauttavat aina numeroita.
• ICU-lausekkeet: Käytetään viesteissä (teksti, painikkeet jne.) dynaamiseen sisältöön. ICU-lausekkeet palauttavat aina merkkijonoja.

Smoc-lausekkeet päätöselementeissä

Kun Smoc-bottimoottori tekee päätöksen siitä, mitä reunaa seurataan seuraavaksi,
se käyttää Smoc-lausekkeita antaakseen numeerisen pisteen jokaiselle mahdolliselle reunalle.

Tämän jälkeen valitaan seurattava reuna:

• Jos yhdelläkään reunalla ei ole positiivista pistettä, mitään reunaa ei seurata.
  • TÄRKEÄÄ: Lisää aina oletusreuna pisteellä 0.5, jotta botti ei jää jumiin.
• Jos yhdellä reunalla on korkeampi piste kuin muilla, sitä seurataan.
• Jos usealla reunalla on korkein piste, niistä valitaan satunnainen.

Smoc-lausekkeet ovat infix matemaattisia lausekkeita.

Sallitut operaattorit ovat +, -, * ja /. Voit myös käyttää ( ja ) ryhmitelläksesi alilausekkeita.

Jokainen operandi on joko numero tai muuttuja. Useimmat muuttujat odottavat kirjainkoon huomioimatonta argumenttia =-merkin jälkeen.

Esimerkiksi:

2 * ${answer=34}

Tässä esimerkissä ensimmäinen operandi on 2 (numero), ja toinen operandi on ${answer=34} (muuttuja).

Muuttuja palauttaa joko 0 tai 1. ${answer=34}-muuttuja palauttaa 1 vain jos vierailija
on antanut kyselykysymyksen vastauksen, jonka id on 34.

Valittavana on monia Smoc-lausekemuuttujia, ja useimmat niistä kuvaavat tietoja, jotka tiedämme vierailijasta ennen
kuin hän on aloittanut vuorovaikutuksen botin kanssa (esim. sijainti, laitetyyppi, utm_-muuttujat jne).

ICU-lausekkeet viesteissä

ICU-lausekkeita käytetään viestien muotoiluun. Ne voivat viitata keskustelun aikana käytettävissä oleviin kontekstimuuttujiin.

Esimerkiksi:

Hello from {country_name}!

Jos country_name-muuttuja on "Norway", viesti muotoillaan näin:

Hello from Norway!

ICU-lausekkeet tukevat myös eri tekstin näyttämistä muuttujan arvon perusteella:

{country_name,select,
  Norway {Hello from Norway!}
	other {Hello from another country!}
}

Tässä esimerkissä, jos country_name-muuttuja on "Norway", viesti muotoillaan muodossa Hello from Norway!. Muussa tapauksessa se muotoillaan muodossa Hello from another country!.

Yhteystietokenttien varat kuuluvat viestin ICU-lausekkeisiin, eivät ${…=}-päätöslausekkeisiin. Puuttuva {linkedin_company} tai {company} muuttuu tyhjäksi merkkijonoksi, ellet kirjoita {linkedin_company, fallback, company {your team}}. Nämä kaksi kenttää ovat eri asia: LinkedIn-profiilin yritys vs. yhteystietueen yritys.

Näitä lausekkeita voi ketjuttaa luodakseen dynaamisia viestejä useiden muuttujien perusteella:

Otetaan seuraava hinnoittelumalli:

Mistä olet kotoisin?	Oletko opiskelija?	Hinta
Norja	Kyllä	100
Norja	Ei	200
Ruotsi	Kyllä	300
Ruotsi	Ei	400
muu	muu	500

Vastaava ICU-lauseke olisi:

{country, select,
  Norway {
    {student, select,
      Yes {Your price is 100}
      No {Your price is 200}
      other {Your price is 500}
    }
  }
  Sweden {
    {student, select,
      Yes {Your price is 300}
      No {Your price is 400}
      other {Your price is 500}
    }
  }
  other {Your price is 500}
}

Jos käyttäjä on vastannut näihin kysymyksiin virrassa, viesti muotoillaan oikealla hinnalla.

Kuten smoc-lausekkeissa, kysymysten ja vastausten tulee olla kysymyksen / vastauksen id:

question_1	question_2	Hinta
answer_3	answer_5	100
answer_3	answer_6	200
answer_4	answer_5	300
answer_4	answer_6	400
muu	muu	500

Vastaava ICU-lauseke olisi:

{question_1, select,
  answer_3 {
    {question_2, select,
      answer_5 {Your price is 100}
      answer_6 {Your price is 200}
      other {Your price is 500}
    }
  }
  answer_4 {
    {question_2, select,
      answer_5 {Your price is 300}
      answer_6 {Your price is 400}
      other {Your price is 500}
    }
  }
  other {Your price is 500}
}

Työkalut

ICU-lausekkeiden luominen voi olla hieman hankalaa, joten työkalujen käyttö on suositeltavaa:

• ChatGPT on erittäin taitava luomaan ICU-lausekkeita taulukoista

• Kun sinulla on ICU-malli, voit testata sitä tällä työkalulla

Muuttujat

Alla olevassa taulukossa on listattu kaikki käytettävissä olevat Smoc-lausekemuuttujat.

Nimi	Smoc-lausekkeen esimerkki	ICU-lausekkeen esimerkki	Kuvaus
accept_language	${accept_language=some_accept_language}	{accept_language}	Merkkijono
browser	${browser=115}	{browser}	Selain-tunniste. Katso täydellinen lista kaikista tuetuista arvoista (yli 100 vaihtoehtoa)
city	${city=some_city}	{city}	Merkkijono
conversation_url	${conversation_url=some_conversation_url}	{conversation_url}	Merkkijono
country_name	${country_name=some_country_name}	{country_name}	Merkkijono
device_type	${device_type=console}	{device_type}	Laitetyyppi. Katso täydellinen lista kaikista tuetuista arvoista
lang	${lang=da-DK}	{lang}	Kielikoodi. Katso täydellinen lista kaikista tuetuista arvoista
os	${os=AIX}	{os}	Käyttöjärjestelmä. Katso täydellinen lista kaikista tuetuista arvoista (yli 100 vaihtoehtoa)
os_version	${os_version=some_os_version}	{os_version}	Merkkijono
referrer	${referrer=some_referrer}	{referrer}	Merkkijono
referring_domain	${referring_domain=some_referring_domain}	{referring_domain}	Merkkijono
region	${region=some_region}	{region}	Merkkijono
user_agent	${user_agent=some_user_agent}	{user_agent}	Merkkijono
utm_campaign	${utm_campaign=some_utm_campaign}	{utm_campaign}	Merkkijono
utm_content	${utm_content=some_utm_content}	{utm_content}	Merkkijono
utm_medium	${utm_medium=some_utm_medium}	{utm_medium}	Merkkijono
utm_source	${utm_source=some_utm_source}	{utm_source}	Merkkijono
utm_term	${utm_term=some_utm_term}	{utm_term}	Merkkijono

---

Selaimen arvot

115 / 2345 / 360 / Alipay / Amaya / Android Browser / Arora / Avant / Avast Secure Browser / AVG Secure Browser / Baidu Browser / Basilisk / Blazer / Bolt / Bowser / Brave / Camino / Chimera / Chrome / Chrome Headless / Chrome WebView / Chromium / Cobalt / Coc Coc / Conkeror / Dillo / Dolphin / Doris / Dragon / DuckDuckGo / Edge / Epiphany / Facebook / Falkon / Fennec / Firebird / Firefox / Firefox Focus / Firefox Reality / Flock / Flow / GoBrowser / GSA / Helio / HeyTap / Honor / Huawei Browser / iCab / ICE Browser / IceApe / IceCat / IceDragon / IceWeasel / IE / Instagram / Iridium / Iron / Jasmine / K-Meleon / KakaoTalk / KHTML / Kindle / Klar / Klarna / Konqueror / LBBROWSER / LibreWolf / Line / LinkedIn / Links / Lunascape / Lynx / Maemo Browser / Maxthon / Midori / Minimo / MIUI Browser / Mobile Chrome / Mobile Firefox / Mobile Safari / Mosaic / Mozilla / Naver / NetFront / Netscape / Netsurf / Nokia Browser / Obigo / Oculus Browser / OmniWeb / Opera / Opera Coast / Opera Mini / Opera Mobi / Opera Tablet / Opera Touch / OviBrowser / PaleMoon / PhantomJS / Phoenix / Pico Browser / Polaris / Puffin / QQBrowser / QQBrowserLite / Quark / QupZilla / rekonq / Rockmelt / Safari / Sailfish Browser / Samsung Internet / SeaMonkey / Silk / Skyfire / Sleipnir / SlimBoat / SlimBrowser / Slimjet / Smart Lenovo Browser / Snapchat / Sogou Explorer / Sogou Mobile / Swiftfox / Tesla / TikTok / Tizen Browser / Twitter / UCBrowser / UP.Browser / Vivaldi / Vivo Browser / w3m / Waterfox / WebKit / WeChat / Weibo / Whale / Wolvic / Yandex

Laitetyypin arvot

console / desktop / embedded / mobile / smarttv / tablet / wearable / xr

Kielen arvot

da-DK / en-GB / es-ES / fi-FI / nb-NO / sv-SE

Käyttöjärjestelmän arvot

AIX / Amiga OS / Android / Android-x86 / Arch / Bada / BeOS / BlackBerry / CentOS / Chrome OS / Chromecast / Chromecast Android / Chromecast Fuchsia / Chromecast Linux / Chromecast SmartSpeaker / Contiki / Debian / Deepin / DragonFly / elementary OS / Fedora / Firefox OS / FreeBSD / Fuchsia / Gentoo / GhostBSD / GNU / Haiku / HarmonyOS / HP-UX / Hurd / iOS / Joli / KaiOS / Linpus / Linspire / Linux / macOS / Maemo / Mageia / Mandriva / Manjaro / MeeGo / Minix / Mint / Morph OS / NetBSD / NetRange / NetTV / Nintendo / OpenBSD / OpenHarmony / OpenVMS / OS/2 / Palm / PC-BSD / PCLinuxOS / Pico / Plan9 / PlayStation / QNX / Raspbian / RedHat / RIM Tablet OS / RISC OS / Sabayon / Sailfish / SerenityOS / Series40 / Slackware / Solaris / SUSE / Symbian / Tizen / Ubuntu / Unix / VectorLinux / watchOS / WebOS / Windows / Windows Mobile / Windows Phone / Xbox / Zenwalk