Expressions

Le bot prend actuellement en charge deux types d'expressions :

• Expressions Smoc : Utilisées dans les éléments de décision pour déterminer la prochaine étape. Les expressions Smoc renvoient toujours des nombres.
• Expressions ICU : Utilisées dans les messages (texte, boutons, etc.) pour du contenu dynamique. Les expressions ICU renvoient toujours des chaînes de caractères.

Expressions Smoc dans les éléments de décision

Lorsque le moteur du bot Smoc prend une décision sur l'arête à suivre,
il utilise les expressions Smoc pour attribuer un score numérique à chaque arête possible.

Il sélectionne ensuite une arête à suivre :

• Si aucune arête n'a un score positif, aucune arête n'est suivie.
  • IMPORTANT : Ajoutez toujours une arête par défaut avec un score de 0.5 pour éviter que le bot ne se bloque.
• Si une arête a un score supérieur à toutes les autres, elle sera suivie.
• Si plusieurs arêtes ont le score le plus élevé, l'une d'elles sera choisie au hasard.

Les expressions Smoc sont des expressions arithmétiques infixées.

Les opérateurs valides sont +, -, * et /. Vous pouvez également utiliser ( et ) pour regrouper des sous-expressions.

Chaque opérande est soit un nombre, soit une variable. La plupart des variables attendent un argument insensible à la casse après le signe =.

Par exemple :

2 * ${answer=34}

Dans cet exemple, le premier opérande est 2 (un nombre), et le second opérande est ${answer=34} (une variable).

Une variable est évaluée à 0 ou 1. La variable ${answer=34} sera évaluée à 1 uniquement si le visiteur
a répondu à une question d'enquête avec l'identifiant 34.

Il existe de nombreuses variables d'expression Smoc parmi lesquelles choisir, et la plupart représentent des informations que nous connaissons sur le visiteur avant
qu'il n'ait commencé à interagir avec le bot (comme la géolocalisation, le type d'appareil, les variables utm_, etc.).

Expressions ICU dans les messages

Les expressions ICU sont utilisées pour formater les messages. Elles peuvent référencer des variables de contexte issues de la conversation en cours.

Par exemple :

Hello from {country_name}!

Si la variable country_name est "Norway", le message sera formaté ainsi :

Hello from Norway!

Les expressions ICU permettent également d'afficher un texte différent selon la valeur d'une variable :

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

Dans cet exemple, si la variable country_name est "Norway", le message sera formaté comme Hello from Norway!. Sinon, il sera formaté comme Hello from another country!.

Les valeurs de secours des champs de contact doivent être placées dans les ICU de message, et non dans les expressions de décision ${…=}. L'absence de {linkedin_company} ou {company} devient une chaîne vide sauf si vous écrivez {linkedin_company, fallback, company {your team}}. Ces deux champs sont différents : entreprise du profil LinkedIn vs entreprise de la fiche contact.

Ces expressions peuvent être enchaînées pour créer des messages dynamiques basés sur plusieurs variables :

Prenons le modèle de tarification suivant :

D'où venez-vous ?	Êtes-vous étudiant ?	Prix
Norvège	Oui	100
Norvège	Non	200
Suède	Oui	300
Suède	Non	400
autre	autre	500

L'expression ICU correspondante serait :

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

Si l'utilisateur a répondu à ces questions dans le parcours, le message sera formaté avec le bon prix.

Comme pour les expressions smoc, les questions et réponses doivent être les id de la question / réponse :

question_1	question_2	Prix
answer_3	answer_5	100
answer_3	answer_6	200
answer_4	answer_5	300
answer_4	answer_6	400
autre	autre	500

L'expression ICU correspondante serait :

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

Outils

Créer des expressions ICU peut être un peu complexe, il est donc recommandé d'utiliser des outils :

• ChatGPT est très performant pour créer des expressions ICU à partir de tableaux

• Une fois que vous avez un modèle ICU, vous pouvez le tester avec cet outil

Variables

Le tableau ci-dessous liste toutes les variables d'expression Smoc disponibles.

Nom	Exemple d'expression Smoc	Exemple d'expression ICU	Description
accept_language	${accept_language=some_accept_language}	{accept_language}	Une chaîne de caractères
browser	${browser=115}	{browser}	Identifiant du navigateur. Voir liste complète pour toutes les valeurs prises en charge (100+ options)
city	${city=some_city}	{city}	Une chaîne de caractères
conversation_url	${conversation_url=some_conversation_url}	{conversation_url}	Une chaîne de caractères
country_name	${country_name=some_country_name}	{country_name}	Une chaîne de caractères
device_type	${device_type=console}	{device_type}	Type d'appareil. Voir liste complète pour toutes les valeurs prises en charge
lang	${lang=da-DK}	{lang}	Code langue. Voir liste complète pour toutes les valeurs prises en charge
os	${os=AIX}	{os}	Système d'exploitation. Voir liste complète pour toutes les valeurs prises en charge (100+ options)
os_version	${os_version=some_os_version}	{os_version}	Une chaîne de caractères
referrer	${referrer=some_referrer}	{referrer}	Une chaîne de caractères
referring_domain	${referring_domain=some_referring_domain}	{referring_domain}	Une chaîne de caractères
region	${region=some_region}	{region}	Une chaîne de caractères
user_agent	${user_agent=some_user_agent}	{user_agent}	Une chaîne de caractères
utm_campaign	${utm_campaign=some_utm_campaign}	{utm_campaign}	Une chaîne de caractères
utm_content	${utm_content=some_utm_content}	{utm_content}	Une chaîne de caractères
utm_medium	${utm_medium=some_utm_medium}	{utm_medium}	Une chaîne de caractères
utm_source	${utm_source=some_utm_source}	{utm_source}	Une chaîne de caractères
utm_term	${utm_term=some_utm_term}	{utm_term}	Une chaîne de caractères

---

Valeurs de navigateur

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

Valeurs de type d'appareil

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

Valeurs de langue

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

Valeurs de système d'exploitation

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