(NEW) Чат с клиентами в МАКС в окне записи и журнале записи

МАКС для клиентов — это интеграция для общения с клиентами из мессенджера МАКС прямо в YCLIENTS. Больше не нужно переключаться между приложениями — переписка с клиентом доступна прямо в окне записи и в журнале записи.

Возможности

Полностью официальная интеграция с вашим ботом в МАКС. Без сторонних интеграций и посредников.
Чат в МАКС доступен в окне записи и журнале записи.
Общий список чатов в журнале записи. Все диалоги с клиентами в одном месте, с сортировкой по времени и индикаторами непрочитанных сообщений.
Отправка сообщений от лица вашей компании.
Обмен сообщениями и мультимедиа: текст, эмодзи, ссылки, вложения (изображения и документы до 10 МБ).
Форматирование текста: жирный, курсив, подчеркнутый, зачеркнутый, списки, цитаты и ссылки.
Черновики сообщений: текст и вложения сохраняются в браузере, чтобы ничего не потерять при случайной перезагрузке.
Один бот на несколько филиалов сети. Если у вас сеть, можно использовать один токен бота во всех ваших филиалах.

Важно

На текущий момент интеграция с чатом в МАКС работает в тестовом режиме и доступна не всем пользователям.

Для подключения интеграции необходима оплаченная лицензия YCLIENTS. На пробной версии подключение недоступно.

Чат в МАКС доступен только в веб-версии YCLIENTS.
Чат в журнале записи доступен только на компьютере.
В мобильной веб-версии чат доступен только в окне записи.

Подключение интеграции

1. В YCLIENTS перейдите в раздел «Интеграции > Уведомления» и выберите приложение «Макс для клиентов».

2. На открывшейся странице нажмите кнопку«Подключить».

3. Подтвердите доступ приложения «Макс для клиентов» к филиалу и разрешите передачу данных. Ознакомьтесь с информацией по обработке персональных данных, поставьте отметки для согласия, затем нажмите «Подтвердить».

4. Далее в приложении откроется вкладка «Настройки», где необходимо указать токен вашего чат-бота из МАКС. Где взять токен, читайте далее в этой статье. Также на этой странице можно сразу перейти к инструкции по созданию бота в МАКС.

5. После вставки токена нажмите «Сохранить».

На этом подключение интеграции завершено — в окне записи справа появится вкладка «Чат МАКС», а в журнале записи на правой панели появится отдельная иконка чата.

Пример в журнале записи:

Пример в окне записи:

6. Для отключения интеграции в приложении «Макс для клиентов» нажмите «Отключить» и затем снова «Отключить» во всплывающем окне.

Отключение интеграции не влияет на бота в МАКС.

Важно

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

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

Как создать токен

1. Для создания чат-бота и получения токена сначала необходимо зарегистрироваться и пройти верификацию в сервисе «MAX для бизнеса» через мини-приложение «MAX для бизнеса» или бот «MAX для бизнеса».

Подробнее о регистрации и работе с чат-ботом читайте в документации MAX.

2. Создайте чат-бота в МАКС. Для этого:

Перейдите в ваш профиль на платформе MAX для бизнеса.
В разделе Чат-боты нажмите «Создать».
Заполните данные в карточке создания бота.
Ник создается автоматически по шаблону:
- idИНН_bot — для ИП и юрлиц, где ИНН — номер вашей организации или ИП;
- se(orgid)_bot — для самозанятых, где (orgid) — идентификатор профиля на платформе.
  Остальные поля нужно заполнить самостоятельно в соответствии с форматом — о нем написано в таблице в инструкции. После создания и проверки бота можно отредактировать все данные, кроме ника.

Нажмите «Создать».
После бот должен пройти модерацию. Проверка занимает до 48 часов по рабочим дням.

3. После успешной проверки чат-бота можно перейти к работе с токеном.
Токен — уникальный идентификатор бота, с помощью которого он будет взаимодействовать с API MAX. Он будет сформирован автоматически после проверки.

Чтобы скопировать токен:

Перейдите на платформу MAX для бизнеса в раздел «Чат-боты».
Если у вас несколько ботов, в панели управления ботом нажмите на имя текущего бота и выберите нужный из списка.
Перейдите в раздел «Расширенные настройки» → «Настроить».
Скопируйте токен в поле «Токен доступа».
После этот токен необходимо вставить в поле «Токен чат-бота» в приложении «Макс для клиентов» в YCLIENTS.

Важно

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

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

Работа с чатом в МАКС

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

1. Скопируйте ссылку на бота в чате в журнале записи или окне записи.

2. Отправьте ссылку клиенту любым удобным способом.

3. После перехода по ссылке клиенту необходимо дать разрешение на переписку — нажать на кнопку «Начать», чтобы запустить бота, а затем «Поделиться контактом».

Только после этого клиенту можно будет писать сообщения.

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

Важно

Если до подключения интеграции через чат-бот в МАКС ранее уже велась переписка с клиентами — эта история переписок не отобразится в YCLIENTS.

Максимальный размер одного сообщения — 4000 символов. При превышении лимита поле ввода не принимает новые символы.

Доступна отправка изображений и документов до 10 МБ — до 10 файлов за раз.

Редактировать сообщения в чате можно только в течение 24 часов после отправки.

На текущий момент удаление сообщений недоступно.

Права доступа

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

Блок «Настройки», право «Управлять правами сотрудников с доступом» (любое из вложенных прав) — для подключения и настройки интеграции.

Блок «Окно записи», права «Доступ к данным клиентов», «Доступ к выпадающему списку с данными о клиентах» — «Показывать номера телефонов» — для работы с интеграцией в окне записи и журнале записи. Также необходимы базовые права доступа для работы с журналом и окном записи.

Часто задаваемые вопросы

Что делать, если вкладка чата в МАКС не появляется?

Убедитесь, что интеграция имеет статус «Подключено». Также проверьте, есть ли у вас права «Доступ к данным клиентов» и «Показывать номера телефонов». Если прав нет, обратитесь к вашему руководителю.

Нужно ли заново подключать интеграцию после смены токена?

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

У нас сеть из нескольких филиалов. Можем ли мы использовать одного бота?

Да. Введите один и тот же токен в настройках интеграции для каждого филиала сети. Сообщения от клиента и ответы сотрудников будут видны во всех этих филиалах.

Возникает ошибка «Токен недействителен», что это значит?

Токен устарел, был отозван или бот заблокирован на платформе МАКС. Получите новый токен в личном кабинете МАКС и обновите его в настройках интеграции YCLIENTS.

Почему не удается отправить сообщение клиенту, хотя все настроено?

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

Достигнут лимит отправки сообщений в МАКС — что это значит?

Ваш бот отправил максимальное количество сообщений за единицу времени (30 сообщений в секунду). Подождите несколько секунд и попробуйте снова. Лимит сбрасывается автоматически.

Предыдущая статья (NEW) Уведомления в МАКС для клиентов

Следующая статья Медицинская функциональность

Была ли статья полезна?