Skip to main content
Rich Responses transform your AI Agent from a plain-text responder into a fully interactive, channel-aware messaging experience. Instead of sending walls of text, an Agent with Rich Responses enabled can display visual product cards, horizontally scrollable carousels, quick-reply buttons, and images — all automatically formatted for the channel the customer is on (Messenger, Instagram, WhatsApp, Zalo, Webchat, and others). At the same time, the Agent can silently execute system actions in the background: assigning Tags, updating Custom Fields, triggering automation Flows, or handing the conversation to a human agent. Standard AI models can only output raw text. Without Rich Responses, if a customer asks to see a product, the Agent can only share a link. With Rich Responses, ChatbotX acts as a middleware layer that reads the Agent’s structured JSON output and renders it as native interactive components on each channel — no extra code required on your side.

When to Use Rich Responses

Rich Responses are particularly valuable in these scenarios:
  • Product or service consultations that require displaying images, names, prices, and direct purchase buttons.
  • Mobile-friendly interactions where Quick Replies reduce typing effort and guide the customer through a decision.
  • Lead capture flows where the Agent collects an email, phone number, or full name and automatically saves it to a Custom Field.
  • Customer segmentation where the Agent assigns Tags (lead, hot-lead, vip, support-needed) based on how the conversation unfolds.
  • Advanced automations where the Agent triggers a Flow or transfers the chat to a live agent for special or sensitive requests.

Response Types

Available Actions

How to Enable Rich Responses

1

Create required Custom Fields and Tags

Go to ChatbotX System Settings and create the Custom Fields (e.g., size, color, address, buyer_status) and Tags (e.g., lead, hot-lead, support-needed) your business needs before configuring the Agent.
2

Open AI Agents

Select AI Agents from the left navigation bar.
3

Edit the Agent

Click edit on an existing Agent or create a new one.
4

Enable the Rich Response switch

In the Agent configuration modal, scroll down to the Rich Response toggle and switch it to ON. With this setting active, the Agent outputs a structured JSON object containing messages and actions instead of raw text streaming.
5

Paste the Prompt template

Copy the production-ready Prompt template (see below) and paste it into the System Message (Prompt) field. Customise the business name, product catalogue, Custom Field names, Tag names, and Flow IDs to match your workspace.
6

Save and test

Click Confirm (or Save Settings) and send a test message through a live conversation channel to verify that cards, carousels, and quick replies render correctly.
You must create every Custom Field and Tag in ChatbotX System Settings before referencing them in the Prompt. If a field or tag does not exist in the system, the Agent will not be able to save or assign values to it.

How Response Rules Work in the System Message

When Rich Responses is enabled, the Agent must output valid JSON in this shape for every reply:
The messages array contains the visual components (text, card, carousel, quick replies, image). The actions array contains the background operations (tag assignment, field updates, flow triggers, human transfer). You define the rules for when each response type should be used directly in the System Message — the Agent reads those rules and applies them automatically based on the customer’s intent.

Production Prompt Template

The template below is a complete, production-grade Prompt designed for an automated fashion sales Agent. You can copy it directly, then adapt the brand name, product catalogue, field names, tag names, and Flow IDs to fit your own workspace.

Best Practices

Rich Message formats (Card, Carousel, Quick Replies) are automatically optimised by ChatbotX for each conversation channel. A Carousel renders as a standard Facebook Carousel on Messenger, and as a compatible visual list on Zalo or WhatsApp — you do not need to write separate prompts for different channels.
When writing your Prompt rules, keep the following in mind:
  • Flow IDs, Tag names, and Custom Field names in the actions array must exactly match what you created in ChatbotX System Settings. A mismatch will silently fail — the Agent will send the message but the action will not execute.
  • Keep rule sections short and explicit. The more clearly each scenario is defined, the more reliably the Agent will produce the correct JSON structure.
  • Test on the actual channel. Preview rendering inside ChatbotX may differ from how a channel like WhatsApp or Instagram displays the components. Always test on a live channel before launching.