OXID eShop Integration

Chat on your shop, and answers from your own catalogue

Overview

The Asyntai module puts the assistant on your OXID shop. It answers visitor questions on every page, and it answers from your own articles, with the price, the stock and a card that links to the product.

A shopper can ask "which hose fits a 12 mm fitting" and get the right article out of a catalogue of 25,000.

How It Works

The module does two things.

First, it adds the chat widget to every shop page. It hooks into the shop output, so it works on any theme, and the admin interface is left alone.

Second, it publishes your articles as a feed. Asyntai reads that feed on a schedule, so the prices and the stock in an answer match the ones in your shop.

Requirements

OXID eShop 7.0 or later
PHP 8.1 or later
An Asyntai account. The chat widget works on every plan. The product feed needs the Standard plan or higher.

Installation

Follow these steps to add Asyntai to OXID:

Install the Module

Run these commands in your shop directory:

composer require asyntai/oxid-chatbot
vendor/bin/oe-console oe:module:install source/modules/asyntai/chatbot
vendor/bin/oe-console oe:module:activate asyntaichatbot

Get Your Widget ID

Paste It Into the Shop

In the shop admin open Extensions → Modules → Asyntai AI Chatbot → Settings and put the ID into Widget ID. The whole embed snippet works as well. The chat appears on your shop at once.

Publishing Your Catalogue

Set a Feed Token

In the same settings screen set Feed token to a secret of your choice. The feed URL carries it, and a request without it is refused.

Connect It in Asyntai

Open Real-Time Data Feed in your Asyntai dashboard and paste your feed URL:

https://www.example.com/index.php?cl=asyntaifeed&token=YOUR_TOKEN

Tip: The Standard plan reads 200,000 characters of feed. The Pro plan reads 10,000,000, which is about 25,000 articles.

What the Feed Carries

Each article carries its name, article number, category, price, currency, stock, description, product link and picture. Asyntai builds the product card from those fields.

Only active articles are listed, and only the parent of a variant set, so the same product does not fill an answer many times over. Prices come from the article itself, so the VAT and the currency are the ones a customer sees.

Settings

The module has six settings, in English and German:

Widget ID and Show the chat on the shop
Script URL, which you change only when we ask you to
Publish the product feed, Feed token and Articles in the feed

Removing It

Run vendor/bin/oe-console oe:module:deactivate asyntaichatbot, then composer remove asyntai/oxid-chatbot.

Privacy

The feed carries the article fields listed above, and nothing else. Privacy policy.

Plans & Pricing

The module is free. The chat widget works on every plan. The product feed needs the Standard plan or higher. View pricing.

Need Help?

If you have any questions or run into issues, contact us at [email protected].

ドキュメント