Документация и руководство
Полное руководство по установке, настройке и использованию aizap - мощной системы чата и поддержки клиентов
Чтобы установить PHP версию aizap на ваш сервер, выполните следующие шаги:
Чтобы отобразить чат на вашем веб-сайте, включите следующие скрипты в область <head></head> или <footer></footer> каждой страницы, где показывается чат.
Замените [AIZAP-URL] на URL вашей установки aizap, получите его из Настройки > Прочее > URL установки. Например: https://example.com/aizap/js/main.js.
Чтобы установить WordPress версию aizap, выполните следующие шаги:
Если вы хотите показать чат на другом веб-сайте, следуйте шагам PHP установки.
Чтобы отобразить чат на вашем веб-сайте, перейдите на https://cloud.aizap.ru/account/?tab=installation и скопируйте код для встраивания, затем вставьте его на страницы вашего веб-сайта.
Если вы используете WordPress, вы можете скачать плагин aizap Cloud. Активируйте приложения из Настройки > Приложения.
aizap - это мощный инструмент, но его обилие функций может создать сложности при быстрой настройке. Для упрощения процесса мы предоставляем список наиболее часто используемых функций, которые мы советуем настроить.
Активируйте email-уведомления из Настройки > Уведомления. Убедитесь, что активированы следующие опции: Уведомления агентов по email, Звуки админа > Входящие беседы и сообщения, и Push-уведомления.
Настройте SMTP-сервер в Настройки > Уведомления > SMTP. В случае если вы используете облачную версию, SMTP уже активирован.
Перейдите в Настройки > Сообщения и настройте последующие сообщения и оффлайн-сообщения.
Если вы используете WP или PHP версию aizap, активируйте Pusher. В случае облачной версии, Pusher уже активирован.
Если у вас возникли какие-либо проблемы, пожалуйста, обратитесь к нашей команде поддержки. Перед обращением к нам убедитесь, что ваш сервер имеет все необходимые требования.
Включите режим отладки, если у вас есть проблемы с aizap или вы его настраиваете. Чтобы включить режим отладки, добавьте атрибут debug к URL административной области.
При использовании чата на iPhone текстовая область автоматически увеличивается, когда пользователь начинает вводить новое сообщение. Чтобы остановить увеличение, введите код ниже в область <head> всех страниц, которые включают чат.
Чат может не отображаться по следующим причинам:
У бесед есть четыре различных статуса: отметить как прочитанное, архивировать, удалить и восстановить. Вы можете управлять статусом беседы, открыв ее в области бесед и затем нажав на соответствующие кнопки-иконки в правом верхнем углу окна беседы.
Вы можете искать беседы по ID департамента, ID назначенного агента, заголовку беседы, ID беседы, тексту сообщения, названию вложений, имени пользователя, фамилии пользователя, email пользователя.
Текстовый редактор админ-области и автоматические сообщения (например: приветствие и подписка) могут использоваться для создания стилизованных сообщений:
Все текстовые ссылки автоматически преобразуются в кликабельные гиперссылки. Чтобы установить название ссылки, добавьте к URL следующую строку: #sb-example.
Код: `ваш текст`
Редактор поддерживает синтаксис форматирования текста:
Merge-поля - это строки, заменяемые внешними значениями при использовании. Merge-поля могут использоваться в любом сообщении или автоматическом сообщении.
| Код | Описание |
|---|---|
| {user_name} | Полное имя активного пользователя |
| {user_email} | Email активного пользователя |
| {agent_name} | Полное имя активного агента |
| {agent_email} | Email активного агента |
Rich-сообщения - это специальные сообщения с интерактивными функциями, такими как кнопки, выпадающие списки или поля ввода. Они позволяют агенту запрашивать информацию от пользователя через форму ввода или отображать интерактивное содержимое.
Создайте rich-сообщение, вставив шорткод в текстовый редактор административной области.
Пользователь видит rich-сообщение и может выбрать или ввести необходимую информацию.
После заполнения формы показывается сообщение об успехе и данные сохраняются.
| Название | Шорткод | Описание |
|---|---|---|
| Карточка | [card image="URL" header="ЗАГОЛОВОК" description="Описание" link="URL" link-text="Купить" extra="$599"] |
Карточка призыва к действию с изображением, заголовком, описанием, ссылкой |
| Слайдер | [slider image-1="URL" header-1="ЗАГОЛОВОК"] |
Слайдер карточек. Можно добавить до 10 слайдов |
| Чипсы | [chips options="A,B,C"] |
Список кнопок |
| Кнопки | [buttons options="A,B,C"] |
Список кнопок |
| Выбор | [select options="A,B,C"] |
Выпадающий список опций |
| Поля ввода | [inputs values="A,B,C" button="Отправить"] |
Список текстовых полей |
[email name="true" phone="true"] |
Форма для сбора email и телефона пользователя |
Встроенные сообщения - это предварительно запрограммированные сообщения, отправляемые автоматически системой aizap. Найти их можно в Настройки > Сообщения.
Отправляет сообщение новым пользователям при первом посещении веб-сайта. Поддерживает форматирование текста, merge-поля и rich-сообщения.
Если ни один агент не отвечает в течение указанного времени, отправляется сообщение с запросом данных пользователя.
Отображает форму обратной связи для оценки беседы при ее архивировании. Не совместимо с мессенджерами.
Уведомляет пользователя, когда сообщение отправлено вне рабочих часов или когда все агенты оффлайн.
Представляет сообщение о конфиденциальности с кнопками Принять и Отклонить. Обеспечивает соблюдение GDPR.
Показывает всплывающее уведомление всем пользователям. Отображается до тех пор, пока пользователь его не закроет.
Здесь вы можете получить информацию о загрузке файлов и вложений сообщений.
Следующие форматы изображений отображаются автоматически: .jpg, .jpeg, .png
Разрешенные расширения файлов вложений устанавливаются в файле aizap/include/upload.php.
Добавьте новые разрешенные расширения файлов, добавив код в файл config.php:
По умолчанию папка загрузок находится в aizap/uploads для PHP версии, а для WordPress версии - wp-content/uploads/sb. Вы можете настроить это в конфигурационном файле.
Управляйте пользователями из области Пользователи в левом меню административной области.
Можете импортировать пользователей из Настройки > Пользователи > Импорт пользователей. Поддерживаются только CSV файлы.
Вы можете искать пользователей по имени, фамилии, email и пользовательским полям.
Можете удалить пользователя, открыв окно редактирования пользователя и нажав Удалить пользователя.
Для отображения дополнительных колонок в таблице пользователей перейдите в Настройки > Админ.
Управляйте, создавайте и удаляйте агентов и администраторов из области Пользователи.
Настройте привилегии и разрешения агентов из Настройки > Админ > Привилегии агентов.
Чтобы создать агента или администратора, перейдите в область пользователи и нажмите кнопку Добавить пользователя в правом верхнем углу.
Можно создать супервизора из Настройки > Админ > Супервизор. Супервизор - это специальный агент с особыми привилегиями.
Примечание: Только агенты и администраторы могут войти в административную область aizap. При активации плагина aizap в WordPress автоматически создается аккаунт администратора с теми же именем пользователя и паролем, что и у текущего вошедшего пользователя.
Вы можете собирать данные пользователей, такие как их имя и email, различными способами:
Используя регистрационную форму
С помощью follow-up сообщений
С помощью потоков чат-бота
Регистрационная форма - это форма перед чатом, которая требует от пользователя ввести определенную информацию перед началом чата.
Вы можете использовать регистрационную форму как форму перед чатом, ограничив запрашиваемую у пользователя информацию только email-адресом пользователя или именем пользователя, например.
Форма входа показывается только если поле email включено. Поле пароля всегда показывается, когда система пользователей установлена на "WordPress".
Вы можете автоматически входить пользователя через параметры URL.
Вы можете установить расписание офисных часов из Настройки > Прочее > Офисные часы. Офисные часы используются для:
Оффлайн сообщения
Отправка сообщений вне рабочих часов
Скрытие чата
Отключение чата вне рабочего времени
Управление ботом
Включение/отключение чат-бота
Статьи базы знаний предоставляют мгновенные ответы клиентам, помогая сократить объем клиентской поддержки. Доступ к статьям можно получить из левого меню aizap.
Статьи могут отображаться в панели чата, включив их из Настройки > Статьи > Отображать в панели.
Статьи также могут передаваться в любой чат через rich-сообщение шорткодом [articles].
Вставьте код ниже в вашу страницу. Замените [AIZAP-URL] на URL вашей установки aizap и [YOUR-TOKEN] на любой токен администратора.
Вставьте код ниже в вашу страницу. Замените [AIZAP-URL] на URL установки и [AIZAP-PATH] на путь установки aizap.
Этот метод не рекомендуется для SEO, так как статьи загружаются асинхронно.
Если вы используете WordPress версию, можете использовать шорткод:
Этот метод поддерживается только в WordPress версии.
aizap полностью многоязычен и предоставляет мощные функции для автоматического определения языка пользователя.
Для редактирования языков чата и админ-панели перейдите в Настройки > Переводы. Некоторые настройки, такие как содержимое email, переводятся напрямую и не требуют перевода здесь.
aizap уже переведен на 41 язык. Доступно множество вариантов установки языка:
ВАРИАНТ 1: Перейдите в Настройки > Чат и установите опцию Язык в многоязычный для автоматического использования языка браузера пользователя.
ВАРИАНТ 2: Добавьте параметр URL lang=LANGUAGE-CODE к скрипту, загружающему чат. Например: https://aizap.ru/js/main.js?lang=es
ТОЛЬКО WORDPRESS: WordPress версия aizap использует язык по умолчанию установки WordPress или язык текущей страницы, если сайт многоязычный.
Чтобы перевести административную область, выполните следующие шаги:
Вы можете переводить почти любой пользовательский контент, такой как rich-сообщения, встроенные сообщения, департаменты и многое другое:
aizap может отправлять email уведомления агентам, администраторам и пользователям при возникновении определенных событий.
Для надежной доставки email настройте SMTP-сервер в Настройки > Уведомления > SMTP.
В email уведомлениях доступны специальные merge-поля:
Push уведомления отправляются мгновенно на устройства пользователей и агентов, даже когда браузер закрыт.
Рекомендуется для большинства случаев. Надежная доставка и хорошая производительность.
Альтернативный вариант с расширенными возможностями сегментации.
Для работы push уведомлений необходимо установить Service Worker файл в корень вашего сайта:
Desktop:
Mobile:
SMS уведомления можно настроить через интеграцию с Twilio для отправки сообщений на мобильные телефоны пользователей и агентов.
Для настройки SMS уведомлений через Twilio выполните следующие шаги:
SMS поддерживает международные номера телефонов в формате E.164:
aizap интегрируется с OpenAI GPT для создания мощного AI-помощника, который может отвечать на вопросы клиентов, предоставлять поддержку и автоматизировать многие задачи.
Получите API ключ в аккаунте OpenAI и введите его в настройках:
Модель:
gpt-3.5-turbo (быстро и экономично)
Температура:
0.7 (оптимальный баланс)
Функция человеческого вмешательства позволяет агентам брать управление беседой на себя, когда AI не может предоставить удовлетворительный ответ.
Агенты могут в любой момент взять управление беседой, нажав кнопку "Взять беседу" в интерфейсе администратора.
AI отвечает автоматически на все сообщения
Плавный переход от AI к человеку
Агент полностью контролирует беседу
Обучите ваш AI-помощник на собственных данных для получения более точных и релевантных ответов.
AI может автоматически обучаться на основе прошлых бесед и оценок качества ответов от пользователей.
Настройте автоматические задачи для регулярного обновления знаний AI:
aizap включает полнофункциональную систему тикетов, которая позволяет пользователям создавать и отслеживать заявки поддержки.
Для отображения панели тикетов на вашем сайте используйте следующий код:
Интеграция с WhatsApp Business API для обмена сообщениями с клиентами.
Подключение к Facebook Messenger для общения через социальную сеть.
Создание Telegram бота для автоматического общения с пользователями.
Интеграция с Viber для обмена сообщениями через популярный мессенджер.
Подключение к LINE Messaging API для азиатских рынков.
Интеграция с WeChat для китайского рынка и пользователей.
Для большинства мессенджеров требуется настройка webhook URL:
Синхронизация тикетов и пользователей с платформой Zendesk.
• Двусторонняя синхронизация
• Импорт существующих тикетов
• Автоматическое создание пользователей
Интеграция с интернет-магазинами Shopify для поддержки клиентов.
• Информация о заказах
• История покупок клиента
• Автоматические уведомления
Подключение к системе биллинга WHMCS для хостинг-компаний.
• Информация о услугах
• Статус платежей
• Автоматическая авторизация
Синхронизация с CRM системой Perfex для управления клиентами.
• Синхронизация контактов
• История взаимодействий
• Автоматическое логирование
Интеграция с OpenCart для поддержки интернет-магазинов.
• Информация о товарах
• Статус заказов
• Профили покупателей
Подключение к тысячам приложений через платформу Zapier.
• Автоматические workflow
• Триггеры и действия
• Интеграция с любыми сервисами
Большинство интеграций требует получения API ключей:
Доступны различные опции синхронизации:
Облачная версия aizap предоставляет все возможности системы без необходимости установки на собственном сервере.