Script block

​

Execution modes

• Execute on client enabled: runs in the visitor browser and can access browser APIs such as window and document. This mode is available in Web Chat and preview.
• Execute on client disabled: runs in the isolated QuickJS server sandbox.
• Channels without a browser runtime, such as WhatsApp, Instagram, Facebook, Telegram and Gmail, automatically use the server sandbox even when client execution is selected.

​

Variables

// ✅ Evaluates the variable value
console.log({{My variable}})

// ❌ Produces text containing the internal variable reference
console.log("{{My variable}}")

​

setVariable function

if ({{My variable}} === "foo") {
  setVariable("My variable", "bar")
} else {
  setVariable("My variable", "other")
}

​

Server sandbox limitations

• console.log, console.info, console.warn and console.error are captured and shown in the Studio preview logs.
• setTimeout and setInterval are not available.
• import and require are not available.
• Browser APIs such as window, document and localStorage are not available.
• Direct fetch() is intentionally disabled to prevent server-side request forgery and access to internal infrastructure. Use the HTTP Request block for external requests.
• Scripts exceeding the configured timeout, memory, input or output limits fail with a detailed error in the Studio preview.

​

Examples

​

Calculate and save a value on every channel

const total = Number({{Price}}) * Number({{Quantity}})
setVariable("Total", total)
return total

​

Reload the Web Chat page

window.location.reload()

​

Redirect in Web Chat based on a variable

if ({{Category}} === "qualified") {
  window.location.href = "https://my-site.com"
}