README

Answers your visitors day and night, and answers from your own catalogue with live prices, stock and product cards.

What it does

Chat on every shop page. The assistant reads your shop pages and answers in the visitor's own language, on any theme.
Your catalogue answers too. The module publishes your articles as a feed. Asyntai reads it on a schedule, so a shopper can ask for a product by what they need it to do and get the right article, with its price, its stock and a card that links straight to the product page.
Leads and transcripts. Every conversation is saved in Asyntai, and an email or phone number left in the chat becomes a lead.

Install

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

Set the widget

Open asyntai.com and copy your widget ID from the dashboard.
In the shop admin open Extensions > Modules > Asyntai AI Chatbot > Settings.
Put the ID into Widget ID. The whole embed snippet works too.

The chat now appears on every shop page. The admin interface is left alone.

Publish the catalogue

In the same settings screen, set Feed token to a secret of your choice.
In Asyntai open Real-Time Data Feed and paste your feed URL:

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

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

Settings

Setting	What it does
Widget ID	Your Asyntai widget ID, or the whole embed snippet.
Widget enabled	Turns the chat on your shop pages on and off.
Script URL	Only change this when Asyntai support asks you to.
Feed enabled	Turns the catalogue feed on and off.
Feed token	The secret the feed URL carries. A request without it is refused.
Feed limit	How many articles the feed serves. 25,000 by default.

What the feed carries

Each article carries name, sku, category, price, currency, price_display, in_stock, description, product_url and image_url. Asyntai builds the product card from those exact names.

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

Requirements

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

Help

Documentation · hello@asyntai.com

asyntai / oxid-chatbot

Package info

Security

Statistics