TalkWEB

GETTING STARTED

Installing Support Board

To install Support Board on your server follow the steps below:

Open the archive supportboard 1.2.3.zip and extract the folder in a server location of your choice.
Navigate to the link http://[your-site]/supportboard/admin.php and complete the installation. Replace [your-site] with with your website URL. If you change the directory name, replace supportboard with the new directory name.
Once the installation is complete, log in with the email and password you created in the previous step and you're done!

Display the chat

To display the chat on your website include the following scripts into the <head></head> or <footer></footer> area of each page where the chat is shown. Replace [YOUR-SUPPORT-BOARD-URL] with the URL of your Support Board installation. Ex. https://example.com/supportboard/js/main.js.

                                        <!-- Not required if jQuery is already loaded -->
                                        <script src="[YOUR-SUPPORT-BOARD-URL]/js/min/jquery.min.js"></script>
                                        <script id="sbinit" src="[YOUR-SUPPORT-BOARD-URL]/js/main.js"></script>

URL parameters

lang=LANGUAGE-CODE See the multilingual docs for more details.
url=APP-URL Use this parameter if your application directory URL / folder has been changed. Replace APP-URL with the FULL URL of the application folder. You can also define the URL via JavaScript: var SB_INIT_URL = "APP-URL".

Site migration

If you migrate the chat to a new domain / URL you need to edit the config.php file (it's in the Support Board folder) and update the SB_URL constant with the new URL.

Minify JS

For performance reasons, you may want to load the minified main.js file: [YOUR-SUPPORT-BOARD-URL]/js/min/main.min.js. Please note that if you contact us for support you will need to load again the non-minified version.

To install Support Board on WordPress follow the steps below:

Go to the Plugins page and click Add new then Upload plugin and upload the file supportboard 1.2.3.zip.
Once the installation is complete you should see a new left menu item named Support Board . You're done, the chat is automatically shown on all pages.

To display the chat on your website go to https://cloud.board.support/account/?tab=installation and copy the embed code, then paste it into your website pages. If you are using WordPress, you can download the Support Board Cloud plugin here.

Requirements

Your web project must support HTML and PHP, and pages containing the chat must be opened via a web browser.
You cannot display the chat on a HTML page opened directly on a local computer. Use a local server like Xampp instead.
Your server must allow the access of the following file: supportboard/include/ajax.php
If you're using the WordPress version of Support Board and you have any security plugins installed, please make sure that they don't block the supportboard/include/ajax.php file.
JQuery 1.1+
PHP 7.4+
In your server settings, CURL, ZIP ARCHIVE, must be enabled and working correctly.
Read and write file permissions must be granted for the Support Board uploads, resources/language and apps folders. Support Board must be able to save and read the files in these folders.
MySQL 5.5+
MySQL - The SQL mode "ONLY_FULL_GROUP_BY", and the setting "ANSI_QUOTES", must be disabled.
All Support Board folders should have 755 permissions, all Support Board files should have 644 permissions.

Once the installation is completed you can check the system requirements from Settings > Miscellaneous > System requirements.

Activation

To activate Support Board and enable all of the features (including updates and more secure encryption), you need to enter the Envato purchase code in Admin > Settings > Miscellaneous.

Apps installation

To download, install, and activate the apps go to the Settings > Apps area of Support Board and enter the Envato purchase code or license key.

Find your Envato purchase code

Updates

To update Support Board and the apps, enter the admin area and click on the version number in the lower left corner.
You can also activate automatic updates via Settings > Miscellaneous.
To enable the updates, you need to have a valid Envato purchase code. To update the Support Board apps you need to have a separate valid License Key or Envato purchase code for each specific app. Besides, the License Key must not be older than 1 year (only for apps purchased outside of CodeCanyon). If your License Key is expired, you will need to purchase a new license to enable App updates again. Apps purchased on CodeCanyon have lifetime updates.
The latest versions of the apps may not work if Support Board has not been updated to the latest version.
If you're using the WordPress version of Support Board , keep in mind that you cannot update Support Board from the WordPress plugins page.

Manual updates

To manually update Support Board and the apps go to https://board.support/synch/manual.php.

Having Problems?

If you're having any issues at all, please contact our friendly support team at support@board.support. Before contacting us, please make sure that your server has all the requirements listed above. On that same note, if you are using the WordPress version, please make sure that your WordPress installation has all the requirements listed above.

General issue

For any issue you can check the system requirements from Settings > Miscellaneous > System requirements. We can not provide support about solving the issues reported by the system requirement function, please contact your hosting or server support if you need help.

Blank screen when accessing the admin area

Check if the browser console has error (on Chrome you can open it from Settings > More tools > Developer tools > Console).
Enable the PHP debug and check the PHP error logs.
If you have the WordPress version, disable all security plugins and plugins related to your hosting.

Cross-domain configuration

If you want to use the same chat installation on multiple domains, your server should allow cross-origin requests. To enable cross-origin requests on your server follow the steps below:

Cross-domain configuration via server

For Apache servers — Edit the .htaccess file of the domain where the plugin is installed and enter the code <IfModule mod_headers.c>Header set Access-Control-Allow-Origin "*"</IfModule> or <IfModule mod_headers.c="">header('Access-Control-Allow-Origin: *');</IfModule> at the very top of the file. To make it works you need to have at least AllowOverride +FileInfo or AllowOverride All in the Apache config.
For nginx servers — Edit the file /etc/nginx/nginx.conf of the domain where the plugin is installed and enter the code add_header Access-Control-Allow-Origin "*"; at the very top of the file. If you're using Plesk go to Domains > example.com > Apache and nginx settings > Additional nginx directives and insert
add_header 'Access-Control-Allow-Origin' '*';.
For OpenLiteSpeed servers — Visit https://openlitespeed.org/kb/setting-up-cors-on-openlitespeed/.

You can view tutorials for the most common server administration software in the list below:

Cross-domain configuration via PHP

If none of the previous solutions work or you can't change the server settings, follow the steps below:

Edit the file supportboard/config.php and enter the code define('SB_CROSS_DOMAIN', true); at the end of the file.
Upload the following folders into your destination domain(the domain where the chat should be shown, not the one where Support Board is installed): supportboard/media/fonts and supportboard/media/icons. You can upload the files where you want, for example, http://www.example.com/chat-files. If the chat is loaded on multiple domains upload the files on each domain.
Edit again the file supportboard/config.php and Enter the code define('SB_CROSS_DOMAIN_URL', 'YOUR-URL'); at the end of the file. Replace YOUR-URL with the URL that points to the files you just uploaded, for example, http://www.example.com/chat-files. If the chat is loaded on multiple domains replace YOUR-URL with the an array of URLs, for example, ["http://www.example.com/chat-files", "http://www.example-2.com/chat-files"].

Blocking zoom on iOS devices

When using the chat on iPhones the textarea is automatically zoomed when the user's start typing a new message. To stop the zoom Enter the code below into the <head> area of all the pages that include the chat.

                                <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1.0, user-scalable=no" />

Hide admin.php from URL

By default, the admin URL is something like https://your-website.com/support/admin.php. You can hide the admin.php part of the URL and make it like https://your-website.com/support/ by inserting the following code in your .htaccess file:

                                    <ifmodule mod_dir.c> DirectoryIndex admin.php</ifmodule>

Chat widget not displaying

You cannot see and test the chat as a user if you're logged-into the admin area. To test the chat as a user, please log out of your admin account. Alternatively, you can use another browser window in “private” or “incognito” mode. Additionally, you can force a logout by executing the SBF.reset() function in the browser console.

Reset email or password of the admin account

If you can no longer log in to the admin area you can reset your password and email by following the steps below:

Edit your MySQL Database. You can edit it from your hosting panel, usually with phpMyAdmin.
Edit the table sb_users.
Find your admin account, and make sure the value of the column user_type is admin.
Reset your password by editing the password column and by inserting the new password as a hash. To generate a hash for your password, visit https://phppasswordhash.com/, or Enter the hash $2y$10$i7OComVhUh8BHcyx9VzUfuN.hnNsnKzK1Hd/GKK2KIwBo7Y6stppu (password: 12345678).
Reset your email address from the column email.

If you're using the WordPress version, you can delete the user from the database and WordPress will generate it again. You can also create a new WordPress user with administrative privileges, then logout from your current account, and log in with the new one. Once you're into Support Board , change the password of your previous agent from Users > Agents.

Admin account deleted

If you have accidentally deleted all your admin and agent accounts and you can no longer log in to the admin area, you can resolve this issue by following the steps below:

Edit your MySQL Database. You can edit it from your hosting panel, usually with phpMyAdmin.
Edit the table sb_users.
You can convert any existing user to an admin by editing the column user_type, and entering the value admin.
You can also add a new user by assigning a value to the columns first_name, last_name, password, email, and user_type fields. The value of the password column must be a hash. To generate a hash for your password, visit https://phppasswordhash.com/. Also, the value of the column user_type must be admin.

Server down

If your server and/or website goes down or suddenly stops working after a few minutes of chat usage, the issue could be related to your server's Firewall. This usually happens as a result of an IP Address Banning (Fail2Ban) or Web Application Firewall (ModSecurity) settings. The multiple AJAX requests from the chat to the database are recognized as a "server attack" and so your server places a temporary block on your IP address. This issue should only affect you and/or your developers; visitors/users should not be affected. To confirm whether or not this is the issue, use a VPN service like Hotspot Shield. When the server goes down, activate the VPN to change your IP and try accessing your website again. If the website works normally, the issue is confirmed. To solve it temporarily disable fail2ban or contact your hosting support for additional support.

Disable chat via JS

Enter the code var SB_DISABLED = true; into a page to prevent the chat from loading.

БЕСЕДЫ

Управление беседами

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

Поиск бесед

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

Информация

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

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

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

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

Объединяющие поля

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

Код	Описание
{user_name}	Полное имя активного пользователя.
{user_email}	Электронная почта активного пользователя.
{agent_name}	Полное имя активного агента.
{agent_email}	Электронная почта активного агента.

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

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

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

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

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

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

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

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

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

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

Название	Шорткод	Описание
Карточка	[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"]	Слайдер карточек с призывом к действию, изображением, заголовком, описанием, ссылкой и т. д. Можно добавить до 10 слайдов.
Слайды изображений	[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=""]	Форма для сбора электронной почты и номера телефона пользователя. Все атрибуты являются необязательными. Последующие настройки используются в качестве значений по умолчанию. Добавьте атрибут required-messaging-apps="true", чтобы заставить пользователей предоставить свою электронную почту и телефон в мессенджерах.
Регистрация	[registration]	Форма регистрации.
Расписание	[timetable]	Расписание.
Статьи	[articles link="https://board.support/articles-demo"]	Статьи с областью поиска. Атрибут link используется как резервное сообщение для Facebook Messenger, WhatsApp, Telegram.
Оценка	[rating label-positive="Helpful" label-negative="Not helpful" label="Rate and review" success-negative=""]	Форма для оценки агента. Чтобы шорткод оценки работал в WhatsApp, Messenger, Telegram, вам нужно использовать Dialogflow и чат-бота, создать новый Intent с rating в качестве input Context, ничего в качестве output Context, список наиболее распространенных сообщений пользователя для положительной оценки в качестве Training phrases (например, хорошо, положительно) и { "rating": 1, "force-message": true } в качестве Custom Payload ответа. Для отрицательной оценки создайте новый интент с тем же контекстом, но замените тренировочные фразы и пользовательскую нагрузку на { "rating": -1, "force-message": true } . Шорткод также должен включать title или message.
Список	[list values="A,B,C"]	Текстовый список.
Двойной список	[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://board.support" name="Click here" target="_blank" style="link"]	Отображение ссылки или открытие статьи. Атрибут target="_blank" является необязательным и открывает ссылку в новом окне. Атрибут style="link" является необязательным и изменяет дизайн кнопки. Чтобы открыть статью по щелчку, значение ссылки должно быть #article-ID, замените ID на идентификатор статьи.
Видео	[video type="youtube" id="0TImic4N1ko" height="350"]	Отображение видео YouTube или Vimeo. Значение атрибута type может быть youtube или vimeo. Атрибут id — это идентификатор видео, получить его из URL. Атрибут height является необязательным и устанавливает высоту видео в пикселях.
Изображение	[image url="https://board.support/media/admin.png"]	Изображение.
Поделиться	[share fb="https://board.support/" tw="https://board.support/" li="https://board.support/" pi="https://board.support/" wa="https://board.support/"]	Кнопки для социальных сетей.

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

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

Параметры	Описание
id="123"	ID богатого сообщения (также используется для сохранения данных в формате JSON).
title="ABC"	Название богатого сообщения.
message="ABC"	Описание богатого сообщения, которое отображается под заголовком.
success="ABC"	Сообщение, которое появляется, когда пользователь завершает и отправляет богатое сообщение. Ввод пользователя добавляется к этому сообщению.
settings="ABC"	Дополнительное поле для необязательных значений.

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

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

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

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

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

Код

Описание

<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>

Изображение, которое увеличивается при клике.

Вложения

Разрешенные расширения файлов вложений устанавливаются в файле supportboard/include/upload.php. Следующие форматы изображений отображаются автоматически: .jpg, .jpeg, .png.

Добавьте новые разрешенные расширения файлов, добавив код define("SB_FILE_EXTENSIONS", ["exe", "abc", ...]) в файл config.php вашей папки установки Support Board. Замените ["exe", "abc", ...] на массив, содержащий расширения, которые вы хотите разрешить.

ПОЛЬЗОВАТЕЛИ

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

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

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

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

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

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

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

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

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

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

Тип	Описание
user	"user" — это любой пользователь с электронной почтой.
lead	"lead" — это любой пользователь без деталей пользователя, который автоматически зарегистрирован и имеет как минимум одно сообщение.
visitor	"visitor" — это любой пользователь, который не начал разговор. Примечание: Посетители автоматически удаляются каждые 24 часа.

Управление агентами

Управляйте агентами из Области пользователей. Агент — это специальный пользователь, который может войти в административную область и отвечать на все разговоры. Существует два типа агентов: агенты. Только администраторы могут создавать новых агентов; они также имеют доступ к области настроек. Агенты могут управлять только пользователями и разговорами.

Если вы используете версию Support Board для WordPress, администратор создается при активации плагина с тем же именем пользователя и паролем, что и у вошедшего пользователя.

Информация

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

НАСТРОЙКИ

Настройки

Часы работы

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

Автоматического отображения расписания и сообщения, когда пользователь отправляет сообщение вне рабочего времени или если все агенты офлайн. Чтобы включить эту функцию, настройте Офлайн сообщение в Настройки > Сообщения > Офлайн сообщение. Офлайн сообщение отправляется тому же пользователю максимум 1 раз в час.
Отключения и скрытия чата вне рабочего времени.
Отключения чат-бота Dialogflow во время обычных рабочих часов и включения его вне рабочего времени.

Дополнительная информация

Пустые значения в настройках расписания считаются вне рабочего времени.
Часы работы представлены в формате UTC. Ваш UTC генерируется автоматически, когда вы нажимаете на поле Настройки > Разное > UTF смещение. Чтобы вручную получить смещение UTC для вашей области, перейдите на: https://browserspy.dk/ или wikipedia.org/wiki/List_of_UTC_time_offsets and copy the offset (e.g. for UTC −12:00, enter -12). Принимаются только целые числа. Если ваше смещение не является целым числом (например, UTC -12:30 или UTC -12:45), попробуйте найти альтернативное смещение UTC. Если вы не можете найти целое смещение, вам придется вручную скорректировать времена в таблице часов работы, чтобы исправить разницу.
Формат даты и времени расписания автоматически соответствует тому, который используется в стране языка браузера пользователя.
Офлайн сообщение не отправляется автоматически, если активна Настройки > Dialogflow > Человеческое вмешательство. Когда опция человеческого вмешательства Dialogflow активна, офлайн сообщение отправляется только при человеческом вмешательстве.
Офлайн сообщение не отправляется, если вы используете приложение Slack и вы или любой другой агент в сети через Slack./li>

Статьи базы знаний

Статьи базы знаний предоставляют мгновенные ответы клиентам, чтобы помочь сократить объем поддержки клиентов. Чтобы управлять статьями, перейдите в Настройки > Статьи. Статьи поддерживают HTML-код, который можно использовать для добавления изображений, видео и другого контента. Вот некоторые примеры HTML-кода, который вы можете использовать:

Название	Код
Кнопка	<a href="https://www.google.com" target="_blank" class="sb-rich-btn sb-btn">Click here</a>
Изображение	<img src="https://via.placeholder.com/1500x600" />
Изображение с лайтбоксом	<div class="sb-image"><img src="https://via.placeholder.com/1500x600" class="sb-image" /></div>
Видео	<video controls><source src="video.mp4" type="video/mp4"></video>
YouTube и Vimeo	Вставьте код для встраивания, предоставленный YouTube или Vimeo

Отображение статей

Статьи можно отображать на панели чата, включив их в разделе Настройки > Чат area.
Статьи можно отображать на отдельной странице, вставив код <script>var SB_ARTICLES_PAGE = true;</script> на любую страницу, где показывается чат. Чтобы установить расположение области статей, вставьте код <div id="sb-articles" class="sb-loading"></div>. Если вы используете версию WordPress, вы можете использовать шорткод [sb-articles].
В качестве альтернативы статьи можно поделиться с помощью шорткода для богатых сообщений, [articles].

Дополнительная информация

Переведите категории из Настройки > Переводы, добавив название перевода и его перевод.
Если вы используете категории, будут отображаться только статьи, назначенные определенной категории.
Если в языке пользователя есть хотя бы одна переведенная статья, будут отображаться только переведенные статьи.
Статьи автоматически синхронизируются с базой знаний Dialogflow, если приложение Dialogflow установлено.
Вы можете создать внутреннюю ссылку на статью в чате с помощью кнопки богатого сообщения.
Вы можете создать внешние ссылки на статьи с атрибутом URL article=ID, заменив ID на идентификатор статьи. Пример: https://board.support/articles-demo?article=Ucsx6.

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

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

Редактирование переводов

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

Язык чата

Support Board уже переведен на 41 язык. Доступно множество опций для установки языка:

ВАРИАНТ 1 Перейдите в Настройки > Чат и отметьте опцию Автоматический перевод. Эта функция автоматически использует язык чата браузера пользователя.
ВАРИАНТ 2 - ТОЛЬКО PHP Добавьте URL параметр lang=КОД-ЯЗЫКА к скрипту, который загружает чат, заменив "КОД-ЯЗЫКА" на двухбуквенный код языка, который вы хотите отобразить. Пример: https://board.support/supportboard/js/main.js?lang=en. Перейдите на wikipedia.org/wiki/List_of_ISO_639-1_codes для полного списка кодов языков (см. столбец 639-1).
ВАРИАНТ 2 - ТОЛЬКО WORDPRESS Перейдите в Настройки > WordPress и установите опцию Принудить язык.
ВАРИАНТ 3 - ТОЛЬКО WORDPRESS Версия Support Board для WordPress использует язык по умолчанию, установленный в WordPress; или язык текущей страницы или поста, если сайт многоязычный. Эта функция совместима с WPML, Polylang и другими многоязычными плагинами. Примечание: Эта функция автоматически отключается, если активна опция Чат > Автоматический перевод.

Язык админки

Чтобы перевести область администратора, выполните следующие шаги:

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

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

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

Перевод пользовательского контента

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

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

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

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

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

Информация

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

Отделы

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

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

Настройки

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

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

Агенты и администраторы могут получить доступ только к беседам, пользователям и агентам, которые были назначены их конкретному отделу.
Когда агент назначается в новый отдел, всем агентам, назначенным в новый отдел, отправляется уведомление по электронной почте.
Общий отдел является глобальным и предоставляет агентам доступ ко всем беседам во всех отделах. Кроме того, все агенты без назначенного отдела автоматически назначаются в Общий отдел.
Чтобы автоматически назначить отдел для бесед пользователей, вы можете ввести переменную JavaScript var SB_DEFAULT_DEPARTMENT = ID; на страницы, где отображается чат, заменив ID на идентификатор отдела. Для получения более подробной информации ознакомьтесь с API здесь.
Администраторы без назначенного отдела всегда видят беседы всех отделов.
Чат-бот может назначить отдел активной беседе через действия dialogflow.

Как назначить отдел

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

Через Настройки > Разное > Настройки отделов > Отображать на панели управления. Эта настройка заставит пользователя выбрать отдел при начале новой беседы.
Через Настройки > Автоматизация > Дополнительно.
С помощью JavaScript переменной var SB_DEFAULT_DEPARTMENT = ID;. Введите код на страницы, где отображается чат, и замените ID на идентификатор отдела. Для получения более подробной информации ознакомьтесь с API здесь.
Через API.

Очередь

Когда очередь активирована через Настройки > Разное > Очередь, пользователи автоматически попадают в очередь, когда достигается лимит чатов агента. Когда пользователь входит в очередь, отображается сообщение с текущей позицией в очереди и предполагаемым временем ожидания. Support Board автоматически назначает беседы всем доступным агентам пропорционально. Когда агент помечает беседу как завершённую (архивируя её), очередь обновляется, и поступает новая беседа.

Дополнительная информация

Только онлайн-агенты учитываются как "доступные" агенты; только онлайн-агенты получат новые беседы.
Администраторы не включены; администраторы всегда видят все беседы.
Агенты должны архивировать беседу, чтобы пометить её как завершённую; это автоматически даст им доступ к следующей беседе в очереди.
Агенты могут переключать свой статус между онлайн и офлайн, наведя курсор на изображение профиля и затем нажав на ярлык всплывающего окна профиля в нижнем левом углу админ-панели.
Агенты могут видеть только свои беседы; однако они могут видеть все беседы одного пользователя.
Агенты могут только искать и фильтровать свои беседы.
Время ожидания отображается в минутах и рассчитывается следующим образом: позиция в очереди X время ответа = время ожидания. Например, если пользователь 5-й в очереди, и время ответа установлено на 4 минуты (через Настройки > Разное > Очередь), то общее время ожидания, отображаемое пользователю, составит 20 минут.
Если пользователь находится в очереди и покидает её (например, закрыв браузер) на более чем 1 минуту, беседа сохраняется; однако, когда пользователь возвращается, очередь сбрасывается, и пользователь теряет свою предыдущую позицию.
Очередь совместима с отделами.
Если активирован переход на человека в Dialogflow, очередь активируется только при переходе на человека.
Для бесед, начатых из мессенджеров, таких как WhatsApp, невозможно соблюдать лимит бесед на агента; все беседы будут немедленно и пропорционально назначены агенту.
Используйте Настройки > Сообщения > Офлайн сообщение, чтобы предотвратить отображение сообщения об обновлении очереди пользователю.
Когда активна звуковая опция, звук воспроизводится, когда наступает очередь пользователя.

Как протестировать очередь

Чтобы смоделировать нескольких пользователей и агентов, откройте чат в нескольких разных браузерах (например, Opera, Firefox, Brave, Chrome и т.д.). Каждый браузер может смоделировать двух пользователей/агентов: одного в обычном режиме и одного в "приватном" или "инкогнито" режиме.
Чтобы сбросить чат и начать новую пользовательскую сессию, откройте консоль браузера, введите SBF.reset() и нажмите ENTER.

Маршрутизация

Когда маршрутизация активирована через Настройки > Разное > Маршрутизация, Support Board автоматически распределяет разговоры пользователей среди всех доступных агентов пропорционально.

Информация

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

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

Когда маршрутизация активирована через Настройки > Разное > Скрыть разговоры других агентов, агенты видят только свои собственные разговоры и могут выбирать незанятые.

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

Email Piping

Email piping позволяет вам, вашим агентам и пользователям отвечать на сообщения чата по электронной почте.

Активация

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

Информация

Настройка Уведомления > Уведомления по электронной почте для пользователей должна быть включена для отправки ответов на электронную почту пользователя.
Если вы используете приложение Dialogflow, и настройка Настройки > Dialogflow > Человеческое вмешательство активна, электронные письма не отправляются, если чат-бот знает ответ.
Если настройка Конвертировать все электронные письма активна, все электронные письма, отправленные на ваш почтовый ящик, будут конвертированы в сообщения чата; имейте в виду, что все электронные письма, включая спам, рекламные письма и прочее, также будут неправильно конвертированы.
Если настройка Конвертировать все электронные письма активна, письма, отправленные с адресов электронной почты агентов и администраторов, будут игнорироваться; используйте другой адрес электронной почты для тестирования.
Если настройка Конвертировать все электронные письма активна, каждое письмо, отправленное непосредственно на адрес email piping, будет генерировать новый разговор с пользователем.
Вы не можете использовать тот же адрес электронной почты, используемый для email piping, чтобы ответить. Все ваши агенты и администраторы Support Board должны использовать другой адрес электронной почты.
Агенты должны отвечать по электронной почте с того же адреса электронной почты, который зарегистрирован в Support Board.
Когда агенты отвечают в Support Board, электронные письма всегда отправляются пользователю, даже если уведомления по электронной почте для пользователя отключены.
Электронное письмо отправляется агентам только в том случае, если они офлайн. Если они онлайн, письма не отправляются.
Для электронной почты Google Gmail и Google Workspace вам нужно заменить свой пароль Google на пароль приложения Google; подробности см. по https://support.google.com/accounts/answer/185833 (раздел "Создание и использование паролей приложений"). Введите imap.gmail.com в качестве хоста и 993 в качестве порта.
Email piping требует модуля php5-imap (IMAP модуль). Если он не установлен на вашем сервере, вы можете установить его с помощью команды apt-get install php5-imap. Если у вас возникли проблемы, свяжитесь с поддержкой вашего хостинга/сервера.
Опция Разделитель добавляет текст в верхней части всех электронных писем:
### Пожалуйста, напишите свой ответ выше этой строки ###
. Этот текст говорит Support Board удалить весь контент ниже него, и он полезен для вырезания всех цитат ответов. Активируйте его, если вы видите дублирующиеся сообщения в чате. Если эта опция активна, вы и ваши пользователи не можете использовать строку ### в электронных письмах.
Поддерживаются вложения к электронным письмам.
Для работы email piping ответы по электронной почте должны содержать имя получателя Support Board. Например, Support Board | SB2457-4734 <example@email.com>. Все основные почтовые клиенты, такие как Outlook Web, Outlook, Gmail, Yahoo Mail, поддерживают имя получателя по умолчанию через ответ чат-бота или кнопку ответить всем.
Из-за особенностей работы электронной почты каждый почтовый клиент использует свои личные коды, разделители и автоматические строки и т.д. По этой причине некоторые сообщения чата, конвертированные из электронной почты, могут содержать недействительные тексты. Мы работаем над оптимизацией как можно большего количества почтовых клиентов, в настоящее время следующие почтовые клиенты оптимизированы и не должны возвращать недействительный текст: Outlook Web, Outlook, Gmail, Yahoo Mail.
Email piping поддерживает департаменты; если разговор пользователя назначен на департамент, уведомления по электронной почте отправляются только агентам, назначенным на этот департамент.

Cron Job

Support Board пытается обрабатывать электронные письма через cron jobs каждые 60 секунд; подробности здесь.
Вы можете вручную инициировать выполнение и ускорить cron jobs через API с помощью функции PHP sb_email_piping() или функции WEB API email-piping.
Вы можете создать cron job, который запускает URL [SUPPORT-BOARD-INSTALLATION-URL]/include/api.php?piping=true *. Используйте команду */59 * * * * wget [SUPPORT-BOARD-INSTALLATION-URL]/include/api.php?piping=true, чтобы запустить его через команду. Замените [SUPPORT-BOARD-INSTALLATION-URL] на ваш URL Support Board *.
Вы также можете использовать этот файл cron job: скачать. Команда cron job: php -f YOUR-FILE-PATH/cron.php.
Если вы вручную запускаете cron job, проверьте настройку Отключить cron job, чтобы остановить ручное его выполнение Support Board и улучшить производительность.
* Если вы используете облачную версию, URL: https://cloud.board.support/script/include/api.php?piping=true&cloud=API-TOKEN; замените API-TOKEN на ваш API токен (https://cloud.board.support/account/?tab=installation)

Pusher

Активируйте Pusher (рекомендуется), чтобы использовать WebSockets вместо HTTP AJAX-запросов для функциональности чата. WebSockets значительно улучшают производительность чата, устраняя необходимость в повторных AJAX-запросах к вашему серверу для проверки новых сообщений и разговоров. WebSockets также улучшают отзывчивость чата: более быстрая доставка сообщений, более точные статусы онлайн и ввода, более точный список онлайн-пользователей и многое другое.

Активация

Перейдите на https://dashboard.pusher.com/accounts/sign_up и создайте новую учетную запись.
В вашей панели управления на https://dashboard.pusher.com выберите продукт Channels, нажав на Начать.
Введите имя вашего приложения и выберите кластер, ближайший к вашему местоположению.
В левом меню панели управления нажмите на Настройки приложения и включите клиентские события.
В левом меню панели управления нажмите на Ключи, скопируйте App ID, Key, Secret, Cluster.
Перейдите в Настройки > Разное > Pusher и вставьте App ID, Key, Secret, Cluster.
Готово.

Information

Pusher можно использовать бесплатно до 200 тысяч сообщений и 100 одновременных подключений в день. Сообщения используются для следующих функций и не только: регистрация пользователей, статус онлайн-пользователей, сообщения чата и сообщения чат-бота. Подсчет каналов Pusher объясняется здесь.
Когда Pusher активен, следующие AJAX-запросы заменяются WebSockets: проверка новых сообщений, проверка новых разговоров, статус онлайн/оффлайн, статус ввода, список онлайн-пользователей.
Когда Pusher активен, значение последней активности пользователей и агентов обновляется только при загрузке страницы или когда они отправляют новые сообщения.
Когда Pusher активен, опция Настройки > Пользователи > Регистрация всех посетителей автоматически активируется и ее нельзя отключить.

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

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

Общие сведения

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

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

Сообщение чата отправляется в активный разговор, если таковой имеется, иначе - в новый разговор.
Если опция Настройки > Уведомления по электронной почте для пользователей активна, все пользователи с электронной почтой уведомляются по электронной почте.
Если опция Настройки > Уведомления текстовыми сообщениями > Активно для пользователей активна, все пользователи с номером телефона уведомляются текстовым сообщением.
Если опция Настройки > Уведомления Push активна, всем пользователям отправляется push-уведомление.
Сообщение также отправляется в мессенджеры, такие как WhatsApp и Messenger, если пользователь подключен к ним.
Чтобы отправить сообщение всем пользователям единственного мессенджера, введите одну из следующих строк: whatsapp, messenger, instagram, telegram, twitter, google, wechat. Введите tickets, чтобы отправить сообщение только пользователям, которые создали тикет в Support Board через приложение Tickets.

Прямой email

Заголовок электронного письма и подпись электронной почты автоматически включаются во все письма, их можно настроить в Настройки > Уведомления.
Поддерживается HTML язык.
Темы поддерживают слияние полей.

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

Чтобы включить прямые текстовые сообщения, вы должны активировать SMS в Настройки > Уведомления > Уведомления текстовыми сообщениями.

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

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

Чтобы удалить условие, установите его в пустое. Чтобы отключить автоматизацию, удалите все условия.
Автоматизации отправляются пользователям только 1 раз.
Если вы использовали автоматизацию в прошлом, и пользователи уже ее получили, вам нужно удалить автоматизацию и создать новую, чтобы показать ее пользователям.
Повторение работает только в сочетании с датой и временем.
Когда дата и время используются в сочетании с критерием равно, значение не должно содержать часы и минуты (чч:мм). Например, 25/10/2021 (25/10/2021 10:30 не сработает).
Настройка Настройки > Пользователи > Регистрация всех посетителей должна быть активна, если есть автоматизации сообщений, выполняемые при загрузке страницы.
Города, страны, языки работают автоматически только если обе настройки Настройки > Пользователи > Регистрация всех посетителей и Настройки > Пользователи > Полные данные о посетителях включены.
Города работают только если пользовательские данные местоположение установлены и равны город, страна, или если установлено значение город.
Страны работают только если установлены пользовательские данные country_code или country, или если пользовательские данные местоположение установлены и равны город, страна. Название страны должно быть на английском языке.
Языки работают только если установлены пользовательские данные browser_language или language.
Посетитель является Возвращающим посетителем, только если он снова посещает веб-сайт через 24 часа или более.
Всплывающие окна появляются только если чат закрыт, и они заменяют стандартное всплывающее окно. Вы можете проверить опцию резервное сообщение, чтобы отправить сообщение вместо показа всплывающего окна, если чат открыт.
Вам может потребоваться включить Настройки > Пользователи > Регистрация всех посетителей, если вы хотите отправить автоматическое сообщение новым пользователям.
Сообщения чата и сообщения всплывающего окна отправляются только если последнее сообщение пользователя или агента в разговоре старше 10 минут. Эта функция предотвращает отправку нежелательных автоматических сообщений во время разговора агента с пользователем.
Условие Пользовательская переменная проверяет переменные JavaScript с заданными именами и значениями. Например, условие example=ABC будет выполнено, если на странице чата есть следующий код JavaScript: var example = "ABC";. Добавьте несколько переменных, разделенных запятыми.

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

Mailchimp

Чтобы получить Ключ, следуйте инструкциям по ссылке https://mailchimp.com/help/about-api-keys/.
Чтобы получить ID списка, следуйте инструкциям по ссылке https://mailchimp.com/help/find-audience-id/.

Sendinblue

Чтобы получить Ключ, следуйте инструкциям по ссылке https://account.sendinblue.com/advanced/api.
Чтобы получить ID списка, следуйте инструкциям по ссылке https://my.sendinblue.com/lists.

SendGrid

Чтобы получить Ключ, следуйте инструкциям по ссылке https://app.sendgrid.com/settings/api_keys.
Чтобы получить ID списка, войдите в SendGrid и нажмите Маркетинг > Контакты (https://mc.sendgrid.com/contacts), затем нажмите на список или создайте новый. Последняя часть URL — это ID списка. Пример: https://mc.sendgrid.com/contacts/lists/8558c1e7-3c99-4428-a68f-78df2e437f8e (ID списка — 8558c1e7-3c99-4428-a68f-78df2e437f8e).

Elastic Email

Чтобы получить Ключ, войдите в Elastic Email, затем нажмите Настройки в меню профиля в правом верхнем углу. Нажмите Создать дополнительный API-ключ (https://elasticemail.com/account#/settings/new/create-api), задайте имя и выберите Плагин или Полный доступ, или Пользовательский, и убедитесь, что разрешение Контакты установлено на Просмотр и изменение.
ID списка — это имя списка. Важно! Названия существующих списков или сегментов не должны содержать пробелов.

Campaign Monitor

Чтобы получить Ключ, войдите в Campaign Monitor, затем нажмите Настройки аккаунта в меню профиля в правом верхнем углу. Нажмите API ключи > Сгенерировать API ключ.
Чтобы получить ID списка, войдите в Campaign Monitor, затем нажмите Списки и подписчики в верхнем меню. Выберите список, затем нажмите Настройки в левом меню и скопируйте ID API списка.

HubSpot

Чтобы получить Ключ, войдите в HubSpot, затем получите его из Настройки > Интеграции > API ключ.
Чтобы получить ID списка, войдите в HubSpot, затем получите его из Контакты > Список > Подробности списка.

Moosend

Чтобы получить Ключ, войдите в Moosend, затем нажмите Настройки > API ключ.
Чтобы получить ID списка, войдите в Moosend, затем получите его из Аудитория > Email списки.

GetResponse

Чтобы получить ID списка, войдите в GetResponse, затем получите его из Списки > Ваш список > Настройки (https://app.getresponse.com/lists). Скопируйте значение Токен списка.
Чтобы получить Ключ, посетите https://app.getresponse.com/api.

ConvertKit

Чтобы получить Ключ, войдите в ConvertKit, затем получите его из Настройки > Дополнительно > API секрет.
Чтобы получить ID списка, войдите в ConvertKit, затем получите его из Рост > Целевые страницы и формы. Откройте свою форму и скопируйте числовую часть URL. Например, ID формы с URL https://app.convertkit.com/forms/designers/3003412/edit равен 3003412.

ActiveCampaign

Чтобы получить Ключ, войдите в ActiveCampaign, затем получите его из Настройки аккаунта > Разработчик.
Чтобы получить ID списка, войдите в ActiveCampaign, затем получите его из Левое меню > Списки или Левое меню > Контакты > Списки. Откройте ваш список и скопируйте ID списка из URL. Например, ID списка с URL https://schiocco.activehosted.com/app/contacts/?listid=1&status=1 равен 1. ID списка должен быть в этом формате: домен:ID-списка. Домен — это первая часть вашего URL панели управления. Например, домен https://schiocco.activehosted.com/ равен schiocco, и окончательное значение для вставки в Support Board — schiocco:1.

MailerLite

Чтобы получить Ключ, войдите в MailerLite, затем получите его из Левое меню > Интеграции > MailerLite API.
Чтобы получить ID списка, войдите в MailerLite, затем получите его из Левое меню > Подписчики > Группы. Просмотрите группу и скопируйте ID группы из URL (например, ....group=18783408688903967...).

Mailjet

Чтобы получить Ключ, посетите https://app.mailjet.com/account/apikeys или войдите в Mailjet и получите его из Настройки аккаунта > Настройки аккаунта.
Чтобы получить ID списка, войдите в MailerLite, затем получите его из Контакты > Списки контактов > Ваш список. Получите ID списка, нажав на ? значок рядом с адресом электронной почты списков. Например, 1202546.

Grammarly

Следуйте приведённым ниже шагам, чтобы начать использовать Grammarly.

Зарегистрируйте учетную запись разработчика на https://developer.grammarly.com/.
Создайте новое приложение, перейдите в область Учётные данные и скопируйте Client ID. В Origins вы также должны добавить домен, где установлен Support Board.
Вставьте Client ID в Настройки > Администратор > Grammarly > Client ID.
Убедитесь, что вы отключили расширение Grammarly в вашем браузере.

Amazon Web Services

Amazon S3

Загружайте вложения в ваш бакет Amazon S3 вместо сервера, на котором установлен Support Board. Следуйте приведённым ниже шагам для настройки.

Войдите в AWS как пользователь root по адресу https://aws.amazon.com/.
Перейдите на панель управления IAM и нажмите Левое меню > Управление доступом > Пользователи.
Нажмите Добавить нового пользователя, введите имя пользователя и продолжайте.
Выберите Добавить пользователя в группу, затем в разделе Группы пользователей нажмите Создать группу. В Политиках разрешений найдите AmazonS3FullAccess и выберите её. Нажмите Создать группу пользователей.
Назначьте новую группу создаваемому пользователю и продолжайте, затем нажмите Создать пользователя.
Выберите вновь созданного пользователя и откройте вкладку Учетные данные безопасности.
В разделе Ключи доступа нажмите Создать ключ доступа и выберите Приложение, работающее вне AWS. Продолжайте, пока не получите ключи, и сохраните их в Support Board > Настройки > Разное > Amazon S3.
Перейдите на панель управления Amazon S3 и нажмите Создать бакет.
Установите имя бакета и регион, который вы хотите. Сохраните регион и имя в Support Board > Настройки > Разное > Amazon S3. Убедитесь, что ACL включены и Владелец бакета предпочтителен. Снимите галочку с Блокировать весь публичный доступ и всех связанных с ним флажков.
Нажмите Создать бакет.
Эта функция является технической и необязательной. Поддержка не предоставляет помощи, связанной с этой функцией.

УВЕДОМЛЕНИЯ

Уведомления

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

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

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

Email уведомления для администраторов и агентов

Когда пользователь отправляет свое первое сообщение, если разговор назначен на отдел, уведомление по электронной почте отправляется только агентам, назначенным на этот отдел; если разговор назначен конкретному агенту, уведомление отправляется только этому агенту; в противном случае уведомление отправляется всем агентам, которые в данный момент не в сети. Последующие уведомления отправляются только последнему агенту в разговоре.
Уведомления по электронной почте отправляются только если последний агент в разговоре оффлайн.
Если вы используете приложение Dialogflow, и Настройки > Dialogflow > Включить вмешательство человека активно, уведомления по электронной почте не отправляются, если чат-бот знает ответ.
Если вы не получаете уведомления по электронной почте, убедитесь, что они работают, отправив тестовое письмо из Настройки > Уведомления > Тестовое письмо для пользователя или Тестовое письмо для агента. Если вы не получаете тестовое письмо, ваш сервер или SMTP сервер не работает. Откройте консоль браузера для получения дополнительной информации об ошибке. Поскольку это не проблема, связанная с Support Board, поддержка не покрывает это, пожалуйста, свяжитесь с поддержкой вашего сервера/хостинга/SMTP вместо этого.

Email уведомления для пользователей

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

Создание email

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

Код	Описание
{recipient_name}	Имя пользователя или агента, получающего электронное письмо.
{sender_name}	Имя пользователя или агента, отправившего сообщение, которое вызвало уведомление по электронной почте.
{sender_profile_image}	Профильное изображение пользователя или агента, отправившего сообщение, которое вызвало уведомление по электронной почте.
{message}	Ссылки на любые вложения, которые были частью сообщения, вызвавшего уведомление по электронной почте.
{attachments}	Уведомления по электронной почте могут не быть доставлены по нескольким причинам; ниже приведены самые распространенные из них:

Проблемы?

Электронные письма могут не доставляться по нескольким причинам; ниже приведены самые распространенные из них:

Причина	Описание	Решение
Проблемы с хостингом	Почтовый сервер вашего веб-хостинг-провайдера не может отправлять электронные письма или письма отправляются, но автоматически определяются как спам и удаляются почтовыми клиентами.	Пожалуйста, свяжитесь с вашим веб-хостинг-провайдером по поводу поддержки электронной почты или используйте свой SMTP-сервер, активировав его в Настройки > Уведомления > SMTP.
Проблемы с SMTP	Электронное письмо не отправляется, даже если вы активировали опцию SMTP в Уведомлениях.	Мы не предоставляем поддержку по проблемам, связанным с вашим SMTP. Отправьте тестовое электронное письмо, чтобы получить детали о проблеме, или используйте sendgrid.com, вы можете отправить 40000 писем в течение 30 дней бесплатно, затем 100 в день навсегда бесплатно. Примечание: если вы используете Gmail, введите smtp.gmail.com в качестве хоста и установите 465 или 587 в качестве порта. Вам также необходимо разрешить доступ Gmail для менее безопасных приложений, это можно сделать на https://myaccount.google.com/lesssecureapps.

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

Push уведомления похожи на Десктопные уведомления, но с некоторыми ключевыми отличиями. Десктопные уведомления, также называемые Веб-уведомлениями, запрашиваются непосредственно клиентом, в то время как Push уведомления приходят с сервера. Основное отличие заключается в том, что Push уведомления работают всегда, даже если ваше устройство оффлайн или Support Board не открыт. Кроме того, они постоянны и всегда видимы, пока не будут закрыты. Push уведомления требуют внешнего сервиса для работы. Мы используем Pusher, который бесплатно используется для администраторских уведомлений, отправляемых агентам, и бесплатно для отправки уведомлений пользователям до 2000 пользователей/устройств. К сожалению, Apple пока не предоставила поддержку для iOS, но мы надеемся, что это произойдет скоро.

Активация

Перейдите на https://dashboard.pusher.com/accounts/sign_up и создайте новую учетную запись.
На своей панели управления в https://dashboard.pusher.com выберите продукт Beams, нажав на Начать работу.
Введите Имя экземпляра и создайте экземпляр. Вы можете ввести любое значение, которое хотите.
В левом меню панели управления нажмите на Ключи, скопируйте Идентификатор экземпляра и Первичный ключ.
Войдите в администраторскую область Support Board, перейдите в Настройки > Уведомления > Push уведомления и вставьте идентификатор экземпляра, первичный ключ.
Вы завершили.

Активация для пользователей

Скачайте файл службы-работника здесь.
Загрузите этот файл на свой сайт по следующему адресу: https://your-site.com/service-worker.js
Перейдите в Настройки > Уведомления > Push уведомления > URL службы-работника и введите URL файла. Например, https://your-site.com/service-worker.js. Если вы используете облачную версию, введите https://cloud.board.support/sw.js. Если вы используете SaaS версию, замените cloud.board.support на ваш домен.
Вы завершили.

Информация

Pusher бесплатно используется для до 1000 одновременных подписчиков. Хотя вы должны иметь возможность использовать бесплатный тарифный план для администраторской области и всех агентов, вам может понадобиться платный тарифный план для Push уведомлений, отправляемых пользователям, в зависимости от трафика вашего сайта.
Push уведомления в настоящее время не поддерживаются на iPhone и устройствах iOS. Push уведомления поддерживаются только на устройствах Mac, Windows и Android.
Push уведомления работают только для полных HTTPS веб-сайтов. Единственным исключением является localhost для упрощения разработки.
Когда пользователь нажимает на уведомление, открывается последняя посещенная пользователем страница, и чат открывается автоматически.
На десктопе браузер должен быть запущен, так как это процесс, который получает push сообщения.
Когда активны push уведомления, они заменяют десктопные уведомления.
На Android и мобильных устройствах десктопные уведомления могут не работать, в этом случае вам нужно использовать push уведомления.
Если Push уведомления активны и не работают, отключите их и попробуйте снова.
Push уведомления не могут быть получены на настольном ПК, если браузер не запущен.

Push уведомления для администраторов и агентов

Когда агент нажимает на уведомление, открывается администраторская область, и выбирается правильный разговор. Если администраторская область уже открыта, уведомление не откроет новую вкладку.
Когда пользователь отправляет свое первое сообщение, Push уведомление отправляется всем подтвержденным агентам; последующие уведомления отправляются только последнему агенту в разговоре.
Если вы используете приложение Dialogflow и Настройки > Dialogflow > Человеческое вмешательство активно, уведомления не отправляются, если чат-бот знает ответ.
Если вы используете версию WordPress, Push уведомления не поддерживаются в администраторской области WordPress, вам нужно получить доступ к администраторской области Support Board напрямую, более подробная информация здесь.
Если настройка Маршрутизация активна, только агент, назначенный разговору, получает уведомление, администраторы видят все разговоры, но не получают уведомлений.
Если настройка Очередь активна, только агент, назначенный разговору, получает уведомление. Уведомления не отправляются для сообщений, отправленных пользователем, пока он ждет в очереди. Администраторы видят все разговоры, но не получают уведомлений.
Если разговор пользователя назначен на отдел, только агенты, назначенные этому отделу, получают уведомление.
Если разговор пользователя не назначен ни на какой отдел, уведомление получают только агенты без назначенного отдела.
Уведомления не поддерживаются на iPhone и iOS устройствах.
Уведомления отправляются только если последний агент в разговоре оффлайн.
и Настройки > Dialogflow > Человеческое вмешательство активно, уведомления не отправляются, если чат-бот знает ответ.
Если push уведомления не работают, убедитесь, что вы разрешили уведомления, в Chrome вы можете проверить это в Конфиденциальность и безопасность > Настройки сайта > Уведомления. Если они не работают на мобильном устройстве, попробуйте следующие шаги: установите PWA или удалите его и установите снова, перезапустите мобильное устройство.

Десктопные уведомления

Уведомления не отправляются, если пользователь просматривает страницу с чатом (браузер пользователя открыт и видим, а активная страница содержит чат).
Уведомления не поддерживаются на iPhone и устройствах iOS.
Уведомления работают только для защищенных URL, которые используют HTTPS (не HTTP). Ваш URL администратора Support Board должен использовать HTTPS.
Когда активны push уведомления, они заменяют десктопные уведомления.

Уведомления по текстовым сообщениям

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

Активация

Перейдите на https://www.twilio.com и создайте новую учетную запись.
Подтвердите свой номер телефона.
Заполните форму и выберите SMS.
После перехода на панель управления нажмите Получить пробный номер, затем Выбрать этот номер.
Войдите в админку Support Board, перейдите в Настройки > Уведомления > Уведомления по текстовым сообщениям и вставьте SID учетной записи, токен аутентификации, пробный номер (или купленный номер телефона). Найдите все данные на панели управления Twilio.
Если вы используете пробную версию, вы можете отправлять уведомления только на проверенные номера. Перейдите на панель управления Twilio и нажмите кнопку слева # (Номера телефонов), затем нажмите Проверенные идентификаторы вызывающих абонентов и добавьте свой номер телефона.
Чтобы начать использовать сервис вживую и получать текстовые сообщения в Support Board, вам необходимо приобрести номер телефона. После покупки перейдите в Номера телефонов > Управление > Активные номера, нажмите на ваш номер и введите URL Support Board, получите его из Support Board > Настройки > Уведомления > Уведомления по текстовым сообщениям > Получить URL конфигурации.
Вы закончили.

Информация

Все номера телефонов должны иметь код страны, начинающийся с символа + (например, +15558675310).
Вы можете получить номер телефона пользователя через регистрационную форму, последующее сообщение, сообщение о подписке или через [email] короткий код. Вы можете вручную ввести номер телефона пользователя из админки или через API.
Когда пользователь отправляет свое первое сообщение, если разговор назначен на отдел, тестовое сообщение отправляется только тем агентам, которые назначены в этот отдел, если разговор назначен конкретному агенту, текстовое сообщение отправляется только этому агенту, в противном случае текстовое сообщение отправляется всем агентам, которые не онлайн в данный момент. Последующие текстовые сообщения отправляются только последнему агенту в разговоре.
Уведомления по текстовым сообщениям отправляются только в том случае, если последний агент в разговоре оффлайн.
Если вы используете приложение Dialogflow, и Настройки > Dialogflow > Переход к человеку активно, текстовые сообщения не отправляются, если чат-бот знает ответ.
Чтобы использовать функцию идентификатора отправителя, введите имя отправителя в поле Номер отправителя.

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

Звуки работают только после взаимодействия пользователя или агента с документом (пользователь или агент где-то кликнули).

WORDPRESS

WordPress

Настройки ниже относятся к версии Support Board для WordPress.

Синхронизация пользователей

Пользователи WordPress могут автоматически синхронизироваться с Support Board, выбрав "WordPress" в разделе Система пользователей в области Настройки > WordPress. Когда функция активна, чат на фронтэнде автоматически распознает всех вошедших в систему пользователей WordPress и создает новую учетную запись пользователя Support Board с теми же данными (имя, фамилия, электронная почта и пароль). Также форма входа распознает электронную почту и пароль каждого пользователя WordPress. При входе в Support Board пользователь автоматически также входит в WordPress.

Чтобы создать пользователя WordPress, когда посетитель регистрируется в Support Board, включите опцию Настройки > WordPress > Регистрация WordPress и добавьте поля пароля и электронной почты в форму регистрации, они обязательны. Пользователь WordPress автоматически войдет в систему.

Дополнительная информация

Прямой доступ и PWA

Вы можете получить доступ к администраторской области напрямую, не проходя через WordPress, перейдя по адресу /wp-content/plugins/supportboard/supportboard/admin.php и войдя в систему с помощью своей электронной почты и пароля администратора WordPress или агента. Имейте в виду, что ваша папка wp-content может отличаться. Получив доступ к администраторской панели напрямую, вы также сможете использовать ее как Прогрессивное веб-приложение. Вы можете найти более подробную информацию, кликнув здесь.

Вход и выход

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

Получить ID страницы или типа записи

Чтобы получить ID конкретной страницы или типа записи, перейдите в администраторскую область WordPress и отредактируйте страницу или запись. ID отображается в адресной строке. Пример: http://your-site.com/wp-admin/post.php?post=11&action=edit&lang=en (ID страницы/записи равен 11).

Получить slug типа записи

Slug типа записи блога и записей это post. Slug типа записи страниц это page. Чтобы получить slug кастомного типа записи, перейдите в администраторскую область WordPress и откройте страницу кастомного типа записи из левого меню. Slug отображается в адресной строке. Пример: http://your-site.com/wp-admin/edit.php?post_type=food (slug равен food).

Отключить эмодзи WordPress

Чтобы предотвратить замену эмодзи чата на эмодзи WordPress, вставьте код ниже в файл functions.php вашей темы.

            function disable_emojis() {
                 remove_action("wp_head", "print_emoji_detection_script", 7);
                 remove_action("admin_print_scripts", "'print_emoji_detection_script");
                 remove_action("wp_print_styles", "print_emoji_styles");
                 remove_action("admin_print_styles", "print_emoji_styles");
            }
            add_action("init", "disable_emojis");

WordPress Multisite

Если у вас установка multisite, вы должны установить Support Board на главном сайте.

WOOCOMMERCE

WooCommerce

Настройки ниже относятся к приложению WooCommerce для версии Support Board на WordPress.

Dialogflow

Начало работы

Чтобы начать использовать чат-бота Dialogflow, перейдите в Настройки > WooCommerce > Синхронизация Dialogflow и нажмите Синхронизировать сущности сейчас, затем нажмите Создать намерения сейчас. После завершения синхронизации вы готовы. Чат-бот начнет отвечать на вопросы пользователей.

Список встроенных вопросов намерений

Импортируя встроенные намерения, чат-бот может отвечать на вопросы, такие как приведенные ниже. Для полного списка, пожалуйста, посетите раздел намерений в консоли Dialogflow.

Вы продаете обувь дешевле $299?
Покажите мне ваши сумки
У вас есть что-нибудь для женщин на распродаже?
Какие лучшие туфли 2020 года?
Добавить Абстрактный принт в корзину
Удалить Абстрактный принт из корзины
Что вы продаете?

Какой статус моего заказа?
Куда будет отправлен мой заказ?
Отобразите товары в моей корзине!
Вы осуществляете доставку в Австралию?
Куда вы осуществляете доставку?
Откройте страницу обуви.
Перейдите, пожалуйста, на страницу кашемирового топа.

Действия

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

Код действия	Описание
{ "woocommerce-update-cart": [ "cart-add", "PRODUCT-NAME-OR-ID" ] }	Добавляет продукт в корзину пользователя. Замените PRODUCT-NAME-OR-ID на ID или полное название продукта.
{ "woocommerce-update-cart": [ "cart-remove", "PRODUCT-NAME-OR-ID" ] }	Удаляет продукт из корзины пользователя. Замените PRODUCT-NAME-OR-ID на ID или полное название продукта.
{ "woocommerce-checkout": true }	Перенаправляет пользователя на страницу оформления заказа.

Многоязычность

Функция многоязычности совместима с плагинами WPML и Polylang.
Чтобы активировать функцию многоязычности, перейдите в Настройки > WordPress > Плагин многоязычности и выберите WPML или Polylang. Синхронизация автоматически создает Сущности на всех доступных языках вашего сайта. Чтобы язык работал, чат-бот должен быть переведен на этот язык в Dialogflow, более подробную информацию можно найти здесь.
Встроенные намерения Dialogflow доступны только на английском языке, чтобы перевести их, перейдите в вашу консоль Dialogflow, выберите язык, на который хотите перевести, перейдите на страницу Намерения и переведите существующие намерения WooCommerce.
Функция многоязычности для атрибутов продуктов требует плагин WooCommerce Multilingual, если вы используете WPML, или плагин Polylang для WooCommerce, если вы используете Polylang.

Дополнительная информация

Если вы редактируете существующее встроенное намерение WooCommerce в Dialogflow, а затем снова импортируете намерения из Настройки > WooCommerce > Синхронизация Dialogflow, вы потеряете свои изменения. Чтобы сохранить ваши редактирования, измените название намерения.
Чат-бот может отображать до 15 продуктов через слайдер с расширенным сообщением.
Чат-бот автоматически обновляется каждые 60 минут по умолчанию, но это может занять больше времени. Если вы обновите продукт, категорию, тег или атрибут, пожалуйста, подождите несколько часов, чтобы новые данные вступили в силу.
Синхронизация обнаруживает следующие события: продукт удален, продукт восстановлен из корзины, продукт обновлен, новый продукт добавлен, продукт удален, категория или тег удалены, категория или тег обновлены, новая категория или тег добавлены.
Чтобы улучшить чат-бота, добавьте все возможные варианты атрибута, включая варианты, которые не используются в ваших продуктах. Пример: если вы продаете только желтые и красные футболки, добавьте все возможные цвета в атрибут цвет, а не только желтый и красный.
Вы можете вручную синхронизировать чат-бота в любое время из Настройки > WooCommerce > Синхронизация Dialogflow
У продуктов должен быть установлен атрибут Обычная цена.
Названия продуктов не должны использовать двойную кавычку: ".
Некоторые функции многоязычности не совместимы с поддоменами или внешними доменами языков URL.

Слияние полей и шорткоды

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

Код	Описание	Совместимость
{product_images}	Слайдер изображений продукта. Если результатов нет, полное сообщение заменяется на "Результаты не найдены".	Dialogflow
{shipping_location_check}	Проверяет, осуществляет ли магазин доставку в указанную страну.	Dialogflow
{product_attribute_terms}	Список терминов атрибутов продукта.	Dialogflow
{product_attribute_name}	Название атрибута термина атрибута.	Dialogflow
{category_link}	Ссылка на страницу категории.	Dialogflow
{tag_link}	Ссылка на страницу тега.	Dialogflow
{product_name}	Название продукта.	Dialogflow, Автоматические сообщения
{product_image}	Изображение продукта.	Dialogflow, Автоматические сообщения
{product_price}	Цена продукта.	Dialogflow, Автоматические сообщения
{product_description}	Описание продукта.	Dialogflow, Автоматические сообщения
{product_rating}	Рейтинг продукта. Если у продукта еще нет оценок, полное сообщение заменяется на "[название продукта] пока не имеет оценок или отзывов".	Dialogflow, Автоматические сообщения
{product_link}	Ссылка на продукт.	Dialogflow, Автоматические сообщения
{shipping_locations}	Список стран доставки.	Dialogflow, Сообщения, Автоматические сообщения
{shop_link}	Ссылка на магазин.	Dialogflow, Сообщения, Автоматические сообщения
{cart_link}	Ссылка на корзину.	Dialogflow, Сообщения, Автоматические сообщения
{cart}	Список продуктов в корзине пользователя. Если корзина пуста, полное сообщение заменяется на "Ваша корзина в настоящее время пуста".	Dialogflow, Автоматические сообщения
{order_status}	Статус последнего заказа пользователя. Если пользователь никогда не размещал заказ, полное сообщение заменяется на "Вы еще не размещали заказ".	Dialogflow, Автоматические сообщения
{order_details}	Детали последнего заказа пользователя. Если пользователь никогда не размещал заказ, полное сообщение заменяется на "Вы еще не размещали заказ".	Dialogflow, Автоматические сообщения
{product_card}	Карта продукта. Опциональные атрибуты: id ID продукта. link-type Действие при нажатии пользователя. Доступные значения: purchase, checkout, link. По умолчанию: purchase. link-text Текст кнопки. По умолчанию: Покупка.	Dialogflow, Сообщения, Автоматические сообщения
{products_slider}	Поиск продуктов, соответствующих указанным атрибутам, и отображение их в слайдере карточек продуктов. Если результатов нет, полное сообщение заменяется на "Результаты не найдены". Опциональные атрибуты: id ID продуктов, разделенные запятыми. Если этот атрибут установлен, все остальные атрибуты игнорируются. tag Отображать только продукты с указанным тегом. category Отображать только продукты из указанной категории. discounted Установите значение true, чтобы показать только продукты со скидками. rating Отображать только продукты с рейтингом равным или больше указанного значения. Введите значение от 1 до 5. max-price Отображать только продукты с ценой равной или меньшей указанного значения. Введите число. min-price Отображать только продукты с ценой равной или большей указанного значения. Введите число. attribute Отображать только продукты с указанным атрибутом. link-type Действие при нажатии пользователя. Доступные значения: purchase, checkout, link. По умолчанию: purchase. link-text Текст кнопки. По умолчанию: Покупка. language Код языка продуктов для отображения.	Dialogflow, Сообщения, Автоматические сообщения
{payment_methods}	Доступные методы оплаты.	Dialogflow, Сообщения, Автоматические сообщения
{coupon}	Генерирует код купона. Опциональные атрибуты: discount Скидка купона в процентах. expiration Срок действия купона. Пример: '60 секунд', '5 часов', '2 дня'.	Dialogflow, Сообщения, Автоматические сообщения
{product_names}	Названия продуктов.	Только там, где указано
{discount_price}	Сниженная цена продукта или общая сниженная цена нескольких продуктов.	Только там, где указано
{original_price}	Оригинальная цена продукта или общая оригинальная цена нескольких продуктов.	Только там, где указано
{carts}	Список корзин нескольких пользователей с продуктами.	Только там, где указано
{purchase_button}	Кнопка покупки продукта.	Только там, где указано
{html_product_card}	Карта деталей продукта.	Электронная почта
{html_products_list}	Список карт деталей продуктов.	Электронная почта

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

Шорткод	Описание
[woocommerce-button name="" ids="" coupon="" checkout="true"]	Добавляет продукт или несколько продуктов в корзину пользователя. По желанию можно применить код купона и перенаправить пользователя на страницу оформления заказа.

Дополнительная информация

Список ожидания

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

Уведомление о удаленном товаре из корзины

Если купон включен, сообщение чата отправляется только для первого удаленного товара, а затем снова после истечения срока действия купона.
Купон действителен только для удаленных товаров.
Следующие поля слияния могут использоваться и в теме письма: {coupon}, {discount_price}, {original_price}, {product_names}, {customer_name}.
Только пользователи с электронной почтой будут уведомлены по электронной почте.

Уведомление о возвращающихся посетителях

Сообщение чата отправляется через 15 секунд.
Сообщение чата отправляется в активный разговор, если таковой имеется, в противном случае — в новый разговор.
Посетитель считается "возвращающимся" только если с момента последнего визита прошло как минимум 24 часа.
Сообщение чата отправляется только 1 раз, если посетитель возвращается снова, сообщение не отправляется.

Сообщение с последующим обращением

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

Разное

Когда посетитель завершает покупку, новый пользователь Support Board автоматически создается с данными, предоставленными в форме оформления заказа.
Автоматические сообщения (сообщение о брошенной корзине, сообщения с последующими обращениями и т. д.) отправляются в активный разговор, если таковой имеется, в противном случае — в новый разговор.
Стандартные значения купонов составляют 0% скидки и 7 дней срока действия.
Купоны в корзине все еще действительны, вы должны удалить их навсегда.
Все купоны можно использовать только 1 раз.
Истекшие купоны автоматически удаляются с помощью заданий cron.
Всплывающее окно продуктов в области администраторов разговоров ищет по названию, описанию и цене продукта.
Всплывающее окно продуктов в области администраторов разговоров многоязычно и автоматически отображает продукты на языке пользователя, если таковые доступны.
Чтобы просмотреть заказы гостей, которые не отправляли никаких сообщений в чате до покупки, вам необходимо включить Настройки > Пользователи > Регистрировать всех посетителей.
Настройка Выбор продуктов билета > Исключить продукты принимает идентификаторы продуктов WooCommerce, разделенные запятыми.

Магазин WhatsApp

Чтобы позволить пользователю покупать продукты вашего магазина WooCommerce через WhatsApp, идентификатор продукта продуктов вашего магазина WhatsApp должен совпадать с идентификатором продукта ваших продуктов WooCommerce. Как только пользователь отправляет заказ в WhatsApp, WooCommerce автоматически сохраняет его. Используйте поле слияния {catalog_checkout}, чтобы отправить пользователю ссылку на оформление заказа.

Используйте плагин https://wordpress.org/plugins/facebook-for-woocommerce/, чтобы автоматически синхронизировать продукты WooCommerce с продуктами магазина WhatsApp.

БИЛЕТЫ

Билеты

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

Установка и использование

Установка PHP

Чтобы отобразить область билетов, включите следующий скрипт на вашу страницу.

        <script src="supportboard/js/min/jquery.min.js"></script> <!-- Не требуется, если jQuery уже загружен -->
        <script id="sbinit" src="supportboard/js/main.js?mode=tickets"></script>

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

Установка WordPress

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

Установка облачной версии

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

Информация

Билеты аналогичны чат-разговорам и сообщениям, единственное отличие от чата — это панель фронтенда.
Большинство настроек чата совместимы с приложением Билеты, но не все из них. Настройки панели управления, всплывающее сообщение и многое другое не совместимы.
Специальные API для приложения Билеты доступны в разделе API.
Чтобы убрать обязательную форму 'Новый билет' для новых пользователей, активируйте приветственное сообщение в Настройки > Сообщения > Приветственное сообщение. Задержка приветственного сообщения игнорируется в области билетов, сообщение отправляется немедленно..
Чтобы вручную отключить обязательную регистрацию только на одной странице, используйте JavaScript-код var SB_REGISTRATION_REQUIRED = true. Установите его в false, чтобы заставить регистрацию вместо этого.

DIALOGFLOW

Dialogflow

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

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

Чтобы начать использовать Dialogflow с Support Board, выполните следующие шаги.

Перейдите на console.cloud.google.com и войдите в систему.
Активируйте API Dialogflow, введя Dialogflow API в верхней строке поиска. Нажмите Dialogflow API, а затем Включить.
Создайте свой первый проект, нажав кнопку Выбрать проект в верхнем левом углу. Назовите проект как хотите.
Выберите проект и перейдите в Левое меню > API и сервисы > Экран согласия OAuth. Выберите Внешний и нажмите Создать. В Имя приложения введите любое название, в Email поддержки пользователей и Контактная информация разработчика введите свой email. Нажмите Сохранить и продолжить.
В области доступов нажмите Добавить или удалить доступы, прокрутите вниз и в области Добавить доступы вручную введите https://www.googleapis.com/auth/dialogflow,https://www.googleapis.com/auth/cloud-language,https://www.googleapis.com/auth/cloud-translation. Нажмите Добавить в таблицу, затем Обновить и Сохранить и продолжить.
В области тестовых пользователей нажмите Добавить пользователей и добавьте свой Google email, используйте тот же email, что и для текущей учетной записи. Нажмите Сохранить и продолжить.
Перейдите в Левое меню > API и сервисы > Учетные данные и нажмите Создать учетные данные, выберите Идентификатор клиента OAuth. В качестве Типа приложения выберите Веб-приложение. Введите любое название. В URI перенаправления введите URL-адрес перенаправления, получите его из Support Board > Настройки > Dialogflow > Синхронизация > URI перенаправления. Нажмите Создать.
Скопируйте ID клиента и Секрет клиента и вставьте их в Support Board > Настройки > Dialogflow > Синхронизация. Сохраните настройки.
Нажмите Support Board > Настройки > Dialogflow > Синхронизация > Синхронизировать. Войдите с той же учетной записью Google, которую вы использовали до сих пор. На следующем экране нажмите Продолжить. На следующем экране выберите все доступы и нажмите Продолжить.
Скопируйте Токен обновления и вставьте его в Support Board > Настройки > Dialogflow > Синхронизация > Токен обновления.
Вы почти закончили! Теперь вам нужно ввести ID проекта вашего чат-бота или имя агента. Чтобы получить его, выполните шаги ниже. Обратите внимание, что приложение не требует одобрения Google.

Получить ID проекта

Войдите в консоль Dialogflow ES, перейдя на dialogflow.cloud.google.com. Вы должны войти с той же учетной записью Google, использованной во время синхронизации.
Нажмите на иконку шестеренки в верхнем левом углу, рядом с именем чат-бота, и откройте область настроек. . Если вы еще не создали чат-бота, выполните инструкции ниже, чтобы создать своего первого бота.
Скопируйте ID проекта .
Убедитесь, что вы выбрали США / ГЛОБАЛЬНЫЙ в верхнем левом углу панели управления Dialogflow .

Получить имя агента Dialogflow CX

Войдите в консоль Dialogflow CX, перейдя по адресу https://dialogflow.cloud.google.com/cx/.
Выберите проект желаемого агента и перейдите на страницу агентов. Вы можете войти на страницу агентов, выбрав агента и нажав на верхнюю кнопку Агенты > Просмотреть всех агентов .
Нажмите на меню опций для желаемого агента и нажмите Копировать имя .
Более подробная информация на https://cloud.google.com/dialogflow/cx/docs/quick/api#detect-intent-drest.

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

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

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

Чтобы создать своего первого чат-бота, войдите в консоль Dialogflow и создайте агента. В качестве Проекта Google выберите тот же проект, что использовался во время синхронизации.
Добавьте новый Интенция из левого меню и откройте ее.
В области Обучающие фразы добавьте вопрос пользователя, на который вы хотите, чтобы чат-бот ответил, добавьте столько вариантов, сколько сможете. Например, если вы хотите, чтобы чат-бот ответил на вопросы пользователей о вашем адресе, добавьте такие варианты, как "какой у вас адрес", "адрес", "где вы находитесь".
В области Ответы добавьте ответ бота в виде текстового ответа.
Вы создали свой первый вопрос и ответ! Протестируйте это из правой области или из чата Support Board. Добавьте новые Интенции, чтобы заполнить своего чат-бота вопросами и ответами, которые вам нужны. Вы можете включить основные предустановленные вопросы и ответы, включив функцию Малый разговор из левого меню.

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

Действия

Следующие действия предоставляют чат-боту возможность взаимодействовать с веб-сайтом автономно от имени пользователя. Чтобы использовать действие, перейдите в Dialogflow, отредактируйте Интенцию и добавьте новый Пользовательский ответ с помощью следующего синтаксиса: { "ИМЯ-ДЕЙСТВИЯ": ЗНАЧЕНИЕ-ДЕЙСТВИЯ }.

Код действия	Описание
{ "human-takeover": true }	Отключить чат-бота на 5 минут, уведомить агентов и оставить разговор непрочитанным.
{ "disable-bot": true }	Отключить чат-бота на 5 минут.
{ "redirect": "URL" }	Перенаправить пользователя на указанный URL. Добавьте значение "new-window": true, чтобы открыть URL в новом окне.
{ "open-article": ID }	Открыть статью с указанным ID.
{ "transcript": true }	Сгенерировать транскрипцию разговора в виде текстового файла и скачать его. Установите email, чтобы отправить транскрипцию на электронную почту пользователя, добавьте значение message: "Ваше сообщение", чтобы включить сообщение в электронное письмо.
{ "department": ID }	Изменить или установить отдел разговора и уведомить агентов.
{ "agent": ID }	Изменить или установить агента, назначенного на разговор, и уведомить агента.
{ "send-email": { "recipient": "active_user", "message": "", "attachments": [] } }	Отправить электронное письмо активному пользователю или агентам. Синтаксис вложений: [["имя", "ссылка"], ["имя", "ссылка"], ...]}. Значение получателя может быть active_user или agents.
{ "update-user": true }	Сообщает административной зоне обновить информацию о пользователе активного разговора. Используйте это действие в комбинации с другими действиями, чтобы обновить детали пользователя в административной зоне в реальном времени.
{ "archive-chat": true }	Архивировать чат и отправить сообщение о закрытии, если оно активно.
{ "update-user-details": { "email": "", "last_name": "", "first_name": "", "extra": { "phone": ["+123456789", "Телефон"] }}}	Обновить данные активного пользователя. Вы можете обновить все данные, включая first_name, last_name, email, user_type, password. Вы можете обновить дополнительные данные пользователя, такие как номер телефона, введя значения в ключ extra; значения должны использовать следующий синтаксис: "slug": [значение, "метка"]. Скачайте пример здесь. Чтобы загрузить Интенцию, перейдите в область Интенции и нажмите на иконку меню с тремя точками в правом верхнем углу, затем нажмите Загрузить Интенцию. Начните разговор, отправив сообщение "start".

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

Чтобы включить функцию определения языка и автоматического перевода сообщений агентов на язык пользователя, а сообщений пользователя на язык агента, отметьте опцию Настройки > Dialogflow > Автоматический перевод и синхронизируйте Dialogflow. Учетная запись Google, используемая для синхронизации Dialogflow, должна иметь включенные выставление счетов и службу cloud-translation. Для этого выполните следующие шаги:

Войдите на https://console.cloud.google.com с помощью вашей учетной записи Google и выберите проект вашего агента Dialogflow.
В верхней строке поиска введите cloud translation, выберите службу Cloud Translation API и включите её. Обратите внимание, что это платная услуга с бесплатным уровнем, могут возникнуть дополнительные charges.
Включите выставление счетов, нажав Левое меню > Выставление счетов и включив учетную запись выставления счетов с действующим способом оплаты. Включите выставление счетов для проекта вашего агента Dialogflow.

После завершения настройки учетной записи Google автоматические переводы начинают работать сразу. Вот более подробная информация:

Сообщения пользователей в административной зоне автоматически переводятся в режиме реального времени, чтобы соответствовать языку агента.
Сообщения агентов автоматически переводятся в режиме реального времени, чтобы соответствовать языку пользователя.
Агенты могут просмотреть оригинальное сообщение, открыв меню сообщения и нажав Просмотреть оригинальное сообщение.
Язык агента основывается на языке пользовательских данных агента, если он установлен, в противном случае — на языке браузера или языке административной зоны.
Язык пользователя основывается на языке пользовательских данных пользователя, если он установлен, в противном случае — на языке браузера или его можно определить с помощью функции Настройки > Dialogflow > Определение языка.

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

Сообщение пользователя должно содержать как минимум 2 слова.
Определение языка выполняется только для первых 2 сообщений пользователя в разговоре.

Человеческое вмешательство

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

Когда активируется человеческое вмешательство, чат-бот автоматически отключается на время, пока агент онлайн. После этого чат-бот снова активируется, но в течение 10 дней после человеческого вмешательства не будут отправлены стандартные сообщения обратной связи, если чат-бот не знает ответа на вопрос пользователя в том же разговоре. Вы можете заставить сообщение Dialogflow всегда отправляться, добавив в намерение значение пользовательской полезной нагрузки "force-message": true.
Чат-бот полностью активируется снова, когда разговор архивируется или удаляется.
Если вы используете Slack, никаких сообщений не будет отправлено, если чат-бот знает ответ. Как только человеческое вмешательство активно, все сообщения разговора отправляются в Slack.
Когда агент человека отвечает пользователю, человеческое вмешательство активируется автоматически.

Опция человеческого вмешательства

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

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

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

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

Ручное вмешательство человека

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

WhatsApp, Messenger, Telegram

Чтобы запрос на человеческое вмешательство работал в WhatsApp, Messenger, Telegram, вам необходимо создать новое Намерение с human-takeover в качестве входного контекста, ничего в качестве выходного контекста, список наиболее распространенных сообщений подтверждения пользователя в качестве Фраз обучения (например, ок, да) и { "human-takeover": true } в качестве Пользовательской полезной нагрузки. .

Умный ответ

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

Предложения бота

Чтобы использовать предложения бота, просто синхронизируйте Dialogflow как обычно и обучите чат-бота, как обычно. Один и тот же чат-бот, который используется для пользователей, будет использоваться.

Предложения помощи агента

Помощь агента требует технических знаний для работы и предназначена только для корпоративного бизнеса с набором данных не менее 30 000 разговоров. Если вы никогда не использовали помощь агента, вероятно, у вас нет знаний и данных, чтобы использовать ее, и поэтому вы можете ее игнорировать. Более подробная информация на https://cloud.google.com/agent-assist/docs/conversation-profile.

Информация

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

OpenAI

Интеграция OpenAI (ChatGPT) дает вашему чат-боту возможность отвечать на общие вопросы практически на любую тему, которую вы можете себе представить. Чтобы начать использовать его, выполните следующие шаги.

Зарегистрируйтесь на https://beta.openai.com/signup.
Получите ключ API на https://beta.openai.com/account/api-keys и вставьте его в Настройки > Dialogflow > OpenAI > Ключ API.

Генерация выражений пользователя - Опция

Когда эта опция активна, OpenAI будет генерировать новые выражения пользователя в реальном времени, когда вы открываете окно Dialogflow Intent, нажав на пункт меню Отправить в Dialogflow сообщения в разговоре.

Генерация выражений пользователя - Кнопка

Когда вы нажимаете кнопку Сгенерировать выражения пользователя, OpenAI обновит вашего агента Dialogflow и сгенерирует новые выражения пользователя для каждого Намерения.

Сначала сделайте резервную копию вашего агента Dialogflow.
Эта задача может занять несколько минут или даже часов, если у вашего чат-бота много Намерений. Поскольку операция занимает много времени, ваш сервер может прервать выполнение (время выполнения операции) до его завершения, в этом случае вам нужно нажать кнопку снова. Вы можете проверить, прервана ли операция, проверив консоль браузера на наличие ошибок.
Эта задача выполняется только один раз для каждого Намерения. Ранее обработанные Намерения будут проигнорированы.
Эта задача проверяет существующие выражения пользователя и не создает дубликаты.
Первые 5 выражений пользователя будут использоваться для генерации новых выражений пользователя.
Поскольку это автоматизированный процесс, мы настоятельно рекомендуем просмотреть ваши Намерения после завершения задачи.

Информация

Запрос OpenAI выполняется только в том случае, если чат-бот не знает ответа на вопрос пользователя и если длина сообщения пользователя больше 6 символов.

Поиск Google

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

Зарегистрируйтесь на https://programmablesearchengine.google.com/.
Создайте поиск и настройте его по своему усмотрению. Мы рекомендуем добавлять только ваш сайт и Википедию, если вы хотите, чтобы ваш чат-бот отвечал на общие вопросы, отключите опцию Поиск по всему интернету. Используйте настройку Сущности для исключения недействительных результатов.
Перейдите в Редактировать поисковую систему > Настройки > Основные и скопируйте значение ID поисковой системы, вставьте его в Support Board.
Чтобы получить ключ API, посетите https://developers.google.com/custom-search/v1/overview и нажмите Получить ключ.

Сущности

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

Войдите на https://console.cloud.google.com с вашей учетной записью Google и выберите проект вашего агента Dialogflow.
Введите Cloud Natural Language API в строку поиска в верхней части, выберите Cloud Natural Language API и включите API .
Включите биллинг, нажав Левое меню > Биллинг и включив аккаунт биллинга с действительным способом оплаты. Включите биллинг для проекта вашего агента Dialogflow.

Информация

Поиск Google выполняется только в том случае, если чат-бот не знает ответа на вопрос пользователя и если длина сообщения пользователя больше 6 символов.
Если поиск Google возвращает результат, контекст Dialogflow google-search автоматически активируется. Контекст содержит атрибут link, который является ссылкой на сайт результата поиска Google. Используйте контекст для создания нового намерения, которое предоставляет ссылку, если пользователь отправляет сообщение вроде расскажи подробнее или я хочу узнать больше.
Поиск Google не требуется для активации исправления орфографии. Вы можете отключить поиск Google и активировать только исправление орфографии.
Если поиск Google активен, он будет иметь приоритет над OpenAI.

Выполнение

Данные выполнения, отправляемые на ваш 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"
 }

Поля payload и session содержат идентификатор пользователя Support Board и идентификатор разговора.

Информация

База знаний

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

Ответ Dialogflow

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

Вложения пользователя

Вложения пользователя отправляются в Dialogflow, добавляя вложения к деталям сообщения в следующем формате:

[name:file-name.ext,url:URL,extension:file-extension]

Example:

                                    [name:archive.zip,url:https://board.support/archive.zip,extension:zip]
                                    [name:license.pdf,url:https://board.support/license.pdf,extension:pdf]

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

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

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

Замените "name" на фактическое имя вложения для отображения и замените "YOUR-LINK" на фактический URL файла. Вложения с изображениями отображаются автоматически как изображения.

Расширенные сообщения

Чтобы разрешить Dialogflow отправлять расширенные сообщения, просто введите код расширенного сообщения в поле TEXT RESPONSE или добавьте новый ответ Custom Payload и вставьте этот JSON-код: { "rich-message": "shortcode" }. Замените "shortcode" на код расширенного сообщения, чтобы получить действительный JSON-код, вам нужно заменить все " символы на \". Чтобы получить коды или узнать, как создать расширенное сообщение, пожалуйста, нажмите здесь.

Ответ расширенного сообщения

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

Если пользователь взаимодействует с чат-ботом через приложение для обмена сообщениями (например, WhatsApp), ответ расширенного сообщения не содержит ID расширенного сообщения, и контексты Dialogflow должны использоваться для того, чтобы Dialogflow понимал, какое намерение активировать для конкретного ответа расширенного сообщения.

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

Из Левое меню > Fulfillment включите Webhooks, вам нужно только ввести URL файла, который будет получать данные вебхука Dialogflow.
Создайте намерение с ID расширенного сообщения, для формы регистрации введите registration, для формы последующего действия введите sb-follow-up-form, для форм электронной почты введите email.
Включите Fulfillment для намерения
Вы сделали это! Файл URL вебхука будет получать детали пользователя расширенного сообщения Support Board.

Оптимизация чат-бота Dialogflow

Если чат-бот отвечает неправильными намерениями, перейдите в Консоль Dialogflow > Настройки чат-бота > Настройки ML, и установите ПРОПОРЦИОНАЛЬНЫЙ ПРЕДЕЛ КЛАССИФИКАЦИИ ML на большее число, например, 0.6.

Последовательный опрос

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

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

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

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

Связывание отделов

Получите ID отделов из Настройки > Разное > Отделы.
Получите ID проектов из области настроек Dialogflow ваших агентов.

Дополнительная информация

Вы можете активировать чат-бота через API, отправив сообщение без текста и с полезной нагрузкой { "event": "activate-bot" }.
Поддерживаемый китайский язык - только китайский - упрощенный. Пожалуйста, используйте язык Dialogflow Китайский - упрощенный (zh-CN) только. Языковые коды zh-HK и zh-TW не будут работать.
Следующие детали отправляются в Dialogflow в параметре queryParams при определении намерения: conversation_id, user_id.
Чтобы вызвать приветственное событие в Dialogflow CX, создайте Обработчик событий и вставьте Welcome в качестве Пользовательского события.
Статьи Support Board синхронизируются автоматически с базой знаний Dialogflow.
Используйте переменную JS SB_DIALOGFLOW_AGENT = "AGENT ID", чтобы изменить стандартный агент Dialogflow, замените "AGENT ID" на ID проекта.

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

Установка

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

Настройка WhatsApp Cloud API

Создайте учетную запись разработчика и новое приложение Facebook, как описано по адресу https://developers.facebook.com/docs/whatsapp/cloud-api/get-started#set-up-developer-assets.
В Support Board > Настройки > WhatsApp > Cloud API > Секретный ключ введите случайную строку, затем перейдите по адресу https://developers.facebook.com/apps и выберите ваше приложение. Нажмите Добавить продукт и добавьте WhatsApp, затем перейдите в WhatsApp > Конфигурация и в Webhook URL введите URL, который вы получили из Support Board > Настройки > WhatsApp > Cloud API > Конфигурационный URL. В Проверочный токен введите секретный ключ, который вы ранее ввели в Support Board. Нажмите Проверить и сохраните, нажмите Поля вебхука > Управлять, активируйте следующие поля вебхука: messages.
В Support Board > Настройки > WhatsApp > Cloud API > Токен введите тестовый токен для тестирования и следуйте инструкциям ниже для получения постоянного токена доступа.
- Перейдите на https://business.facebook.com и перейдите в Левое меню > Настройки > Дополнительные системные настройки, затем перейдите в Пользователи > Системные пользователи, чтобы просмотреть системного пользователя, которого вы создали, или создайте нового. Нажмите на этого пользователя и выберите Добавить ресурсы. Системный пользователь должен быть администратором.
- Нажмите Левое меню > Приложения и в разделе Выберите ресурсы выберите ваше приложение. Включите Разработать приложение для этого приложения и сохраните.
- Нажмите Сгенерировать токен и выберите ваше приложение, включите следующие разрешения: whatsapp_business_management, whatsapp_business_messaging, business_management. Нажмите Сгенерировать токен и сохраните. Вставьте токен в Support Board > Настройки > WhatsApp > Cloud API > Токен.
Чтобы получить ID телефона, перейдите на https://developers.facebook.com, выберите ваше приложение и перейдите в Левое меню > WhatsApp > Начало работы.
Вы можете протестировать интеграцию на https://developers.facebook.com, выберите ваше приложение и перейдите в Левое меню > WhatsApp > Начало работы.

Настройка аккаунта 360dialog

Перейдите на https://www.360dialog.com/ и создайте новый аккаунт.
Войдите в свою панель управления и в разделе Левое меню > Аккаунты WhatsApp создайте API ключ и скопируйте его в Support Board > Настройки > WhatsApp > Настройки 360dialog.
Нажмите Support Board > Настройки > WhatsApp > Настройки 360dialog > Синхронизировать сейчас.
Готово! Support Board должен начать получать сообщения WhatsApp, отправленные на ваш номер, и вы можете отвечать на эти сообщения из Support Board.
Обратите внимание, что вы также можете использовать бесплатный тестовый аккаунт для тестирования, более подробная информация на https://docs.360dialog.com/whatsapp-api/whatsapp-api/sandbox. Тестовый аккаунт имеет ограничения, и некоторые функции, такие как медиа-вложения, не будут работать.

Настройка аккаунта Twilio

Перейдите на https://www.twilio.com и создайте новый аккаунт.
Подтвердите свой номер телефона.
Заполните форму и выберите WhatsApp, Уведомления и оповещения, Совсем без кода, Интеграции с третьими сторонами.
В консоли Twilio скопируйте ACCOUNT SID и AUTH TOKEN и вставьте их в Support Board > Настройки > WhatsApp > Настройки Twilio, сохраните изменения.
Теперь вам нужно настроить бесплатный тестовый аккаунт для проведения тестов и проверки работы интеграции с Support Board. В левом меню нажмите Сообщения > Настройки > Настройки песочницы WhatsApp и введите в КОЛИЧЕСТВО СООБЩЕНИЙ и URL обратного вызова статуса URL Support Board, получите его из Support Board > Настройки > WhatsApp > Настройки Twilio > Получить конфигурационный URL. Обратите внимание, что localhost не сработает, вам нужен публичный URL и рабочий сервер.
В левом меню нажмите Сообщения > Попробуйте > Отправить сообщение WhatsApp. Следуйте инструкциям и отправьте сообщение с кодом на предоставленный номер WhatsApp. Нажимайте следующие кнопки, пока конфигурация не будет завершена.
Готово! Support Board должен начать получать сообщения WhatsApp, отправленные на тестовый аккаунт, и вы можете отвечать на эти сообщения из Support Board.
Чтобы публично использовать интеграцию WhatsApp с вашими клиентами, вам нужно обновить ваш аккаунт и включить выставление счетов, вы можете сделать это здесь. После этого вам нужно будет приобрести номер Twilio, который будет номером вашего официального WhatsApp Business аккаунта. Более подробная информация здесь. Вы не можете использовать номер вашего существующего WhatsApp Business аккаунта, вы должны использовать номер Twilio. Более подробная информация здесь.

Сообщения резервного копирования

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

Резервное текстовое сообщение

Чтобы включить резервное текстовое сообщение, вы должны настроить SMS в Настройки > Уведомления > Уведомления текстовых сообщений.
Более подробная информация здесь

Шаблонные сообщения WhatsApp

Шаблонное сообщение WhatsApp — это формат сообщения, который вы можете использовать снова и снова для сообщения пользователям, как только они согласились и предоставили вашему приложению разрешение отправлять им сообщения. Вы не можете вводить оригинальное сообщение в шаблон, вы должны использовать его, чтобы уведомить пользователя о новом сообщении и указать ему, как его просмотреть, например, предоставив ссылку на ваш веб-сайт, где отображается чат.

WhatsApp Cloud API

Чтобы получить Имя шаблона и управлять шаблонами, посетите https://business.facebook.com и перейдите в Левое меню > Настройки > Другие системные настройки, затем перейдите в Учетные записи > Учетные записи WhatsApp > Настройки и нажмите WhatsApp Manager.
В Языках шаблона введите все коды языков, поддерживаемые вашим шаблоном, разделенные запятыми. Если язык не найден, будет использоваться первый код языка. Список кодов языков здесь (копируйте только код языка, например, it, es, en_US).
В Параметрах заголовка и Параметрах тела введите поддерживаемые поля слияния, разделенные запятыми, например, {recipient_name}, {conversation_url_parameter}. Количество параметров, введенных здесь, должно соответствовать количеству параметров шаблона. Используйте эту функцию, если ваш шаблон использует динамические значения. Порядок имеет значение, первое поле слияния будет использоваться как первый параметр шаблона.

Twilio

Введите код шаблона в Support Board > Настройки > WhatsApp > Резервный шаблон. Если вы используете песочницу Twilio для тестирования, вы можете использовать предварительно одобренные шаблоны, такие как Ваш {{1}} код — {{2}}, вы можете заменить переменные на переменные Support Board, такие как {recipient_name}, например, Ваш код для {recipient_name} — {recipient_email}. Более подробная информация здесь.

360dialog

Получите значение Namespace из Левое меню > Учетные записи WhatsApp > Подробности.
Получите Имя шаблона и Шаблонный язык по умолчанию из области шаблонов 360dialog.
В Пользовательских параметрах введите поддерживаемые поля слияния, разделенные запятыми, например: {recipient_name}, {conversation_url_parameter}. Используйте эту функцию, если ваш шаблон использует динамические значения. Порядок имеет значение, первое поле слияния будет использоваться как первое динамическое значение шаблона.
Support Board попытается использовать шаблон с тем же языком, что и у пользователя; если он недоступен, будет использоваться шаблон с языком по умолчанию. Следующие языки шаблонов несовместимы: en_GB (используйте en_US), pt_PT (используйте pt_BR), zh_HK и zh_TW (используйте zh_CN), es_AR и es_MX (используйте es_ES).

Магазин WhatsApp

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

Поле слияния	Описание
{catalog id="123" product_id="123" body="" footer=""}	Отображает один продукт. Замените id на ID каталога и product_id на ID продукта. Атрибуты body и footer являются необязательными.
{catalog id="123" product_id_1_1="123" product_id_1_2="123" product_id_2_1="123" section_1="" section_2="" header="" body="" footer=""}	Отображает несколько продуктов. Замените id на ID каталога. Добавьте продукты, группируя их в секции через атрибуты product_id_[A]_[B], замените [A] на индекс секции, начиная с 1, и замените [B] на индекс продукта, начиная с 1 для каждой секции. Также необходимо добавить атрибут section_[A]="" для каждой секции, заменив [A] на индекс секции. Атрибуты header и body являются обязательными, footer является необязательным.

Поле слияния

Описание

{catalog id="123" product_id="123" body="" footer=""}

Отображает один продукт. Замените id на ID каталога и product_id на ID продукта. Атрибуты body и footer являются необязательными.

{catalog id="123" product_id_1_1="123" product_id_1_2="123" product_id_2_1="123" section_1="" section_2="" header="" body="" footer=""}

Отображает несколько продуктов. Замените id на ID каталога. Добавьте продукты, группируя их в секции через атрибуты product_id_[A]_[B], замените [A] на индекс секции, начиная с 1, и замените [B] на индекс продукта, начиная с 1 для каждой секции. Также необходимо добавить атрибут section_[A]="" для каждой секции, заменив [A] на индекс секции. Атрибуты header и body являются обязательными, footer является необязательным.

Когда пользователь отправляет заказ, информация о заказе отправляется по URL, указанному в Настройки > WhatsApp > Вебхук заказа. Страница по этому URL должна обработать заказ и отправить сообщение пользователю с помощью функции PHP API sb_whatsapp_send_message().
Чтобы подключить магазин к WooCommerce, нажмите здесь.

More information

Если вы не получаете сообщения WhatsApp, убедитесь, что вы не назначаете разговоры WhatsApp какому-либо отделу и что номер WhatsApp, используемый для тестирования, не является номером телефона администратора или агента Support Board. Также убедитесь, что вы правильно настроили URL вебхука WhatsApp.
Если вы не можете отправить сообщения, в админ-панели должно появиться сообщение об ошибке, когда вы пытаетесь отправить сообщение пользователю.
Мы не можем предоставить поддержку по настройке Twilio или 360dialog, включая все связанные с этим вопросы.
Мы не можем помочь в получении одобрения для вашей учетной записи WhatsApp или шаблона сообщения WhatsApp.
Разговоры и сообщения WhatsApp совместимы с маршрутизацией и очередью.
Если вы тестируете с песочницей и через 72 часа больше не можете отправлять сообщения на свой номер телефона, вам нужно снова связать свой номер телефона с песочницей.
Если вы отправляете чипы, кнопки или выбираете богатые сообщения с более чем 3 опциями, вы можете использовать атрибут короткого кода whatsapp="Ваш текст меню", чтобы установить текст меню сообщения WhatsApp.

МЕНЕДЖЕР

Messenger

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

Установка

В Настройки > Приложения нажмите Messenger и введите свой лицензионный ключ для установки и активации приложения. Если у вас облачная версия, приложение уже активно.
После установки приложения перейдите в Настройки > Messenger и нажмите Начать синхронизацию.
Завершите синхронизацию, выбрав как минимум 1 страницу Facebook, и введите полученную информацию в Настройки > Messenger > Страницы Facebook.
Готово. Все сообщения, отправленные на выбранные вами страницы Facebook и аккаунты Instagram, будут отображаться в области администрирования разговоров Support Board.

Instagram

Чтобы связать Instagram с вашей страницей Facebook и Support Board, выполните следующие шаги.

Перейдите в раздел Настройки вашей страницы Facebook и нажмите Левое меню > Instagram (https://www.facebook.com/YOUR-PAGE-SLUG/settings/).
Нажмите Подключить аккаунт и завершите настройку.
Снова синхронизируйте Messenger с Support Board, и на этом всё.

Дополнительная информация

Если вы не получаете сообщения из Instagram, убедитесь, что включили Настройки > Конфиденциальность > Сообщения > Подключенные инструменты - Разрешить доступ в мобильном приложении Instagram. Также убедитесь, что ваша учетная запись Instagram не настроена как профессиональная, она должна быть бизнес-аккаунтом.
У каждого пользователя Support Board есть только 1 разговор из Facebook и Instagram.
Расширенные сообщения Support Board автоматически конвертируются в расширенные сообщения Facebook, когда это возможно; некоторые части расширенного сообщения могут быть удалены или изменены.
Только частные сообщения Facebook будут отправлены в ваш общий ящик. Если кто-то оставляет сообщение на вашей стене в Facebook, оно не появится в вашем общем ящике.
Когда кто-то отправляет сообщение на вашу страницу компании в Facebook или Instagram, он будет обозначен как лид в Support Board. Вы сможете увидеть только имя пользователя в Facebook или Instagram и его аватар.
Разговоры и сообщения в Messenger совместимы с маршрутизацией и очередью.
Dialogflow поддерживается для Facebook и Instagram, включая следующие функции: Передача оператору, расширенные сообщения Support Board, обнаружение языка и переключатель языка чат-бота.
Сообщение для последующего обращения поддерживается, но настройка задержки игнорируется, сообщение отправляется мгновенно.
Сообщение об отсутствии в сети поддерживается, но расписание не отправляется.
Можно синхронизировать только 1 учетную запись Facebook; чтобы связать страницы из нескольких учетных записей Facebook, учетная запись, синхронизированная в Support Board, должна быть администратором всех страниц Facebook других учетных записей.

TWITTER

Twitter

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

Установка

Зарегистрируйтесь на https://developer.twitter.com. Убедитесь, что вы подтвердили свой номер телефона по адресу https://twitter.com/settings/phone, иначе регистрация не пройдет.
Создайте свое первое приложение, введя имя приложения, и нажмите Получить ключи. Скопируйте API Key (Consumer key) и API Key Secret (Consumer secret) и вставьте их в Support Board > Настройки > Twitter.
Запросите Elevated доступ по адресу https://developer.twitter.com/en/portal/products/elevated. Нажмите Подать заявку на Elevated и заполните форму следующим образом: В первой области Вашими словами и в Будет ли ваше приложение использовать функции Tweet, Retweet, Like, Follow или Direct Message? введите Мне нужен доступ к Account Activity API, чтобы начать получать Twitter Direct Messages в мое программное обеспечение для чата (Support Board) и отвечать на них напрямую из Support Board, подробности на https://board.support/twitter. Отключите все остальные поля, нажав Нет: Планируете ли вы анализировать данные Twitter?, Планируете ли вы отображать Твиты или агрегировать данные о контенте Twitter вне Twitter?, Будет ли ваш продукт, услуга или анализ предоставлять контент Twitter или производную информацию государственному органу?
Подождите несколько дней, пока Twitter рассмотрит и одобрит Elevated доступ; вы получите электронное письмо от Twitter.
После получения Elevated доступа зайдите на панель разработчика (https://developer.twitter.com/en/portal/dashboard) и в левом меню нажмите Продукты > Премиум > Разработчикские окружения и под Account Activity API / Sandbox нажмите Настроить dev окружение, в Метка dev окружения введите sb или то же значение, которое вы ввели в Настройки > Twitter > Синхронизация > Метка dev окружения.
Перейдите в Настройки вашего приложения из Левое меню > Проекты и приложения > Ваш проект > Ваше приложение и под Настройки аутентификации пользователей нажмите Настроить и активируйте OAuth 1.0a. В Разрешениях приложения выберите Чтение и запись и Прямое сообщение, в URI обратного вызова / URL перенаправления введите URL, который вы получили из Support Board > Настройки > Twitter > Получить URL обратного вызова, в URL сайта введите URL вашего сайта.
Перейдите в область Ключи и токены вашего приложения из Левое меню > Проекты и приложения > Ваш проект > Ваше приложение > Ключи и токены и под Токены аутентификации создайте Access Token и Secret, скопируйте и вставьте их в Support Board > Настройки > Twitter.
Введите имя пользователя вашего профиля Twitter в Support Board > Настройки > Twitter > Ваше имя пользователя. Получите его с вашей страницы профиля Twitter, скопируйте имя, начиная с @, или часть URL, содержащую ваше имя пользователя. Например: https://twitter.com/SupportBoard1.
Сохраните настройки Support Board и нажмите кнопку Support Board > Настройки > Twitter > Подписаться, и вы готовы. Все сообщения, отправленные на вашу учетную запись Twitter, будут получать Support Board.

Дополнительная информация

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

ГУГЛ БИЗНЕС СООБЩЕНИЯ

Гугл Бизнес Сообщения

Настройки ниже относятся к приложению Гугл Бизнес Сообщения.

Установка

В Support Board > Настройки > Бизнес Сообщения > Синхронизация > Клиентский токен введите случайную строку и сохраните.
Откройте Консоль разработчиков бизнес-коммуникаций (https://business-communications.cloud.google.com) и войдите в систему с вашей учетной записью Google для бизнес-сообщений.
Нажмите Настройки партнерской учетной записи в верхней части.
Настройте Webhook, введя URL вебхука и Клиентский токен, и сохраните изменения; получите значения из Support Board > Настройки > Бизнес Сообщения > Синхронизация.
Вернитесь в Консоль разработчиков бизнес-коммуникаций (https://business-communications.cloud.google.com) и откройте свою партнерскую учетную запись.
Нажмите Учетная запись службы в левом меню и создайте новый ключ, загрузите ключ и откройте его с помощью текстового редактора, такого как Блокнот; скопируйте private_key, client_email и вставьте значения в Support Board > Настройки > Бизнес Сообщения > Синхронизация.
Готово! Чтобы протестировать вашего агента, посетите https://business-communications.cloud.google.com/console, нажмите на ваш бренд, чтобы войти в раздел Обзор, в разделе Информация об агенте > URL тестирования агента нажмите кнопку, подходящую для вашего мобильного устройства, и откройте ссылку на своем мобильном устройстве.

Дополнительная информация

Значения для чипов, кнопок и расширенных сообщений должны содержать максимум 25 символов, и разрешено не более 13 значений.
Аватар должен быть изображением в формате JPG размером 1024x1024px и максимальным размером 50KB.

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

Установка

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

Дополнительная информация

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

VIBER

Viber

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

Установка

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

Дополнительная информация

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

SLACK

Slack

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

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

Чтобы синхронизировать Slack, нажмите кнопку Начать синхронизацию в разделе Настройки > Slack и следуйте инструкциям.

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

Синхронизация Slack может не пройти по ряду причин; ниже приведены самые распространенные:

Описание проблемы	Решение
Вы можете получать сообщения в Slack, но не можете отправлять сообщения из Slack в Support Board	Перейдите по адресу /supportboard/apps/slack/post.php в вашем браузере. Если вы видите ошибку 403 - Запрещено, вам нужно связаться с вашим хостинг-провайдером и попросить его установить правильные разрешения для этого файла и/или добавить правило в брандмауэр, чтобы предотвратить блокировку файла. Он должен быть доступен для выполнения без каких-либо ограничений. Также, в разделе Настройки рабочей области > Разрешения, необходимо разрешить всем создавать публичные каналы. Если проблемы не устраняются, пожалуйста, обратитесь в службу поддержки Slack по адресу https://api.slack.com/support.
Синхронизация Slack не работает	Убедитесь, что при попытке синхронизировать Slack вы выбрали публичный канал. Если нет, попробуйте снова выполнить синхронизацию, на этот раз выбрав публичный канал. Общий канал — хороший вариант.

Описание проблемы

Решение

Вы можете получать сообщения в Slack, но не можете отправлять сообщения из Slack в Support Board

Перейдите по адресу /supportboard/apps/slack/post.php в вашем браузере. Если вы видите ошибку 403 - Запрещено, вам нужно связаться с вашим хостинг-провайдером и попросить его установить правильные разрешения для этого файла и/или добавить правило в брандмауэр, чтобы предотвратить блокировку файла. Он должен быть доступен для выполнения без каких-либо ограничений. Также, в разделе Настройки рабочей области > Разрешения, необходимо разрешить всем создавать публичные каналы. Если проблемы не устраняются, пожалуйста, обратитесь в службу поддержки Slack по адресу https://api.slack.com/support.

Синхронизация Slack не работает

Убедитесь, что при попытке синхронизировать Slack вы выбрали публичный канал. Если нет, попробуйте снова выполнить синхронизацию, на этот раз выбрав публичный канал. Общий канал — хороший вариант.

Ручное архивирование каналов

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

Откройте канал Slack, который хотите заархивировать.
В правом верхнем углу нажмите на значок шестеренки и выберите Дополнительные параметры.
Нажмите на значок информации в правом верхнем углу экрана, затем нажмите на Дополнительные параметры и выберите Архивировать этот канал.

Связывание с отделами

Получите ID отделов из раздела Настройки > Разное > Отделы.
Получите ID каналов, нажав кнопку Получить ID каналов.

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

Настройка Настройки > Slack > Поля пользователя позволяет выбрать, какие данные пользователя будут включены в сообщение, отправляемое в главный канал, когда новый пользователь отправляет первое сообщение. Вы можете включить идентификатор вашего пользовательского поля или следующие идентификаторы: браузер, язык_браузера, местоположение, электронная_почта, тип_пользователя, токен, время_создания, код_страны, текущий_url, ОС, город, адрес, почтовый_индекс, телефон, дата_рождения, компания, временная_зона, вебсайт. По умолчанию: электронная почта, браузер, язык браузера, местоположение.

Информация

Когда новый пользователь отправляет первое сообщение, в выбранный во время синхронизации главный канал или в канал, связанный с отделом разговора, отправляется сообщение Slack с данными пользователя и кнопкой для присоединения к каналу пользователя. Только учетная запись Slack, использованная во время синхронизации, автоматически присоединится к каналу пользователя, другие участники Slack должны присоединиться вручную через кнопку.
Когда активирована настройка Настройки > Slack > Привязка агентов, если разговор назначен отделу, только агенты, прикрепленные к этому отделу, получат сообщение. Если разговор назначен одному агенту, то сообщение получит только этот агент.
Slack бесплатен в использовании. Только крупным компаниям может понадобиться платный тарифный план, подробности здесь.
Push-уведомления совместимы с Slack. Когда агенты отправляют сообщения через Slack, пользователи получают push-уведомления.
Если вы используете Dialogflow, сообщения в Slack не будут получены, если чат-бот знает ответ. Когда активируется перехват человеком, все сообщения разговора отправляются в Slack.
Приложение Slack совместимо с email-пайпингом и мессенджерами.
Удаление или выход из канала не поддерживается, поддерживается только архивирование каналов.
Когда разговор архивируется в Support Board, связанный канал Slack также архивируется.
При ответе пользователю через Slack, если пользователь уведомляется по электронной почте или текстовому сообщению, в Slack отправляется сообщение для уведомления вас.
Используйте команду Slack /archive, чтобы заархивировать разговор из Slack.

PERFEX CRM

Perfex

Ниже приведены настройки, относящиеся к приложению Perfex.

Установка

Установка требует два шага:

В разделе Настройки > Приложения нажмите Perfex и введите ваш код покупки Envato для установки и активации приложения. После установки перейдите в раздел Настройки > Perfex и введите информацию о базе данных и URL Perfex. Вы можете получить эту информацию из файла application/config/app-config.php в папке установки Perfex. Если вы не знаете префикс Perfex, оставьте поле пустым, по умолчанию используется префикс tbl.
Перейдите в административную панель Perfex, затем в раздел Настройки > Модули и установите модуль Support Board, загрузив файл module.zip. После установки модуля перейдите в Настройки > Support Board и введите URL плагина Support Board. Если вы используете версию для WordPress, URL должен быть таким: https://example.com/wp-content/plugins/supportboard/supportboard.

Чтобы отображать Support Board в административной панели Perfex, Support Board должен быть установлен на том же домене и в той же файловой системе, что и установка Perfex.

Если у вас возникли проблемы или вы изменили данные базы данных Perfex, убедитесь, что файл supportboard/config.php использует правильные данные базы данных Perfex. Обновление данных в Support Board не обновит данные в файле config.php.

Zendesk

Ниже приведены настройки, относящиеся к приложению Zendesk.

Установка

Получите домен из URL вашей административной панели Zendesk, скопируйте первую часть URL: https://домен.zendesk.com/. Например, домен https://supportboard.zendesk.com/agent/get-started/ticketing-system/ticketing-intro — это supportboard.
Получите API ключ из Левое меню > Админ > Каналы > API > Настройки. Нажмите Добавить API токен.
Email — это ваш адрес электронной почты, зарегистрированный в Zendesk.

Дополнительная информация

Заявки, преобразованные через Support Board, автоматически синхронизируются, когда в Support Board отправляются или принимаются новые сообщения. Они связываются с существующим пользователем Zendesk, если он есть, или создается новый пользователь Zendesk.
Support Board связывает пользователей Zendesk с пользователями Support Board через email или номер телефона.

WHMCS

Ниже приведены настройки, относящиеся к приложению WHMCS.

Установка

Процесс включает две установки: одно — это WHMCS-дополнение, другое — приложение Support Board.

Установка приложения

Перейдите в админ-панель Support Board, затем перейдите в Настройки > Приложения > WHMCS и введите Лицензионный ключ, чтобы установить приложение. После установки приложения перейдите в Настройки > Whmcs и введите информацию о базе данных и URL WHMCS.

Установка дополнения WHMCS

Переместите папку supportboard из файла addon.zip (скачайте его здесь) в каталог /modules/addons/ вашей установки WHMCS.
Перейдите в Конфигурация > Системные настройки > Модули дополнений, найдите модуль Support Board и нажмите Активировать. Подробнее на https://docs.whmcs.com/Addon_Modules_Management#Installing_An_Addon.
Нажмите кнопку Настроить и введите URL плагина Support Board.

Как обновить

Обновить приложение WHMCS в Support Board просто, вы можете включить автоматические обновления или обновить вручную. Подробности здесь. Для обновления дополнения WHMCS вам нужно скачать последнюю версию дополнения с https://board.support/docs/files/whmcs/addon.zip и вручную заменить каталог /modules/addons/supportboard/ вашей установки WHMCS на новый, только что скачанный.

Если у вас возникли проблемы или если вы изменили данные базы данных WHMCS, убедитесь, что файл supportboard/config.php использует правильные данные базы данных WHMCS. Обновление данных в Support Board не обновит данные в файле config.php.

ULTIMATE MEMBERSHIP PRO

Ultimate Membership Pro

Ниже приведены настройки, относящиеся к приложению Ultimate Membership Pro.

Синхронизация пользователей

Новые пользователи синхронизируются автоматически. Чтобы вручную синхронизировать существующих пользователей, перейдите в Настройки > WordPress > Синхронизировать пользователей и нажмите Импортировать пользователей.

Дополнительная информация

Чтобы ограничить доступ к определенному плану, используйте этот шорткод [ihc-hide-content ihc_mb_type="show" ihc_mb_who="4" ihc_mb_template="2"]<script id="sbinit" src="YOUR-URL/supportboard/supportboard/js/main.js"></script>[/ihc-hide-content]. Замените 4 на нужный вам уровень пользователя, а YOUR-URL на URL вашей папки WordPress /plugins/. Вам также нужно проверить Настройки > WordPress > Ручной запуск.

ARMEMBER

ARMember

Ниже приведены настройки, относящиеся к приложению ARMember.

Синхронизация пользователей

Дополнительная информация

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

Active eCommerce

Ниже приведены настройки, относящиеся к приложению Active eCommerce.

Установка

Процесс требует две установки: одна — это приложение Support Board, а другая — установка в Active eCommerce.

Установка приложения

Перейдите в административную область Support Board, затем в Настройки > Приложения > Active eCommerce и введите Лицензионный ключ, чтобы установить приложение. После установки приложения перейдите в Настройки > Active eCommerce и введите информацию о базе данных, URL Active eCommerce и другие настройки.
Секретный ключ можно найти в файле .env, находящемся в корневом каталоге Active eCommerce. Скопируйте значение APP_KEY.
Если у вас возникли проблемы, убедитесь, что файл supportboard/config.php использует правильные данные базы данных Active eCommerce.

Установка в Active eCommerce

Отредактируйте файл \resources\views\frontend\inc\footer.blade.php в каталоге Active eCommerce и вставьте код ниже сразу после открывающего тега футера <footer. Замените [YOUR-SITE] на URL вашей установки Support Board.

        <script src="https://[YOUR-SITE]/js/min/jquery.min.js"></script>
        <script id="sbinit" src="https://[YOUR-SITE]/js/main.js"></script>
        @php
        $sb_code = '';
        $sb_cart = false;
        if (Auth::check() && !isAdmin()) $sb_code = 'var SB_AECOMMERCE_ACTIVE_USER = ' . Auth::user()->id . ';';
        if (isset($detailedProduct)) $sb_code .= 'var SB_DEFAULT_AGENT = "aecommerce-' . $detailedProduct->user->id . '";';
        if (auth()->user() != null) $sb_cart = \App\Models\Cart::where('user_id', Auth::user()->id)->get(); else { $temp_user_id = Session()->get('temp_user_id'); if ($temp_user_id) { $sb_cart = \App\Models\Cart::where('temp_user_id', $temp_user_id)->get(); }}
        if ($sb_cart && count($sb_cart) > 0) { $sb_code .= 'var SB_AECOMMERCE_CART = ['; foreach ($sb_cart as $key => $item) { $sb_code .= '["' . $item['product_id'] . '", "' . $item['price'] . '", "' . $item['quantity'] . '"],'; } $sb_code = substr($sb_code, 0, -1) . '];'; }
        if ($sb_code != '') echo '<script>' . $sb_code . '</script>';
        @endphp

Как обновить

Обновление приложения Active eCommerce в Support Board просто, вы можете включить автоматические обновления или обновить его вручную. Подробности здесь. Если вы обновите Active eCommerce, вам нужно будет снова вставить код выше в файл footer.blade.php.

Чат продавцов

Чтобы заставить продавцов видеть только разговоры пользователей, пишущих со страниц их продуктов, включите опцию Настройки > Разное > Скрыть разговоры других агентов . После этого просто нажмите кнопку Настройки > Active eCommerce > Импортировать продавцов, и все готово! Продавцы будут зарегистрированы в Support Board и смогут войти в административную область.

Администраторы всегда могут видеть разговоры всех агентов (продавцов).

Martfury

Ниже приведены настройки, относящиеся к приложению Martfury.

Установка

Перейдите в административную область Support Board, затем в Настройки > Приложения > Martfury и введите Лицензионный ключ, чтобы установить приложение.
После установки приложения перейдите в Настройки > Martfury и введите данные базы данных, URL Martfury, Секретный ключ. Получите информацию из файла .env, находящегося в корневом каталоге Martfury.
Установите путь к Martfury в Настройки > Martfury > Путь Martfury. Получите эту информацию, загрузив этот файл в папку /public/ корневого каталога Martfury, после загрузки откройте его через браузер (например, https://shop.com/public/path.php).
Чтобы показать чат на сайте, введите код Support Board для PHP установки в Martfury Admin > Внешний вид > Пользовательский JS > JS в нижнем колонтитуле. Не включайте jQuery.
Если у вас возникли проблемы, убедитесь, что файл supportboard/config.php использует правильные данные базы данных Martfury.

Как обновить

Обновление приложения Martfury в Support Board просто, вы можете включить автоматические обновления или обновить его вручную. Подробности здесь.

Чат продавцов

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

Проверьте опции Настройки > Martfury > Личный чат, Настройки > Чат > Отключить панель управления, Настройки > Чат > Разрешить только один разговор.
В Настройки > Martfury > Импортировать продавцов импортируйте всех продавцов.
В Настройки > Martfury > Связывание личного чата свяжите каждого продавца с правильным магазином. Вы можете получить идентификаторы продавцов в Пользователи > Агенты и администраторы.

LINE

Ниже приведены настройки, относящиеся к приложению LINE.

Установка

Войдите на https://developers.line.biz/console/ или создайте новую учетную запись.
Создайте нового Поставщика, а затем новый Канал API обмена сообщениями, выберите Messaging API в качестве типа канала.
В разделе Основные настройки канала скопируйте Секрет канала и вставьте его в Support Board > Настройки > Line > Синхронизация > Секрет канала.
В области Messaging API канала сгенерируйте Токен доступа канала (долговечный), скопируйте его и вставьте в Support Board > Настройки > Line > Синхронизация > Токен доступа.
Введите свой URL вебхука в поле Webhook URL и нажмите Проверить. Получите URL вебхука из Support Board > Настройки > Line > Синхронизация > Webhook URL.
Включите Использовать вебхук.
Сканируйте QR-код с помощью вашего мобильного приложения LINE, чтобы начать писать в ваш канал.
Вы сделали это. Все сообщения, отправленные на вашу учетную запись бота LINE, будут отображаться в области администрирования разговоров Support Board.

Дополнительная информация

У вас есть 7 дней с момента отправки сообщения конечного пользователя из WhatsApp, чтобы ответить на сообщение.
Стикеры не поддерживаются.
Расширенные сообщения Support Board автоматически преобразуются в расширенные сообщения LINE, когда это возможно, в противном случае они удаляются из сообщения.
Разговоры и сообщения LINE совместимы с маршрутизацией и очередями.
Поддерживается Dialogflow, включая следующие функции: Передача человеку, Расширенные сообщения Support Board, определение языка и переключатель языка чат-бота.
Сообщение о последующем действии поддерживается, но настройка задержки игнорируется, сообщение отправляется мгновенно.
Офлайн-сообщение поддерживается, но расписание не отправляется.

WECHAT

WeChat

Ниже приведены настройки, относящиеся к приложению WeChat.

Установка

В Настройки > Приложения нажмите WeChat и введите свой лицензионный ключ, чтобы установить и активировать приложение. Если у вас облачная версия, приложение уже активно.
Перейдите по ссылке https://mp.weixin.qq.com/cgi-bin/readtemplate?t=register/step1_tmpl&lang=en_US и зарегистрируйте Сервисный аккаунт.
После регистрации перейдите в раздел Официальные аккаунты и в левом меню нажмите Настройки и разработка > Проверка WeChat. Вы должны завершить проверку, это занимает несколько недель и стоит 99 долларов США или 300 юаней для китайских юридических лиц.
В левом меню нажмите Настройки и разработка > Основная конфигурация и скопируйте ID разработчика (App ID), Пароль разработчика (App Secret). Вставьте информацию в Support Board > Настройки > WeChat.
В левом меню нажмите Настройки и разработка > Основная конфигурация и завершите настройку сервера (服务器配置(已启用). В Адрес сервера (URL) введите URL, который вы получите из Support Board > Настройки > WeChat > Синхронизация > Получить URL конфигурации. В Токен введите любое значение, это же значение должно быть введено в Support Board > Настройки > WeChat > Токен.
Вы сделали это. Все сообщения, отправленные на ваш аккаунт WeChat, будут отображаться в области администрирования разговоров Support Board.

Дополнительная информация

Если вы получаете ошибку, такую как {"errcode":41001,"errmsg":"access_token missing rid: 631111-470b3b22-48553870"}, вам нужно внести IP-адрес вашего сервера в белый список в Официальный аккаунт > Настройки и разработка > Основная конфигурация > IP-белый список.
Файлы WeChat и вложения с местоположением не поддерживаются и не поступают в Support Board.
Ссылки не поддерживаются в WeChat, они преобразуются в текст.
Расширенные сообщения Support Board автоматически преобразуются в расширенные сообщения WeChat, когда это возможно, в противном случае они удаляются из сообщения.
Разговоры и сообщения WeChat совместимы с маршрутизацией и очередями.
Поддерживается Dialogflow, включая следующие функции: Передача человеку, Расширенные сообщения Support Board, определение языка и переключатель языка чат-бота.
Сообщение о последующем действии поддерживается, но настройка задержки игнорируется, сообщение отправляется мгновенно.
Офлайн-сообщение поддерживается, но расписание не отправляется.

ДОПОЛНИТЕЛЬНЫЕ НАСТРОЙКИ

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

Этот раздел содержит справочную информацию по другим настройкам, не указанным выше.

Прогрессивное веб-приложение

Административная панель Support Board является PWA, что означает, что вы можете установить ее на настольные, Mac или мобильные устройства и использовать как полностью функциональное приложение. Примечание: эта функция оптимизирована для Google Chrome.

Установка на настольном компьютере

Войдите в свою административную панель (например, https://www.your-site.com/supportboard/admin.php) и нажмите на + значок в верхнем правом углу адресной строки вашего браузера Chrome.

Мобильная установка - только облачная версия

Если вы используете облачную версию Support Board, вы можете использовать приложения, доступные в Google Play и Apple Store.

Google Play

Мобильная установка

Войдите в свою административную панель с помощью Google Chrome (например, https://www.your-site.com/supportboard/admin.php)
Откройте настройки вашего браузера.
Прокрутите вниз и нажмите Добавить на главный экран.
Подтвердите, нажав Добавить.

Установка на WordPress

Чтобы установить PWA на WordPress, вам нужно получить доступ к административной панели напрямую, перейдя по следующему адресу:

https://www.your-site.com/wp-content/plugins/supportboard/supportboard/admin.php

Замените "your-site" на URL вашего веб-сайта и также учтите, что название папки "wp-content" может отличаться от названия вашей установки.

Изменение иконки и названия PWA

Скачайте файл manifest.json здесь. Отредактируйте его, заменив ВАШЕ ИМЯ на название вашего бренда, ОПИСАНИЕ ВАШЕГО ИМЕНИ на любой текст, который вы хотите, и example.png на относительный URL вашей иконки, размер иконки должен быть 512 x 512 пикселей. После завершения редактирования переместите файл в папку установки Support Board, ту же папку, где находится файл admin.php. Имейте в виду, что поскольку это настройка, наша поддержка не охватывает ее, если вам нужна помощь, вы можете нанять нас.

Горячие клавиши

Горячие клавиши в административной панели включены как на ПК, так и на MAC и работают следующим образом:

Сочетание клавиш	Описание
ENTER или SPACE	Подтвердить или закрыть диалоговое окно; то же самое, что и нажатие OK.
ESC или CANCEL	Отклонить диалоговое окно и закрыть его.
SHIFT + ENTER или CTRL + ENTER	Добавить разрыв строки в сообщение. Это работает только для редактора администратора.
ESC	Закрыть лайтбокс.
CANCEL	В области разговоров администратора архивировать разговор или удалить его.
CTRL + UP/DOWN ARROW	В области разговоров администратора перемещаться между разговорами в списке.
CTRL + RIGHT/LEFT ARROW	В области пользователей администратора перемещаться между пользователями.
CTRL + V	Вставить изображение из буфера обмена и отправить его как сообщение.

Файл конфигурации

Файл config.php — это специальный файл, который содержит данные для входа в базу данных MySQL и другие важные настройки. Большинство настроек генерируются автоматически, но некоторые являются необязательными. Вы можете добавить следующие настройки ниже:

Код	Описание
define('SB_UPLOAD_URL', 'YOUR-URL')	Изменить директорию загрузки (по умолчанию: /supportboard/uploads/). Введите URL: например, https://your-site.com/myuploads/. Для этой настройки также необходимо определить SB_UPLOAD_PATH.
define('SB_UPLOAD_PATH', 'YOUR-PATH')	Изменить путь директории загрузки (по умолчанию: /supportboard/uploads/). Введите ПУТЬ: например, C:\xampp\htdocs\uploads. Найти корневой путь вашего сайта может быть немного сложно. Вы можете попробовать скопировать путь, отображаемый в вашем FTP-клиенте, или просто обратиться к вашему веб-хостинг-провайдеру за дополнительной поддержкой.
$GLOBALS['SB_LOCAL_SETTINGS'] = []	Перезаписать настройки по умолчанию. Значение представляет собой массив ключей и значений, каждый ключ — это настройка, например, ["registration-required" => [true]]. Посмотрите пример здесь. Получите список настроек из resources/json/settings.json и файлов settings.json внутри папок приложения.

Cron Jobs

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

Логи

Файл журнала сохраняется в директории установки Support Board.
Логи фиксируют следующие действия агентов и администраторов: отправленное сообщение, удаленное сообщение, архивированный разговор, удаленный разговор, восстановленный разговор, разговор, назначенный агенту, разговор, назначенный отделу, обновленный пользователь, удаленный пользователь.

Супервизор

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

Параметры URL

Чат на фронтенде

Параметры URL позволяют чату выполнять определенные действия при загрузке страницы. Чтобы использовать их, добавьте параметры URL ниже к любому URL на вашем сайте, который отображает чат. Пример: https://example.com/?conversation=1234

Параметр URL	Описание
?token=TOKEN	Войти как существующий пользователь. Замените TOKEN на токен пользователя.
?conversation=ID	Открыть разговор. Замените ID на идентификатор разговора. Атрибут token требуется для пользователей, не вошедших в систему.
?chat=open	Открыть чат.

Административная зона

Параметры URL позволяют административной зоне выполнять определенные действия при загрузке страницы. Чтобы использовать их, добавьте параметры URL ниже к вашему административному URL. Пример: https://example.com/supportboard/admin.php?conversation=1234

Параметр URL	Описание
?conversation=ID	Открыть разговор в области разговоров. Замените ID на идентификатор разговора.
?user=ID	Открыть профиль пользователя. Замените ID на идентификатор пользователя.
?setting=ID	Открыть настройки в области настроек. Замените ID на идентификатор настройки.
?report=ID	Открыть отчет в области отчетов. Замените ID на идентификатор отчета.
?area=name	Открыть область администратора. Замените name на: conversations, users, settings, reports.

Zapier

Интегрируйте Zapier с Support Board, следуя приведенным ниже шагам. Интеграция основана на вебхуках Support Board, каждый вебхук является триггером Zapier, поэтому у вас есть более 15 триггеров Zapier. Для получения дополнительной информации посетите страницу вебхуков.

Перейдите на https://developer.zapier.com/ и войдите в систему или зарегистрируйте новую учетную запись.
Создайте новую интеграцию, нажав Начать интеграцию Zapier, или посетите https://developer.zapier.com/app/new. Заполните все обязательные поля, такие как имя и описание, и нажмите Создать. Вы можете ввести любой текст, но имейте в виду название приложения, так как оно потребуется вам позже.
В левом меню нажмите Триггеры, затем Добавить триггер.
Заполните все обязательные поля, такие как ключ и описание, и нажмите Сохранить и продолжить. Вы можете ввести любой текст.
В верхней части нажмите Конфигурация API, выберите REST Hook в качестве Типа триггера и нажмите Сохранить.
Вернитесь в раздел Настройки триггера или перейдите на https://zapier.com/app/zaps и нажмите Создать Zap.
Найдите ваше только что созданное приложение, введя его имя, и нажмите на него. В Событие триггера выберите ваш триггер и нажмите продолжить.
Скопируйте Webhook URL, нажмите Продолжить, затем перейдите в административную область Support Board и вставьте его в Настройки > Разное > Вебхуки > URL, активируйте вебхуки, сохраните настройки и обновите Support Board.
Выполните действие, чтобы сработал вебхук, например, отправьте сообщение или создайте нового пользователя, затем вернитесь в Zapier и нажмите Проверить триггер; вы должны увидеть данные вебхука Support Board. Нажмите Продолжить.
Нажмите на кнопку Фильтры и настройте фильтр так, чтобы интеграция срабатывала только в том случае, если переменная существует. Вам нужен фильтр, потому что Support Board будет отправлять все вебхуки во все zaps. Например: если ваш zap хочет интегрировать сообщения Support Board, вам нужно будет установить фильтр, чтобы продолжить только в том случае, если существует переменная message.
Нажмите Продолжить или + и добавьте вашу интеграцию.
Для использования нескольких zaps и вебхуков вам нужно будет обновить Настройки > Разное > Вебхуки > URL и добавить новые идентификаторы zap, разделенные запятыми. Например: если у вас есть два zap с URL https://hooks.zapier.com/hooks/catch/10352851/bbad21f/ и https://hooks.zapier.com/hooks/catch/10352851/aaaa66t/, URL должен быть https://hooks.zapier.com/hooks/catch/10352851/bbad21f,aaaa66t/.

Дополнительная информация

Если вы измените имя папки плагина после установки, вам необходимо обновить его в константе SB_URL файла config.php.
Приветственные сообщения не отправляются в Slack, и разговоры, содержащие только приветственное сообщение (и без ответа), автоматически архивируются.
Сообщения с последующим обращением отправляются максимум раз в 24 часа.
Сообщение всплывающее сообщение всегда показывается по умолчанию, пока пользователь не закроет его вручную; затем оно остается закрытым.
Разделы Пользователи и Разговоры в административной области Support Board используют авто-пагинацию при прокрутке, которая ограничена 100 результатами за прокрутку.
Сообщение о конфиденциальности не отображается, если включена опция Требовать регистрацию.