НачалоДокументация

Shopify Integration

Добавете AI чатботове на ChatReact, контактни формуляри и FAQ акордеони във вашия Shopify магазин с официалното ChatReact Shopify приложение.

Installation

  1. Инсталирайте приложението ChatReact от Shopify App Store
  2. Отворете приложението в администраторския панел на Shopify

Не е необходимо отделно свързване на акаунт — свързвате приложението с вашите чатботове и формуляри, като поставите техните ID-та от таблото на ChatReact.

Features

Shopify приложението предлага три типа джаджи:

WidgetDescriptionPlacement
Chat WidgetAI чатбот с поддръжка на живоНа цялата страница или на конкретни страници чрез App Embed
Form WidgetКонтактни формуляри със защита срещу спамВградено чрез App Block в Theme Editor
FAQ WidgetFAQ в стил акордеонВградено чрез App Block в Theme Editor

Setting Up the Chat Widget

Настройването на чат джаджата се извършва в две стъпки: създаване на widget assignment в ChatReact приложението, след което активиране на App Embed в темата ви.

Step 1: Create a Widget Assignment

  1. Отворете ChatReact приложението в админ панела на Shopify
  2. В раздела Chat Widget кликнете Add Assignment
  3. Въведете вашия ИД на чатбот (намира се в таблото на ChatReact в Вграждане раздела на вашия чатбот)
  4. Кликнете Save Assignment

Step 2: Enable the App Embed

  1. Отидете в Online Store → Themes → Edit theme
  2. Кликнете иконата App embeds (парче пъзел) в долния ляв страничен панел
  3. Превключете ChatReact Chat Widget на ON
  4. Кликнете 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:

  1. Отидете в Online Store → Themes → Edit theme
  2. Навигирайте до страницата, където искате да поставите джаджата
  3. Кликнете Add block и потърсете "ChatReact"
  4. Изберете ChatReact Form или ChatReact FAQ
  5. Въведете 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:

SettingOptions
AlignmentLeft, Center, Right
Max Width200–1200px
Font Size12–28px
Margin Bottom0–120px
ЕзикAuto-detect (default) or one of 24 languages

FAQ Widget Styling

SettingOptions
КатегорииOptional comma-separated category slugs (e.g. general,pricing) to show only selected FAQ categories
Font Size12–28px
Margin Bottom0–120px
ЕзикAuto-detect (default) or one of 24 languages

Managing Widgets

ChatReact приложението в админ панела на Shopify предоставя три раздела:

  1. Chat Widget — Създаване и управление на widget assignments, които контролират на кои страници се показва чат джаджата
  2. Форми — Стъпка по стъпка инструкции за вграждане, ръчния Liquid фрагмент и къде да намерите своя Form ID
  3. 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 магазин.


Next Steps