All Products
Search
Document Center

Chat App Message Service:Chat Flow nodes

Last Updated:Sep 14, 2024

A node is the smallest unit in a chat flow. You can add multiple nodes and configure the nodes to create an automated chat flow. This topic describes Chat Flow nodes and node configurations.

Node description

The Configuration description column in the following table offers a brief overview of node configurations. For more information about the node configurations, see the topics provided in the References column.

Node icon

Node name

Node description

Configuration description

References

image

Trigger

Triggers a chat flow. Different trigger methods require different configurations.

  • TriggeredByWhatsApp: You need to bind an approved phone number within your WhatsApp Business Account (WABA) to the trigger node. After the binding is complete, the chat flow is triggered when the phone number receives a mobile originated (MO) message from a user.

  • TriggeredManually: No additional configuration is required.

Configure the trigger node

image

Send a Viber Message

Sends Viber Business Messages. Users can use specific Viber features to reply to such messages.

Valid value of the Action parameter: From/To.

Valid values of the Send Message Type parameter:

  • Transaction

  • Promotion

Note

From/To indicates that the message sender and recipient are fixed. You can select a channel or variable to specify the sender, and enter a phone number or select a variable to specify the recipient.

Configure the Send a Viber Message node

image

Send an SMS Message

Sends messages.

After you enter a sender ID, you can specify the message content type. Valid values of the Content Type parameter:

  • Verification

  • Notification

  • Marketing

Configure the Send an SMS Message node

image

Send a WhatsApp Message

Sends WhatsApp messages. Users can use specific WhatsApp features to reply to such messages.

Valid values of the Action parameter:

  • From/To

  • Reply Back

Valid values of the Message Type parameter:

  • Text: Variables are supported.

  • Media: You can send images, audio, videos, files, and locations. Variables are supported.

  • Interactive: Interactive messages contain buttons or lists. Variables are supported.

  • Product: Single-product messages and multi-product messages are supported. Variables are supported.

  • Template: You can send WhatsApp template messages. The template that you select must be approved.

Configure the Send a WhatsApp Message node

image

Wait for a WhatsApp Response

Waits for a WhatsApp message response from a user.

  • Duration: Specify a custom wait time.

You can turn on Add expired case and then specify different actions in cases of receiving a reply and not receiving a reply after the wait time expires.

Configure the Wait for a WhatsApp Response node

image

HTTP Request

Sends an HTTP request to the specified URL.

Valid values of the Request Method parameter:

  • GET

  • POST

You can turn on Failure Branch and then specify different actions for request success and request failure scenarios.

Configure the HTTP Request node

image

Set Variables

Sets custom variables for reference in subsequent steps.

-

Configure the Set Variables node

image

Jump to Another Step

Jumps to any other step in the chat flow.

You can specify the node to jump to and the maximum number of jumps. When the chat flow reaches this step, the chat flow automatically jumps to the specified node. After the maximum number of jumps is reached, the chat flow proceeds to the next step, instead of jumping to the specified node.

Configure the Jump to Another Step node

image

Wait

Waits for a period of time.

You can specify a wait time. The chat flow proceeds to the next step when the wait time is reached.

Configure the Wait node

image

Branching by Conditions

Adds multiple branches based on conditions. This allows different actions to be performed based on specified condition rules.

You can add rules or rule groups for branches to determine which branch to enter based on specified condition rules.

  • And: The chat flow enters a branch when all rules for the branch are met.

  • Or: The chat flow enters a branch when one of the rules for the branch is met.

Supported variables:

  • incomingMessage: the MO message from a user.

  • wabaId: the ID of a WABA. You can obtain the WABA ID on the WhatsApp channel details page.

  • wabaPhoneNumber: the phone number added to a WABA. The phone number is used to send messages to users.

  • customerPhoneNumber: the phone number of a user.

  • customerName: the name of a user.

Supported condition operators:

  • dateEquals

  • dateGreaterThan

  • dateLessThan

  • numberEquals

  • numberGreaterThan

  • numberLessThan

  • stringContains

  • stringEquals

  • stringStartsWith

  • stringlsBlank

  • stringlsNotBlank

  • stringEntireMatchesRegex

  • stringAnyMatchesRegex

Configure the Branching by Conditions node

image

Branching by Date/Time

Adds multiple branches based on time. The chat flow enters different branches based on time conditions.

You can specify a time condition by date, time range, and day of the week. You can also specify a time zone.

Configure the Branching by Date/Time node

image

Recognize Entities in Text

Automatically identifies entities in text. The identified data can be reused in subsequent steps.

You can select a value from the Recognize Name drop-down list to specify the recognition text, and then configure the Variable and Entity parameters to specify the entity to be identified. Only phone numbers and email addresses can be identified.

Configure the Recognize Entities in Text node

image

Recognize Language from Text

Identifies the language of a message and converts the language into a variable for reference in subsequent steps.

This node can automatically identify the languages of the MO messages from users and convert the languages into variables.

Configure the Recognize Language from Text node

image

Call a Function

Invokes the custom function that you create in Function Compute. This node allows you to implement custom business logic in the chat flow, such as data processing, remote service calls, message delivery, and data storage.

Before you use this node, you must activate Function Compute and create and design a custom function in the Function Compute console.

Configure the Call a Function node

image

Recognize a Phone Number

Identifies the calling code of a phone number written in international format or the two-letter country or region code defined by the International Organization for Standardization (ISO).

This node can convert the identified calling codes or two-letter country or region codes into variables for reference in subsequent steps. This node supports multiple branches with different configurations.

If the phone number is 8613012345678, the output calling code is 86 and the output two-letter country code is CN.

Configure the Recognize a Phone Number node

image

Sentiment/Topic Classification

Classifies text based on custom or preset sentiment or theme tags.

This node analyzes input variables or text, and determines which branch to enter based on custom or preset sentiment or theme tags. You can configure different sentiment or theme tags for different branches.

Configure the Sentiment/Topic Classification node

image

Subscribe to Group

Adds a user to a user group.

This node adds the phone number and name of a user to the specified user group.

Configure the Subscribe to Group node

image

Unsubscribe from Group

Removes a user from a user group.

This node removes a user from the specified user group.

Configure the Unsubscribe from Group node

image

End

Ends the chat flow.

In most cases, this node is added to end a single branch or a chat flow when no more actions need to be performed.

-