Shopify Integration
Добавете AI чатботове на ChatReact, контактни формуляри и FAQ акордеони във вашия Shopify магазин с официалното ChatReact Shopify приложение.
Installation
- Инсталирайте приложението ChatReact от Shopify App Store
- Отворете приложението в администраторския панел на Shopify
Не е необходимо отделно свързване на акаунт — свързвате приложението с вашите чатботове и формуляри, като поставите техните ID-та от таблото на ChatReact.
Features
Shopify приложението предлага три типа джаджи:
| Widget | Description | Placement |
|---|---|---|
| Chat Widget | AI чатбот с поддръжка на живо | На цялата страница или на конкретни страници чрез App Embed |
| Form Widget | Контактни формуляри със защита срещу спам | Вградено чрез App Block в Theme Editor |
| FAQ Widget | FAQ в стил акордеон | Вградено чрез App Block в Theme Editor |
Setting Up the Chat Widget
Настройването на чат джаджата се извършва в две стъпки: създаване на widget assignment в ChatReact приложението, след което активиране на App Embed в темата ви.
Step 1: Create a Widget Assignment
- Отворете ChatReact приложението в админ панела на Shopify
- В раздела Chat Widget кликнете Add Assignment
- Въведете вашия ИД на чатбот (намира се в таблото на ChatReact в Вграждане раздела на вашия чатбот)
- Кликнете Save Assignment
Step 2: Enable the App Embed
- Отидете в Online Store → Themes → Edit theme
- Кликнете иконата App embeds (парче пъзел) в долния ляв страничен панел
- Превключете ChatReact Chat Widget на ON
- Кликнете Save
Трябва да активирате App Embed само веднъж. След това управлявате къде се показва джаджата изцяло от ChatReact приложението.
Чат джаджата се появява на всяка страница, обхваната от една от вашите widget assignments.
Widget Assignments
Всяко назначение свързва чатбот с вашия магазин. Има два типа назначения:
- Everywhere: Джаджата се показва на всички страници (по подразбиране). По избор можете да добавите Exclude URLs — един път на ред, с поддръжка на
*джокери (например/blogs/*) - Specific Page: Джаджата се показва само на въведения от вас път на страницата (например
/pages/about)
Ако дадена страница има собствено Specific Page назначение, там ще се покаже този чатбот вместо Everywhere чатбота.
Adding Form and FAQ Widgets
Формите и FAQ джаджите се добавят като App Blocks в Theme Editor:
- Отидете в Online Store → Themes → Edit theme
- Навигирайте до страницата, където искате да поставите джаджата
- Кликнете Add block и потърсете "ChatReact"
- Изберете ChatReact Form или ChatReact FAQ
- Въведете Form ID или Chatbot ID в настройките на блока
Manual Embed (Liquid)
Ако предпочитате да редактирате шаблоните директно, можете също да добавите джаджите във всеки Liquid шаблон:
<!-- Form widget -->
<div id="chatreact-form"></div>
<script src="https://www.chatreact.ai/embed/form.js"
data-form-id="YOUR_FORM_ID"
data-container="chatreact-form"
async></script>
<!-- FAQ widget -->
<div id="chatreact-faq"></div>
<script src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-container="chatreact-faq"
async></script>
Form Widget Styling
Персонализирайте външния вид на формуляра в Theme Editor:
| Setting | Options |
|---|---|
| Alignment | Left, Center, Right |
| Max Width | 200–1200px |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Език | Auto-detect (default) or one of 24 languages |
FAQ Widget Styling
| Setting | Options |
|---|---|
| Категории | Optional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories |
| Font Size | 12–28px |
| Margin Bottom | 0–120px |
| Език | Auto-detect (default) or one of 24 languages |
Managing Widgets
ChatReact приложението в админ панела на Shopify предоставя три раздела:
- Chat Widget — Създаване и управление на widget assignments, които контролират на кои страници се показва чат джаджата
- Форми — Стъпка по стъпка инструкции за вграждане, ръчния Liquid фрагмент и къде да намерите своя Form ID
- FAQ Widget — Инструкции за вграждане на FAQ джаджата и къде да намерите вашия Chatbot ID
Изборът на формуляри и FAQ става в Theme Editor: въведете Form ID или Chatbot ID в настройките на блока.
Language Support
Приложението поддържа всичките 24 езика на ЕС:
- chat widget автоматично засича езика на браузъра на всеки посетител и го съпоставя с поддържаните от вашия чатбот езици, като при необходимост използва основния език на чатбота
- Form and FAQ blocks имат собствено Език настройка в Theme Editor — по подразбиране е Auto-detect и може да бъде променяна за всеки блок
Uninstalling
Когато деинсталирате ChatReact приложението, всички конфигурации на джаджите и съхранените данни автоматично се почистват от вашия Shopify магазин.