AI Agent Actions in ChatSyncs

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##: id

Type ## in the System Prompt box to autocomplete actions, then pick a label/sequence/etc. from the list. The UI shows names, but the prompt always stores numeric IDs underneath.

Full 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.

How to write actions in System Prompt panel listing add_label, remove_label, assign_sequence, remove_sequence, save_custom_field, call_http_api, shopify_store, shopify_get_order_details, shopify_recommend_products, shopify_update_order_tag, and shopify_cancel_order with their id format and description

How to write actions in System Prompt panel continued, listing woocommerce_store, woocommerce_get_order_details, woocommerce_recommend_products, woocommerce_update_order_note, woocommerce_cancel_order, assign_human_member, assign_human_role, trigger_bot_flow, transfer_agent, mark_as_solved, block_subscriber, and skip_reply with their id format and description

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##: 12

before ##shopify_get_order_details## or ##shopify_cancel_order## will work.

Sending images

Don’t put image URLs directly in the System Prompt. Add product or gallery images under Knowledge Sources → Media instead — the agent sends them from there when a customer asks for photos.

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.

​Syntax

​Full action reference

​Store actions need a bound store first

​Sending images

​Frequently asked

Syntax

Full action reference

Store actions need a bound store first

Sending images

Frequently asked