Home
  • 😃Welcome to Cataleya
  • Cataleya Basics
  • 🏁Getting Started
    • Building a Chatbot
    • Testing a Chatbot
    • Installation
      • Installation on Website
        • Installation using HTML
        • Installation using Google Tag Manager
      • Installing on Wordpress
      • Installing on SquareSpace
      • Installation on WhatsApp
      • Installation on Facebook
      • Installation on SMS
    • Deploying a Chatbot
    • Utility Tools
  • ⏹️Action Blocks
    • Overview
    • Trigger
      • Set values to variables using Trigger
    • Send Message
    • Collect Input
    • Buttons
    • Carousel
    • Calendar
    • Send an Email
    • Branch
    • Image Carousel
    • Human Handover
    • Slider
    • File Upload
    • Delay
    • Form
    • Flow
    • Jump
    • Codeblock
      • Dynamic Dialog Generator
    • Options
    • List
    • Reply Buttons
    • AI Model
  • 🤖AI Studio
    • Overview
      • From URL
      • From File
      • From Intent
  • 🔗Integrations
    • Overview
    • Service Call
    • Javascript
    • Zapier
    • Code block
    • Google Calendar
    • Calendly
    • HubSpot
    • DialogFlow
    • Link Tracking
  • ✉️Live Chat
    • Overview
      • Live Chat Screen
      • Live Chat Settings
  • 🛠️Troubleshooting
    • Cloning Bots
    • Connecting Action Blocks
    • Creating Loops
    • Setting Up Fallback Variables
    • Setting Up Link Tracking
    • Variable Manager
    • Image Dimensions
  • 📣Outbound Bots
    • Overview
    • Building One Off Campaign
    • Building Ongoing Campaign
    • Creating a WhatsApp Template
    • Action Blocks: Outbound
      • Send WhatsApp
      • Send SMS
      • Delay
      • Branch
  • 🎨Chatbot Customisation
    • Chatbot Appearance
    • Custom CSS
    • Embed bots in iFrame
    • Embedding the Chatbot
    • JS functions to show/hide
  • 👜Account Management
    • Teams
    • Teammates
    • Purchasing a plan
    • Payment Methods
    • Refund Policy
    • Reset Password
    • Deleting Account
  • ⏺️Reporting
    • Analytics Dashboard
    • Custom Reports
    • What are contacts in Cataleya?
    • Scheduling a Contact Report
    • Exporting a Contact List
    • What are weekly reports?
      • What are weekly reports?
Powered by GitBook
On this page
  • Via Query Params
  • Storing values for a WhatsApp chatbot
  • Injecting JSON in the code snippet
  1. Action Blocks
  2. Trigger

Set values to variables using Trigger

Want to personalise the chat or capture the details about the visitor even before the chat is initiated? This is now possible with Cataleya by injecting custom variables using Trigger Block

PreviousTriggerNextSend Message

Last updated 1 year ago

Want to personalize chat or capture details about the visitor even before the chat is initiated? This is possible with Cataleya where it allows you to inject custom variables from outside using the Trigger action block even before the chat is initiated.

The values can be anything like sending and storing the details like name of the visitor, utm parameters of where the visitor is coming from can be captured and mapped with the variables.

The values stored in these defined variables, and can later be used at any given point of time in the flow of the chat.

There are two methods in Cataleya that a user can follow to parse the information into variables. They are:

Via Query Params

Using this method, you will be able to send Query Params on the domain in which the bot is hosted & you will be able to map those params in the ‘Trigger’ action block with a variable name.

For example, www.cataleya.com

Let’s say I want to store the value of utm_source and utm_medium, I can simply map these names in the 'Object path/parameter' column.

And choose the variables in which this value is to be stored.

You can add a maximum of 15 entries

Storing values for a WhatsApp chatbot

While using this section for a WhatsApp chatbot, you can store the payload received from the WhatsApp Business API provider.

This is helpful if you want to branch out the conversation flow based on button/text inputs from an outbound message sent.

Provider
Button input
Text input

Meta

360Dialog

messages[0].button.text

messages[0].text.body

Twilio

payload.Body

payload.Body

GupShup

result.payload.payload.text

Injecting JSON in the code snippet

Using this method the user will be able to inject a JSON payload inside Cataleya ’s code snippet. And using the trigger action block the user will be able to map the object path with a variable.

For example,

<script src="" data-session-payload={"name": "Charles", "phone": "8164848686"} defer></script>

In addition to the code snippet, we have added a data-session-payload section. Adding this section with a JSON payload allows Cataleya to read these values and store them in variables.

In the above example, we have passed the values of “name” and “phone”, so now to store these values, we will map these fields on the Trigger action block.

It is essential to dynamically add this data-session-payload on Cataleya’s code snippet before the code snippet is fired, because Cataleya only reads this data once.

To read the data again, visitors would have to refresh the page and start conversing with the bot again.

⏹️
entry[0].changes[0].value.messages[0].button.payload
entry[0].changes[0].value.messages[0].text.body