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.
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: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
When writing your Prompt rules, keep the following in mind:- Flow IDs, Tag names, and Custom Field names in the
actionsarray 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.