Bot Tools — How to Trigger Bot Studio Journeys from Your AI Agent

Learn what Bot Tools are, how to create them, how to add parameters, and how to build their Bot Studio journeys — with three real examples from simple to advanced.

A Bot Tool connects your AI Agent to a Bot Studio journey. When the agent detects a specific customer intent — based on the tool's description — it triggers the linked journey automatically.

Without Bot Tools, your AI Agent can only reply with text. With Bot Tools, it can collect structured information from the customer, send rich messages, assign conversations to team members, save data to Google Sheets, add tags, trigger APIs, and much more — all through Bot Studio's visual flow builder.

When Should You Use a Bot Tool?

Use a Bot Tool when you want the agent to do something more than just answer a question. Here are some common scenarios:

Scenario	What the Bot Tool Does
Customer wants to book an appointment	Collects date, time, and details, then saves to a sheet or assigns an agent
Customer wants a product demo	Collects name, company, and requirements, then notifies your sales team
Customer wants to register for an event	Collects event name, date, number of people, and location
Customer wants a callback	Collects phone number and preferred time, then triggers a call or assigns an agent

How Bot Tools Work

1. A customer sends a message on WhatsApp.

2. The AI Agent reads the message and matches it to a Bot Tool based on the tool's description.

3. If the tool has parameters, the agent collects each piece of information from the customer through the conversation.

4. Once all required information is collected, the connected Bot Studio journey activates.

5. The journey performs the actions you have configured — sending messages, assigning agents, saving data, etc.

---

Key Fields in a Bot Tool

Field	What It Means
Name	A clear name describing what the tool does — for example, Talk To Human or Booking
Description	Tells the agent when to use this tool. The agent reads this to decide whether to activate it. This is the most important field — write it clearly
Type	Set to Bot
Parameters	Information the agent collects from the customer before triggering the journey. Some tools have no parameters

---

Understanding Parameter Types

When adding parameters, you choose a type for each one:

Type	When to Use	Example
String	Text or a mix of text and numbers	Customer name, email, date, location
Number	Purely numeric input	Phone number, pin code, quantity
Options	Customer must choose from a fixed list	T-shirt size (Small, Medium, Large, XL), car type (Sedan, SUV)

When you select Options, an extra field appears where you enter choices as comma-separated values — for example: Small, Medium, Large, XL, XXL.

Each parameter also has:

Field	What It Does
Description	Short explanation of what this input is
Sample Value	An example that helps the agent understand the expected format
Required Parameter checkbox	Check this if the agent must collect this input before triggering the tool

---

Example : Sell Used Car — Complete Journey Walkthrough

This example walks through both the tool creation and the full journey setup block by block, so you can see exactly how every piece connects.

Imagine you run a used car business. A customer messages "I want to sell my car." You want the agent to collect the car details and customer information, and then assign the conversation to a team member.

How to Create the Tool

1. Click the Add Tool button.

2. In Name, type: Sell_Used_Car.

3. In Description, type: "Fires after capturing customers data on their decision on selling car."

4. In Type, select Bot.

How to Add the Parameters

1. Add the following seven parameters one by one:

Name	Type	Description	Required
Brand	String	Car brand	Yes
Model	String	Car model	Yes
Year	Number	Car manufacturer year	Yes
Km	Number	Km's driven	Yes
Name	String	Customer name	Yes
Number	Number	Customer number to contact on	Yes
City	String	Customer residency city	Yes

1. Click Create.

2. Turn the toggle on (green) to activate.

Notice how the parameters are split into two groups — the first three (Brand, Model, Year, Km) capture car details, and the last three (Name, Number, City) capture customer details. This makes the conversation feel natural — the agent asks about the car first, then about the customer.

1. Click the Journey button on the tool's row. Bot Studio opens.

Block 1 — Starting Point (already configured)

This block defines when and where the journey activates.

Field	What It Means
Trigger Type	"On customer intent" — activates when the agent detects that the customer wants to sell a car
Intent Keyword	The keyword linking this journey to the tool — in this case, Sell_Used_Car
WABA Scope	Which WhatsApp numbers this journey applies to. "Bot for All WABAs" applies it to all connected numbers. Or select specific numbers individually

Block 2 — How to Add a Send Message Block

1. Add a Send Message block after the starting point.

2. Check the "Continue on WABA" box.

3. In the Body field, type your message. For example: "Thank you for sharing your car details! Let me connect you with our team who will get back to you with a valuation shortly."

Field	What It Means
Continue on WABA	Journey continues on the same WhatsApp number the customer messaged
Media Upload	Optionally attach an image, audio, video, or PDF
Body	The text message to send — up to 1024 characters

Block 3 — How to Add an Assign Agent Block

1. Add an Assign Agent block after the Send Message block.

2. In the Assignment Method dropdown, select how conversations should be distributed.

3. In the Agents list, check the team members who should receive conversations.

4. Optionally check "Re-assign if already assigned."

The Assignment Method has three options:

Option	What It Does
Assign Randomly	Distributes conversations randomly among selected agents
Rotate Equally (Round Robin)	Cycles through agents in sequence — Agent A, then Agent B, then back to Agent A
Reassign to Last Human Agent	Assigns back to the human agent who previously handled this customer

The Complete Flow — What the Customer Experiences

1. Customer sends a WhatsApp message like "I want to sell my car."

2. AI Agent recognises the sell car intent.

3. Agent asks for the car brand, model, manufacturer year, and kilometres driven.

4. Agent then asks for the customer's name, contact number, and city.

5. Once all seven details are collected, the Bot Studio journey activates.

6. Journey sends the acknowledgement message.

7. Journey assigns the conversation to a team member.

The customer's experience is seamless — they share their car and contact details in a natural conversation, and your team receives everything they need to follow up with a valuation.

Summary

In this article, you learned what Bot Tools are, how to create them with and without parameters, how the three parameter types (String, Number, Options) work, and how to build Bot Studio journeys step by step. You saw three real examples — a simple Talk To Human tool, a multi-parameter car requirement tool, and a complete event booking walkthrough. In the next article, we will cover API Tools — how to connect your AI Agent to external systems to fetch or send data in real time.