WhatsApp API Platform

AI Bot

Build WhatsApp AI assistants from templates — personality and guardrails, knowledge bases, built-in tools, and human escalation.

AI Bot turns a WhatsApp number into an AI assistant that answers in your brand's voice. Start from a template, give it a personality and guardrails, feed it a knowledge base, attach tools so it can take actions, and let it escalate to a human when it is out of its depth. Unlike the rule-based Chatbot, an AI Bot understands free-form questions and replies in natural language.

AI Bots page listing an assistant as a card with its template, language, tone, status, and attached tools

In the app: Dashboard → Automation → AI Bot

Pre-launch preview

AI Bot is marked Pre launch preview. Behaviour and configuration may change before general availability.


AI Bot vs Chatbot

ChatbotAI Bot
How it repliesFixed flow of nodes you drawGenerates answers from a model
Best forPredictable, structured journeys (menus, forms, qualification)Open-ended questions, FAQs, sales conversations
SetupVisual flow editorTemplate + personality + knowledge base
GuardrailsThe flow itselfTone, topic and competitor restriction, escalation rules

Run both: a chatbot for deterministic steps, an AI Bot for the open conversation around them.


The AI Bot page

The page has three tabs — Bots, Knowledge, and Tools — across the top.

The Bots tab lists every assistant on your account as a card showing its template badge, language and tone, an Active / Inactive status, the guardrails in force (Block competitors, Auto-escalate), and the tools attached to it. Use the search box to find a bot by name, the status filter to show only Active or Inactive bots, and Refresh to reload. Click Create bot (top right) to add one, or the menu on a card to edit or delete it.

AI Bot is an add-on

The number of AI Bots you can run is set by your plan and the AI Bot add-on. If you hit the limit, top up capacity from Billing → Usage / Add-ons.


Create a bot

Creating a bot is a four-step wizard: pick a template, shape its personality, attach knowledge, and enable tools. A progress bar tracks your place (25% → 100%).

Choose a template

The template sets the bot's starting behaviour and pre-loads a set of tools. Pick the closest fit; you can refine everything in the next steps.

Template step showing the four AI Bot template cards: Shopify Sales Bot, WhatsApp Store Sales Bot, Customer Support Bot, and Custom

TemplateWhat it's forIncluded tools
Shopify Sales Bot (Popular)Recommend products and recover abandoned carts for a connected Shopify storeProduct Recommendations, Cart Recovery, Order Status
WhatsApp Store Sales BotTurn your WhatsApp number into a storefront with catalog browsing and paymentsCatalog Browse, Order Collection, Payment Processing
Customer Support Bot (Most used)Handle FAQs, troubleshoot issues, and escalate to a human when neededIssue Diagnosis, Step-by-Step Help, Human Escalation
CustomStart from a blank assistant and fully control its personalityCustom Prompts, Tool Selection, Knowledge Attachments

Define personality and guardrails

Shape how the bot speaks and where it draws the line. The screen is split into four panels.

Personality step with Identity, Guardrails, Language & Tone, and Human Handoff panels

Identity — how the bot presents itself.

FieldWhat it does
Bot nameThe assistant's name, e.g. "Sales Assistant"
Company infoA short description of your business, used for context
Organizing your data (system prompt)The bot's core instructions. Editable on Custom, auto-generated on every other template (see below)

Who writes the system prompt?

On the Custom template you write the system prompt yourself: describe the bot's persona and how it should behave, for example "You are a helpful travel guide." On every other template (Shopify, WhatsApp Store, Customer Support) the system prompt is auto-generated and managed for you from your selection, so the field stays read-only.

Identity panel on a non-custom template showing the system prompt auto-generated and marked as auto-managed

Guardrails — keep the bot on-message.

SettingWhat it does
Topic restrictionKeeps the conversation to your knowledge base
Block competitor mentionsPrevents the bot discussing rival brands

When Block competitor mentions is on, a Competitor names field appears — list the brands, comma separated. While it is off, a banner reminds you "Competitor filtering is off. The bot may discuss other brands."

Guardrails with Block competitor mentions enabled and a Competitor names field

Language & Tone — how the bot sounds.

SettingWhat it does
Primary languageThe language the bot replies in
Conversation toneFormal, Friendly, or Casual
Max response lengthA character cap that keeps replies concise for chat

Language & Tone panel showing primary language, tone toggle, and a 150-character max response length

Human Handoff — when to bring in a person.

SettingWhat it does
Auto-escalate to humanHand the conversation to an agent when the bot is stuck
Confidence thresholdHow sure the bot must be before answering; below it, it escalates
Escalation messageWhat the customer sees at handoff
Max conversation turnsThe back-and-forths the bot attempts before passing to a human

Escalation

Escalation triggers after the confidence or turn limits are hit, and sends your escalation message. The conversation then lands in Team Chats for an agent to pick up.

Attach knowledge

Pick the knowledge bases the bot should answer from. Each card shows the knowledge base name, its document count, last-updated date, and a Ready status. Select one, several, or none (the bot then answers from the template and its instructions alone). You can change this any time after creation.

Knowledge step showing selectable knowledge base cards, each marked Ready

Enable tools

Turn on the tools the bot may use, then Finish. The new bot appears on the Bots tab, ready to activate.

Tools step showing the built-in tools as selectable cards


Manage a bot

Open a bot from the Bots tab to reach Manage Bot, where everything you set in the wizard can be changed across three tabs: Personality, Knowledge Base, and Tools.

Personality

Edit identity, guardrails, language and tone, and human handoff exactly as in the wizard. Click Save personality to apply.

Manage Bot Personality tab with Identity, Guardrails, Language & Tone, and Human Handoff

Knowledge base

Two panels: Attached (the knowledge bases this bot answers from) and Available (every other knowledge base on your account). Use the + to attach a knowledge base and the trash icon to detach one. Detaching never deletes the knowledge base itself — it just stops this bot using it.

Knowledge Base tab with Attached and Available knowledge bases

Tools

The same two-panel layout for tools: Attached tools the bot can call, and Available tools you can add with +. Remove a tool with the trash icon.

Tools tab with attached tools on the left and available tools on the right

Toggle a bot Active to let it answer customers, or Inactive to take it offline without deleting it.


Delete a bot

From a bot card's menu, choose Delete. A confirmation dialog appears first.

Delete bot confirmation dialog warning the action cannot be undone

Deletion is permanent

Deleting a bot removes its personality, tool attachments, and configuration. This cannot be undone. Its knowledge bases are not deleted and remain available to other bots.


Knowledge bases

A knowledge base is the set of documents your bots answer from. They are managed centrally on the Knowledge tab and attached to any number of bots, so the same content can power several assistants.

Knowledge tab listing global knowledge bases with their document counts and Ready status

Create a knowledge base

Click Create Knowledge Base, give it a Name and an optional Description, then continue to its edit screen.

Create Knowledge Base dialog with name and description fields

Add documents

On a knowledge base's Manage Knowledge screen, the left panel ingests content three ways and the right panel lists what is indexed.

Manage Knowledge screen with the ingestion panel on the left and a documents table on the right

MethodWhat it accepts
Upload FilesPDF, DOCX, TXT, CSV, or MD files, up to 10MB each
Import from URLA web page the platform fetches and reads
Paste TextA title and free-text content you type or paste

Each source is split into chunks the model can search. The documents table lists every source with its file name, type (e.g. TEXT, APP/DOCS for a fetched page), chunk count, status, and upload date. Remove a source with its trash icon.

StatusMeaning
ProcessingThe document is being read and chunked
ReadyIndexed and available to bots
FailedIngestion failed — remove and re-add the source

Keep knowledge focused

Add the documents a customer would actually ask about: product specs, policies, FAQs, shipping and returns. Stale or irrelevant content makes answers worse, not better.

Edit or delete a knowledge base

Use Edit (top right of Manage Knowledge) to rename it or change its description.

Edit knowledge base dialog with name and description fields

Use Delete to remove it. A confirmation dialog appears first.

Delete knowledge base confirmation dialog

Deletion is permanent

Deleting a knowledge base removes it and all of its documents, and detaches it from every bot that used it. This cannot be undone.


Tools

Tools let a bot do more than talk — raise a ticket, send a payment link, run a survey, tag a contact, or hand off to a human. The Tools tab reviews every tool that can be attached to bots; attach them per bot from Manage Bot → Tools.

Tools tab listing the built-in tools available to bots

ToolWhat it does
Raise TicketCreate a support ticket for the customer
Send Payment LinkSend a payment or checkout link to the customer
Send CSAT SurveySend a customer satisfaction survey
Human HandoffTransfer the conversation to a human agent
Remove TagRemove a tag from the contact
Set AttributeSet a contact attribute value
Add TagAdd a tag to the contact

Each tool is marked Built-in. A bot calls a tool when the conversation calls for it — for example, raising a ticket when a customer reports a problem, or handing off when it can't help.


Best practices


Troubleshooting

How is this guide?

On this page