Uttrykk

Boten støtter for øyeblikket to typer uttrykk:

• Smoc-uttrykk: Brukes i beslutningselementer for å avgjøre hvor man skal gå videre. Smoc-uttrykk returnerer alltid tall.
• ICU-uttrykk: Brukes i meldinger (tekst, knapper, osv.) for dynamisk innhold. ICU-uttrykk returnerer alltid strenger.

Smoc-uttrykk i beslutningselementer

Når Smoc bot-motoren skal avgjøre hvilken kant den skal følge videre,
bruke den Smoc-uttrykk for å tildele en numerisk score til hver mulig kant.

Deretter velges en kant å følge:

• Hvis ingen kanter har en positiv score, følges ingen kant.
  • VIKTIG: Legg alltid til en standardkant med score 0.5 for å sikre at boten ikke setter seg fast.
• Hvis én kant har høyere score enn alle andre, vil den følges.
• Hvis flere kanter har høyest score, velges en tilfeldig blant dem.

Smoc-uttrykk er infix aritmetiske uttrykk.

Gyldige operatorer er +, -, * og /. Du kan også bruke ( og ) for å gruppere sub-uttrykk.

Hver operand er enten et tall eller en variabel. De fleste variabler forventer et ikke-sensitivt argument etter =-tegnet.

For eksempel:

2 * ${answer=34}

I dette eksempelet er den første operanden 2 (et tall), og den andre operanden er ${answer=34} (en variabel).

En variabel evalueres til enten 0 eller 1. Variabelen ${answer=34} vil evalueres til 1 kun hvis besøkende
har gitt et svar på et undersøkelsesspørsmål med id 34.

Det finnes mange Smoc-uttrykk-variabler å velge mellom, og de fleste representerer fakta vi vet om besøkende før
de har begynt å samhandle med boten (som geolokasjon, enhetstype, utm_-variabler osv).

ICU-uttrykk i meldinger

ICU-uttrykk brukes til å formatere meldinger. De kan referere til kontekstvariabler fra den pågående samtalen.

For eksempel:

Hello from {country_name}!

Hvis variabelen country_name er "Norway", vil meldingen bli formatert slik:

Hello from Norway!

ICU-uttrykk støtter også å vise forskjellig tekst basert på verdien til en variabel:

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

I dette eksempelet, hvis variabelen country_name er "Norway", vil meldingen bli formatert som Hello from Norway!. Ellers vil den bli formatert som Hello from another country!.

Fallback for kontaktfelt hører hjemme i melding ICU, ikke i ${…=} beslutningsuttrykk. Manglende {linkedin_company} eller {company} blir en tom streng med mindre du skriver {linkedin_company, fallback, company {your team}}. Disse to feltene er forskjellige: LinkedIn-profilfirma vs. kontaktpost-firma.

Disse uttrykkene kan lenkes sammen for å lage dynamiske meldinger basert på flere variabler:

Ta følgende prismodell:

Hvor er du fra?	Er du student?	Pris
Norge	Ja	100
Norge	Nei	200
Sverige	Ja	300
Sverige	Nei	400
annet	annet	500

Det tilsvarende ICU-uttrykket vil være:

{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}
}

Hvis brukeren har svart på disse spørsmålene i flyten, vil meldingen bli formatert med riktig pris.

Akkurat som smoc-uttrykk, må spørsmål og svar være id til spørsmålet / svaret:

question_1	question_2	Pris
answer_3	answer_5	100
answer_3	answer_6	200
answer_4	answer_5	300
answer_4	answer_6	400
annet	annet	500

Det tilsvarende ICU-uttrykket vil være:

{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}
}

Verktøy

Å lage ICU-uttrykk kan være litt vanskelig, så det anbefales å bruke verktøy for å lage dem:

• ChatGPT er veldig flink til å lage ICU-uttrykk fra tabeller

• Når du har en ICU-mal kan du teste den med dette verktøyet

Variabler

Tabellen under viser alle tilgjengelige Smoc-uttrykk-variabler.

Navn	Eksempel på Smoc-uttrykk	Eksempel på ICU-uttrykk	Beskrivelse
accept_language	${accept_language=some_accept_language}	{accept_language}	En streng
browser	${browser=115}	{browser}	Nettleser-identifikator. Se full liste for alle støttede verdier (100+ alternativer)
city	${city=some_city}	{city}	En streng
conversation_url	${conversation_url=some_conversation_url}	{conversation_url}	En streng
country_name	${country_name=some_country_name}	{country_name}	En streng
device_type	${device_type=console}	{device_type}	Enhetstype. Se full liste for alle støttede verdier
lang	${lang=da-DK}	{lang}	Språkkode. Se full liste for alle støttede verdier
os	${os=AIX}	{os}	Operativsystem. Se full liste for alle støttede verdier (100+ alternativer)
os_version	${os_version=some_os_version}	{os_version}	En streng
referrer	${referrer=some_referrer}	{referrer}	En streng
referring_domain	${referring_domain=some_referring_domain}	{referring_domain}	En streng
region	${region=some_region}	{region}	En streng
user_agent	${user_agent=some_user_agent}	{user_agent}	En streng
utm_campaign	${utm_campaign=some_utm_campaign}	{utm_campaign}	En streng
utm_content	${utm_content=some_utm_content}	{utm_content}	En streng
utm_medium	${utm_medium=some_utm_medium}	{utm_medium}	En streng
utm_source	${utm_source=some_utm_source}	{utm_source}	En streng
utm_term	${utm_term=some_utm_term}	{utm_term}	En streng

---

Nettleserverdier

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

Enhetstype-verdier

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

Språkverdier

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

Operativsystem-verdier

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