Quick Actions settings
Navigation: WordPress Admin → WooCommerce → AI Assistant → Settings → Quick Actions
Card title: Quick Action Buttons.
Chips shown above the chat composer. Maximum 8 buttons. Labels max 48 characters. Chat messages max 400. AI instructions max 800 and stay on the server — the widget only receives id, label, icon, and type.
Default list is empty until you add buttons.
Button list (repeater)
Each row:
Button Label
What it does Text on the chip.
Default value Empty (placeholder “New button”).
Available options Plain text, max 48 characters.
Recommended configuration Short verbs: “Find products”, “Track order”.
When to use it Always required for a visible chip.
Effect on the frontend Chip text.
Dependencies Enabled toggle.
Important notes Must be unique enough for staff to recognize in analytics.
Example Find products
Button Type
What it does Chooses what happens on click.
Default value chat_message — Chat Message.
Available options
| Value | Label | Behavior |
|---|---|---|
chat_message | Chat Message | Sends the configured message as if the shopper typed it |
link | Link | Opens the URL |
contact_form | Contact Form | Opens the URL (same URL field) |
ai_action | AI Action | Starts a turn with a server-side instruction; shoppers never see the prompt |
Filter aiwsa_quick_action_types can add types (developers).
Recommended configuration Mix of Chat Message and AI Action. Use Link for shipping policy pages.
When to use it AI Action for guided workflows; Chat Message for simple canned queries.
Effect on the frontend See Quick Actions feature.
Dependencies AI Action needs an AI provider for best results; without AI, the turn still goes through the native catalog handler.
Important notes Instructions are never in aiwsaBoot.
Example Type AI Action + template Track My Order.
Icon
What it does Icon on the chip.
Default value chat
Available options Search, Sparkles, Compare, Package, Price, Help, Cart, Chat, Link, Mail, AI (bolt).
Recommended configuration Match the action (search icon for Find Products).
When to use it Always.
Effect on the frontend Visual only.
Dependencies None.
Important notes Unknown keys fall back during sanitize.
Example Package icon for Track My Order.
Enabled
What it does Shows or hides the chip without deleting it.
Default value Off for a new empty row until checked.
Available options On / Off.
Recommended configuration Enable only tested buttons.
When to use it Seasonal campaigns.
Effect on the frontend Hidden chips are omitted from GET /config.
Dependencies None.
Important notes Disabled rows remain in aiwsa_settings['quick_actions'].
Example Disable “Holiday gift guide” after January.
Chat message (type Chat Message)
What it does Text submitted as the shopper’s message.
Default value Empty.
Available options Plain text, max 400.
Recommended configuration A query that works with your catalog.
When to use it FAQ shortcuts.
Effect on the frontend Sends that string through the normal turn API.
Dependencies Enable AI Agent.
Important notes Counts toward rate limits like a typed message.
Example Show me best sellers
URL (types Link and Contact Form)
What it does Destination URL.
Default value Empty.
Available options https:// URL.
Recommended configuration Your Contact page or shipping policy.
When to use it Off-chat destinations.
Effect on the frontend Browser navigation.
Dependencies None.
Important notes Not an embedded form builder — only a link.
Example https://example.com/contact
AI Action Type (type AI Action)
What it does Workflow kind used with templates and analytics.
Default value custom
Available options Product Search, Product Recommendation, Product Comparison, Product Q&A, Cart Assistant, Order Assistant, Sales Assistant, Custom AI Action.
Recommended configuration Use a template (Find Products, Help Me Choose, etc.) then edit the instruction.
When to use it Match the tool you want the agent to prefer.
Effect on the frontend Shopper only sees the label. Server prepends the instruction.
Dependencies Approved tools still gate what can run.
Important notes Filter aiwsa_ai_action_templates / aiwsa_ai_action_config.
Example Product Search + Find Products template.
AI Instruction (type AI Action)
What it does System-side instruction for that click.
Default value Template text if you insert a template; otherwise empty.
Available options Plain text, max 800.
Recommended configuration Keep short. Catalog facts still come from tools.
When to use it Every AI Action.
Effect on the frontend Invisible to customers.
Dependencies AI agent tools.
Important notes Cannot grant new tools or bypass confirmation.
Example Help the customer find suitable products from the WooCommerce catalog. Ask clarifying questions when necessary.
Row controls
- Up / Down — reorder
- Remove — delete the row
- Save the form to persist
Built-in templates (admin picker): Find Products, Help Me Choose, Recommend Products, Compare Products, Product Questions, Track My Order, Shopping Assistant.