Message
    • 19 Dec 2024
    • 5 Minutes to read
    • Dark
      Light
    • PDF

    Message

    • Dark
      Light
    • PDF

    Article summary

    Who should read this article: Administrators

    The Message node allows you to send automated messages to inbound digital channel interactions.

    Introduction

    Use the Message node to send automated messages to contacts during an inbound digital channels flow. You can specify that the node must wait for the contact to respond before moving to the next node. You can also set a timer to automatically progress to the next node if the contact does not respond.

    Your message body may include variables so that you can personalize the message.

    You can save the contact's response to a variable. This is useful for capturing information such as phone numbers, account numbers, and so on, then passing it to a Conditions or HTTP request node for further processing.

    The following digital channels are supported by the Message node:

    • Facebook
    • Instagram
    • Telegram
    • Viber
    • WebChat
    • WhatsApp

    Connections

    The Message node supports unlimited input connections and up to 2 output connections.

    Use Case: Chatbot

    You can use the Message node to build a self-service chatbot for your contact center. For example, you can use a HTTP Request node to obtain various data from one or more web services, then pass the data as variables to the Message node to create a personalized message and send it to the contact.

    The Message node can save contact responses in custom variables which can be used for conditional routing using the Conditions node or to retrieve data from a web service using the HTTP request node.

    Using the Message node

    To add a Message node to your interaction flow, click the Message icon:

    Flow Builder Digital Message Node

    The Message node allows an unlimited number of input connections and up to two output connections. To make an input connection, drag a link to the Message node from any node supporting an output connection. To make an output connection, drag a link from the Message node to any node supporting an input connection.

    Flow Builder Digital Message Node Making Connections

    The Message node has two output connections: Contact response and Next step (or Next step (x)).

    At least one of these connections must be set. These connections represent one of the possible outcomes for the node. Refer to the sections below for the details of these connections.

    By default, only the Next step connection is required. The other connections are added if you request a contact response or set a timeout.

    Contact response

    If the Contact response option is specified in the Message configuration panel, the Contact response connection is added to the node.

    If the contact responds to the message, the interaction is routed through this connection. If you specify a variable name in the Save to variable menu, the contact's response is saved to the variable and is available for processing by other nodes such as HTTP request and Conditions.

    Next step

    By default, the interaction is routed through the Next step connection unless you specify that a contact response is required.

    The Next step (x) connection replaces this connection if a wait time is set.

    Next step (x)

    The Next step (x) connection replaces the Next step connection when a timeout is set in the Waiting time section.

    "X" refers to the specified timeout value, rounded to the nearest hour, minute, or second. For example, a 10 second timeout changes the connection to Next step (10 sec).

    Variables

    The Message node supports system and custom variables that you can use when building requests and when passing data to the next node.

    System variables

    System variables can be used in the message text or the validation error response.

    The following system (global) variables are available for digital interactions:

    VariableDescriptionExample
    {{from}}A string containing the user's ID for the digital channel.55555555555
    {{to}}A string containing the ID of the channel to which the user sent an interaction.55555555555
    {{start_time}}The time the interaction started.2023-08-21T04:02:18Z
    {{uuid}}A string containing the UUID of the interaction.07771c38-c159-4965-a878-be0162118b2b

    Custom variables

    You can include dynamic content in your messages by leveraging custom variables in the Text field. Click "{ }" to display the Variables menu or manually enter a variable by typing its name enclosed in double brace brackets like this: {{variableName}}.

    The Message node enables you to define and use custom variables to store data from the contact's response.

    Flow Builder Digital Message Node Custom Variables

    Passing data to other nodes

    You can reference the custom variable from a Message node in the following nodes:

    Configuring the Message node

    To configure a Message node in your interaction flow, click the Message node to display the Message node panel. The panel includes three sections:

    Message content section

    Use the Text field of the Message content section to compose the message to be sent to contacts. Your message can include emojis and custom and system variables. Your message may be up to 1024 characters in length.

    Flow Builder Digital Message Node Message Content Section

    Contact response section

    Use the Contact response section to wait for the contact to enter a response to the message and then route the interaction to the Contact response connection.

    Flow Builder Digital Message Node Contact Response Section

    You may optionally save the contact's response in a custom variable. Select an existing custom variable from the Save to variable menu or click "+" to create a new one.

    If you choose to save the contact's response, be sure to include a message in the Validation error response field that guides the contact on how to format their answer correctly, according to the data type of the variable. You can enhance this message by adding emojis and using custom or system variables. Your validation text may be up to 1024 characters in length.

    The following table provides a description of each data type supported for custom variables.

    TypeDescriptionExample
    StringMaximum string length is 4096 characters. Used for storing names, URLs, and other text-based information."Isabela GarcĂ­a" or "https://myservice.com/bal?q={{var}}"
    NumberAny numerical value up to 255 digits. Both integers and floating point numbers are supported."199.95" or "16"
    DatetimeA single date and time in the following format: YYYY-MM-DD HH:MM:SS"2024-04-17 13:45:30"

    Waiting time section

    Use the Timeout field in the Waiting time section to specify how long to wait until progressing to the next node.

    Flow Builder Digital Message Node Waiting Time Section

    If the Contact response section is turned on, the node will either route the interaction by the Contact response connection if the contact responds to the message, or by the Next step (x) connection when the timeout expires, whichever occurs first.

    Flow Builder Digital Message Node Contact Response And Next X Connection

    "X" refers to the specified timeout value, rounded to the nearest hour, minute, or second. For example, a 10 second timeout changes the connection to Next step (10 sec).

    If the Contact response section is enabled, the node will route the interaction when the contact responds. If the contact replies before the timeout, the interaction will follow the Contact response connection. If the timeout expires first, the interaction will be routed to the Next step (x) connection.

    You may specify timeout values between 00:00:00 and 23:59:59. If no value is specified, the timeout is 24:00:00 by default.


    Was this article helpful?