How do I connect my Magento store?

What the Magento connection gives you

• The agent searches your store for what the visitor asks about at that moment; it shows products as cards and tells sizes and colors, stock, similar items and items bought together. Your products are not copied to Agenola; prices and stock are what your storefront shows.
• The visitor builds their cart in the chat and goes on to your store's own checkout.
• The visitor can ask about their own order; requests such as a cancellation, return or address change are added to the order as a note for your team.
• Information pages such as returns, shipping and FAQ are added to the agent's knowledge base.

When you connect, an agent named “Magento Agent” is created and the agent button is added to your storefront; the button is hidden on checkout pages by default. You choose which of these the agent does in its AI Assistant step.

Connecting step by step

1. On Integrations → Magento, enter your store's main address in “Store address” (e.g. mystore.com).
2. Press “Connect”.
3. The approval page opens in your Magento Admin. Check the workspace and the person asking, then approve.
4. Back in Agenola you see a message that the store is connected.

If the approval page doesn't open on its own, the “Open the approval page right away” setting is off in your Magento Admin; find the request under Marketing → Agenola AI Sales Assistant and approve it there.

The module creates an integration named “Agenola” in your store. The connection uses its credentials, so it keeps working if the person who connected leaves the team.

After connecting

• “Edit the store agent” opens the created agent.
• “Get changes from your store”: when your storefront address or pages like returns and shipping change, the changes arrive on their own; press it if the agent still uses the old version.
• The Magento Admin link under the buttons opens the Agenola settings in your store; you may be asked to sign in.
• The page shows whether the agent may really cancel orders and open refund records.

Settings in Magento

In your Magento Admin under Stores → Configuration → Agenola:

• Storefront button: showing it on the storefront, hiding it on checkout pages, the window's position (bottom corner or centered, large) and the name shown in the window.
• Real order actions (off by default): when on, a visitor who has verified who they are can have their own order cancelled after confirming a summary of what will happen (if it hasn't shipped and is within the time you set), or have a refund record opened. A refund record sends no money; your team returns the payment through your own payment channel. See Order lookup, cancellations and refunds.
• Recognize signed-in customers (on by default): a customer signed in to your store can ask about their own orders without typing an order number and e-mail.
• Open the approval page right away: when a connection is started, the approval page opens at once; turn it off to keep your Admin address private.

Magento steps in agents

With the Magento step you can work with products and categories; stock; orders (get, list, add a note, cancel, hold); invoices, shipments and refund records; customers; carts, cart price rules and coupons; pages and content blocks.

Actions that can't be undone (deleting, cancelling, creating invoices and refund records) need a confirmation checkbox on the step and are limited to a set number per hour.

Troubleshooting and disconnecting

• Firewall error: a firewall or security plugin in front of your store is blocking the connection. Pass the error message to your developer; they need to let Agenola reach your store.
• “This connection was made with an older permission list”: update the module and reconnect the store.
• The agent button shows but the window opens empty: your store's address may have changed; press “Get changes from your store”.
• To disconnect, press “Remove connection”. The “Agenola” integration in your store is deleted and the button disappears from the storefront. If your store can't be reached, delete the integration yourself under System → Integrations in your Magento Admin.