Установка виджета чата Chatsy

<!-- Chatsy -->
<script id="chat-init" src="https://my.chatsy.ru/account/js/init.js?id=7777777"></script>

<!-- Chatsy -->
<script>(function(){var oJ=window.jQuery,oD=window.$;window.jQuery=window.$=undefined;delete window.jQuery;delete window.$;console.log('Before loading widget: jQuery=',window.jQuery,'$=',window.$);setTimeout(function(){var s=document.createElement('script');s.id='chat-init';s.src='https://my.chatsy.ru/account/js/init.js?id=7777777';s.async=true;s.onload=function(){window.jQuery=oJ;window.$=oD;console.log('Chatsy widget loaded successfully')};s.onerror=function(){console.error('Failed to load Chatsy widget');window.jQuery=oJ;window.$=oD};document.head.appendChild(s)},50)})();</script>

Управление диалогами

Чаты имеют всего четыре различных статуса: отметить как прочитанное , архивировать , удалить и восстановить . Вы можете управлять статусом беседы, открыв ее в области бесед, а затем нажав на любую из соответствующих иконок в правом верхнем углу окна беседы.

Поиск диалогов

Вы можете искать диалоги по ID отдела, ID назначенного Менеджера, заголовку диалога, ID диалога, тексту сообщения, имени вложения, имени пользователя, фамилии пользователя, email пользователя

Информация

• Когда вы очищаете корзину , все разговоры в корзине будут окончательно удалены.
• Когда пользователь отправляет новое сообщение в архивированный или удаленный разговор, разговор автоматически восстанавливается и теперь будет виден в области Входящие .
• Удаленные беседы автоматически удаляются через 30 дней.
• При удалении пользователя все беседы и сообщения также удаляются навсегда.
• Менеджер может удалять свои сообщения, открыв меню сообщения и нажав Удалить . Меню сообщений становится видимым, когда вы наводите курсор мыши на сообщение.
• Список левых бесед использует автоматическую пагинацию, которая ограничена 100 результатами на один скролл.

Функции текстового редактора и автоматических сообщений

Редактор текста области администратора и автоматические сообщения (например, приветственные и подписные сообщения) могут быть использованы для создания стилизованных сообщений:

• Форматирование ссылок— Везде текстовые ссылки автоматически преобразуются в кликабельные гиперссылки. Чтобы задать имя ссылки, добавьте следующую строку к URL: #sb-example . Заменить пример на желаемое имя ссылки, а пробелы на -- .
• Форматирование текста— Редактор также поддерживает синтаксис форматирования текста:
  • Чтобы сделать текст жирным, окружите его тегом * : *ваш текст*.
  • Чтобы сделать текст курсивом, окружите его тегом __ : __ваш текст__.
  • Чтобы сделать текст зачеркнутым, окружите его тегом ~ : ~ваш текст~.
  • Чтобы вставить однострочный код комментарий, окружите его ` : `ваш текст`.
  • Чтобы вставить блок кода, окружите его тегом ``` : ```ваш текст```.
• HTML и другие языки кода — По соображениям безопасности не разрешается использование HTML, JavaScript (JS) или других языков кода. Однако вы можете использовать фрагменты HTML, используя настраиваемые богатые сообщения (описывается ниже).
• Чтобы вставить перенос строки в сообщение, используйте комбинацию клавиш SHIFT + ENTER или CTRL + ENTER .

Переменные

Переменные - это строки, заменяемые внешними значениями при использовании. Переменные могут использоваться в любом сообщении или автоматическом сообщении, включая сообщения чат-бота.

{user_name}

{user_email}

{agent_name}

{agent_email}

Богатые сообщения

Rich messages - это специальные сообщения с интерактивными функциями, такими как кнопки, выпадающие списки или поля ввода. Они позволяют Менеджеру запрашивать информацию у пользователя с помощью формы ввода пользователя или отображать интерактивное содержимое. Rich messages могут быть вставлены в сообщение чата с помощью коротких кодов. Короткие коды принимают различные параметры, такие как заголовок и описание. Доступные rich messages перечислены ниже.

Как это работает:

1

Создать и отправить

Создайте богатое сообщение, вставив шорткод в текстовый редактор области администратора. Настройте все параметры с вашей информацией и отправьте ваше сообщение.

2

Сообщение отображается

Когда используется шорткод, пользователь видит богатое сообщение (а не шорткод) и может выбрать или ввести необходимую информацию для завершения отправки формы.

3

Ответ пользователя отправлен

Как только форма богатого сообщения была заполнена и отправлена пользователем, отображается сообщение об успешной отправке, и данные формы сохраняются.

Богатые сообщения

[card image="URL" header="TITLE" description="Lorem ipsum dolor sit amete" link="URL" link-text="Purchase" extra="$599" target="_blank"]

[slider image-1="URL" header-1="TITLE" description-1="Lorem ipsum dolor sit amete" link-1="URL" link-text-1="Purchase" extra-1="$599" image-2="URL" header-2="TITLE" description-2="Lorem ipsum dolor sit amete" link-2="URL" link-text-2="Purchase" extra-2="$599" target="_blank"]

[slider-images images="URL,URL,URL"]

[chips options="A,B,C"]

[buttons options="A,B,C"]

[select options="A,B,C"]

[inputs values="A,B,C" button="Send now"]

[email name="true" last-name="true" phone="true" phone-required="false" placeholder=""]

[timetable]

[articles link="https://chatsy.ru/articles-demo"]

[list values="A,B,- C,- D,E" numeric="true"]

[list values="A:X,B:Y,C:Z"]

[list-image values="URL:A,URL:B,URL:C"]

[table header="A,B,C" values="A:B:C,A:B:C,A:B:C"]

[button link="https://chatsy.ru" name="Click here" target="_blank" style="link"]

[video type="youtube" id="0TImic4N1ko" height="350"]

[image url="https://chatsy.ru/media/admin.png"]

[share fb="https://chatsy.ru/" tw="https://chatsy.ru/" li="https://chatsy.ru/" pi="https://chatsy.ru/" wa="https://chatsy.ru/"]

Специальные символы

Если ваш текст содержит символы , , : , или " , вам необходимо добавить в начало \ символ им. Например: \, , \: , \" .

Глобальные параметры

Везде в богатых сообщениях поддерживаются следующие параметры:

id="123"

title="ABC"

message="ABC"

success="ABC"

settings="ABC"

Используйте богатые сообщения в чат-боте

Вам нужно создать Чат бот Dialogflow , затем просто введите код короткого сообщения в текстовый ответ активного Намерение .

Ответ с богатым сообщением

Когда пользователь завершает обработку богатого сообщения, данные ответа сохраняются в формате JSON в базе данных в таблице sb_messages и столбец нагрузка . Пример:

{"rich-messages":{"4Voyu":{"type":"email","result":{"email":["example@email.com","Your email..."]}}}}

Перевод богатых сообщений

Для перевода строки богатого сообщения исходный текст богатого сообщения должен быть на английском языке, добавьте точный английский текст и его переводы в Setting > Translations > Фронтенд .

Показать богатое сообщение при инициализации чата

Для отображения богатого сообщения, такого как список кнопок, когда пользователь начинает чат впервые, вставьте шорткод богатого сообщения в сообщение приветствия .

Пользовательские богатые сообщения

Вы можете создавать пользовательские богатые сообщения с вашим собственным контентом, перейдя на Настройки > Разное . В настоящее время пользовательские богатые сообщения являются статическими и не имеют интерактивных опций, доступных как с шорткодами. Однако вы можете вставлять пользовательские HTML-коды.

HTML коды

При создании пользовательского богатого сообщения вы можете использовать следующие коды:

<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn">Click here</a>

<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn-text">Click here</a>

<div class="sb-image"><img src="https://via.placeholder.com/1500x600" class="sb-image" /></div>

Встроенные сообщения

Встроенные сообщения - это заранее запрограммированные сообщения, которые отправляются автоматически Chatsy. Вы можете найти их, перейдя по Настройки > Сообщениеs .

Приветствие

Отправьте сообщение новым пользователям, когда они впервые посещают сайт.

• Форматирование текста поддерживается.
• Переменные поддерживаются.
• Богатые сообщения поддерживаются.
• Приветственное сообщение не отправляется в Slack.
• Беседы, содержащие только приветственное сообщение (и без ответа), автоматически архивируются.

Дежурное сообщение (Follow Up)

Если ни один Менеджер не ответит в течение указанного интервала времени, будет отправлено сообщение с запросом данных пользователя, например адреса электронной почты.

• Форматирование текста поддерживается.
• Переменные поддерживаются.
• Вы можете отправить подтверждение по электронной почте пользователю, заполнив Follow-up Email поля.
• Если задержка не установлен, используется динамический временной интервал и определяется следующим образом: Если Настройки > Разное > Office hours настроен, и текущее время попадает в определенные часы работы офиса, или если хотя бы один Менеджер находится в сети, то задержка будет установлена на 15 секунд. Во всех остальных случаях задержка будет установлена на 5 секунд.
• Повторные сообщения отправляются не чаще одного раза в 24 часа.
• Следующее сообщение отправляется только пользователям без адреса электронной почты.
• Если чат-бот передача чата человеку Функция активирована, последующее сообщение отправляется только во время подключения человека.

Рейтинг

Отобразите форму обратной связи, чтобы оценить беседу, когда она будет заархивирована.

• Сообщение оценки несовместимо с каналами обмена сообщениями.
• Рейтинг виден в правой панели беседы область, в рейтинги Менеджеров отчет о отчеты область и в профиле Менеджера.

Автономное сообщение

Уведомляйте пользователя, если его сообщение отправлено в нерабочие часы или когда все Менеджеры находятся в автономном режиме.

• Форматирование текста поддерживается.
• Переменные поддерживаются.
• Чтобы узнать больше о возможности часов работы офиса, пожалуйста, нажмите здесь .
• Офлайн-сообщение отправляется тому же пользователю не более 1 раза в час.
• По умолчанию оффлайн-сообщение также отправляется, если все Менеджеры находятся в оффлайне, даже в рабочее время. Чтобы предотвратить это, включите Отключить проверку Менеджеров опция.
• Если чат-бот передача чата человеку Функция активирована, офлайн-сообщение отправляется только во время подключения человека.
• Если вы или любой другой Менеджер находитесь в сети, используя Slack , они также будут считаться онлайн-Менеджерами Chatsy.

Сообщение о конфиденциальности

Представьте сообщение о конфиденциальности с кнопками Принять и Отклонить. Для начала использования чата требуется одобрение пользователя путем нажатия на кнопку Принять. Эта функция обеспечивает соблюдение политики конфиденциальности и соответствие GDPR.

• Сообщение о конфиденциальности не отображается, если Настройки > Пользователи > Require registration опция включена.
• The privacy message is also sent to messaging channels like WhatsApp, but the user does not have the option to approve or decline the privacy policy. The messaging functionalities are not blocked either. The message is sent after the user initiates the conversation by sending their first message.

Всплывающее сообщение

Всплывающее сообщение будет появляться над кнопкой чата, когда он в закрытом состоянии.

• Всплывающее сообщение всегда отображается, пока пользователь не закроет его вручную; после этого оно остается закрытым.

Вложения

Здесь вы можете получить информацию о загрузке файлов и вложениях сообщения.

• Следующие форматы изображений отображаются автоматически: .jpg, .jpeg, .png .
• Расширения разрешенных файлов для вложений установлены в supportboard/include/upload.php файл.
• Добавить новые разрешенные расширения файлов, добавив код define("SB_FILE_EXTENSIONS", ["exe", "abc",...]) к config.php файл вашей папки установки Chatsy. Замените ["exe", "abc",...] на массив, содержащий расширения, которые вы хотите разрешить.
• Для инструкций по отправке вложений с чат-ботом нажмите здесь .

Информация

Здесь вы можете получить доступ к информации о различных функциях, связанных с разговорами.

Теги

Теги позволяют более эффективно организовывать и группировать беседы. Пожалуйста, обратитесь к информации ниже для получения дополнительных сведений.

• Вы можете управлять тегами с помощью Настройки > Admin > Tags .
• Теги могут быть назначены беседам различными способами: через область администратора, перейдя к Настройки > Автоматизацияs > More , через Действия Dialogflow , и вставив переменную JS SB_DEFAULT_TAGS на страницу, показывающую чат или на веб-страницу, отображающую чат или панель с билетами.
• Для поиска разговоров с определенными тегами просто введите названия тегов в строку поиска, расположенную в верхнем левом углу области разговоров администратора, или вы можете выбрать нужный тег из меню фильтров в верхнем левом углу. Фильтр тегов виден только в случае, если хотя бы один тег назначен разговору.
• Проверьте Помеченный тег опция отображения значка звездочки тега в области бесед. Это позволяет выбирать беседы, назначенные первому тегу, одним щелчком. Первый тег сверху всегда является звездочкой.
• Вы можете отключить теги с Настройки > Admin > Disable tags .

Заметки

Примечания позволяют пользователям добавлять комментарии к беседам, которые видны только Менеджерам и администраторам.

• If you are usign OpenAI, we suggest enabling the сбор данных заметок опция.

Стенограмма

Полный разговор может быть отправлен пользователю Менеджером или администратором в виде файла транскрипции.

• Менеджеры и Админы могут отправлять пользовательские беседы, нажав на Стенограмма кнопка в правом верхнем углу окна разговора администратора.
• Менеджеры и Админы могут автоматически отправить текстовую запись пользователю, когда беседа архивируется, используя закрыть сообщение доступно по Настройки > Messages & Forms > Закрыть message .
• Транскрипт может быть отправлен пользователю только в случае наличия у него адреса электронной почты.
• Если разговор был переведен, транскрипт также будет включать переведенные сообщения.

Разное

• Формат даты и времени автоматически определяется на основе языковых настроек браузера.

Управление пользователями

Управление пользователями из Область пользователей в левом меню администраторской области.

Импортировать пользователей

Вы можете импортировать пользователей из Настройки > Пользователи > Import users . Поддерживаются только файлы CSV. Вы можете скачать пример файла CSV здесь . В примере файла первая строка является заголовком и столбцами Высота и Цвет волос это пользовательские поля, добавленные из Настройки > Пользователи > Custom fields .

Поиск пользователей

Вы можете искать пользователей по имени, фамилии, электронной почте и настраиваемым полям.

Удалить пользователей

Вы можете удалить пользователя, открыв Пользователь edit box и затем нажмите Удалить пользователя . Чтобы удалить нескольких пользователей одновременно, выберите пользователей, которых вы хотите удалить, из таблицы Пользователей, а затем нажмите в правом верхнем углу Удалить значок .

• Когда пользователь удаляется, все их беседы и сообщения автоматически удаляются навсегда.
• Если пользователь удаленного пользователя вернется на веб-сайт, будет автоматически создан новый пользователь.
• Посетители автоматически удаляются каждые 24 часа.

Дополнительные столбцы таблицы пользователей

Чтобы отобразить дополнительные столбцы в таблице пользователей, перейдите на Настройки > Admin > Пользователи table additional columns и добавьте новые столбцы. Значение каждого столбца - это слаг детали пользователя или дополнительной детали пользователя, которую вы хотите отобразить. Слаг записывается строчными буквами и пробелы заменяются символом - . Например, слаг дополнительного деталя пользователя "Дата рождения" - "date-of-birth".

Типы пользователей

user

lead

visitor

Управление Менеджерами и администраторами

Управляйте, создавайте и удаляйте Менеджеров и администраторов из Область пользователей .

• Настройте привилегии и разрешения Менеджеров с помощью Настройки > Admin > Agent privileges .
• Это может создать супервайзера из Настройки > Admin > Supervisor . Супервизор - это специальный Менеджер с определенными привилегиями, он должен быть администратором. Вы можете добавить несколько супервизоров, указав идентификаторы администраторов через запятую.
• Для создания Менеджера или рекламного администратора перейдите на пользователи area и нажмите кнопку Добавить пользователя вверху справа.
• Только Менеджеры и Админы могут войти в область администратора Chatsy.
• When you activate the Chatsy plugin on WordPress, an admin account is automatically created using the same username and password as the currently logged-in user.

Сбор данных пользователей

Вы можете собирать данные пользователей, такие как их имя и адрес электронной почты, с помощью различных методов:

• С использованием предварительной формы чата с помощью форма регистрации .
• С Следующий шаг сообщение.
• С помощью чат-бота потоки .

Регистрация

Форма регистрации - это форма предварительного чата, которая требует от пользователя ввести определенную информацию перед началом чата.

• Вы можете использовать форму регистрации как форму предварительного чата, ограничив информацию, запрашиваемую у пользователя, только адресом электронной почты пользователя или именем пользователя, например.
• Форма входа отображается только в том случае, если поле электронной почты включено.
• The password field is always shown when the user system is set to "WordPress".

Настройки

Рабочие часы

Вы можете установить расписание рабочего времени офиса с Настройки > Разное > Office hours . Время работы офиса используется для:

• Отправить оффлайн сообщение .
• Отключение и скрытие чата во время нерабочего времени.
• Отключение чатбота в рабочее время и включение его в нерабочее время.

Дополнительно

• Пустые значения в настройках расписания считаются часами вне офиса. Обратите внимание, что вам нужно установить ЗАКРЫТО если вы хотите установить весь день как нерабочие часы.
• Часы работы офиса указаны в формате UTC. Ваше UTC генерируется автоматически при нажатии на поле Настройки > Разное > UTF offset . Оставьте его пустым, затем щелкните по пустому полю, и правильное значение будет сгенерировано. Принимаются только целые числа. Если ваш сдвиг не является целым числом (например, UTC -12:30 или UTC -12:45), попробуйте найти альтернативный сдвиг UTC. Если вы не можете найти целочисленный сдвиг, вам придется вручную скорректировать времена в таблице рабочих часов, чтобы исправить разрыв.
• Формат даты и времени расписания автоматически соответствует тому, который используется в стране языка браузера пользователя.

Статьи

Статьи базы знаний предоставляют мгновенные ответы клиентам, чтобы снизить объем обращений в службу поддержки. Вы можете получить доступ к статьям из левого меню Chatsy.

Как отобразить область статей

• Статьи можно показать на панели управления чатом, включив их из Настройки > Статьяs > Display in dashboard .
• В качестве альтернативы, статьи могут быть отправлены в любом чате с помощью короткого кода для богатого сообщения, [статьи] .
• Следуйте этим шагам, чтобы отобразить статьи на странице вашего домена и веб-сайта. Вы можете отобразить их тремя способами:

  • REST API METHOD

    Вставьте код ниже на вашу страницу. Замените [SUPPORT-BOARD-URL] с URL вашей установки Chatsy и [ВАШ_ТОКЕН] с любым токеном администратора. Если вы используете облачная версия , URL - https://my.chatsy.ru/script/include/api.php , чтобы получить токен, нажмите здесь , также удалите первые два скрипта. Включите атрибут nojquery => true если у вас уже есть jQuery включен на вашей странице. Включите атрибут nojs => true если у вас уже есть встроенный код чата на вашей странице.

    <div id="sb-articles">
         <script src="[SUPPORT-BOARD-URL]/js/min/jquery.min.js"></script>
         <script id="sbinit" src="[SUPPORT-BOARD-URL]/js/main.js"></script>
         <?php
         $ch = curl_init('[SUPPORT-BOARD-URL]/include/api.php' . (empty($_GET['category']) ? (empty($_GET['article_id']) ? (empty($_GET['search']) ? '' : '?search=' . urlencode($_GET['search'])) : '?article_id=' . $_GET['article_id']) : '?category=' . $_GET['category']));
         $parameters = [
             CURLOPT_RETURNTRANSFER => true,
             CURLOPT_SSL_VERIFYPEER => false,
             CURLOPT_USERAGENT => 'Support Board',
             CURLOPT_POST => true,
             CURLOPT_CONNECTTIMEOUT => 5,
             CURLOPT_POSTFIELDS => http_build_query([
                                       'token'=> '[YOUR-TOKEN]', 
                                       'function' => 'init-articles'
                                   ])
         ];
         curl_setopt_array($ch, $parameters);
         $response = curl_exec($ch);
         curl_close($ch);
         echo $response;
         ?>
    </div>
    

  • PHP API METHOD

    Вставьте код ниже на вашу страницу. Замените [SUPPORT-BOARD-URL] с вашим URL-адресом установки, получите его от Настройки > Miscellaneous > Installation URL . Заменить [ПУТЬ-ДО-ДОСКИ-ПОДДЕРЖКИ] с указанием пути к вашей установке Chatsy. Этот метод недоступен в облачная версия . Если jQuery уже включен на вашей странице, не включайте его снова.

    <script src="[SUPPORT-BOARD-URL]/js/min/jquery.min.js"></script>
    <script id="sbinit" src="[SUPPORT-BOARD-URL]/js/main.js"></script>
    <link href="[SUPPORT-BOARD-URL]/css/main.css" type="text/css" rel="stylesheet">
    <link href="[SUPPORT-BOARD-URL]/css/articles.css" type="text/css" rel="stylesheet">
    <div id="sb-articles">
        <?php require('[SUPPORT-BOARD-PATH]/include/articles.php'); ?>
    </div>
    

  • МЕТОД JS

    Вставьте код ниже на вашу страницу. Этот метод не рекомендуется с точки зрения SEO, так как статьи загружаются асинхронно и страница может не быть проиндексирована поисковыми системами. Замените [SUPPORT-BOARD-URL] с вашим URL-адресом установки, получите его от Настройки > Miscellaneous > Installation URL . Если вы используете тег облачная версия , URL - https://my.chatsy.ru/script .

    <script src="[SUPPORT-BOARD-URL]/js/min/jquery.min.js"></script>
    <script id="sbinit" src="[SUPPORT-BOARD-URL]/js/main.js"></script>
    <script>var SB_ARTICLES_PAGE = true;</script>
    <div id="sb-articles" class="sb-loading"></div>
    

  • МЕТОД WORDPRESS

    If you're using the WordPress version you can use the shortcode [sb-статьи] . This method is supported only in the WordPress version.

  Страница показывает категории статей, которые необходимо добавить родительские категории и назначьте им статьи. Статьи будут показаны в том же месте кода выше. Вы можете скрыть виджет чата, добавив JS-код var SB_DISABLED = true; на страницу.

Замена URL

Вы можете включить перезапись URL с Settings Статьяs > URL rewrite . Стандартные URL-адреса Chatsy не являются дружественными для пользователей и содержат параметры. Вы можете переписать URL-адреса через .htaccess файл. Ниже приведен код, который переписывает URL-адреса категорий и страниц статей. URL-адреса категорий изменяются с articles.php?categories=ID к статьи/категория/ID . URL статьи изменяется с articles.php?article_id=ID к статьи/ID .

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^articles?$ articles.php [L]
RewriteRule ^articles/category/(.*)$/?$ articles.php?category=$1 [L,QSA]
RewriteRule ^articles/(.*)$/?$ articles.php?article_id=$1 [L,QSA]
</IfModule>

Изменить статьи с именем вашей страницы статей и установите URL страницы статей в Настройки > Статьяs > Статьяs page URL .

Дополнительно

• Если вы используете категории, все статьи должны быть назначены категории.
• Если хотя бы одна статья переведена на язык пользователя, отображаются только переведенные статьи. В противном случае отображаются все статьи на оригинальном языке.
• Принудительно установите отображение страницы статей на определенном языке, добавив параметр URL язык=КОД-ЯЗЫКА . Заменить КОД-ЯЗЫКА с двухбуквенным языковым кодом.
• Если многоязычный через перевод Функция активирована, статьи и их категории будут автоматически переведены.
• Статьи синхронизируются автоматически с базой знаний Dialogflow, если установлено приложение искусственного интеллекта.
• Вы можете создать внутреннюю ссылку чата на статью с кнопка богатого сообщения .
• Вы можете создать ссылку на конкретную статью с помощью атрибута URL статья=ID , заменить Идентификатор с идентификатором статьи. Пример: https://chatsy.ru/articles-demo?article=Ucsx6 .
• Вы можете создать ссылку на категорию статьи с атрибутом URL категория=ID , заменить Идентификатор с идентификатором категории. Пример: https://chatsy.ru/articles-demo?category=LnNaZ .
• Статьи всегда включаются в обучение вашего OpenAI чат-бот.
• Если какой-то блок не сохраняется, например текстовый блок, отключите все расширения браузера и попробуйте снова.
• Чтобы скрыть виджет чата, вставьте следующий код на страницу статей: <script>var SB_DISABLED = true;</script> .

Язык и переводы

Chatsy полностью многоязычен и предоставляет мощные функции для определения языка пользователя на лету.

Редактировать переводы

Для редактирования языков как чата, так и администратора, перейдите на Настройки > Translations . Некоторые настройки, такие как содержание электронной почты, можно прямо перевести и, следовательно, здесь не нужно переводить.

Язык чата

Чатsy уже переведен на 41 язык. Есть много доступных опций для установки языка:

• ВАРИАНТ 1 Перейти на Настройки > Чат и проверьте Язык опция. Установите ее на многоязычный для автоматического использования языка чата браузера пользователя или языка, сохраненного в профиле пользователя.
• ВАРИАНТ 2 Добавить параметр URL язык=КОД-ЯЗЫКА к скрипту, который загружает чат, замените "LANGUAGE-CODE" на двухбуквенный код языка, который вы хотите отобразить. Например. https://chatsy.ru/supportboard/js/main.js?lang=es или https://my.chatsy.ru/account/js/init.js?id=123456&lang=es для облачная версия .
  Эта функция заставит чат всегда использовать один и тот же язык и Настройки > Чат > Language опция будет проигнорирована. Перейти к википедия.орг/вики/Список_кодов_ISO_639-1 для полного списка кодов языков (см. столбец 639-1). Для традиционного Китайского используйте zt , для использования упрощенного Китайского zh , для использования в бразильском португальском pt .
• ВАРИАНТ 2 - ТОЛЬКО WORDPRESS Перейти на Настройки > WordPress и установите опцию Язык силы . Эта функция заставит чат всегда использовать один и тот же язык и Настройки > Чат > Language опция будет проигнорирована.
• ВАРИАНТ 3 - ТОЛЬКО WORDPRESS The WordPress version of Chatsy uses the default language of the WordPress installation; or the language of the current page or post if the website is multilingual. This feature is compatible with WPML, Polylang, and other multilingual plugins. This feature is automatically disabled if the Настройки > Чат > Language опция активна.

Язык администратора

Для перевода администраторской области выполните следующие шаги:

• Переведите тексты на вашем языке с Настройки > Translations .

Для установки языка администраторской области у вас есть три варианта:

• Активировать опцию Настройки > Admin > Automatically translate администратор area . Эта функция автоматически переводит область администратора, чтобы соответствовать языку профиля Менеджера или языку браузера Менеджера.
• Редактировать файл config.php внутри каталога установки Chatsy и введите код define('SB_ADMIN_LANG', 'КОД-ЯЗЫКА'); в конце содержимого файла. Заменить КОД-ЯЗЫКА с кодом языка, который вы хотите использовать, используйте только 2 буквы, например, вставьте только es , а не es_ES . Эта опция недоступна в облачная версия .

Перевести пользовательские содержимое

Вы можете перевести практически любое пользовательское содержимое, такое как богатые сообщения , заголовки, описания, автоматические сообщения, заголовок чата и многое другое. Чтобы добавить переводы, посетите Настройки > Translations и нажмите на Новый перевод кнопка. Затем введите английский контент, который вы хотите перевести, в первое поле, а его соответствующий перевод во второе поле. Оригинальный текст должен быть на английском. Если у вас есть приложение искусственного интеллекта, вы также можете автоматически перевести все содержимое на любой язык через многоязычный через перевод особенность.

Добавить новый язык

Чтобы добавить новый язык, выполните следующие шаги:

• Через FTP или файловый менеджер перейдите в supportboard\resources\languages\front .
• Дублировать (скопировать и вставить в ту же директорию) supportboard\resources\languages\front\source.json файл.
• Переименуйте файл с кодом языка, который вы хотите добавить. Перейдите к википедия.орг/вики/Список_кодов_ISO_639-1 для полного списка кодов языков (см. столбец 639-1).
• Перейти на Настройки > Translations и новый язык должен появиться автоматически.

Чтобы добавить новый язык для административной области, выполните точно такие же шаги, но используйте папку администратор вместо этого. Новые языки не будут потеряны или удалены при обновлении плагина.

Информация

• Если строка перевода отсутствует, добавьте её, нажав на кнопку Добавить новый перевод .
• Если строка перевода не работает, убедитесь, что удалены все пробелы и переносы строк в начале и в конце строки.
• Редактированные переводы не сохраняются в базе данных, а непосредственно в файлах перевода. Когда перевод редактируется и сохраняется, создается резервная копия в загрузки папка. Резервная копия восстанавливается автоматически при обновлении плагина и активации плагина.
• Некоторые специальные символы, такие как & заменяются эквивалентным кодом HTML (см. https://www.w3schools.com/html/html_entities.asp ). Например. & заменяется на &amp; .
• Вы также можете добавлять недостающие строки перевода с помощью кода. Редактируйте файлы языка, расположенные в supportboard\resources\languages . После редактирования файла новые строки будут видны под Настройки > Translations . Не забудьте нажать Сохранить изменения для сохранения ваших переводов и избежания их потери при обновлении Chatsy.

Отделы

Отделы дают вам возможность распределять беседы и назначать различных Менеджеров на конкретные отделы. Например, вы можете создать отдел под названием "Продажи" и назначить определенные беседы этому отделу. Чтобы начать использовать отделы, выполните следующие шаги:

• Перейти на Настройки > Разное и добавьте, удалите и управляйте отделами. После сохранения перезагрузите страницу.
• Перейти на Users > Менеджеры При редактировании Менеджера появится новое поле, в котором вы сможете указать отдел Менеджера.
• Перезагрузите страницу и вы готовы! В Область чатов , теперь вы увидите опцию установить отдел.

Настройки

• Отображение в виджете чата Отображает список отделов в панели управления чатом и заставляет пользователей выбрать отдел перед началом разговора.
• Отображение изображений Отображает изображение отдела вместо цвета отдела.
• Отображать в списке диалогов Отображает цвет отдела в списке бесед в области администратора.
• Один диалог на отдел Ограничьте пользователей открытием нескольких разговоров в одном и том же отделе, разрешив активным быть только одному разговору на отдел.
• Ярлык Замените метку Отделы (множественное число) с другим текстом. Имя отображается в администраторе и области билетов.
• Одиночная метка Замените метку Отдел (единственное число) с другим текстом. Имя отображается в области администратора и билетов.
• Заголовок блока Установите заголовок списка панели управления чатом. По умолчанию: Отделы.

Как это работает

• Менеджеры и Админы без назначенного отдела всегда видят беседы всех отделов.
• Менеджеры и Админы с назначенным отделом могут получить доступ только к беседам, пользователям и Менеджерам в этом отделе.
• Когда разговор назначается новому отделу, отправляется уведомление по электронной почте всем Менеджерам, назначенным в новый отдел.
• Чат-бот может назначить отдел для активного разговора через Вопросы и ответы установить данные особенность, the потоки действий функция, или Действия Dialogflow .

Как назначить отдел для беседы

Вы можете назначить отдел для беседы несколькими способами:

• Через Вопросы и ответы установить данные особенность.
• Через действия потоков особенность.
• Через Настройки > Miscellaneous > Departments Настройки > Display in dashboard . В этом случае пользователю потребуется выбрать отдел перед началом нового разговора.
• Через Настройки > Автоматизацияs > More .
• Через JavaScript, с переменной var SB_DEFAULT_DEPARTMENT = ID; . Enter the code into the pages where the chat is displayed и replace ID with the department ID. For more details check the API здесь .
• Через API .

Очередь и маршрутизация

Когда очередь активируется через Настройки > Разное > Queue , или маршрутизация активирована через Настройки > Разное > Routing , Chatsy автоматически назначает беседы пользователей всем доступным Менеджерам пропорционально.

• Только онлайн-Менеджеры считаются "доступными" Менеджерами и будут получать новые беседы.
• Беседы распределяются пропорционально между всеми онлайн-Менеджерами.
• Администраторы не включены; администраторы всегда видят все беседы.
• Менеджеры должны архивировать беседу, чтобы отметить её как завершённую; это автоматически даст им доступ к следующей беседе в очереди. Беседа считается активной, если она не удалена или не архивирована.
• Менеджеры могут переключать свой статус между онлайн и офлайн, наводя курсор на свое изображение профиля и затем нажимая на метку всплывающего окна профиля в нижнем левом углу области администратора.
• Менеджеры могут только искать и фильтровать свои разговоры.
• Менеджеры могут только просматривать свои разговоры; однако они могут видеть все разговоры одного пользователя.
• Чтобы Менеджеры могли просматривать все нераспределенные беседы, активируйте Настройки > Miscellaneous > Hide conversations of other agents и Покзывать неназначенные диалоги .
• Очередь и маршрутизация совместимы с отделы .
• Если передача чата человеку активен, очередь или маршрутизация активируется только при подключении человека.

Дополнительно - только очередь

Когда очередь активирована, пользователи автоматически попадают в очередь, когда достигнут предел чата Менеджера. Когда пользователь входит в очередь, отображается сообщение с текущей позицией в очереди и ожидаемым временем ожидания. Chatsy автоматически распределяет беседы между всеми доступными Менеджерами пропорционально. Когда Менеджер помечает беседу как завершенную (архивирует ее), очередь обновляется, и поступает новая беседа.

• Если пользователь находится в очереди и уходит (например, закрывает браузер) на более чем 1 минуту, разговор сохраняется; однако, когда пользователь возвращается, очередь сбрасывается, и пользователь теряет свою предыдущую позицию. Если пользователь уходит, разговор остается не назначенным и поэтому невидимым для Менеджеров, но видимым только для администраторов.
• Вы можете использовать следующие Переменные в сообщении очереди: {position} , {minutes} . Они будут заменены реальными значениями в реальном времени.
• The waiting time is displayed in minutes и is calculated as follows: queue position X response time = waiting time. For example, if a user is 5th in the queue, и the response time has been set to 4 minutes (via Настройки > Miscellaneous > Queue), then the total wait time displayed to the user will be 20 minutes.
• Когда опция звука активна, звучит звук, когда ходит пользователь.
• For conversations started from messaging apps like WhatsApp, it is not possible to respect the limit of conversations per agent, all conversations will be immediately and proportionally assigned to an agent.
• Используйте тег оффлайн сообщение чтобы предотвратить отображение сообщения об обновлении очереди пользователю в чате.

Для тестирования очереди выполните следующие шаги:

• Для имитации нескольких пользователей и Менеджеров откройте чат в нескольких разных браузерах (например, Opera, Firefox, Brave, Chrome и т. д.). Каждый браузер может имитировать двух пользователей/Менеджеров: одного в обычном режиме и одного в режиме "частного" или "инкогнито".
• Для сброса чата и начала новой сессии пользователя откройте консоль браузера и введите SBF.reset() , и нажмите ВВОД .

Дополнительно - только маршрутизация

Когда маршрутизация активирована, Chatsy автоматически присваивает беседы пользователей всем доступным Менеджерам пропорционально.

• Если Routing > Отключить online status check опция активна, беседы распределяются пропорционально между всеми Менеджерами, независимо от того, онлайн они или офлайн.
• Когда Менеджер снова становится онлайн после того, как был оффлайн, все неназначенные беседы автоматически назначаются на него.
• Когда маршрутизация активна, Менеджеры могут вручную направлять беседы другим Менеджерам из правой панели области бесед.
• Если беседа помещена в архив и пользователь в будущем откроет её, отправив новое сообщение, и назначенный Менеджер в беседе не в сети, беседа будет назначена другому Менеджеру.

Ручная маршрутизация

Когда маршрутизация активирована через Настройки > Miscellaneous > Hide conversation of other agents Менеджеры видят только свои собственные разговоры и могут выбирать нераспределенные.

• Выбор менеджера : отображает меню Менеджеров для назначения активного разговора другому Менеджеру.
• Распределять если оффлайн : если беседа помещена в архив и пользователь в будущем снова открывает ее, отправив новое сообщение, и назначенный Менеджер в беседе не в сети, беседа назначается другому онлайн-Менеджеру, если таковой есть, в противном случае - ни одному Менеджеру.
• Покзывать неназначенные диалоги : разрешить Менеджерам просматривать нераспределенные беседы, когда Менеджер отвечает, беседа автоматически назначается на него, и беседа в реальном времени удаляется из области администратора других Менеджеров. Установите эту опцию, чтобы включить ручное маршрутизирование.

Чтение почты

Email piping lets you, your agents, and your users reply to chat messages via email.

Активация

Чтобы активировать перенаправление электронной почты, перейдите на Настройки > Notifications > Email piping и введите информацию о вашем почтовом сервере POP3/IMAP, затем установите адрес электронной почты для использования в канализации электронной почты в Настройки > Уведомления > SMTP и вы готовы! Адрес электронной почты должен быть тем, к которому подключается почтовый сервер. Chatsy будет отправлять все электронные письма с этого адреса электронной почты, и вы, ваши Менеджеры и ваши пользователи будете отвечать на этот адрес электронной почты.

Информация

• Адрес электронной почты Настройки > Notifications > SMTP > Sender email должен совпадать с тем, который используется сервером перенаправления электронной почты.
• Это Notifications > User email notifications Настройка включается автоматически, когда активирована обработка почты. Когда Менеджеры отвечают в Chatsy, электронные письма всегда отправляются пользователю.
• Если вы используете приложение Artificial Intelligence, и настройки Настройки > Artificial Intelligence > Передача чата человеку активен, письма не отправляются, если чат-бот знает ответ.
• Если Конвертировать все Email письма опция активна:
  • Все электронные письма, отправленные на ваш почтовый ящик, будут преобразованы в сообщения чата, имейте в виду, что все письма, включая спам, рекламные письма и другие, могут быть неправильно преобразованы.
  • Email sent by email addresses of agents and admins will be ignored, use another email address for testing.
  • Каждое электронное письмо, отправленное непосредственно на адрес электронной почты для обработки, породит новый разговор с пользователем.
• Вы не можете использовать тот же адрес электронной почты, который использовался для перенаправления электронной почты, чтобы ответить. Все ваши Менеджеры и Админы Chatsy должны использовать другой адрес электронной почты.
• Менеджеры должны отвечать по электронной почте с того же адреса электронной почты, который зарегистрирован в Chatsy.
• Email отправляется Менеджерам только в случае их офлайна. Если они онлайн, то письма не отправляются.
• For Google Gmail и Google Workspace emails, you need to replace your Google password with a Google app password, details on https://support.google.com/accounts/answer/185833 (Создать и использовать раздел паролей приложения). Введите imap.gmail.com как хост и 993 как порт. Вам также нужно разрешить доступ к Gmail менее безопасным приложениям, вы можете сделать это с https://myaccount.google.com/lesssecureapps .
• Email piping requires php5-imap модуль (модуль IMAP). Если его нет на вашем сервере, вы можете установить его с помощью команды apt-get install php5-imap . Если у вас возникли проблемы, обратитесь в службу поддержки вашего хостинга/сервера.
• The Разделитель опция добавить текст в верхней части всех электронных писем:
  ### Пожалуйста, введите ваш ответ выше этой линии ###
  . Этот текст указывает Chatsy удалить весь контент ниже него, и он полезен для удаления всех цитат ответов. Активируйте его, если вы видите дублированные сообщения в чате. Если эта опция активна, вы и ваши пользователи не сможете использовать строку ### в электронных письмах.
• Email attachments are supported.
• Для работы электронной почты через каналы ответов, ответы на электронные письма должны содержать имя получателя. Например: Chatsy | SB2457-4734 <example@email.com> . Все основные почтовые клиенты, такие как Outlook Web, Outlook, Gmail, Yahoo Mail, поддерживают имя получателя по умолчанию через кнопки ответа чат-бота или ответить всем.
• Из-за особенностей работы электронной почты каждый почтовый клиент использует свои собственные коды, разделители, автоматические строки и другие элементы. По этой причине некоторые чат-сообщения, преобразованные из электронных писем, могут содержать недопустимый текст. Мы работаем над оптимизацией как можно большего числа почтовых клиентов, на данный момент следующие почтовые клиенты оптимизированы и не должны возвращать недопустимый текст: Outlook Web, Outlook, Gmail, Yahoo Mail.
• Email piping supports отделы , если разговор пользователя назначен отделу, уведомления по электронной почте отправляются только Менеджерам, назначенным в этот отдел.
• Если электронное письмо содержит Ответить атрибут, который будет служить основным адресом электронной почты пользователя, и уведомления будут отправляться на этот адрес.

Задание Cron

• Если вы используете облачная версия задание cron уже активировано по умолчанию и будет запускаться как минимум один раз каждые 60 минут.
• You can manually trigger execution and speed up cron jobs via API with the PHP function sb_email_piping() , or the WEB API function перенаправление электронной почты .
• Вы можете создать cron-задачу, которая запускает URL [SUPPORT-BOARD-URL]/include/api.php?piping=true . Используйте комманду */59 * * * * wget [SUPPORT-BOARD-URL]/include/api.php?piping=true чтобы запустить его через командную строку. Замените [SUPPORT-BOARD-URL] с вашим URL установки. Чтобы получить URL, выполните следующие шаги:
  Если вы используете версию WP или PHP, перейдите к Настройки > Miscellaneous > Installation URL . Если вы используете облачная версия , используйте этот URL: https://my.chatsy.ru/script/include/api.php?piping=true&cloud=API-TOKEN и заменить API-TOKEN с вашим API-токен .
• Вы также можете использовать этот файл задания cron: скачать . Задание cron job: php -f ПУТЬ-К-ВАШЕМУ-ФАЙЛУ/cron.php .
• Если вы запускаете задание cron вручную, активируйте Отключить задание cron опция остановить Chatsy от ручного запуска и улучшить производительность.

Прямые сообщения

Прямые сообщения позволяют вам отправлять одно чат-сообщение, электронное письмо или текстовое сообщение одному пользователю или нескольким пользователям. Прочтите информацию ниже, чтобы понять, как это работает.

• Чтобы отправить сообщение, перейдите на Пользователи выберите область и нажмите на значок прямого сообщения. Кнопки прямых сообщений также доступны в профильной панели пользователя.
• Чтобы отправить сообщение всем пользователям, введите Везде в ID пользователей поле.
• Чтобы отправить сообщение группе пользователей, введите их идентификаторы в ID пользователей поле. Вы можете проверить пользователей, а затем нажать на значок прямого сообщения, чтобы автоматически ввести их идентификаторы.
• Поддержка типов сообщений везде Переменные .

Прямое сообщение в чате

• Сообщение чата отправляется в активный разговор, если он есть, в противном случае - в новый разговор.
• Если Настройки > Notifications > User email notifications опция активна, все пользователи с адресом электронной почты уведомляются по электронной почте.
• Если Настройки > Notifications > Text message notifications > Active for users опция активна, все пользователи с номером телефона уведомляются по SMS.
• Если Настройки > Уведомления > Push notifications если опция активна, то отправляется push-уведомление всем пользователям.
• The message is also sent to messaging apps such as WhatsApp и Messenger if the user is connected to them.
• Чтобы отправить сообщение всем пользователям одного мессенджера, введите одну из следующих строк: WhatsApp , мессенджер , инстаграм , телеграм , твиттер , zalo , wechat , viber , строка . Введите билеты отправить сообщение только пользователям, создавшим заявку Чатsy через приложение Tickets.

Прямая электронная почта

• Email header and email signature are automatically included in all emails, set them from Настройки > Уведомления .
• Язык HTML поддерживается.
• Тема поддерживает объединение полей.

Прямые текстовые сообщения

• To enable direct text messages you must enable the SMS in Настройки > Notifications > Text message notifications .

Direct WhatsApp template messages

• Для получения дополнительной информации нажмите здесь .

Автоматизация

Автоматизация позволяет запускать многоязычные автоматические задачи, когда выполняются условия, установленные вами.

• Чтобы удалить условие, установите его в пустое значение. Чтобы отключить автоматизацию, удалите все условия.
• Автоматические сообщения отправляются пользователям только 1 раз.
• Если вы использовали автоматизацию ранее, и пользователи ее уже получили, вам нужно удалить автоматизацию и создать новую, чтобы показать ее пользователям.
• Повторение работает только при использовании в сочетании с дата время .
• Когда дата время используется совместно с критериями точно , значение не должно содержать часы и минуты (чч:мм). Например, 25/10/2021 (25/10/2021 10:30 не будет работать).
• The Настройки > Пользователи > Register all visitors опция должна быть активной, если есть автоматизированные сообщения, которые выполняются при загрузке страницы.
• Город , страны , языки работают автоматически только если оба параметра Настройки > Пользователи > Register all visitors и Настройки > Пользователи > Full visitor details включены.
• Города работает только если детали пользователя местоположение установлено и равно город, страна , или если детали пользователя город установлено.
• Страны работает только если детали пользователя Код страны , или страна установлен, или если детали пользователя местоположение установлено и равно город, страна . Название страны должно быть на английском языке.
• языки работает только если детали пользователя язык_браузера , или язык установлено.
• Посетитель - это Повторный посетитель только если он посетит веб-сайт снова через 24 часа или позже.
• Всплывающие окна появляются только в случае закрытого чата, и они перезаписывают стандартное всплывающее окно. Вы можете проверить запасной вариант сообщения возможность отправить сообщение вместо отображения всплывающего окна, если чат открыт.
• Возможно, вам потребуется включить Настройки > Пользователи > Register all visitors если вы хотите отправить автоматическое сообщение новым пользователям.
• Сообщения чата и всплывающие сообщения отправляются только в том случае, если последнее сообщение пользователя или Менеджера в беседе старше 10 минут. Эта функция предотвращает отправку нежелательных автоматических сообщений во время разговора между Менеджером и пользователем.
• Это Пользовательская переменная проверка условия для переменных JavaScript с заданными именами и значениями. Например, условие пример=ABC встречается, если на странице чата есть следующий код JavaScript: переменная пример = "ABC"; . Добавить несколько переменных, разделенных запятыми.
• Automations are not compatible with the messaging apps like WhatsApp, Messenger, Instagram, Telegram, Twitter, Zalo, WeChat, Viber, Line.

Дополнительные настройки

Сохраненные ответы

Сохраненные ответы, также известные как шаблонные сообщения, представляют собой набор заранее написанных сообщений, к которым Менеджеры могут быстро получить доступ и использовать в редакторе чата.

• Сохраненные ответы можно распечатать, набрав # за которым следует Имя сохраненного ответа , плюс пробел .
• Окно сохраненных ответов можно открыть, набрав ## .
• Используйте \n для переноса строки.
• Если вы используете чат-бот Dialogflow, поиск в панели сохраненных ответов будет включать результаты из намерений Dialogflow.
• У вас есть возможность добавить все намерения Dialogflow в список сохраненных ответов, используя опцию на Настройки > Artificial Intelligence > Google > Добавить Intents to saved replies .

Уведомления

Для понимания того, как работают уведомления и когда они отправляются, прочтите информацию ниже. Если вы считаете, что уведомления не работают, скорее всего, вы просто тестируете их неправильным способом, пожалуйста, прочтите информацию ниже перед обращением за поддержкой.

Email уведомления

И Менеджеры, и пользователи могут получать уведомление по электронной почте, когда поступает новое сообщение.

Email notifications for администратор and agents

• Когда пользователь отправляет свое первое сообщение, если беседа назначена на отдел , электронное письмо отправляется только Менеджерам, назначенным на этот отдел, если беседа назначена конкретному Менеджеру, электронное письмо отправляется только этому Менеджеру, в противном случае электронное письмо отправляется всем Менеджерам, которые в данный момент не в сети. Последующие электронные письма отправляются только последнему Менеджеру в беседе.
• Email notifications are sent only if the last agent in the conversation is offline.
• Если вы используете приложение Искусственный Интеллект, и Настройки > Artificial Intelligence > Передача чата человеку активен, письма не отправляются, если чат-бот знает ответ.
• Чтобы предотвратить получение уведомлений по электронной почте администраторами, установите галочку Настройки > Notifications > Do not send email notifications to администраторs .

Email notifications for users

• Когда Менеджер отправляет сообщение пользователю, электронное письмо отправляется пользователю только в том случае, если пользователь не в сети.
• Отправляется только 1 электронное письмо. Последующие сообщения не вызовут нового оповещения по электронной почте.

Создать электронное письмо

Для управления электронными письмами и создания контента перейдите на Настройки > Уведомления . Можно использовать текст и HTML. Новые строки автоматически преобразуются в <br /> . Вы можете использовать следующие Переменные в электронном письме. Переменные автоматически заменяются обновленной информацией.

{recipient_name}

{sender_name}

{sender_profile_image}

{message}

{attachments}

{conversation_link}

{conversation_id}

Задание Cron

Вы можете запустить следующую задачу cron для отправки уведомлений по электронной почте как пользователям, так и Менеджерам, в этом случае вам также нужно выбрать Настройки > Notifications > Email notifications via cron job . Отправка электронных писем через задание cron улучшит ваши уведомления по электронной почте: они будут включать в себя всю беседу и будут отправлены только 1 раз.

• Вы можете создать cron-задачу, которая запускает URL [SUPPORT-BOARD-URL]/include/api.php?email-notifications=true .
• Используйте комманду */59 * * * * wget [SUPPORT-BOARD-URL]/include/api.php?email-notifications=true чтобы запустить его через командную строку.
• Замените [SUPPORT-BOARD-URL] с вашим URL-адресом установки, получите его от Настройки > Miscellaneous > Installation URL .
• Если вы используете облачная версия , используйте этот URL: https://my.chatsy.ru/script/include/api.php?email-notifications=true&cloud=API-TOKEN и заменить API-TOKEN с вашим API-токен .
• Наша поддержка не включает помощь с этой функцией, так как она предназначена для опытных пользователей и связана с вашим сервером. Для помощи с этим обращайтесь нанять нас .

Возникли проблемы?

Emails may not be delivered several reasons; below are the most common ones:

SMS Уведомления

Both agents and users can be notified via text message when a new message comes in. Text message notifications are provided by Twilio. Twilio is a paid service, but it is cheap, and you can use the trial version to test text message notifications for free.

Активация

• Перейти на https://www.twilio.com и создайте новую учетную запись.
• Подтвердите свой номер телефона.
• Заполните форму и выберите SMS .
• После входа в панель управления нажмите Получить пробный номер , затем Выберите это число .
• Перейдите в административную область Chatsy, перейдите в Настройки > Notifications > Text message notifications , и вставьте идентификатор учетной записи, токен аутентификации, пробный номер (или купленный номер телефона). Найдите все детали в Twilio dashboard .
• If you're using the trial version, you can send notifications only to verified numbers. Enter the Twilio dashboard и click the left button # (Номера телефонов) , затем нажмите Подтвержденные идентификаторы звонящего и добавьте свой номер телефона.
• Для начала использования сервиса live и получения текстовых сообщений в Chatsy вам необходимо приобрести номер телефона. После покупки перейдите на Телефон numbers > Manage > Active numbers , нажмите на ваш номер, и введите URL Chatsy, получите его от Чатsy > Настройки > Notifications > Text message notifications > Get configuration URL .
• Вы закончили.

Информация

• Убедитесь, что вашим Менеджерам и администраторам назначен номер телефона, чтобы текстовые сообщения Менеджеров могли быть отправлены на соответствующие номера.
• Везде номера телефонов должны иметь код страны, начинающийся с символа + (например, +15558675310).
• Вы можете получить номер телефона пользователя через форма регистрации , сообщение с последующими действиями или через [email] shortcode. You can manually enter the user phone from the администратор area or via API.
• Когда пользователь отправляет свое первое сообщение, если беседа назначена на отдел , тестовое сообщение отправляется только Менеджерам, назначенным на этот отдел, если беседа назначена конкретному Менеджеру, текстовое сообщение отправляется только этому Менеджеру, в противном случае текстовое сообщение отправляется, а email отправляется всем Менеджерам, которые не в сети в данный момент. Последующие текстовые сообщения отправляются только последнему Менеджеру в беседе.
• Уведомления по текстовым сообщениям отправляются только в случае, если последний Менеджер в беседе находится в офлайне.
• Если вы используете приложение Искусственный Интеллект, и передача чата человеку активен, сообщения не отправляются, если чатбот знает ответ.
• Чтобы использовать функцию идентификатора отправителя, введите имя отправителя в Номер отправителя поле.

Звуковые уведомления

• Когда Настройки > Уведомления > Sounds когда включены, звук будет воспроизводиться при получении нового сообщения или разговора.
• Аудио будет воспроизводиться только тогда, когда пользователь или Менеджер взаимодействует с документом, кликнув где-то в области администратора или на странице, отображающей виджет чата. Это связано с функцией безопасности браузеров.
• Если звук установлен на повторить , цикл будет продолжаться до тех пор, пока область администратора или страница виджета чата не открыта или свернута. Если область администратора или страница виджета чата открыта и видима, звук вы не услышите.

ИСКУССТВЕННЫЙ ИНТЕЛЛЕКТ

Настройки ниже относятся к приложению искусственного интеллекта.

Установка

• От Настройки > Расширения , нажмите Искусственный интеллект и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .

Передача чата человеку

передача чата человеку происходит в следующих случаях:

• Когда человеческий Менеджер отвечает на сообщение пользователя.
• Когда Настройки > Artificial Intelligence > Передача чата человеку опция активна. Она срабатывает автоматически, когда чат-бот не может понять сообщение пользователя, или может быть запрошена вручную пользователем явным запросом на контакт с человеческим Менеджером.

Общая информация

• Когда активируется ручное управление, чат-бот автоматически отключается до тех пор, пока последний человеческий Менеджер, ответивший на беседу, находится в сети. Если ни один Менеджер еще не ответил на беседу, чат-бот останется активным. После этого чат-бот снова активируется, но в течение 10 дней после ручного управления не будут отправляться сообщения по умолчанию, если чат-бот не знает ответ на вопрос пользователя в той же беседе. Вы можете заставить сообщение Dialogflow отправляться всегда, добавив к намерению пользовательское значение Payload "force-message": true .
• Чат-бот снова полностью активирован, если беседа архивирована или удалена.
• If you're using Slack, no messages will be sent if the chatbot knows the answer. Once the human takeover is active all conversation's messages are sent to Slack.
• Когда человеческий Менеджер отвечает пользователю, включается автоматическое подключение человека.
• The human takeover feature is compatible with OpenAI and will continue to function even if the Dialogflow chatbot is deactivated.
• Чтобы полностью отключить чат-бот при подключении человека, установите флажок Human takeover > Disable chatbot .
• Если человеческое управление уже активно, оно не будет активировано снова, и сообщение о человеческом управлении не будет отправлено. Сообщение если нет ответа будет отправлено вместо этого.

Передача чата человеку option

Когда опция Передача чата человеку если активно, происходит следующее:

• Если включено, запрос отправляется только в том случае, если сообщение, отправленное пользователем, длиннее 3 символов и содержит как минимум два слова. Эта оптимизация предотвращает ошибочные запросы.
• Беседы, на которые чат-бот смог правильно ответить, помечены как прочитанные и перемещены вниз списка Входящие список.

Когда пользователь подтверждает подключение человека, или если оно автоматическое, происходит следующее:

• Беседа помечена как непрочитанная и перемещена вверх списка Входящие .
• Любые будущие сообщения пользователей в том же разговоре, отправленные в течение 10 дней после подключения человека, вызовут уведомления Менеджера.
• Если уведомления по электронной почте Менеджеров активированы, уведомление по электронной почте отправляется Менеджеру, назначенному на разговор, или, если разговор пользователя назначен отдел , Менеджерам, назначенным в этот отдел, в противном случае сообщение отправляется всем Менеджерам, находящимся в офлайне.
• Если уведомления Push активны, то уведомление Push отправляется Менеджеру, назначенному на разговор, или, если разговор пользователя назначен отдел , Менеджерам, назначенным в этот отдел, в противном случае отправляется всем Менеджерам в офлайне.
• Если уведомления по текстовым сообщениям активированы, текстовое сообщение отправляется Менеджеру, назначенному на разговор, или, если разговор пользователя назначен отдел , Менеджерам, назначенным в этот отдел, в противном случае отправляется всем Менеджерам в офлайне.
• Запросы на подключение человека не будут отправляться в течение 10 дней после подключения человека в том же разговоре.
• Это повторное сообщение и оффлайн сообщение активированы.
• Если очередь настройки активны, очередь или маршрутизация активированы.

Ручное подключение человека - только Dialogflow

• Вы можете вручную запустить взятие контроля человеком, создав новый Dialogflow Намерение со следующим Пользовательский нагрузка ответ: { "human-takeover": true } .
• Ручное подключение автоматически уведомляет Менеджеров по электронной почте и оставляет беседу отмеченной как непрочитанную.
• Для ручной отправки запроса на подключение человека используйте богатое сообщение chips с ID sb-human-takeover . Например. [фишки id="sb-human-takeover" options="Поддержка человека,Отмена" message=""] .

Manual human takeover - OpenAI Only

• The human takeover can be requested manually by the user explicitly asking to contact a human agent. This setting is active by default. This setting is compatible only with the following OpenAI models: o3-mini , o1 , o1-mini , gpt-4o-mini , gpt-4o , gpt-4-turbo , gpt-4 .

OpenAI Assistant

To enable human takeover on an OpenAI Assistant add the following функция in the OpenAI область функций :

                                {
                                    "name": "sb-human-takeover",
                                    "description": "I want to contact a human support agent or team member. I want human support.",
                                    "parameters": {
                                        "type": "object",
                                        "properties": {},
                                        "required": []
                                    }
                                }
                            

WhatsApp, Messenger, Telegram, и other messaging apps

The make the human takeover request work on WhatsApp, Messenger, Telegram и the other messaging apps, you need to create a new Намерение с передача чата человеку как Ввод контекста , ничего как Контекст вывода , список наиболее часто используемых сообщений подтверждения пользователя как Обучение фразам (например, ок, да) и { "human-takeover": true } как Пользовательский нагрузка ответ .

Генератор готовых ответов в чате

Smart Reply предлагает быстрые ответы в реальном времени во время разговора. После активации вы увидите предложенные ответы в области разговора, если они есть.

Информация

• The Smart Reply feature initially checks for suggestions from the Dialogflow chatbot, provided it is active. If there is at least one suggestion, it will promptly display the results. However, if Dialogflow is inactive, or there are Dialogflow suggestions, the OpenAI suggestions will be returned instead.
• Если определение языка Функция активна, умные ответы также будут использовать определение языка.
• Если многоязычный через перевод Если функция включена, умные ответы также будут использовать многоязычный перевод.
• Чтобы прочитать полный текст умного ответа, наведите указатель мыши на него на протяжении 3 секунд.
• Чтобы восстановить предыдущее сообщение, нажмите комбинацию клавиш на клавиатуре CTRL + Z .

Оптимальная конфигурация для чатбота

Чатsy предоставляет мощные инструменты для помощи вам в процессе создания чатбота.

• Активировать Artificial Intelligence > Google > Dialogflow chatbot . Если у вас есть общие или конкретные вопросы, требующие определенного ответа, или если вы хотите воспользоваться богатые сообщения like buttons, the Dialogflow chatbot is the best option и it can work alongside the OpenAI chatbot. The Dialogflow и OpenAI chatbots can work together simultaneously. More details здесь .
• Продолжайте улучшать чат-бот с помощью окно обучения чат-бота .
• Активировать Artificial Intelligence > Smart Reply . Дополнительные детали здесь .
• Активировать следующее OpenAI настройки: Чат-бот , Правка орфографии , Исправление орфографии в Dialogflow , Переписать кнопку сообщения . Дополнительные детали здесь .
• Train your OpenAI chatbot with your own content, more details здесь .
• Установите значение Google > Dialogflow Intent detection confidence в 0.81 .
• Если ваш веб-сайт получает трафик из нескольких стран, рассмотрите активацию следующего Google опции: многоязычный через перевод , автоматический перевод , определение языка .
• Измените имя чат-бота с Настройки > Пользователи > Bot name .

Окно обучения чатбота

Вы можете открыть окно обучения чат-бота из области беседы, наведя курсор мыши на сообщение, открыв меню сообщения и выбрав Обучить чат бота .

• Если Dialogflow активен, новый Intent будет добавлен в основной Менеджер Dialogflow.
• If OpenAI is active, the OpenAI chatbot will be trained automatically with the new information. You can control the questions and answers generated from this window from Chatbot > Training > Questions и answers .
• Это Сервисы для обновления option let you choose what chatbots to update. When updating a Dialogflow Intent, a new OpenAI question и answer will be generated.
• The training window is not compatible with OpenAI assistants.

Возникли проблемы?

The most frequent reasons for OpenAI or Google not functioning properly are listed below. For more details about the issue, open the инструменты разработчика браузера и затем консоль перейдите на вкладку, отправьте сообщение через чат Chatsy, и в консоли должна появиться ошибка. В Chrome вы можете открыть консоль, нажав Настройки > Больше tools > Developer tools > Console .

OpenAI и Google

• Здесь есть a передача чата человеку .
• Вы можете нанять нас для синхронизации за вас, подробности на нанять нас страница.

OpenAI

• Нажмите на Настройки > Artificial Intelligence > OpenAI > Troubleshoot problems button and check for any error. If there is an error, it will be related to your OpenAI account, follow the error message instructions to fix the issue.
• Убедитесь, что выбрана опция Настройки > Artificial Intelligence > OpenAI > Чатbot .
• You reached the quote limit or you are encountering billing problems with your OpenAI account. Check it at https://platform.openai.com/account/usage .
• If Dialogflow is enabled, OpenAI may not work correctly because your Dialogflow agent does not have the Fallback Intent. Please verify its presence on the Intents page, and if it's missing, you can create it again by following the instructions здесь . Чтобы быстро проверить, является ли это проблемой, вы можете отключить Dialogflow и отправить сообщение, состоящее из 2-3 слов. Затем проверьте, есть ли ошибки в консоли браузера.
• If the chatbot is not replying at all and you have some Google setting active, try to disable the Google settings and check if the chatbot is working.
• Убедитесь, что вы прочитали общие информация .
• Если обучение не работает должным образом, например, если чат-бот не отвечает на вопросы, соответствующие обучающим данным, попробуйте удалить все обучающие данные из Chatbot > Training > Informaion > Delete all training data и обучите чат-бота снова.
• If the training is not working as intended, for instance, if the chatbot replies are cut off or partially incorrect, try asking the same question a few more times. The responses should improve over time. OpenAI is needs to learn from the user interactions.
• Если ваши обучающие данные взяты с веб-сайта, и этот сайт многоязычный, убедитесь, что язык атрибут элемента &lthtml> тег содержит правильный язык.
• Delete all of your OpenAI settings, leave only the OpenAI key and try again.
• Try to use the OpenAI ассистент вместо.
• Если вы используете облачная версия , you can use our OpenAI key by setting Настройки > Artificial Intelligence > OpenAI > Sync mode в Автоматически . If this resolves your problems, it means that the issue originates from your OpenAI account. You need to purchase кредиты для использования этой опции.

Google

• Нажмите на Настройки > Artificial Intelligence > Google > Troubleshoot problems button and check for any error. If there is an error, it will be related to your Google account, follow the error message instructions to fix the issue.
• Убедитесь, что выбрана опция Настройки > Artificial Intelligence > Google > Dialogflow chatbot .
• Если синхронизация не удалась, мы рекомендуем ознакомиться с нашей документацией и повторить шаги синхронизации, чтобы исправить ошибки. При необходимости мы предоставляем услуги интеграции. Подробности на нанять нас страница.
• Вы выбрали неправильное местоположение Менеджера.
• Убедитесь, что вы не используете мега-Менеджера.
• Убедитесь, что вы прочитали общие информация .

OpenAI

Настройки ниже относятся к приложению искусственного интеллекта.

Синхронизация

Автоматический режим синхронизации

Эта функция доступна только на облачная версия о Чатsy.

• Автоматический режим синхронизации готов к использованию и не требует дополнительных настроек. Установите его на Настройки > Artificial Intelligence > OpenAI > Sync mode .
• Если вы хотите активировать чат-бота, отметьте Настройки > Artificial Intelligence > OpenAI > Чатbot .
• Вам необходимо приобрести кредиты для использования этой опции.

Ручной режим синхронизации

The OpenAI (ChatGPT) integration gives your chatbot the ability to answer general questions about almost anything you can imagine. To start using it, follow the steps below.

• Зарегистрируйтесь на https://beta.openai.com/signup .
• Get an API key from https://beta.openai.com/account/api-keys и вставьте его Настройки > Artificial Intelligence > OpenAI > API key . Если вы используете облачная версия , установить Настройки > Artificial Intelligence > OpenAI > Sync mode в В ручную .
• Включите чат-бот с Настройки > Artificial Intelligence > OpenAI > Чатbot .

Настройки

See information about most OpenAI settings here.

Режим чат бота

Эта функция связана с Настройки > Artificial Intelligence > OpenAI > Чатbot mode option. It allows you to configure the information OpenAI will use to respond to user messages.

• Только общие вопросы OpenAI will respond only to general questions и questions related to previous user messages in the same conversation, without using any information you provide. This is the default setting.
• Только вопросы, связанные с вашими источниками OpenAI will only respond to questions related to the information you provide. The user messages will be ignored. You have to first поезд чат-бот с вашими источниками.
• Все вопросы OpenAI will only to questions related to the information you provide, to general questions, и to questions related to previous user messages in the same conversation. You have to first поезд чат-бот с вашими источниками. Это рекомендуемый режим.
• Ассистент Используйте этот режим, если вы используете OpenAI Assistant .

Ассистент

Эти функции позволяют вам использовать своих собственных помощников, созданных на https://platform.openai.com/assistants .

• Если вы используете облачную версию, вам нужно установить Настройки > Artificial Intelligence > OpenAI > Sync mode в В ручную и use your own API key.
• Вы можете использовать несколько ассистентов, добавив их идентификаторы в Настройки > Artificial Intelligence > OpenAI Assistants - Отдел linking и выбор Ассистент в Настройки > Artificial Intelligence > OpenAI > Чатbot mode . Для активации ассистента как самого ассистента, так и беседы должны быть назначены на отдел .
• Ассистент используется только для чатбота и умных ответов, а не для переписывания сообщений и других функций.

Чат-бот

The OpenAI chatbot feature functions similarly to Dialogflow, providing automated responses to user messages. Select the Режим чат бота настройка для указания вопросов, на которые чат-бот способен отвечать. Используйте передача чата человеку возможность перенаправления чатбота на человеческого Менеджера при необходимости.

Сообщение если нет ответа

The fallback message is sent when OpenAI is unable to understand the user question. If the Dialogflow chatbot is enabled, the fallback message will be turned off and the Dialogflow chatbot's fallback message will be utilized instead.

Общий промпт - подсказка ИИ на протяжении всего диалога. Напр: «Ответь «Я не знаю», если не уверен в ответе.»

The prompt instructs OpenAI on how to respond by providing relevant information that can be utilized to answer user inquiries. To comprehend the process, refer to the example prompts listed below.

Если вы решите активировать передача чата человеку feature, you need to tell OpenAI to respond with Я не знаю если он не может предоставить ответ на вопрос пользователя. В приглашении всегда следует включать следующий текст: Ответьте "Я не знаю", если не уверены в ответе .

Промпт для перезаписи сообщений в чате

This prompt instructs OpenAI on how to rewrite a message when the Кнопка перезаписи сообщения активен. Этот запрос должен быть на английском. Chatsy автоматически добавляет следующий текст при необходимости: и использовать язык пользователя, добавить приветствия .

Ответы из источников обучения могут быть использованы с функцией prompt, так как они совместимы.

Коррекция орфографии в чате

Эта функция автоматически исправляет любые орфографические ошибки в сообщении Менеджера.

Язык обучающих данных

Если вы используете обучающие данные Если ваш чат-бот поддерживает несколько языков, укажите здесь язык для обучающих данных по умолчанию. Оставьте как есть по умолчанию если язык по умолчанию обучающих данных - английский.

Генератор готовых ответов в чате

Эта функция позволяет включить Умный ответ функция также работает, даже если чат-бот не активен. Если чат-бот активен, то Умный ответ feature will use OpenAI automatically.

Исправление орфографии в Dialogflow

В случае, если Dialogflow не может найти соответствующий ответ на сообщение пользователя, эта функция проверяет наличие ошибок в написании. Если такие ошибки существуют, Dialogflow снова запрашивает правильно написанную версию сообщения для точного ответа. Хотя у этой функции более высокий приоритет, она все равно может работать совместно с Поиск Гугл функция исправления орфографии.

Кнопка перезаписи сообщения

Эта функция добавляет кнопку к полю ввода текста области диалога, нажмите на нее, чтобы переписать свое сообщение и сделать его более дружелюбным и профессиональным. Приветствия будут добавлены автоматически, если нет предыдущих сообщений Менеджера. Если ваш язык не является английским, вам нужно отредактировать свой профиль Менеджера/администратора и установить правильный язык.

Распознавание аудио в чате

Когда эта опция активна, аудиосообщения будут преобразованы в письменный текст.

• Вам не нужно активировать эту функцию, чтобы чат-бот мог понимать аудиосообщения. Функция распознавания речи чат-бота всегда включена.
• Для лучшей работы этой функции должен быть известен язык пользователя. Чтобы автоматически определить язык пользователя, вы можете включить определение языка особенность.
• Текст будет отображаться рядом с аудиоплеером.
• Сгенерированный текст совместим с перевод особенности.

Указывать ссылки на источники

Когда эта опция активна, ответ автоматически будет включать ссылки на источники и обучающие данные, использованные для генерации ответа. Чтобы включить статьи в качестве источников, сначала нужно установить страницу статей в Настройки > Статьяs > Статьяs page URL .

Извлечение даных из заметок

Когда эта опция активна, вы увидите меню в заметки панель. Меню позволяет автоматически извлекать определенную информацию из сообщений пользователя.

OpenAI parameters

Chatsy allows you to adjust various OpenAI parameters such as temperature and logit_bias, for more details visit https://platform.openai.com/docs/api-reference/completions/create . Don't set any values if you don't know what these parameters do or OpenAI may stop working.

Логит-смещение (От -10 до +10)

Это Логит-смещение (От -10 до +10) параметр должен быть строкой JSON и ключи должны быть строками, например: {"2435":-100, "640":-100} .

Сохр. вопросы для обучении ИИ

When this option is active, OpenAI will generate new user questions in real time when you open the окно обучения чат-бота .

Обучать ИИ бота на диалогах

Автоматически использовать беседы для обучения чат-бота через регулярные интервалы. Вы найдете обучающие данные в Чатbot > Training > Conversations . Обучение происходит с помощью задания cron каждые 24 часа. Используются только сообщения пользователей и Менеджеров, сообщения чатбота игнорируются.

Учитывать данные страницы юзера

When this option is enabled, OpenAI will recognize the context of the web page from which the user is writing the message. The context includes only the page's meta title и meta description texts. T his option is supported solely for the chat widget и is not compatible with messaging channels.

Обучение

С помощью этой функции ваш чат-бот может проходить обучение, используя ваш веб-сайт, тексты, PDF-документы и многое другое. После успешного завершения обучения чат-бот сможет отвечать на вопросы, связанные с вашим контентом.

Обучение с использованием файлов

Этот процесс обучения позволяет вам обучать чат-бота с использованием файлов PDF и TEXT.

• Для доступа к этой функции перейдите по ссылке Чатbot > Training > Files .
• Выберите ваши файлы, нажмите на Обучить чат бота кнопка и ожидание завершения процесса обучения.
• Возможна загрузка файлов только в форматах PDF и TXT.
• Как только обучение завершено, загруженные файлы удаляются.

Обучение с использованием веб-сайта

Этот процесс обучения позволяет вам обучать чат-бота с использованием веб-сайтов.

• Для доступа к этой функции перейдите по ссылке Чатbot > Training > Website .
• Введите URL-адреса веб-сайтов, нажмите Обучить чат бота кнопка и ожидание завершения процесса обучения.
• Если вы обучаете тот же веб-сайт, сначала необходимо удалить данные обучения предыдущего веб-сайта; в противном случае будут обучены только новые URL-адреса.
• Вы можете указать URL веб-сайта, и все дочерние URL будут включены и просканированы, но при больших веб-сайтах более эффективно и менее подвержено ошибкам и бесконечным циклам ссылок использовать XML-карту сайта вместо полаганиясь на URL веб-сайта. Вы можете создать ее с помощью сервиса, например https://www.xml-sitemaps.com .
• Если вы хотите обучить своего чат-бота, используя конкретные страницы своего веб-сайта вместо всех них, вы можете воспользоваться XML-картой сайта. Создайте ее с помощью инструмента, например, https://www.xml-sitemaps.com , а затем удалите страницы, которые вы не хотите включать, отредактировав файл в текстовом редакторе. Чтобы использовать XML-карту сайта, вам нужно загрузить ее либо на свой сервер, либо на внешний онлайн-ресурс. После этого добавьте URL карты сайта в Чатbot > Training > Website . Если ваш файл sitemap содержит более 1000 URL-адресов, рекомендуется разделить его на несколько файлов и обучать чат-бота по одному файлу за раз, чтобы предотвратить сбои сервера.
• Вы можете загружать большие файлы и ваш XML-карту сайта с помощью сервиса, такого как https://tmpfiles.org .

Обучение через вопросы и ответы

Этот процесс обучения позволяет вам обучать чат-бота, добавляя вопросы и ответы индивидуально.

• Для доступа к этой функции перейдите по ссылке Чатbot > Training > Q&A .
• Для получения дополнительной информации нажмите здесь .

Обучение с использованием статей

Этот процесс обучения позволяет вам обучить чат-бота, используя статьи .

• Для обучения чат-бота добавьте статьи и затем нажмите Обучить чат бота кнопка. Статьи используются в качестве источников обучения автоматически.
• Для получения дополнительной информации нажмите здесь .

Обучение с использованием потоков

Этот процесс обучения позволяет вам обучить чат-бота, используя потоки .

• Для доступа к этой функции перейдите по ссылке Чатbot > Flows .
• Для получения дополнительной информации нажмите здесь .

Обучение с использованием разговоров

Этот процесс обучения позволяет обучать чат-бота с использованием разговоров пользователей и Менеджеров.

• Для включения этой функции проверьте Настройки > Artificial Intelligence > OpenAI > Use conversations for training опция.
• Обучающие данные начнут генерироваться в ближайшие дни и будут доступны в Чатbot > Training > Conversations область.
• Хотя этот метод мощный и автоматизированный, он может порождать низкокачественные обучающие данные, если ответы ваших человеческих Менеджеров или сообщения пользователей бесполезны или неверны. Мы настоятельно рекомендуем регулярно проверять обучающие данные. Для большинства чат-ботов мы рекомендуем избегать этот метод.

Обучение с использованием окна обучения чат-бота

После завершения обучения вашего чат-бота, возможно, вы захотите продолжить его улучшение. Эта функция позволяет выбирать сообщения из беседы и использовать их для добавления новых вопросов и ответов или улучшения существующих.

• Для получения дополнительной информации нажмите здесь .

Обучение с использованием информации в реальном времени

Эта функция позволяет чатботу отвечать на вопросы, требующие информации в реальном времени, например, "Какая сегодня температура в Лондоне?".

• Для получения дополнительной информации нажмите здесь .

Информация

• Для добавления новых обучающих данных просто повторно обучите чат-бота. Предыдущие обучающие данные не будут потеряны, и будут добавлены только новые источники.
• Если вы используете облачная версия , для обучения чат-бота существуют ограничения по количеству символов. Однако, если вы используете версию PHP или WP, ограничения отсутствуют. Вы можете просмотреть ограничения по количеству символов здесь .
• The модель встраивания - это необходимо для обучения вашего чат-бота и обработки всех сообщений пользователей. В настоящее время мы используем текстовое вложение-3-маленькое модель. Это необходимо для этих сценариев и не может быть отключено или изменено. Информацию о ценах вы можете найти на https://openai.com/pricing . Проверьте цены на текстовое вложение-3-маленькое модель в Встраивание моделей раздел.
• Перейти на Чатbot > Training > Information , и нажмите Удалить все вопросы кнопка для удаления всех предыдущих данных обучения для чат-бота.

Запустите обучение через задание cron

Если вы используете облачная версия , просто включите Настройки > Artificial Intelligence > OpenAI > Training via cron job опция и задание cron будут активированы. Вы можете проигнорировать инструкции ниже.

Для автоматического обучения чат-бота контентом вашего веб-сайта через регулярные интервалы, создайте задание cron, которое запускает URL [SUPPORT-BOARD-URL]/include/api.php?open-ai-training=true , или используйте комм */59 * * * * wget [SUPPORT-BOARD-URL]/include/api.php?open-ai-training=true чтобы запустить его через командную строку. Замените [SUPPORT-BOARD-URL] с вашим URL-адресом установки, получите его от Настройки > Miscellaneous > Installation URL . Если вы используете облачная версия , используйте этот URL: https://my.chatsy.ru/script/include/api.php?open-ai-training=true&cloud=API-TOKEN и заменить API-TOKEN с вашим API-токен .

• Для облачной версии задание cron может быть выполнено не чаще одного раза в 7 дней.
• Мы настоятельно рекомендуем предоставить XML-карту сайта вместо URL-адреса веб-сайта по причинам производительности.
• Автоматическое обучение ограничено веб-сайтами; файлы, вопросы и ответы и статьи исключены. Повторное обучение удалит предыдущие данные обучения веб-сайта.

Многоязычное обучение

Если ваша аудитория многоязычна, вы можете обучить чат-бота контенту на нескольких языках и ограничить его возможность получения ответов только из источников на языке пользователя. Чтобы активировать эту функцию, проверьте Настройки > Artificial Intelligence > OpenAI > Multilingual Training Sources опция.

• Файлы Файлы в настоящее время поддерживают только один язык.
• Веб-сайты Язык веб-сайта определяется автоматически. Чтобы Chatsy мог понимать язык ваших веб-страниц, <html> должен содержать атрибут язык .
• Вопросы и ответы Q&A в настоящее время поддерживает только один язык.
• Статьи Везде статьи автоматически используются языки.
• Чаты Если автоматический перевод активно, будут использоваться только сообщения на языке Менеджера.

Вопросы и ответы

Информация ниже относится к разделу Вопросов и Ответов области обучения чат-бота. Добавьте вопросы и ответы в чат-бот, чтобы улучшить его производительность. Чат-бот будет использовать эту информацию для ответа на запросы пользователей.

Вопрос

Введите сообщения пользователя, которые будут вызывать ответ. Добавьте столько вариаций вопросов, сколько необходимо. Например, вопросы к ответу Я чат-бот! может быть Кто ты? , Кто ты? , Ты бот? .

Ответить

Введите текст, который будет использоваться для ответа на вопрос пользователя.

Вызов функции

Вызов функции позволяет подключить чат-бота к внешним инструментам и системам. Чат-бот будет запрашивать данные с вашего сервера и возвращать информацию с вашего сервера пользователю. Подробнее здесь . Наша поддержка не включает помощь с этой функцией, так как она предназначена для опытных пользователей и требует настройки кода на вашем сервере. Если вам нужна помощь с этим, не стесняйтесь нанять нас .

Параметры

• URL : Enter the URL of the API endpoint that will supply the necessary values for the function.
• Заголовки : Введите заголовочные параметры ключ-значение, разделенные запятыми. Например, apikey:123345, json:true .
• Свойства : Введите значения, которые пользователь должен предоставить чатботу. Например, город, номер отслеживания и т. д. Чатбот запросит у пользователя эти значения. Если вы уже знаете все возможные значения, вы можете ввести их в Значения, установленные по умолчанию поле.

Ответ от вашего сервера

Ваш сервер должен возвращать JSON-массив со значениями, необходимыми для чатбота. Например, ["order_status" => "Delivered 2 hours and 25 minutes ago"] .

Установить данные и действия

Установите указанные значения пользователя, когда задается вопрос. Вы увидите такие значения в панели сведений о пользователе. Вы можете использовать следующие Переменные для присвоения значений, извлеченных из сообщений пользователя. Включите эти поля в ответ, и они будут заменены фактическими значениями: {language} . Вы также можете использовать эту функцию для выполнения действий, таких как назначение отделы , Менеджеры, и теги к разговору.

Воронки

Информация ниже относится к области потоков чатбота. Потоки позволяют вам легко создавать потоки разговоров, управляемые чатботом. Используйте их, чтобы направлять пользователя к конкретной цели с помощью серии предопределенных сообщений.

Блоки потока

• Начало : Используйте блок start, чтобы установить, когда должны начинаться потоки. Это может быть каждый раз, когда пользователь начинает новый разговор, когда он отправляет определенное сообщение или при загрузке страницы. Если вы установите условия , поток будет запущен только тогда, когда будут выполнены все условия.
• Отправить сообщение : Отправить сообщение пользователю.
• Отправить список кнопок : Отправить список кнопок пользователю.
• Отправить видео : Отправить видео пользователю.
• Получить детали пользователя : Получите данные пользователя и сохраните их в Chatsy. Вы увидите такие значения в панели сведений о пользователе. Вы можете оставить описание поле пусто для стандартных данных, но оно обязательно, если используются пользовательские поля.
• Установить данные : Установите указанные значения пользователя при выполнении блока. Вы увидите такие значения в панели сведений о пользователе.
• Действия : Выполните указанные действия при выполнении блока.
• Условия : Используйте его для создания различных ветвей в потоке. Если условия выполняются, поток будет следовать за установленной ветвью истина , в противном случае установленный как ложь .
• REST API : Используйте его для отправки данных на ваш сервер. Тело должно быть JSON-массивом, и детали пользователя Chatsy автоматически включаются в него под sb ключ. Используйте сохранить ответ секция для сохранения указанных данных пользователя со значениями из ответа вашего сервера. Используйте точечную нотацию JSON. Наша поддержка не включает помощь с этой функцией, так как она предназначена для опытных пользователей и требует настройки кода на вашем сервере. Для помощи с этим обращайтесь нанять нас .

Информация

• Потоки могут быть многоязычными. Добавить переводы для сообщений, текстов кнопок и другого контента в переводы область. Вы также можете использовать многоязычный через перевод функция автоматического перевода. Если язык по умолчанию ваших потоков не является английским, вам также необходимо установить язык по умолчанию Настройки > Artificial Intelligence > OpenAI > Training Sources Язык .

Информация

• If OpenAI is not working, click здесь .
• If Dialogflow is active, the OpenAI query is performed only if the chatbot does not know the answer to the user's question и if the length of the user's message is greater than 4 characters.
• The following settings are compatible with OpenAI: умный ответ , передача чата человеку , отключить для области билетов , отключить в рабочее время , задержка ответа бота , ответить на электронные письма пользователей , ответить на текстовые сообщения пользователя .
• The following Google settings are compatible with OpenAI: многоязычный через перевод , автоматический перевод , определение языка .
• Set the OpenAI chatbot language from Настройки > Чат > Language . Установите его на Многоязычный если ваш веб-сайт поддерживает несколько языков или если ваши пользователи говорят на разных языках. Если вы используете каналы обмена сообщениями, такие как WhatsApp , или Инстаграм , вам необходимо определить язык пользователя через определение языка . Для получения дополнительной информации нажмите здесь .
• If a human takes control, the OpenAI chatbot is deactivated, and is remains deactivated also if the agent goes offline. The Dialogflow chatbot continues to function whenever necessary.
• Стандартная модель - gpt-4o-mini .
• OpenAI supports the use of voice messages through speech recognition.

Google

Настройки ниже относятся к приложению искусственного интеллекта.

Синхронизация

To start using the Google AI services и Dialogflow follow the steps below.

Автоматический режим синхронизации

Эта функция доступна только на облачная версия о Чатsy.

• Нажмите Синхронизировать сейчас и завершите процедуру.
• Если вы хотите активировать чат-бот Dialogflow, проверьте Настройки > Artificial Intelligence > Google > Dialogflow chatbot . Также вам нужно ввести идентификатор вашего проекта чат-бота или имя менеджера, чтобы получить его, следуйте по шаги ниже .
• Вам необходимо приобрести кредиты для использования этой опции.

Ручной режим синхронизации

• Включить Чатsy > Настройки > Artificial Intelligence > Google > Dialogflow Чатbot option и сохраните изменения.
• Перейти на console.cloud.google.com и войдите в систему.
• Выберите или создайте проект, нажав на Выберите проект кнопка в верхнем левом углу. Название проекта на ваше усмотрение.
• Активировать the Dialogflow API by entering Dialogflow API в верхней строке поиска. Нажмите Dialogflow API и затем нажмите Включить .
• Выберите проект и перейдите к Left menu > APIs и services > OAuth consent screen . Выбрать Внешний и нажмите Создать . В Название Расширения введите то, что вы хотите, в Электронная почта службы поддержки пользователей и Контактная информация разработчика введите ваш Email. Нажмите Сохранить и продолжить .
• В разделе областей действия нажмите Добавить или удалить области видимости , прокрутите вниз и внутрь Вручную добавить области вход в зону https://www.googleapis.com/auth/dialogflow,https://www.googleapis.com/auth/cloud-language,https://www.googleapis.com/auth/cloud-translation . Нажмите Добавить в таблицу и затем Обновить и Сохранить и продолжить .
• В разделе тестовых пользователей нажмите Добавить пользователей and add your Google email, use the same email as the currently logged in account. Click Сохранить и продолжить .
• Перейти на Left menu > APIs и services > Credentials и нажмите Создать учетные данные , выбрать Идентификатор клиента OAuth . Как Тип Расширения выбрать Веб-приложение . Введите любое имя, которое вы хотите. В URI перенаправления после авторизации введите URL-адрес перенаправления, получите его от Чатsy > Настройки > Artificial Intelligence > Google > Authorised redirect URI . Нажмите Создать .
• Копировать ID клиента и Секрет клиента и вставьте их в Чатsy > Настройки > Artificial Intelligence > Dialogflow . Сохраните настройки.
• В Настройки > APIs & Services > OAuth Consent Screen нажмите ОПУБЛИКОВАТЬ ПРИЛОЖЕНИЕ . Нет необходимости завершать процесс рецензирования, оставьте его в состоянии ожидания рецензии.
• Нажмите Чатsy > Настройки > Artificial Intelligence > Google > Synchronize . Login with the same Google account you have used till now. On the next screen click Продолжить . На следующем экране выберите все области и нажмите Продолжить .
• Скопируйте Токен обновления и вставьте его Чатsy > Настройки > Artificial Intelligence > Google > Refresh token .
• Вы закончили! Если вы хотите активировать чат-бот Dialogflow, проверьте Настройки > Artificial Intelligence > Google > Dialogflow chatbot . Также вам нужно ввести идентификатор вашего проекта чат-бота или имя менеджера, чтобы получить его, следуйте по шаги ниже . Note that the app does not need to be approved by Google.
• If you are a Google Workspace user, go to https://admin.google.com/ и клик Google Cloud Session control . Установить Политика повторной аутентификации в Никогда не требовать повторной аутентификации .

Dialogflow

Предоставленная ниже информация актуальна для Dialogflow.Warning! We will stop supporting Dialogflow by the end of 2025. Везде its features will be available in Chatsy through OpenAI. Please use OpenAI instead of Dialogflow.

Получить идентификатор проекта

• Войдите в консоль Dialogflow ES, перейдя по ссылке dialogflow.cloud.google.com . You must sign in with the same Google account used during the synchronization.
• Нажмите на иконка шестеренки в верхнем левом углу, рядом с именем чатбота, и откройте область настроек. . Если вы еще не создали чат-бота, следуйте инструкции ниже создать своего первого бота.
• Скопируйте ID проекта .
• Убедитесь выбрать США / ГЛОБАЛЬНЫЙ в верхнем левом углу панели управления Dialogflow. Обратите внимание, что наша система не поддерживает мега-Менеджеров. .

Получить имя менеджера Dialogflow CX

• Войдите в консоль Dialogflow CX, перейдя по ссылке https://dialogflow.cloud.google.com/cx/ .
• Выберите проект желаемого Менеджера и перейдите на страницу Менеджеров. Вы можете зайти на страницу Менеджеров, выбрав Менеджера и нажав на верхнюю кнопку Менеджеры > View all agents .
• Нажмите на меню опций для выбранного Менеджера в клике Скопировать имя .
• Дополнительные сведения на https://cloud.google.com/dialogflow/cx/docs/quick/api#detect-intent-drest .

Местоположение

Установите местоположение или регион вашего Менеджера Dialogflow. Этот параметр является необязательным, если местоположение вашего Менеджера установлено на глобальный .

Намерение приветствия

Активируйте приветственный интент Dialogflow для новых посетителей. Опция Настройки > Сообщениеs & Forms > Welcome message должен быть активным.

Отправить данные пользователя

Отправить пользователю детали форма регистрации и отправляйте богатые сообщения на адрес электронной почты в Dialogflow.

Добавить намерения к сохраненным ответам

Включите намерения Dialogflow в сохраненные ответы. Чтобы получить доступ к опции сохраненных ответов, перейдите на Настройки > Admin > Saved replies .

Создание базового чат-бота

Если вы еще не создали чат-бота, следуйте инструкциям ниже, чтобы создать своего первого. Создание и управление вашим чат-ботом Dialogflow полностью обрабатывается Dialogflow. В Интернете есть много учебных пособий, которые могут помочь вам создать и настроить свой бот Dialogflow.

• Для создания вашего первого чатбота введите Консоль Dialogflow и создайте Менеджера. Как Google project выберите тот же проект, который использовался во время синхронизации.
• Добавить новый Намерение из левого меню и откройте его.
• В Обучение фразам area добавляет вопрос пользователя, на который вы хотите, чтобы чат-бот ответил, добавьте как можно больше вариантов. Например, если вы хотите, чтобы чат-бот отвечал пользователям, спрашивающим ваш адрес организации, добавьте варианты типа "какой ваш адрес", "адрес", "где вы находитесь".
• В Ответы area добавляет ответ чатбота как текстовый ответ . Если вы хотите добавить кнопки, карточки и т. д., вы можете использовать богатые сообщения .
• Вы создали свой первый вопрос и ответ! Проверьте его из правильной области или из чата Chatsy. Добавьте новые намерения, чтобы заполнить своего чатбота вопросами и ответами, которые вам нужны. Вы можете включить базовые предварительно созданные вопросы и ответы, включив Небольшой разговор функция из левого меню.

Вот несколько отличных ресурсов, которые помогут вам создать более сложного чат-бота:

• chatbotslife.com/dialogflow-restaurant-bot-tutorial-1-45ce1d3c0ab5 .
• tutorials.botsfloor.com/building-your-own-chatbot-using-dialogflow-1b6ca92b3d3f .
• marutitech.com/build-a-chatbot-using-dialogflow/ .

Действия

Следующие действия дают чат-боту возможность взаимодействовать с веб-сайтом автономно от имени пользователя. Чтобы использовать действие, перейдите в Dialogflow, отредактируйте Намерение , и добавьте новый Пользовательский нагрузка ответ с следующим синтаксисом: { "ACTION-NAME": ACTION-VALUE } .

{ "human-takeover": true }

{ "redirect": "URL" }

{ "open-article": ID }

{ "transcript": true }

{ "tags": ["Tag 1", "Tag 2"] }

{ "department": ID }

{ "agent": ID }

{ "send-email": { "recipient": "active_user", "message": "", "attachments": [] } }

{ "update-user": true }

{ "archive-chat": true }

{ "update-user-details": { "email": "", "last_name": "", "first_name": "", "extra": { "phone": ["+123456789", "Phone"] }}}

{ "update-user-language": "$language" }

Заполнение Dialogflow

Данные о выполнении, отправленные на ваш URL вебхука, выглядят следующим образом:

 {
    "responseId": "4a58fc4f...",
    "queryResult": {
        "queryText": "fullfilment",
        "parameters": [],
        "allRequiredParamsPresent": true,
        "fulfillmentText": "Example",
        "fulfillmentMessages": [{
            "text": {
                "text": ["Response"]
            }
        }],
        "outputContexts": [{
            "name": "projects/schiocco...",
            "parameters": {
                "no-input": 0,
                "no-match": 0
            }
        }],
        "intent": {
            "name": "projects/schiocco...",
            "displayName": "Fullfilment"
        },
        "intentDetectionConfidence": 1,
        "languageCode": "en"
    },
    "originalDetectIntentRequest": {
        "payload": {
            "support_board": {
                "conversation_id": "3002",
                "user_id": "3777"
            }
        }
    },
    "session": "projects/example/agent/sessions/3777-3002"
 }

Это нагрузка и сессия поля содержат идентификатор пользователя Chatsy и идентификатор беседы.

Информация о Dialogflow

OpenAI

If OpenAI is enabled, Dialogflow takes priority over it. The OpenAI API will only be used if Dialogflow cannot answer the user's question.

Обучение и оптимизация чатбота

• Потребуется некоторое время, чтобы ваш чат-бот стал постоянно давать правильные ответы на все вопросы. Для улучшения его производительности вам и вашим сотрудникам следует непрерывно обучать чат-бота, внедряя новые варианты вопросов и намерений. Такой подход эффективно расширит возможности вашего чат-бота.
• Менеджеры могут добавлять новые намерения и ответы чат-бота, а также добавлять новые обучающие фразы к существующим намерениям на лету из административной области, наводя курсор мыши на сообщение и нажимая на значок намерения Dialogflow. Включить Настройки > Artificial Intelligence > OpenAI > Generate user questions для автоматического добавления вариаций вопроса и переписывания ответа. Новые намерения также будут содержать ответы, в то время как обновление существующих намерений добавит только новые фразы обучения, но не новые ответы чатбота. Если вы используете Dialogflow CX, ответы чатбота будут добавлены в последний использованный поток в разговоре, если таковой имеется, в противном случае - в начальный поток.
• Если чат-бот отвечает неправильными намерениями, перейдите к Dialogflow Console > chatbot Настройки > ML Settings , и установите ПОРОГ КЛАССИФИКАЦИИ ML до более крупного числа, например, 0.6. Также проверьте Уверенность в определении намерения .

Надежность обнаружения намерений Dialogflow

При поиске соответствующего намерения Dialogflow оценивает потенциальные совпадения с уверенностью в обнаружении намерения, также известной как оценка уверенности. Эти значения варьируются от 0.0 (полностью неопределенно) до 1.0 (полностью определенно). Укажите значение в диапазоне от 0.1 к 1.0 . Any answer provided by Dialogflow that is less than this value will not be considered. If you are utilizing Dialogflow alongside your OpenAI chatbot that is trained using your resources, it is recommended to configure the value as 0.81 .

База знаний

База знаний автоматически включена. База знаний - это функция, которая дает вашему чатботу возможность искать ответы в документах (например, в PDF-файлах) или на веб-страницах. Чтобы создать свою первую базу знаний, перейдите на cloud.google.com/dialogflow/docs/knowledge-connectors

Ответ от Dialogflow

Полная документация по Dialogflow JSON ответ автоматически сохраняется в базе данных, sb_messages , столбец нагрузка .

Игнорировать намерение, если оно не соответствует предоставленным ключевым словам

Иногда Dialogflow дает неправильные ответы из-за похожих вопросов с разными темами. Чтобы решить эту проблему, вы можете настроить Chatsy игнорировать Intent, если в сообщении пользователя отсутствуют определенные ключевые слова. Вот как вы можете это сделать:

• Введите Dialogflow и отредактируйте намерение.
• Для каждой обучающей фразы выберите ключевые слова, которые вы хотите, чтобы они были обязательными и свяжите их с новым Сущность , или существующий.
• Под Действия и параметры проверить Необходимо и добавьте новый Общий промпт - подсказка ИИ на протяжении всего диалога. Напр: «Ответь «Я не знаю», если не уверен в ответе.» со значением skip-intent
• Сохраните намерение.

Пользователь attachments

Вложения пользователя отправляются в Dialogflow путем добавления URL-адресов вложений к сообщению.

Вложения чатбота

Чтобы разрешить чат-боту отправлять вложения, добавьте Пользовательский нагрузка ответ и вставьте этот JSON-код:

                                    { "attachments": [["name", "YOUR-LINK"], ["name", "YOUR-LINK"], ["name", "YOUR-LINK"]]}
                                

Богатые сообщения

Для того чтобы позволить Dialogflow отправлять богатые сообщения , просто введите код короткого сообщения с богатым содержанием в ТЕКСТОВЫЙ ОТВЕТ поле или добавьте новое Пользовательский нагрузка ответ и вставьте этот JSON-код: { "rich-message": "shortcode" } . Замените "shortcode" на шорткод богатого сообщения, чтобы получить допустимый JSON-код, вам нужно заменить все " символы с \" . Чтобы получить шорткоды или узнать, как создать богатое сообщение, пожалуйста, нажмите здесь .

Ответ с богатым сообщением

Когда пользователь взаимодействует с богатые сообщения через чат Чатsy (например, нажатием кнопки), богатый ответ в формате сообщения отправляется в Dialogflow следующим образом: ID|ответ , или Идентификатор если тип богатого сообщения - регистрация, электронное письмо, последующее сообщение, в этом случае значения богатого сообщения отправляются как массив в queryParams['payload'] ключ. Идентификатор - это идентификатор богатого сообщения, который можно установить, добавив атрибут id="ВАШ-ID" к короткому коду. Если ID не был установлен, вместо него будет использоваться случайный ID. ответ - это ввод или выбор пользователя. Чтобы заблокировать Dialogflow от ответа на богатое сообщение, добавьте новый интент с Идентификатор как единственное выражение пользователя и без ответа.

If the user is interacting with the chatbot via a messaging app (e.g. WhatsApp), the response of the rich message does not contain the rich message ID и Dialogflow контексты Для того чтобы Dialogflow мог понять, какой намерение активировать для конкретного ответа с богатым сообщением, необходимо использовать тег <code>&lt;p&gt;</code>.

Получить богатый ответ сообщения для регистрации, электронной почты, последующего контакта

• Проверьте опцию Чатsy > Настройки > Artificial Intelligence > Google > Send user details .
• От Left menu > Fulfillment включить Вебхуки , вам нужно только ввести URL файла, который будет получать данные вебхука Dialogflow.
• Создайте намерение с идентификатором богатого сообщения для форма регистрации , введите регистрация , для формы для последующего следования введите sb-follow-up-form , для ввода адреса электронной почты в формы введите электронная почта .
• Включите выполнение для намерения.
• Вы завершили! Файл URL вебхука будет получать детали пользователя Чатsy в виде богатого сообщения.

Последовательное исследование

Для создания последовательного опроса, подобного демонстрационному, вам необходимо ввести Идентификатор богатого сообщения в Обучение фразам , проверьте пример ниже.

• Перейдите в Dialogflow и создайте новый намерение. В Обучение фразам область ввода пользовательского выражения пример опроса . В Ответы введите код области [кнопки id="test-survey-1" опции="Программное обеспечение,Физические товары,Услуги" заголовок="Какой у вас тип бизнеса?" сообщение="Пожалуйста, выберите тип, который лучше всего подходит для вашей компании." успех="Тип вашей компании - "]
• Создайте новый намерение. Введите выражение пользователя тест-опрос-1 и как ответ введите [выберите id="seq-survey-2" варианты="Почта приоритетом, Экспресс-курьер, Международный курьер" заголовок="Способы доставки" сообщение="Выберите предпочтительный способ доставки для ваших клиентов" успех="Предпочтительный способ доставки вашего клиента"]
• Создайте новый намерение. Введите выражение пользователя тест-опрос-2 и как ответ введите Спасибо за заполнение нашего опроса! .
• Вы закончили.

Привязка отделов

• Получить идентификаторы отделов из Настройки > Miscellaneous > Отделs .
• Получите идентификаторы проектов из области настроек Dialogflow ваших Менеджеров.

Дополнительно

• Dialogflow supports the use of voice messages through speech recognition. WhatsApp audio messages and .ogg audio files are not natively supported. To support WhatsApp audio messages and .ogg audio files, activate Настройки > Artificial Intelligence > OpenAI > Speech recognition .
• You can activate the chatbot via API but sending a message with no text and payload { "event": "activate-bot" } .
• Следующие детали отправляются в Dialogflow в Параметры запроса параметр при обнаружении намерения: Идентификатор_диалога , идентификатор_пользователя .
• Кому запустить событие приветствия в Dialogflow CX, создайте Обработчик событий и вставить Добро пожаловать как Пользовательское событие .
• Статьи Chatsy автоматически синхронизируются с базой знаний Dialogflow.
• Используйте переменную JS SB_DIALOGFLOW_AGENT = "ИДЕНТИФИКАТОР МенеджерА" чтобы изменить Менеджера Dialogflow по умолчанию, замените "AGENT ID" на Идентификатор проекта .
• If the user sends the same message again, triggering the same Intent in Dialogflow, и OpenAI is active, Chatsy will attempt to send a message from OpenAI и will ignore the response from Dialogflow.
• Вы можете получить доступ к идентификатор_пользователя и Идентификатор_диалога текущего пользователя и беседы в Dialogflow CX с использованием $session.params.user_id и $session.params.conversation_id коды, которые находятся в области Условия маршрута.

Многоязычный чат-бот

Функция Artificial Intelligence > Google > Multilingual проверяет, есть ли Менеджер Dialogflow на языке пользователя, и активирует его.

• Для работы этой функции должен быть известен язык пользователя. Язык пользователя определяется на основе языковых данных пользователя, если они установлены, в противном случае - на основе языка браузера пользователя. Язык также может быть определен с помощью определение языка особенность.

Автоматический перевод

Функция автоматического перевода автоматически переводит сообщения пользователей на язык Менеджера и сообщения Менеджеров на язык пользователя. Чтобы включить её, установите флажок Настройки > Artificial Intelligence > Automatic translation . Если вы используете облачная версия и Artificial Intelligence > Google > Sync mode установлено на Автоматически , многоязычные функции будут работать автоматически. В противном случае вам придется завершить синхронизация и настройка ниже. The многоязычный через перевод и определение языка функции также требуют выполнения этих шагов.

Настройка

• Войдите в систему https://console.cloud.google.com with your Google account and select the project of your Dialogflow Agent.
• На верхней строке поиска введите облачный перевод , выберите Cloud Translation API включите эту службу. Обратите внимание, что это платная услуга с бесплатным уровнем, могут возникнуть дополнительные расходы.
• Включите выставление счетов, нажав на Left menu > Billing и активировав учетную запись для выставления счетов с действующим способом оплаты.

Информация

• Сообщения пользователя в области администратора автоматически переводятся в реальном времени, чтобы соответствовать языку Менеджера.
• Сообщения Менеджера автоматически переводятся в реальном времени, чтобы соответствовать языку пользователя.
• Менеджеры могут просмотреть исходное сообщение, открыв меню сообщения и нажав Просмотреть исходное сообщение .
• Язык Менеджера основан на язык детали пользователя Менеджера, если установлены, в противном случае на языке браузера или языке области администратора.
• Язык пользователя основан на язык детали пользователя, если установлены, в противном случае на языке чата, если установлены, в противном случае на языке браузера. Язык также можно определить с помощью определение языка особенность.
• Уведомления также переведены.
• Чтобы избежать перевода строки, заключите ее в символы ` или ``` .

Многоязычный через перевод

Функция находится на Настройки > Artificial Intelligence > Multilingual via translation automatically translates user messages into the default language of Dialogflow or OpenAI, and translates Dialogflow or OpenAI messages into the language spoken by the user. Добавитьitionally, this feature translates all text displayed within the chat, such as the chatbot's богатые сообщения , статьи , формы регистрации , и всплывающее окно уведомления. Для повышения производительности и минимизации затрат на перевод, переводы автоматически интегрируются в файлы перевода. Совместите эту функцию с определение языка функция для оптимальных результатов.

• Если английский язык является одним из языков, то английский должен быть языком по умолчанию, оригинальные тексты должны быть на английском.
• If you are using OpenAI with обучающие данные , установите язык по умолчанию для обучающих данных под Настройки > Artificial Intelligence > OpenAI > Training Sources Язык . Оставьте это как по умолчанию если язык по умолчанию обучающих данных - английский.

Определение языка

Определите язык сообщений пользователя и соответственно измените язык пользователя и язык Менеджера Dialogflow, если это возможно, в противном случае покажите сообщение об ошибке. Вы можете использовать следующие поля объединения в сообщении: {language_name} .

• Сообщение пользователя должно содержать как минимум 2 слова.
• Определение языка выполняется только для первых 2 сообщений пользователя в разговоре.
• As long as the OpenAI chatbot is operational and programmed to respond to generic inquiries, the fallback message will never be dispatched, since OpenAI will consistently provide answers to any use message.

Поиск Гугл

The Google search feature at Настройки > Artificial Intelligence > Google search gives your chatbot the ability to search for answers on Google. This feature is helpful for providing answers to questions that require real-time information.

• Зарегистрируйтесь на https://programmablesearchengine.google.com/ .
• Создайте поиск и настройте его так, как вам нужно. Мы рекомендуем добавить только ваш веб-сайт и Википедию, если вы хотите, чтобы ваш чатбот отвечал на общие вопросы, оставьте отключенной опцию Искать во всем вебе . Используйте тег Сущности возможность исключить недопустимые результаты.
• Перейти на Edit search engine > Setup > Basic и скопируйте Идентификатор поисковой системы значение, вставьте его в Чатsy.
• Кому get the API key visit https://developers.google.com/custom-search/v1/overview и клик Получить ключ .

Коррекция орфографии в чате

In the case where Dialogflow is unable to find the appropriate response to the user's message, this function verifies if there are any spelling errors. If any such errors exist, Dialogflow is prompted again with the correctly spelled version of the message for an accurate response. Although it has a lower priority, this feature can still work together with the OpenAI Dialogflow spelling correction feature.

Сущности

Это Сущности setting analyze the user's message и recognize и extract entities like cities, events, dates, и more. Use it to exclude invalid results returned by Google search. To enable this setting follow the steps below.

• Войдите в систему на https://console.cloud.google.com with your Google account and select the project of your Dialogflow Agent.
• Введите Cloud Natural Язык API в строке поиска вверху выберите Cloud Natural Язык API и enable the API .
• Включите выставление счетов, нажав на Left menu > Billing и активировав учетную запись для выставления счетов с действующим способом оплаты. Активируйте выставление счетов для проекта вашего Менеджера Dialogflow.

Информация

• The Google search is performed only if the chatbot does not know the answer to the user's question и if the length of the user's message is greater than 4 characters.
• If the Google search returns a result, the Dialogflow context google-search автоматически активирован. Контекст содержит атрибут ссылка which is the website's link of the Google search result. Use the context to create a new intent that provides the link, if the user sends a message like расскажи мне больше или Я хочу узнать больше .
• Google search is not required to activate the spelling correction. You can disable Google search and activate only spelling correction.
• Google search is compatible with the OpenAI chatbot.

Билеты

Ниже приведены настройки, связанные с приложением Tickets. Приложение Tickets позволяет пользователям создавать беседы и отправлять сообщения через пользовательский интерфейс, отличный от чата.

Установка

• От Настройки > Расширения , нажмите Билеты и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .

Отобразить область билетов

ВЕРСИЯ PHP

Для отображения области билетов вставьте следующий скрипт на вашу страницу.

                                <script src="supportboard/js/min/jquery.min.js"></script> <!-- Not required if jQuery is already loaded -->
                                <script id="sbinit" src="supportboard/js/main.js?mode=tickets"></script>
                            

• Вы не можете включить и чат, и область билетов на одной странице. Убедитесь, что удалили скрипт, который загружает чат. Вы также можете показать область билетов, вставив следующий код <script>SB_TICKETS = true;</script> на любую страницу, отображающую чат.
• Чтобы задать позицию области билетов, введите код <div id="sb-tickets"></div> . Область билетов будет отображаться внутри этого элемента div. По умолчанию область билетов добавляется к тело .

ВЕРСИЯ WORDPRESS

Для отображения билетов используйте шорткод [sb-tickets] . Вставьте его на любую страницу, запись или элемент типа записи.

ВЕРСИЯ ОБЛАЧНОГО ХРАНИЛИЩА

Чтобы отобразить область билетов, включите код встраивания чата на свою страницу и добавьте атрибут &mode=tickets к URL скрипта, например <script id="chat-init" src="https://my.chatsy.ru/account/js/init.js?id=65895623&mode=tickets"></script> . Вы также можете показать область билетов, вставив код <script>SB_TICKETS = true;</script> на любую страницу, отображающую чат.

Информация

• Если область билетов не видна, убедитесь, что опция не отмечена Tickets > Manual initialization . Кроме того, вы можете исследовать другие потенциальные причины этой проблемы здесь .
• Вы также можете использовать область билетов для отображения встроенной или полноэкранной панели чата.
• Билеты - это то же самое, что и чат-разговоры на стороне администратора, единственное отличие от чат-разговоров - это пользовательский интерфейс.
• Большинство настроек чата совместимы с приложением Tickets, но не все из них. Настройки панели управления, всплывающее сообщение и другие несовместимы.
• Dedicated APIs for the Tickets App are available in the API section.
• Чтобы удалить обязательную форму "Новый билет" для новых пользователей, активируйте приветственное сообщение Настройки > Сообщениеs & Forms > Welcome message. The welcome message delay is ignored in the tickets area, the message is sent immediately. .
• Для отключения обязательной регистрации только на одной странице вручную используйте JavaScript-код переменная SB_REGISTRATION_REQUIRED = true . Установите его на истина для принудительной регистрации вместо этого.

WhatsApp

The settings below are related to the WhatsApp app.

Установка

• От Настройки > Расширения , нажмите WhatsApp и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .

WhatsApp Cloud API Setup - Automatic sync mode

Эта функция доступна только на облачная версия о Чатsy.

• Нажмите Синхронизировать сейчас и завершите процедуру.
• Чтобы добавить новые номера, посетите https://business.facebook.com/wa/manage/phone-numbers/ . Если вы добавите новые номера после процесса синхронизации, вам придется синхронизировать их снова. Все номера будут автоматически синхронизированы. Если вы хотите отключить определенные номера, вы можете удалить их из Настройки > WhatsApp > Cloud API numbers .
• If you sync again with the same phone number and do not receive the verification SMS or call, you can enter the latest PIN you received and it will work.

If you do not receive the messages sent to your WhatsApp number in Чатsy, please check the following:

• Нажмите Восстановить соединение и завершите процедуру.
• Перейдите на Мета Бизнес Сьют и добавьте способ оплаты.

WhatsApp Cloud API Setup - Manual sync mode

• Создайте новую учетную запись на https://developers.facebook.com или войдите в свою существующую учетную запись.
• Создайте новое приложение и выберите Другой как тип Расширения . Затем выберите Бизнес . Enter a name for the app and select the Business Админ Панель used for WhatsApp.
• В Чатsy > Настройки > WhatsApp > Cloud API Настройки > Secret key введите строку комнаты, затем перейдите к https://developers.facebook.com/apps выберите ваше приложение. Нажмите Добавить продукт и добавить WhatsApp , затем перейдите к WhatsApp > Configuration и in URL вебхука введите URL, который вы получили от Чатsy > Настройки > WhatsApp > Cloud API > Configuration URL . В Подтвердить токен введите секретный ключ, который вы ранее ввели в Чатsy. Нажмите Подтвердить и сохранить, нажмите Webhook fields > Manage , включите следующие поля вебхука: сообщ. .
• Для проверки интеграции просто перейдите на https://developers.facebook.com и select your app. From there, click on "WhatsApp" in the left menu и then select "API Setup". Copy the ID номера телефона и вставьте его Чатsy > Настройки > WhatsApp > Cloud API numbers > Phone number ID. Enter the desired phone number in the "To" field, such as your personal WhatsApp number, and send a test message. Check your WhatsApp account and send a reply, which should then appear in Chatsy. To reply to the test number from Chatsy, copy the "Temporary access token" and paste it in Чатsy > Настройки > WhatsApp > Cloud API numbers > Token .
• To activate the WhatsApp integration for all phone numbers and add a live phone number, refer to the following guidelines.
  В Чатsy > Настройки > WhatsApp > Cloud API numbers > Token введите постоянный токен доступа, следуйте инструкциям ниже, чтобы его получить.
  • Посетить https://business.facebook.com и перейдите на Left menu > Настройки > Business settings , затем перейдите к Пользовательs > System Пользовательs чтобы просмотреть вашего пользователя системы администратора или создать нового. Откройте пользователя и нажмите Добавить активы , then select the app used for the WhatsApp API integration и check Разработать приложение , или Полный контроль . Пользователь системы должен быть администратором. Если вы не видите эту опцию, нажмите Настройки бизнеса .
  • Нажмите Left menu > Админ Панель > Apps . Выберите свое приложение или добавьте его. Убедитесь, что пользователь системы имеет ли доступ и полный контроль. Если нет, нажмите Добавить пользователя , выберите системного пользователя, нажмите Полный контроль , и нажмите Назначить .
  • Нажмите Left menu > Расширения и под Выберите активы выберите ваше приложение, включите Разработать приложение , или Полный контроль и сохранить.
  • От Пользовательs > System Пользовательs выберите пользователя, которого вы только что создали, и нажмите Создать новый Ключ , нажмите Расширения и select the app used for the WhatsApp API integration, set the Срок действия Комуken в Никогда , включите следующие разрешения: Управление бизнесом в WhatsApp , whatsapp_business_messaging , управление бизнесом . Нажмите Создать Ключ и сохраните. Вставьте токен в Чатsy > Настройки > WhatsApp > Cloud API numbers > Token .
• Для добавления дополнительных номеров телефонов вы можете сделать это, посетив https://developers.facebook.com , выбрав ваше приложение и перейдя к Left menu > WhatsApp > API Setup . Чтобы начать, нажмите на Добавить номер телефона внизу и следуйте предоставленным инструкциям.
  • После активации номера скопируйте ID номера телефона и вставьте его Чатsy > Настройки > WhatsApp > Cloud API numbers > Phone number ID.
  • Если число находится в ожидание статус, вам необходимо войти в панель управления вашего приложения, а затем Left menu > WhatsApp > API Setup и клик Сгенерировать токен доступа .
  • Please keep in mind that if you use your current WhatsApp business number in Chatsy, it will no longer be usable with your WhatsApp Business app, и you will need to migrate it following эти инструкции.

Настройка административной панели 360dialog

• Перейти на https://www.360dialog.com/ и создайте новую учетную запись.
• Введите вашу панель управления и из Left menu > WhatsApp Админ Панельs сгенерировать API-ключ и скопируйте и вставьте его Чатsy > Настройки > WhatsApp > 360dialog settings .
• Нажмите Чатsy > Настройки > WhatsApp > 360dialog Настройки > Synchronize now .
• Done! Chatsy should start receiving the WhatsApp messages sent to your number, и you can reply to those messages from Chatsy.
• Обратите внимание, что вы также можете использовать бесплатную песочницу для тестирования, подробности см. на https://docs.360dialog.com/whatsapp-api/whatsapp-api/sandbox . У санбокс-аккаунта есть ограничения, и некоторые функции, такие как медиа-вложения, не будут работать.

Twilio Админ Панель Setup

• Перейти на https://www.twilio.com и создайте новую учетную запись.
• Подтвердите свой номер телефона.
• Заполните форму и выберите WhatsApp , Предупреждения и Уведомления , Без написания кода вообще , Интеграции сторонних разработчиков .
• От Twilio console копировать ИДЕНТИФИКАТОР УЧЕТНОЙ ЗАПИСИ и ТОКЕН АВТОРИЗАЦИИ и вставьте их в Чатsy > Настройки > WhatsApp > Twilio settings , сохраните изменения.
• Теперь вы создадите бесплатную тестовую учетную запись, чтобы провести несколько тестов и убедиться, что интеграция работает с Chatsy. В левом меню нажмите Messaging > Настройки > WhatsApp sиbox settings и войти в КОГДА ПРИХОДИТ СООБЩЕНИЕ и URL ОБРАТНОГО ВЫЗОВА СТАТУСА URL Чатsy, получите его из Чатsy > Настройки > WhatsApp > Twilio Настройки > Get configuration URL . Обратите внимание, что localhost не будет работать, вам нужен общедоступный URL и рабочий сервер.
• На левой панели меню нажмите Messaging > Try it out > Send a WhatsApp message . Следуйте инструкциям и отправьте сообщение с кодом на указанный номер WhatsApp. Нажимайте кнопки "Далее" до завершения настройки.
• Done! Chatsy should start receiving the WhatsApp messages sent to the sandbox account, and you can reply to those messages from the Chatsy.
• Кому publicly use the WhatsApp integration with your customers you need also to complete the steps below:
  • Обновите свой аккаунт и включите выставление счетов, вы можете сделать это здесь .
  • Purchase a Twilio number, which will be the phone number of your official WhatsApp Business account. More details здесь . You cannot use the phone number of your existing WhatsApp Business account, you must use a Twilio number. More details здесь .
  • From the Twilio console go to Messaging > Services и создайте новый Служба обмена сообщениями . Нажмите Добавить отправителей , выберите WhatsApp Number as the sender type, and add the Twilio number you purchased. Copy the Идентификатор сервиса и вставьте его в Чатsy > Настройки > WhatsApp > Twilio Настройки > Sender .

Unofficial WhatsApp API

Support Boar only supports the Official WhatsApp Cloud API, 360dialog, or Twilio. Unfortunately, unofficial WhatsApp APIs are not supported. However, you can still implement them using the Chatsy API и Webhooks. For more details, visit https://chatsy.ru/docs/api/web . Please be aware that you must possess coding skills as a developer to proceed with this task. Добавитьitionally, our default integrations are equipped with advanced features including chatbot support, automated messages, human takeover, WhatsApp rich messages, attachments, and more. Consequently, although setting up a basic integration for sending and receiving text messages is relatively straightforward, ensuring its flawless functionality is a more intricate process.

Шаблоны

Что касается WhatsApp Business Policy , you cannot send outbound marketing and solicitation messages to end users. End user users must reach out to you first. You have 24 hours from when the end user's message was sent from WhatsApp to reply to the message. To communicate with a user who has not contacted you before or has not been in touch for more than 24 hours, you must opt for the text message fallback or the WhatsApp message template.

• To send message templates you have to add a payment method to your WhatsApp Business Админ Панель. You can do it from https://business.facebook.com/billing_hub/ .
• Чтобы отправить определенный шаблон сообщения группе пользователей, используйте прямые сообщения особенность.

Резервное SMS

To enable the text message fallback you must set up the SMS in Настройки > Notifications > Text message notifications .
Дополнительные детали здесь .

WhatsApp message templates

A WhatsApp message template is a message format that you can use over и over again to message users once they have opted-in и given your app permission to send them messages. You can not Enter the original message into the template, you must use it to notify the user of a new message и instruct him on how to view it, for example by providing a link to your website where the chat is shown.

WhatsApp Cloud API

• Кому получить Название шаблона и управлять посещением шаблонов https://business.facebook.com и перейдите на Left menu > Настройки > More system settings , затем перейдите к Админ Панельs > WhatsApp accounts > Settings и нажмите WhatsApp Manager .
• В Языки шаблонов введите все коды языков, поддерживаемых вашим шаблоном, разделенные запятыми. Список кодов языков здесь (скопируйте только код языка, например, it, es, en_US). Если вы используете шаблон, поддерживающий несколько языков, будет автоматически выбран соответствующий язык для пользователя. В противном случае будет использоваться язык шаблона по умолчанию.
• В Переменные Заголовка и Переменные Тела введите значения, разделенные запятыми, вы можете использовать следующие поля объединения: {recipient_name} , {recipient_email} . Количество введенных здесь параметров должно соответствовать количеству параметров шаблона. Используйте эту функцию, если ваш шаблон использует динамические значения. Для изображений в заголовках передайте URL изображения в качестве первого параметра. Порядок важен, первое объединенное поле будет использоваться как первый параметр шаблона.
• В Переменные кнопки введите ссылку на ваши настраиваемые кнопки или текст быстрых ответов с префиксом быстрый_ответ_ , например, quick_reply_abcde. Каждое значение должно быть разделено запятой. Количество введенных здесь параметров должно соответствовать количеству параметров шаблона. Если есть кнопки или вызовы к действию со статическими значениями, такими как статический URL, введите skip_parameter . Порядок важен, первое поле слияния будет использовано в качестве первого параметра шаблона. Пример:

Альтернативный шаблон

Set the WhatsApp template sent as fallback from Настройки > WhatsApp > Cloud API template fallback . Если вы используете несколько номеров, шаблон должен быть создан для каждого номера WhatsApp, вы можете установить разные шаблоны для каждого номера, но имя шаблона и код языка должны быть одинаковыми. The тестовый шаблон кнопка, отправляющая тестовый шаблон с первого номера.

Отправка шаблонных сообщений пользователю, который ранее не связывался с вами

• В Настройки > WhatsApp > Cloud API Настройки > Business Админ Панель ID введите ваш ID бизнес-аккаунта . Укажите ваш ID бизнес-аккаунта , который можно получить из https://developers.facebook.com . Выберите ваше приложение и перейдите на Left menu > WhatsApp > API Setup .
• Для отправки шаблона конкретным пользователям перейдите в раздел Чатsy Пользователи section и choose the intended recipients. Then, click on the WhatsApp icon located at the top right corner.
• If you are using the WhatsApp Cloud API with a template that supports multiple languages, the matching language for the user will be automatically selected. Otherwise, the default template language will be used.
• If you are using Twilio и have parameters in your template, input the parameter values separated by commas in the Тело раздел.
• Для получения дополнительной информации нажмите здесь .

Twilio

Введите Идентификатор шаблона и атрибуты шаблона, разделенные запятыми, в Чатsy > Настройки > Twilio template .

360dialog

• Получите Пространство имен значение из Left menu > WhatsApp accounts > Details .
• Получить Название шаблона и Язык шаблона по умолчанию из вашей области шаблонов 360dialog.
• В Пользовательские параметры Введите значения, разделенные запятыми, вы можете использовать следующие поля объединения: {recipient_name} , {recipient_email} . Используйте эту функцию, если ваш шаблон использует динамические значения. Порядок важен, первое поле слияния будет использоваться как первое динамическое значение шаблона.
• Chatsy попытается использовать шаблон на том же языке, что и пользователь, если он недоступен, то будет использован шаблон с языком по умолчанию. Следующие языки шаблонов несовместимы: en_GB (используйте en_US), pt_PT (используйте pt_BR), zh_HK и zh_TW (используйте zh_CN), es_AR и es_MX (используйте es_ES).

WhatsApp flows

For more details about the WhatsApp Flows click здесь .

Встроенные потоки

Chatsy автоматически генерирует и отправляет следующий поток. Чтобы сгенерировать поток заново, нажмите Настройки > WhatsApp > Clear flows кнопка.

• Регистрация - This flow is sent when a new user sends their first message to the WhatsApp number, и the Настройки > Пользователи > Require registration опция включена.
• Последующее действие - Этот поток отправляется, если Настройки > Сообщениеs & Forms > Follow-up message опция активна, и у пользователя нет адреса электронной почты.

Отправка пользовательских потоков

Для отправки пользовательских потоков используйте поле слияния {wa_flow id="123" header="" body="" button=""} . Заменить 123 с идентификатором потока и введите текст для атрибутов заголовок , тело , и кнопка .

WhatsApp shop

Для отображения продуктов вашего магазина используйте Переменные ниже.

• Когда пользователь отправляет заказ, информация о заказе отправляется на URL, указанный в Настройки > WhatsApp > Order webhook . The page at that URL should process the order и send a message to the user via the PHP API function sb_whatsapp_send_message() .
• Для подключения магазина к WooCommerce нажмите здесь .

Дополнительно

• You cannot send a WhatsApp message to a user who has sent you a message more than 24 hours ago or has never messaged you before. WhatsApp prohibits this action. Instead, you must use a WhatsApp template или отправьте текстовое сообщение . Если вы столкнулись с сообщением об ошибке "Повторное привлечение", это указывает на данную ситуацию.
• If you does not receive WhatsApp messages make sure you are not assigning the WhatsApp conversations to a отдел and that the WhatsApp number used for testing is not a phone number of a Chatsy администратор or agent. Also, make sure you setup correctly the WhatsApp webhook URL.
• Если вы не можете отправлять сообщения, ошибка должна появиться в области администратора при попытке отправить сообщение пользователю.
• We cannot provide support for Twilio or 360dialog configuration, including all related issues.
• We cannot provide support in getting your WhatsApp account or WhatsApp message template approved.
• WhatsApp conversations и messages are compatible with очередь и маршрутизация .
• Если вы тестируете с помощью sиbox и через 72 часа больше не можете отправлять сообщения на свой номер телефона, вам необходимо повторно привязать свой номер телефона к вашему sиbox.
• Вы можете отправить богатые сообщения to WhatsApp. If you send chips, buttons or select rich messages, with more than 3 options, you can use the whatsapp="Текст вашего меню" shortcode attribute to set the text of the WhatsApp message menu.
• The повторное сообщение поддерживается, но сообщение всегда отправляется, даже если Менеджер отвечает.
• The оффлайн сообщение поддерживается, но расписание не отправляется.
• Чат-бот поддерживается. передача чата человеку функция также поддерживается. Чтобы включить поддержку чат-бота Dialogflow для аудиосообщений, активируйте Настройки > Artificial Intelligence > OpenAI > Speech recognition
• Поддерживаемые функции искусственного интеллекта включают: определение языка , коррекция орфографии , многоязычный через перевод , Поиск Гугл .
• Twilio и 360dialog has many limitations. For example, Twilio does not support messages longer than 1600 characters. We strongly recommend to use the Official WhatsApp API.

Мессенджер

Настройки ниже относятся к приложению Messenger.

Установка

• От Настройки > Расширения , нажмите Мессенджер и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .

Автоматический режим синхронизации

• Complete the synchronization by choosing at least 1 Facebook page и enter the returned information in Настройки > Messenger > Facebook pages.
• Вы завершили. Все сообщения, отправленные на выбранные вами страницы Facebook и аккаунты Instagram, будут отображаться в области администрирования бесед Chatsy. Обратите внимание, что будут синхронизированы только новые сообщения, старые не будут импортированы.

Ручной режим синхронизации

• Create a new account at https://developers.facebook.com/ or login with your existing account.
• Создайте новое приложение и выберите Другой как тип Расширения . Затем выберите Бизнес . Введите имя приложения и пропустите выбор любых бизнес-портфелей.
• Из меню слева нажмите на Добавить продукт . Выберите Мессенджер .
• Под Настройка вебхуков раздел, нажмите на Настроить .
  • Получить URL обратного вызова от Настройки > Messenger > Messenger и Instagram Настройки > Get configuration URL .
  • Установите Подтверждение Кодken в Настройки > Messenger > Messenger и Instagram Настройки > Secret key и сохраните изменения, затем используйте его для проверки вебхука.
  • В Поля вебхука выберите следующее: метки_входящих_сообщений, доставка_сообщений, эхо_сообщений, реакции_на_сообщения, прочтения_сообщений, сообщения, связь_с_аккаунтом_мессенджера, передача_управления_мессенджером, подписки_в_мессенджере, обеспечение_политики_мессенджера, постбэки_мессенджера, рефералы_в_мессенджере .
• В Создание токенов доступа раздел, нажмите на Подключиться . Выберите страницы, которые вы хотите синхронизировать и завершите процесс.
  • Под Подписка на вебхуки столбец, щелкните на Добавить подписки . Выберите области, которые вы хотите: сообщения, обратные вызовы сообщений, подписки на сообщения, прочитанные сообщения и эхо сообщений .
  • В Комуkens столбец, щелкните на Сгенерировать . Скопируйте предоставленный токен доступа и вставьте его в Настройки > Messenger > Facebook pages .
  • Скопируйте ID страницы и Страница Название и вставьте их в Настройки > Messenger > Facebook pages .
  • Повторите эти шаги для всех страниц.
• Сохраните изменения и вы готовы. Последним шагом будет размещение приложения в Режим онлайн .
• Если вы хотите также синхронизировать Instagram, выполните следующие шаги:
  • Из меню слева нажмите Messenger > Instagram settings .
  • В Настройка вебхуков область, щелкните на Настроить . Повторите тот же шаг, который вы сделали ранее для Messenger.
  • Под Подписка на вебхук область, щелкните на Добавить подписки . Выберите следующие области: сообщения, обратные сообщения, подписки на сообщения, просмотр сообщений .
  • Введите свой ID Instagram в Настройки > Messenger > Facebook pages > Instagram ID . Чтобы получить его, откройте свой веб-браузер и введите следующий URL: https://graph.facebook.com/FACEBOOK-PAGE-ID/?access_token=ACCESS-TOKEN&fields=instagram_business_account . Заменить ИДЕНТИФИКАТОР СТРАНИЦЫ FACEBOOK и ТОКЕН-ДОСТУПА с соответствующим идентификатором страницы и токеном доступа от страницы Facebook, связанной с Instagram.
  • Сохраните изменения и вы готовы. Последним шагом будет размещение приложения в Режим онлайн .
• Ваше приложение должно быть в Режим онлайн . Для этого ваше приложение должно быть отправлено на рассмотрение и одобрено Meta. Вы можете использовать текст на это для процесса рецензирования. Обратите внимание, что этот процесс не поддерживается нашей службой поддержки. Если вам нужна помощь, вы можете нанять нас .

Инстаграм

Для связывания Instagram с вашей страницей на Facebook и Chatsy выполните следующие шаги.

• Откройте раздел Настройки вашей страницы на Facebook и нажмите Left Меню > Instagram (https://www.facebook.com/YOUR-PAGE-SLUG/settings/).
• Нажмите Подключить аккаунт и завершите настройку.
• Снова синхронизуйте Messenger с Chatsy и вы закончили. Обратите внимание, что будут синхронизированы только новые сообщения, старые не будут импортированы.

Информация

• Если вы не получаете сообщения в Instagram:
  • Убедитесь, что функция включена Настройки > Privacy > Messages & Forms > Connected tools - Вездеow access из вашего мобильного приложения Instagram.
  • Убедитесь, что ваш аккаунт Instagram не настроен как профессиональный аккаунт, он должен быть бизнес-аккаунтом.
  • Перейти на Мета Бизнес Сьют , выберите свой аккаунт и перейдите на Пользовательs > People . Под Аккаунт Instagram нажмите Управлять и убедитесь, что все разрешения включены.
• Если вы не получаете сообщения в Facebook Messenger, убедитесь, что страница Facebook не отправляет автоматические ответы, такие как приветственное сообщение.
• In case you encounter duplicated messages or an ongoing chat cycle between the chatbot and Instagram messages, you are facing a problem due to the presence of two Chatsy installations or Chatsy Cloud accounts that are both synchronized with the same Instagram account. To resolve this, access the second Chatsy admin area, navigate to Настройки > Messenger > Facebook pages , удалите Идентификатор Instagram значение и сохраните изменения. Попробуйте также нажать на Отписаться кнопка.
• The Отписаться кнопка удаления подписки на вебхук со всех ваших страниц Facebook, она полезна, если вы хотите прекратить получение сообщений с страницы Facebook.
• Каждый пользователь Chatsy имеет только 1 беседу в Facebook и 1 беседу в Instagram.
• Чатsy богатые сообщения автоматически преобразуются в богатые сообщения Facebook, когда это возможно, некоторая часть богатого сообщения может быть удалена или изменена. Кнопки, чипы и выборы поддерживают максимум три варианта выбора и поддерживаются только в мобильном приложении Instagram.
• Только личные сообщения в Facebook будут отправлены в ваш почтовый ящик команды. Если кто-то разместит сообщение на вашей стене в Facebook, оно не появится в вашем почтовом ящике команды.
• Когда кто-то отправляет сообщение на страницу вашей компании в Facebook или аккаунт Instagram, они будут отмечены как потенциальный клиент в Chatsy. Вы сможете видеть только имя пользователя в Facebook или Instagram и его профильную фотографию.
• Беседы в мессенджерах и сообщения совместимы с очередь и маршрутизация .
• Чат-бот поддерживается. передача чата человеку функция поддерживается.
• Поддерживаемые функции искусственного интеллекта включают в себя определение языка , коррекция орфографии , многоязычный через перевод , Поиск Гугл .
• Если чатбот включен, необходимо отключить любые автоматические ответы в Facebook Messenger, такие как приветственное сообщение.
• The последующее сообщение поддерживается, но сообщение всегда отправляется, даже если Менеджер отвечает.
• The оффлайн сообщение поддерживается, но расписание не отправляется.
• Только 1 учетная запись Facebook может быть синхронизирована, чтобы связать страницы из нескольких учетных записей Facebook, учетная запись, синхронизированная в Chatsy, должна быть администратором всех страниц Facebook других учетных записей.
• Использование этой интеграции Instagram и Facebook Messenger не влечет за собой дополнительных затрат.
• Если сообщение превышает 1000 символов, будет передано только первые 1000 символов из-за ограничения на количество символов.
• Только новые сообщения, отправленные после синхронизации, будут синхронизированы, старые не будут импортированы.
• Запрос на удаление данных пользователя ( облачная версия только): Чтобы удалить все ваши данные из Chatsy, нажмите Настройки > Messenger > Unsubscribe затем удалите свою учетную запись из здесь .

Твиттер

Настройки ниже относятся к приложению Twitter.

Установка

• Зарегистрируйтесь на https://developer.twitter.com . Убедитесь, что вы подтвердили свой номер телефона на https://twitter.com/settings/phone или регистрация не будет завершена.
• Создайте свое первое приложение, введя название приложения и нажмите Получить ключи , копировать API Key (Consumer key) и API Key Secret (Consumer secret) и вставьте их Чатsy > Настройки > Twitter .
• Запросите Повышенный доступ с https://developer.twitter.com/en/portal/products/elevated . Нажмите Подать заявку на повышение и заполните форму следующим образом: В первой области Согласно вашим словам и in Будет ли ваше приложение использовать функционал Tweet, Retweet, Like, Follow или Direct Message? ввести I need access to the Админ Панель Activity API to start receiving Twitter Direct Messages to my chat software(Chatsy ) and to reply to them directly from Chatsy , details at https://chatsy.ru/twitter. Отключите все остальные поля, нажав Нет: Вы планируете анализировать данные Twitter?, Планируете ли вы отображать твиты или агрегировать данные о контенте Twitter за пределами Twitter?, Будет ли ваш продукт, услуга или анализ предоставлять контент Twitter или производную информацию государственному органу?
• Дождитесь нескольких дней, пока Twitter проверит и утвердит повышенный доступ, вы получите электронное письмо от Twitter.
• После получения повышенного доступа войдите в панель разработчиков ( https://developer.twitter.com/en/portal/dashboard ) и в левом меню нажмите Продукты > Premium > Dev environments и под Админ Панель Activity API / Sandbox нажмите Настройка среды разработки , в Метка среды разработки ввести sb или того же значения, введенного в Настройки > Twitter > Synchronization > Dev environment label .
• Введите ваше приложение Настройки область от Left menu > Projects & Приложения > Your project > Your app и под Настройки аутентификации пользователя нажмите Настройка и активировать OAuth 1.0a . В Разрешения Расширения проверить Чтение и запись и Прямое сообщение , в URI обратного вызова / URL перенаправления введите URL, который вы получили от Chatsy > Настройки > Twitter > Get callback URL , в URL веб-сайта введите URL вашего веб-сайта.
• Введите ваше приложение Ключи и токены область от Left menu > Projects & Apps > Your project > Your app > Keys и tokens и под Токены аутентификации генерировать Токен доступа и Секрет , скопируйте и вставьте их Чатsy > Настройки > Twitter .
• Введите имя пользователя вашего профиля в Twitter Чатsy > Настройки > Twitter > Your username . Get it from your Twitter profile page, copy the name starting with @ or the URL part containing your username. Ex. https://twitter.com/ Служба поддержки 1 .
• Сохраните настройки Chatsy и нажмите кнопку Чатsy > Настройки > Twitter > Subscribe и готово. Все сообщения, отправленные на ваш аккаунт Twitter, будут получены Chatsy.

Дополнительно

• Если вы получаете дублирующие сообщения, то аккаунт Twitter, который вы используете для тестирования, может совпадать с тем, который вы синхронизировали. Попробуйте отправить сообщение с другого аккаунта Twitter.
• Используйте живой домен, localhost не поддерживается.
• Когда сообщение получено от пользователя Twitter, вы можете отправить до 5 сообщений в ответ в течение 24 часов. После 24 часов с момента получения сообщения в Twitter отправлять сообщения нельзя.
• Вы можете отправить максимум 3 или 4 вложения в зависимости от типа медиафайла.
• Следующие Чаты богатые сообщения не поддерживаются: слайдеры изображений, слайдеры, карточки.
• Чатбот поддерживается. передача чата человеку функция поддерживается.
• Поддерживаемые функции искусственного интеллекта включают определение языка , коррекция орфографии , многоязычный через перевод , Поиск Гугл .

Телеграм

Настройки ниже относятся к приложению Telegram.

Установка

• От Настройки > Расширения , нажмите Телеграм и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .
• После установки приложения посетите https://t.me/botfather .
• Если вы уже создали бота в Telegram ранее, введите комманду /моиботы и откройте вашего бота, затем нажмите API-токен .
• Если вы никогда ранее не создавали бота в Telegram, введите команду /newbot для создания нового бота. BotFather попросит вас ввести имя и имя пользователя, введите их и сгенерируйте аутентификационный токен. Более подробные сведения на https://core.telegram.org/bots .
• Скопируйте токен и вставьте его в Чатsy > Telegram > Token , затем нажмите Синхронизировать сейчас . Ваш веб-сайт должен использовать HTTPS (SSL-сертификат), поддержка HTTP отсутствует.
• Вы завершили. Все сообщения, отправленные вашему боту в Telegram, будут отображаться в области разговоров администратора в Chatsy.

Дополнительно

• Чатsy богатые сообщения автоматически преобразуются в богатые сообщения Telegram, если это возможно, в противном случае они удаляются из сообщения.
• Беседы и сообщения в Telegram совместимы с очередь и маршрутизация .
• Чатбот поддерживается. передача чата человеку функция поддерживается.
• Поддерживаемые функции искусственного интеллекта включают: определение языка , коррекция орфографии , многоязычный через перевод , Поиск Гугл .
• Это последующее сообщение поддерживается, но сообщение всегда отправляется, даже если Менеджер отвечает.
• The оффлайн сообщение поддерживается, но расписание не отправляется.
• Вы можете проверить статус вебхука на https://api.telegram.org/bot><your_bot_token>/getWebhookInfo . Заменить <your_bot_token> с вашим токеном.

Viber

Настройки ниже относятся к приложению Viber.

Установка

• От Настройки > Расширения , нажмите Viber и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .
• Создайте бота на https://partners.viber.com/account/create-bot-account .
• Скопируйте токен и вставьте его в Чатsy > Viber > Token , затем нажмите Синхронизировать сейчас . Ваш веб-сайт должен использовать HTTPS (SSL-сертификат), поддержка HTTP отсутствует.
• Вы завершили. Все сообщения, отправленные вашему боту Viber, будут отображаться в области разговоров администратора Chatsy.

Дополнительно

• Чатsy богатые сообщения автоматически преобразуются в богатые сообщения Viber при возможности, в противном случае они удаляются из сообщения.
• Беседы и сообщения Viber совместимы с очередь и маршрутизация .
• Чатбот поддерживается. передача чата человеку функция поддерживается.
• Поддерживаемые функции искусственного интеллекта включают в себя определение языка , коррекция орфографии , многоязычный через перевод , Поиск Гугл .
• The последующее сообщение поддерживается, но сообщение всегда отправляется, даже если Менеджер отвечает.
• The оффлайн сообщение поддерживается, но расписание не отправляется.

Slack

The settings below are related to the Slack App.

Установка

• От Настройки > Расширения , нажмите Slack и введите свой лицензионный ключ для установки и активации приложения. Подробнее здесь . Если у вас есть облачная версия нажмите Включить .
• После установки приложения перейдите на Настройки > Slack , нажмите на Синхронизировать сейчас кнопку и следуйте инструкциям.

Есть проблемы?

The synchronization of Slack may not be successful for a number of reasons; below are the most common ones:

Архивировать каналы вручную

To archive a channel in Slack, follow these steps:

• Open the Slack channel you want to archive.
• В правом верхнем углу нажмите на значок шестеренки и выберите Дополнительные опции .
• Нажмите на значок информации в верхнем правом углу экрана, затем нажмите на Дополнительная иконка , а затем нажмите Дополнительные опции... . Нажмите Архивировать этот канал .

Привязка отделов

Если Settngs > Slack > Отдел linking опция активна, когда разговор в чате назначен на отдел , a new message is sent to the linked Slack channel, informing Slack users that a new conversation has started и inviting them to join the dedicated user Slack channel. However, the full conversation can only be accessed on the dedicated Slack channel of the specific user.

• Получите идентификаторы отделов из Настройки > Miscellaneous > departments .
• Получите идентификаторы каналов, нажав на кнопку Получить идентификаторы каналов .

Поля пользователя

Это Настройки > Slack > User fields Опция <strong>позволяет выбрать</strong>, какие детали пользователя включить в сообщение, отправляемое на главный канал, когда новый пользователь отправляет первое сообщение. Вы можете включить слаг ваших пользовательских деталей или следующие слаги: браузер , язык_браузера , местоположение , электронная почта , Тип пользователя , токен , время_создания , Код страны , текущий_адрес_URL , ос , город , адрес , почтовый индекс , телефон , дата рождения , компания , часовой пояс , веб-сайт . По умолчанию: email, браузер, язык браузера, местоположение.

Информация

• When a new user sends the first message, a Slack message with the user details и a button to join the user's channel is sent to the main channel selected during the synchronization, or to the channel linked to the conversation's отдел . Only the Slack account used during the synchronization will automatically join the user's channel, other Slack members will have to join it manually via the button.
• Когда Настройки > Slack > Менеджер linking устанавливается, если беседа назначена на отдел, только Менеджеры, назначенные на этот отдел сообщение будет получено, если беседа назначена только одному Менеджеру, то только этот Менеджер получит сообщение.
• Slack is free to use. Only large companies may need a paid subscription plan, more details здесь .
• Push notifications are compatible with Slack, when agents send messages via Slack, Push notifications are sent to users.
• If you're using Dialogflow, no messages will be received in Slack if the chatbot knows the answer. Once the передача чата человеку is active all conversation's messages are sent to Slack.
• The Slack app is compatible with перенаправление электронной почты и мессенджеры.
• Удаление или выход из канала не поддерживается, поддерживается только архивирование канала.
• When a conversation is archived in Chatsy , the linked Slack channel is also archived.
• When replying via Slack to a user, if the user is notified by email or text message, a Slack message is sent to notify you.
• Use the Slack commи /архив to archive a conversation from Slack.