Udtryk

Botten understøtter i øjeblikket to typer udtryk:

• Smoc-udtryk: Bruges i beslutningselementer til at afgøre, hvor der skal gås hen næste gang. Smoc-udtryk returnerer altid tal.
• ICU-udtryk: Bruges i beskeder (tekst, knapper osv.) til dynamisk indhold. ICU-udtryk returnerer altid strenge.

Smoc-udtryk i beslutningselementer

Når Smoc bot-motoren skal beslutte, hvilken kant der skal følges næste gang,
bruger den Smoc-udtryk til at tildele en numerisk score til hver mulig kant.

Derefter vælger den en kant at følge:

• Hvis ingen kanter har en positiv score, følges ingen kant.
  • VIGTIGT: Tilføj altid en standardkant med en score på 0.5 for at sikre, at botten ikke går i stå.
• Hvis én kant har en højere score end alle andre kanter, følges den.
• Hvis flere kanter har den højeste score, vælges en tilfældig blandt dem.

Smoc-udtryk er infix aritmetiske udtryk.

Gyldige operatorer er +, -, * og /. Du kan også bruge ( og ) til at gruppere underudtryk.

Hver operand er enten et tal eller en variabel. De fleste variable forventer et ikke-følsomt argument efter = tegnet.

For eksempel:

2 * ${answer=34}

I dette eksempel er den første operand 2 (et tal), og den anden operand er ${answer=34} (en variabel).

En variabel evalueres til enten 0 eller 1. Variablen ${answer=34} evalueres til 1 kun hvis besøgende
har givet et svar på et spørgeskema med id 34.

Der er mange Smoc-udtryksvariable at vælge imellem, og de fleste af dem repræsenterer fakta, vi kender om den besøgende, før
de er begyndt at interagere med botten (såsom geolokation, enhedstype, utm_ variable osv).

ICU-udtryk i beskeder

ICU-udtryk bruges til at formatere beskeder. De kan referere til kontekstvariable fra den igangværende samtale.

For eksempel:

Hello from {country_name}!

Hvis variablen country_name er "Norway", vil beskeden blive formateret sådan her:

Hello from Norway!

ICU-udtryk understøtter også visning af forskellig tekst baseret på værdien af en variabel:

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

I dette eksempel, hvis variablen country_name er "Norway", vil beskeden blive formateret som Hello from Norway!. Ellers vil den blive formateret som Hello from another country!.

Fallbacks for kontaktfelter hører hjemme i besked ICU, ikke i ${…=} beslutningsudtryk. Manglende {linkedin_company} eller {company} bliver til en tom streng, medmindre du skriver {linkedin_company, fallback, company {your team}}. De to felter er forskellige: LinkedIn profilfirma vs kontaktpost-firma.

Disse udtryk kan kædes sammen for at skabe dynamiske beskeder baseret på flere variable:

Tag følgende prismodel:

Hvor kommer du fra?	Er du studerende?	Pris
Norge	Ja	100
Norge	Nej	200
Sverige	Ja	300
Sverige	Nej	400
andet	andet	500

Det tilsvarende ICU-udtryk ville 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 brugeren har besvaret disse spørgsmål i flowet, vil beskeden blive formateret med den korrekte pris.

Ligesom smoc-udtryk skal spørgsmål og svar være id på spørgsmå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
andet	andet	500

Det tilsvarende ICU-udtryk ville 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}
}

Værktøjer

Det kan være lidt tricky at lave ICU-udtryk, så det anbefales at bruge værktøjer til at lave dem:

• ChatGPT er meget dygtig til at lave ICU-udtryk ud fra tabeller

• Når du har en ICU-skabelon, kan du teste den med dette værktøj

Variable

Tabellen nedenfor viser alle tilgængelige Smoc-udtryksvariable.

Navn	Smoc-udtrykseksempel	ICU-udtrykseksempel	Beskrivelse
accept_language	${accept_language=some_accept_language}	{accept_language}	En streng
browser	${browser=115}	{browser}	Browser-identifikator. Se fuld liste for alle understøttede værdier (100+ muligheder)
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}	Enhedstype. Se fuld liste for alle understøttede værdier
lang	${lang=da-DK}	{lang}	Sprogkode. Se fuld liste for alle understøttede værdier
os	${os=AIX}	{os}	Operativsystem. Se fuld liste for alle understøttede værdier (100+ muligheder)
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

---

Browser-værdier

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

Enhedstype-værdier

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

Sprog-værdier

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

Operativsystem-værdier

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