Ir al contenido
ES
Abrir la app

OpenCart

4 min de lectura
Copiar como Markdown
Ver como MarkdownAbrir el archivo .md.md

Esta página aún no está disponible en tu idioma.

With OpenCart connected, the agent recognises a customer from the number they call from, reads back their recent orders and order status, answers product questions (optionally narrowed to a manufacturer) and, if you allow it, creates the order in the store. Integrations - Catalogue - OpenCart - Connect opens the connect dialog. One connection is shared by every agent in the company.

OpenCart needs a REST extension and an API user. With the recommended Dreamvention REST Admin extension:

  1. Install Dreamvention REST Admin, then Extensions - Modifications - Refresh.
  2. System - Users - API - Add new: a username such as voicelogica, status Enabled, click Generate for the API key, Save, and copy the key.
  3. Under IP addresses on the same API user, add the Voice Logica server IP. An empty list is only suitable for testing.
  4. System - Users - User Groups: allow extension/dreamvention_rest_admin/*, plus Access and Modify on catalog/product, catalog/manufacturer, customer/customer and sale/order.
Store URLREQUIRED
The storefront root with https://, without /admin and without a trailing slash.
API usernameREQUIRED
The username of the API user.
API keyREQUIRED
The key generated for that user.
API dialect
Which REST extension the store uses: dreamvention (default and recommended), journal or native.
Store name
Display name for the connection. Optional.
  1. Integrations - Catalogue - OpenCart - Connect, fill the fields, Test connection, then Connect. OpenCart 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 OpenCart and click Configure.

  3. Pick the operations. Identify caller by phone is on by default. Add Get orders by customer and Search products for order and product questions. Add Create order only if the agent should take orders, and set Max order value and Max order lines. Custom order attributes collected by the agent are added to the order comment.

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

  5. Call the agent from a phone number saved on an OpenCart customer (or use Try this agent). Ask “Has my last order shipped?”. The agent should greet you by name and read back the order status. Then ask for a product by name.

JobWhat happens on the call
Recognise the callerMatches the caller’s number to an OpenCart 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: status, totals, items. Pre-fetch recent orders on call start loads the last 10 orders before the agent speaks.
Product questionsSearches the catalogue, optionally by manufacturer, and reads one product’s details.
Take an orderCreates the order in OpenCart within the limits you set.

Customers and products are refreshed daily. Sync now on the OpenCart card under Connected refreshes them immediately.

Test connection fails with 401

The API user is refusing the request, almost always because the Voice Logica server IP is not in the user’s IP addresses list. Also check that the API user is Enabled and that the key was saved after Generate.

Test connection fails with 404

The REST extension’s routes are not active. Go to Extensions - Modifications and click Refresh, then test again. Check that Store URL is the storefront root, not the /admin address, and that API dialect matches the installed extension.

Customers or orders come back empty

The API user’s group lacks permission on customer/customer or sale/order. Add Access and Modify for those routes under System - Users - User Groups, then Sync now.