AI Agent Actions in ChatSyncs
The full ##action_name## reference for an AI agent's System Prompt in ChatSyncs — assign labels, look up orders, hand off to a human, or transfer to another agent.
On this page
An AI agent's System Prompt in ChatSyncs isn't only plain instructions — you can type actions directly into it, so the agent does something (add a label, look up an order, hand off to a person) instead of just replying with text.
Syntax#
Write an action inside the prompt using this format:
##action_name##: idFull action reference#
| Action | Example | What it does |
|---|---|---|
##add_label## | ##add_label##: 12 | Add a label to the subscriber. |
##remove_label## | ##remove_label##: 12 | Remove a label from the subscriber. |
##assign_sequence## | ##assign_sequence##: 8 | Assign a Message Sequence to the subscriber. |
##remove_sequence## | ##remove_sequence##: 8 | Remove a Message Sequence from the subscriber. |
##save_custom_field## | ##save_custom_field##: 42 | Save a value into a Custom Field. |
##call_http_api## | ##call_http_api##: 5 | Call one of your configured HTTP APIs. |
##shopify_store## | ##shopify_store##: 12 | Bind a connected Shopify store — required before any other Shopify action works. |
##shopify_get_order_details## | ##shopify_get_order_details## | Look up order status (the customer sends the order number). |
##shopify_recommend_products## | ##shopify_recommend_products## | Search and recommend products from the store. |
##shopify_update_order_tag## | ##shopify_update_order_tag##: whatsapp-connected | Add that exact tag to the order. |
##shopify_cancel_order## | ##shopify_cancel_order## | Cancel an order when the customer asks. |
##woocommerce_store## | ##woocommerce_store##: 12 | Bind a connected WooCommerce store — required before any other WooCommerce action works. |
##woocommerce_get_order_details## | ##woocommerce_get_order_details## | Look up WooCommerce order status. |
##woocommerce_recommend_products## | ##woocommerce_recommend_products## | Search and recommend WooCommerce products. |
##woocommerce_update_order_note## | ##woocommerce_update_order_note##: whatsapp-connected | Add that exact note to the order. |
##woocommerce_cancel_order## | ##woocommerce_cancel_order## | Cancel a WooCommerce order when the customer asks. |
##assign_human_member## | ##assign_human_member##: 335 | Always assign to this one specific team member. |
##assign_human_role## | ##assign_human_role##: 3 | Round robin between the available members of a team role. |
##trigger_bot_flow## | ##trigger_bot_flow##: 15 | Trigger a bot flow / postback. |
##transfer_agent## | ##transfer_agent##: 18 | Hand off to another AI agent. |
##mark_as_solved## | ##mark_as_solved## | Mark the conversation as solved when the issue is done. |
##block_subscriber## | ##block_subscriber## | Block the subscriber if the message is spam. |
##skip_reply## | ##skip_reply## | Don't reply to vague or irrelevant questions. |
Store actions need a bound store first#
##shopify_*## actions require ##shopify_store## in the same prompt first. ##woocommerce_*##
actions require ##woocommerce_store## first. Pick a connected store — other store-related
actions won't save without it.
Example: an agent meant to handle order questions for a Shopify store needs, near the top of its System Prompt:
##shopify_store##: 12before ##shopify_get_order_details## or ##shopify_cancel_order## will work.
Sending images#
Frequently asked#
How do I make an agent hand off to a live team member instead of answering?
Use ##assign_human_member##: <id> to always route to one specific person, or
##assign_human_role##: <id> to round-robin between everyone with that team role.
How do I let one agent hand a conversation to another agent?
Use ##transfer_agent##: <id> with the target agent's ID in your System Prompt. This is
separate from — and can work alongside — Agent Routing rules.
My Shopify action isn't working — why?
Check that ##shopify_store##: <id> with a connected store's ID appears in the same System
Prompt. Every other ##shopify_*## action depends on that binding.
How do I stop the agent from replying to junk or off-topic messages?
Add ##skip_reply## to its instructions for vague or irrelevant questions — it tells the
agent not to reply at all rather than guess.
What's the difference between mark_as_solved and skip_reply?
##mark_as_solved## closes out a conversation once the customer's issue is actually
resolved. ##skip_reply## is about not answering a specific message at all — the
conversation itself stays open.
Was this page helpful?
Still stuck? Open a support ticket and our team will help.