Aller au contenu
FR
Ouvrir l’app

Magento

4 min de lecture
Copier en Markdown
Voir en MarkdownOuvrir le fichier .md brut.md

Ce contenu n’est pas encore disponible dans votre langue.

With Magento (Adobe Commerce) connected, the agent recognises a customer from the number they call from, finds an order by the order number the customer reads out, answers product questions by name or SKU, estimates shipping for an address and, if you allow it, places the order in the store for the identified customer or as a guest. Integrations - Catalogue - Magento - Connect opens the connect dialog. One connection is shared by every agent in the company.

An Integration in the Magento admin:

  1. System - Extensions - Integrations - Add New Integration. Name it Voice Logica.
  2. Under API, give it access to Customers, Sales and Catalog. Placing orders goes through the Magento cart, so allow cart access too if the agent will take orders.
  3. Save, then Activate. Magento shows four values: Consumer Key, Consumer Secret, Access Token and Access Token Secret. Copy all four.

This OAuth 1.0a method works on every Magento 2.4 release and does not expire. A single bearer / integration token is also accepted, but Magento 2.4.4 and later reject integration tokens used that way unless the store’s OAuth settings allow it.

Store URLREQUIRED
The store’s base address with https://, no trailing slash, for example https://myshop.example.
Store name
Display name for the connection. Optional.
Store view code
For multi-store setups. Leave empty for the default store view.
AuthenticationREQUIRED
OAuth 1.0a (4 keys) or Bearer / integration token.
Consumer keyREQUIRED
OAuth 1.0a only.
Consumer secretREQUIRED
OAuth 1.0a only.
Access tokenREQUIRED
OAuth 1.0a only.
Access token secretREQUIRED
OAuth 1.0a only.
Bearer / integration tokenREQUIRED
Bearer / integration token only.

Connect checks the credentials against the store before saving. There is no separate test button.

  1. Integrations - Catalogue - Magento - Connect, fill the store URL and the four keys, Connect. Magento appears under Connected and customers and products start copying in the background.

  2. Open My Agents, pick the agent, then Skills - Tools & Workflows. Turn on Magento and click Configure.

  3. Pick the operations. Identify caller by phone is on by default. Add Get orders by customer, Get order by id and Search products for order and product questions. Add List shipping options and Create order only if the agent should take orders, and set Max order lines.

  4. Click Save in the settings window, then Save the agent.

  5. Call the agent from a phone number saved on a Magento customer (or use Try this agent). Ask “Can you check order 000000123?” with a real order number from your store. The agent should read back its status and items. Then ask for a product by name or SKU.

JobWhat happens on the call
Recognise the callerMatches the caller’s number to a Magento customer. Can also find a customer by name or email and remember the number for next time.
Order questionsReads the caller’s recent orders, or one order by the order number the customer sees. Pre-fetch recent orders on call start loads them before the agent speaks.
Product questionsSearches by name or SKU and reads one product’s details.
Take an orderEstimates shipping methods and rates for an address, then places the order through the cart for the identified customer or a guest. Shipping and payment methods are chosen from those the store offers for that order.

Customers and products are refreshed daily.

Connect fails with an authentication error

Check that the Integration is Active in Magento and that the four values come from the same Integration. If you chose Bearer / integration token on Magento 2.4.4 or later, switch to OAuth 1.0a (4 keys): those versions reject integration tokens used as bearer tokens by default.

The agent says no shipping or payment method is available

Magento returned no shipping method for the caller’s address, or no payment method for the order. Check the shipping methods and payment methods enabled for that store view, and that the agent collected a full shipping address.

The agent cannot place an order for a product it found

Orders are placed by SKU. When an item cannot be matched to a SKU, the order is refused. Make sure the product has a SKU and that Search products is selected, so the agent picks the item from your catalogue rather than from the caller’s wording.