Chatbot blocks reference
Blocks are the steps of your chatbot.
- Plan
- Depends on your plan · Which plan do I need?
- Who can use this
- Account owner, Manager
Blocks are the steps of your chatbot.
Blocks are the steps of your chatbot. You drag them from the block panel on the right of the builder into groups on the canvas. This page lists every block by its panel section, with what it does and the settings that matter.
Open a bot from Sidebar → Chatbot. The block panel is on the right of the builder. Card names below are the names shown on the cards.
To add and set up a block:
| Card | What it does |
|---|---|
| Text | Sends a text. {{variables}}, bold and italic allowed. |
| Image, Video, File, Audio | Sends media by upload or URL. |
| YouTube | Sends a YouTube link. |
| Location | Sends a map pin (latitude/longitude or a location variable). |
| Contact | Sends a contact card. |
| Link | Sends a call-to-action URL button. |
| Request Location | Asks the customer to share their location. |
| Request | Asks the customer to allow WhatsApp calls from your business. |
| Call Button | Sends a button the customer taps to call you on WhatsApp. |
| Request Contact | Asks a username-only customer to share their phone number. |
| Card | What it does |
|---|---|
| Quick Reply | Up to 3 reply buttons, each with its own path. |
| List / List v2 | A WhatsApp list, up to 10 rows with optional descriptions. Use List v2 for new bots. |
| Carousel | 2 to 10 cards, each with an image or video and buttons. All cards share the same button layout. |
| Dynamic Choices → Quick Reply / List / Carousel | The same messages, built while the bot runs from a variable (for example a webhook response). Have an On Failure exit. |
Text, Number (optional min/max), Email, Website, Date (DD/MM/YYYY), Time (10:30, 9:00 or 10:30 AM), Phone, File (the tooltip says Upload Files; saves the file link) and Location. Each saves the answer to a variable. Typed inputs re-ask with your retry message when the answer is not valid. You can add a timeout to a question.
| Card | What it does |
|---|---|
| Set | Sets a variable to a value or a calculation. |
| Condition | Compares variables (equals, contains, greater than, is set…). True takes the item edge, false the block edge. |
| Chatbot | Jumps to another of your chatbots, or a group of this one. |
| Delay | Waits a number of seconds before continuing. |
| Time | Saves the current date or time (timezone and format) into a variable. It does not branch. |
| Random | Splits customers randomly between paths (A/B test). |
| Team available? | Goes one way if someone from the chosen teams or staff is online now, another if not. It assigns nobody, so also connect On Failure on the assignment that follows. Can treat a closed business-hours calendar as unavailable. |
| Business hours | Branches on your business-hours calendar right now: Open, Closing soon, Closed, Holiday, On Failure. Calendar: Automatic (the conversation's channel, then its team, then the company calendar) or a specific calendar. "Closing soon" is 1 to 240 minutes. Can save the next opening time ("tomorrow at 9:00 AM"), the holiday note and the calendar name into variables. With no calendar set up, it always answers Open. |
| Message type | Branches on what the customer's last message was: Text, Voice, Image, Video, Document, Other. Unconnected exits fall to Other. Button and list taps take Other unless you treat them as text. Can save the type and the file link, and can turn a voice note into text using your workspace's own OpenAI key. |
| Card | What it does |
|---|---|
| Link | Sends a payment link and waits for SUCCESS, TIMEOUT or CANCELLED. Supported gateways include Stripe, PayPal, Razorpay, Paystack, Flutterwave, Mollie, Mercado Pago, PhonePe, Instamojo, M-Pesa, DPO, N-Genius, PayTabs, Tabby, Tamara, Tap, Telr and Thawani. |
| WhatsApp Pay | Native WhatsApp payment. India (INR) only. |
| Card | What it does |
|---|---|
| Catalog | Sends products from your connected catalog. Type: list, category, set, product or carousel. The bot then continues; it does not wait for a reply. See Send catalog and product messages. |
| Order Status | Sets the status of the current order (Pending, In progress, Completed, Cancelled, Timeout). |
| Payment Status | Sets the payment status of the current order. |
| Set Location | Saves a delivery address or location on the current order. |
Order Status, Payment Status and Set Location need to know the order: use them in a bot that receives orders, or set the ORDER_ID variable first.
| Card | What it does |
|---|---|
| Rest API | Calls an HTTPS endpoint (a webhook to your API) and maps the JSON response into variables. Public https addresses only. It has no failure exit: save the status code and branch on it with a Condition. |
| Webhook Trigger | Waits until an outside system posts to the block's callback URL, then maps the data into variables. |
| CRM | Reads or updates the contact and conversation: assign staff or a team, tag, and more. |
| Template Message | Sends an approved WhatsApp template. Works outside the 24-hour window. |
| AI (OpenAI / Claude) | Asks OpenAI or Claude with an account (API key) you add in the block; the answer goes to variables. Answering from a data source works with OpenAI only. |
| Google Sheets, Sheets v2 | Read, add, update or delete rows. Sheets v2 adds filters, upsert and totals. |
| Google Calendar | Offers free slots and books the one the customer picks. |
| Sends an email from a connected account. | |
| Zapier, Make.com, Pabbly | Sends data to those services. |
| Others | Runs an action in a connected app (for example a CRM) through a saved account. |
System Message (posts in the conversation), Reminder (for staff), Mention (notifies staff: the human hand-over), Custom Field (writes a contact field), Disable Chatbot (stops the bot on this conversation), Notes (internal note) and Close Conversation (needs a closing reason).
| Card | What it does |
|---|---|
| AI Decide | The AI reads the customer's message and picks one of your named outcomes, plus Not sure and Failed paths. Growth, Premium or Enterprise. |
| Smart AI Agent | Hands the conversation to a published AI agent until it finishes, then continues on Success, Fail, Abandoned, Escalated or Error. Growth, Premium or Enterprise. |
| AI Json | Extracts structured data from the conversation into variables. |
{{GL_name}}) instead of pasting them into each webhook.Do it with Copilot
Do it with Copilot
Do it with Copilot
The Copilot's catalog tools are in a pilot and available only in some workspaces.
| What you see | Why | What to do |
|---|---|---|
| A card is greyed out with "Please Upgrade Your Package to Use this!" | Not in your plan. | Upgrade, or use another block. |
| "A {block} step has no URL configured — the call will fail." | Webhook without URL. | Set the endpoint URL. |
| "A Close Conversation step has no closing reason — the panel requires one." | Missing reason. | Pick a closing reason. |
| "An order-update step … is used, but nothing in this bot can tell it which order" | No order in this bot. | Use it in an order bot, or set ORDER_ID. |