FluentCart
The FluentCart action lets your bot read your store’s public catalog on your connected WordPress site. It can find products, compare them, and check prices, variations and availability.
Open Bot > Actions > Action library > FluentCart.
Best for: product questions that need current store data rather than a static description.
Common requests:
- “Do you have the desk lamp in black?”
- “Compare the Office Chair and the Standing Desk.”
- “What’s the cheapest plan with yearly billing?”
Before you start
- You need the Owner, Team Admin or Bot Admin role.
- This bot’s WordPress integration must be set up and enabled. Until it is, the library shows “Set up and enable the WordPress integration before creating or enabling this action.” with a Set up WordPress button. See WordPress integration.
- FluentCart must be installed on the connected WordPress site. Check access confirms the store matches the FluentCart version FluentChat currently supports.
- The FluentCart action must be available on your FluentChat account. It’s off by default in FluentChat’s configuration; if you can’t enable it after a successful check, contact FluentChat through Feedback.
- In WordPress, allow public product access under FluentChat → Integrations → FluentCart.
Add the FluentCart action
-
Open the template. In Action library, select FluentCart, then Start customizing.
-
Name the action. In General, enter an Action name and review When to use.
-
Check access. In FluentCart access, select Check access. When it succeeds, the editor shows Connected store: and “Product access verified. This store is available within its WordPress permissions.”
-
Choose products. Under Products this action can read, choose All products allowed in WordPress, or Selected products or categories and search for the ones to include. Select Save and continue.
-
Choose channels. Turn on the channels that may use the action, then select Save, or Save & enable. Enable the action within five minutes of a successful Check access. After that, the app asks you to “Refresh current product permissions before enabling this action.” Select Check access again.
-
Enable the action. Turn on Enable action if you didn’t use Save & enable.
Settings
| Setting | What it does |
|---|---|
| Action name | The name the bot uses to call this action. Use 3–64 characters. Spaces become underscores. |
| When to use | Tells the bot when to read the catalog. The default tells it to read current public data, keep currency and billing terms, and never claim a purchase succeeded. Select Reset to restore it. |
| Check access | Checks the product permissions allowed in WordPress. It doesn’t change your store. |
| All products allowed in WordPress | The bot can read every product WordPress allows, including future eligible products. |
| Selected products or categories | The bot can read only the products and categories you choose, up to 100 of each. A product can match either selection. Categories include their subcategories. |
Changing the product selection pauses the action. Turn on Enable action again after you save.
What visitors can ask
| Request | What the bot does |
|---|---|
| Find products | Searches by name, with optional category, price range and in-stock filters, sorted by relevance, newest or price. |
| Compare products | Compares up to five products in one reply. If asked for more, it asks which five to prioritize. |
| Product details | Reads a product, including its variations and their attributes. |
| Variation availability | Checks a specific variation for a quantity from 1 to 100. |
The bot treats each answer as a snapshot. An “in stock” answer isn’t a reservation, and a price isn’t a checkout total.
Channel compatibility
| Channel | Supported |
|---|---|
| Chat bubble | Yes |
| Help page | Yes |
| Center stage | Yes |
| API | Yes |
| Fluent Support | Yes |
Limitations
- Read-only. No cart, checkout, order, account or inventory operations are available.
- Price filters and price sorting use one-time prices. Subscription products keep their recurring terms and aren’t compared as one-time prices.
- Up to five products per comparison.
- Needs a conversation. On the API channel, start with
/chator pass achat_id; a standalone/responsesrequest can’t use this action. - Doesn’t run in the Playground. Test it with Preview in the editor or on a channel instead.
- Bound to one store connection. If the saved connection is removed, create a new action for the current store.
Troubleshooting
Allow public product access in WordPress under FluentChat → Integrations → FluentCart, then check access here.
Possible cause: The connector hasn’t allowed product access for FluentChat.
Solution: In WordPress, open FluentChat → Integrations → FluentCart, allow access, then select Check access again.
Product access is unavailable. Check the FluentCart plugin and permissions in WordPress, then check access again.
Possible cause: FluentCart isn’t active or isn’t a supported setup, or the connector’s permissions changed.
Solution: Check the FluentCart plugin and connector permissions in WordPress, then select Check access.
Saved connection unavailable
Possible cause: The WordPress connection this action was saved with no longer exists or is disabled.
Solution: Restore the connection in Bot > Integrations, or create a new FluentCart action for the current store.