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 asyntaichatbotGet Your Widget ID
Sign in to Asyntai and copy the widget ID from your dashboard. It looks like asyntai_ab12cd34.
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_TOKENTip: 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].