WhatsApp Chatbot Components Glossary
In this article, we’ll be exploring the main components of our WhatsApp chatbot builder to help you understand how each part contributes to the overall flow and functionality.
Table of Contents
Understanding Chatbot Components
- New message received
- User message text matches
- New order received
- New flow response
- New CTWA lead message
- Send Message
- Send message template
- Add/remove contact lists
- Add/remove contact tags
- Set Contact Attribute
- Wait for Some Time
- Send API Request
- Assign Team Member
Understanding Chatbot Components
To build a WhatsApp chatbot in WANotifier, you’ll be working with three types of components:
- Nodes: These are the building blocks of your bot’s logic and represent different actions or decisions that your bot can make.
- Edges: These are the connecting lines that you use to connect various nodes.
- Handles: These are the connection points where edges connect to nodes, determining the flow’s direction.
Now let’s go over the different Nodes you can use to assemble a chatbot.
Chatbot Nodes
There are five types of nodes in the chatbot builder:
- Start Node
- Trigger Nodes
- Action Nodes
- Conditional Nodes
- End Node
We’ll go over each one below, along with instructions on how to configure them.
1. Start Node
This marks the beginning of your chatbot flow. Every bot begins with a Start node, which is added by default and cannot be removed.
To begin creating a chatbot, you’ll first connect the Start node to a Trigger node.
2. Trigger Nodes
Trigger Nodes define how and when your chatbot should start interacting with a user. Note that you can only add one trigger node per bot.
Here are the available trigger node types:
1. New message received
This node triggers the bot when a user sends a new message to you outside of an active conversation window.
2. User message text matches
This node triggers the bot when the text in a user’s message or a clicked template button matches one of your configured trigger keywords or phrases.
To set this up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, enter the trigger words or phrases (e.g., “hello”, “hi”, etc.).
- Next, select a MESSAGE TEXT MATCH TYPE option. Choose Exact match if you want to trigger the bot only when the incoming message exactly matches one of your texts. Choose Phrase match if you want to trigger the bot when the incoming message contains one of your texts.
Click Save Changes when done.
3. New order received
This node triggers the bot when a new order is received from a user.
4. New flow response
This node triggers the bot when a user submits a response through one of your WhatsApp Flow forms.
5. New CTWA lead message
This node triggers the bot when a user messages you after clicking on your Click-to-WhatsApp ad.
Note that you can delete a trigger node by clicking the trash icon located at the top right of the node.
3. Action Nodes
These nodes perform specific actions such as sending messages, updating contact info, or making API requests. You can add multiple action nodes to a chatbot flow.
Here’s a list of available Action node types:
1. Send Message
This node enables your bot to send a message to the user. Note that instead of a plain text message, you can also send an image or video with a caption, an audio file, or a document with a caption.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, select a message type (Text, Image, Video, Audio, or Document).
- Add the message content. If it’s Text, enter the message you want to send. If it’s an image, video, or document, then upload a file and add a caption.
- If you’re using a Text message, you can personalize the message using Merge Tags by clicking on the ${} button on the right. These dynamic placeholders let you insert contact details (First name, Last name, WhatsApp number), user interaction data (Last user message), and other types of custom attributes (like city, order ID, product name, or amount) into your message.
- Click on Save Changes to save your node settings.
2. Send message template
This node enables your bot to send a WhatsApp message template to the user.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up
- In the pop-up, select the message template you want to send to the users.
- If the selected template contains variables, you’ll need to provide a Value and a Fallback value for each variable that you want to pass when the message is triggered.
- Finally, click on Save Changes to save your node settings.
3. Add/remove contact lists
This node enables your bot to add or remove a contact from a list.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, use the Add To Lists dropdown to select the list you want to add the contact to.
- Similarly, use the Remove From Lists dropdown to select the list you want to remove the contact from.
- Once done, click the Save Changes button to save the node settings.
4. Add/remove contact tags
This node enables your bot to add or remove a tag (e.g., “new lead”) from a contact.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, use the Add Tags dropdown to select the tags you want to add to the contact.
- Similarly, use the Remove Tags dropdown to select the tags you want to remove.
- Once done, click on Save Changes to save the node settings.
5. Set Contact Attribute
This node enables your bot to update a custom attribute in the contact profile (e.g., “Plan = premium”, “City = New Delhi”).
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, select the attribute you want to add to the contact from the Attribute dropdown. Then, enter the value you want to assign to that attribute in the Value field.
- To assign dynamic values, you can use merge tags by clicking on the ${} button on the right side of the field. Merge tags help you pull actual contact, message, or API data within a bot session to assign as an attribute value.
- Once done, click on Save Changes to save the node settings.
6. Wait for Some Time
This node lets you set a wait timer for the bot. This is helpful for conversation flows where you need to wait for some time before executing the next connected node.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, set a value in the WAIT FOR… field to specify how long you want the bot to wait. Then, use the UNIT dropdown to select whether the time should be in seconds, minutes, hours, or days.
- Finally, click on Save Changes to save the node settings.
7. Send API Request
This node enables your bot to send an API request to third-party apps, like your CRM, Google Sheets, webhook endpoints, and other external systems.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- Select your API Request Type from GET, POST, PUT, PATCH, and DELETE.
- Enter your endpoint Request URL to which you want to send the API request
- Then, enable the Add headers option to add custom headers to the API request. After enabling, you'll get the option to add your custom header key and value pairs.
- Then, enable the Add params option to add query parameters to your request. After enabling, to get the option to add key-value pairs of params below.
- Then, enable the Add body option to add body to your API request. After enabling this, you'll see a text area field to enter your body content. It's important to note that we support JSON by default. If you want to add any other Content-type, make sure to add that in the Headers option above.
- After entering all the API request details above, you then need to send a test API request to make sure the request is getting sent correctly. Before that, if you added merge tags in any of the fields above, you'll see a new option called Enter Dummy Data for Test Request to add dummy values for the merge tags. This is used for sending test API requests to help you set up this API node. Note that this data is not used during actual bot execution.
- After entering your dummy data for merge tags, click on the Test API Request button to send the test request. Note that we only accept JSON responses at the moment. The response will look something like this:
- You can then use the response to configure custom Data Keys to map the data from your response to specific keys that can then be used further in the bot flow. You can add multiple such key-value pairs, and they’ll be available in the merge tags of the subsequent bot nodes.
- Finally, when you’re happy with the setup, click on the Save Changes button to save the node settings.
8. Assign Team Member
This node enables your bot to assign the current conversation to a team member or unassign an existing team member from a conversation.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, select the team member you want to assign the conversation to. If you haven’t added any team members to your account yet, you’ll need to do that first using the Manage Team option in the settings. To unassign an existing team member from a conversation, select the Unassigned option.
- Click on Save Changes to save your node settings.
Note that you can delete any Action Node using the trash icon or duplicate it using the copy icon in the top-right corner of the node.
4. Conditional Nodes
Conditional nodes allow you to direct the flow of your chatbot based on user input or contact information. These are helpful when you want your bot to make decisions and follow different paths depending on the data it receives.
Note that you can add multiple conditional nodes to a chatbot flow.
Here’s a list of available conditional nodes:
1. Check contact data
This node enables your bot to conditionally route the conversation flow based on contact data such as lists, tags, or attributes.
If the conditions set in this node are met, the nodes connected to the True handle will be triggered; otherwise, the ones connected to the False handle will be triggered.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, select a Condition Type. You can choose from a Contact List, Contact Tag, or Contact Attribute.
- Next, select the action for your selected Condition Type. Note that Contact List and Contact Tag can be set to “Is Equal” or “Is Not Equal” to a specific value (e.g., Contact List is equal to “Website lead”). Contact Attribute, on the other hand, can be set to “Is Equal,” “Is Not Equal,” “Contains,” “Starts with,” or “Ends with.”
- You can combine multiple AND/OR logic checks
- When you’re done, click on Save Changes to save the node settings.
2. Check reply message
This node lets your bot conditionally route the conversation flow based on the user's last reply message data.
If the conditions set in this node are met, the nodes connected to the True handle will be triggered; otherwise, the ones connected to the False handle will be triggered.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, select a Condition Type. You can choose either Message Type or Message Text.
- If you select Message Type, you can set the condition to either “Is” or “Is not” action and specify a message type like Text, Template, Image, Video, Audio, Document, Location, Flow Response, Button Reply, or List Reply (e.g., Message Type Is Video).
- If you select Message Text, you can set the condition to “Is Equal,” “Is Not Equal,” “Contains,” “Starts with,” or “Ends with” action types and enter a specific value to compare against (e.g., Message Text contains “pricing”).
- When you’re done, click on Save Changes to save the node settings.
3. Check reply message text
This node allows your bot to check whether the plain text message received from the user matches any of the predefined keywords or phrases you’ve set . It creates a separate handle for each keyword or phrase you configure. It also adds a default handle for cases where the user’s message doesn’t match any of the configured texts.
To set it up:
- Click on the edit icon in the top-right corner of the node. This will trigger a pop-up.
- In the pop-up, enter a keyword or phrase in the REPLY MESSAGE TEXT field. Your bot will use this to check if the user’s message contains the specified text. You can add up to 10 such texts.
- When you’re done, click on Save Changes to save the node settings.
Note that you can delete any Conditional node using the trash icon or duplicate it using the copy icon in the top-right corner of the node.
5. End Node
This node marks the end of your chatbot’s conversation flow. You should connect all open handles that don’t lead to another node to an End node to ensure that your bot has a stopping point.
Now that you’re familiar with different components used to build a chatbot, you’re ready to start setting up one on your own.
Check out the detailed guide below to get started:
>>> WhatsApp Chatbot Creation Guide
Updated on: 15/07/2025
Thank you!