ym88659208ym87991671
Проект SaluteBot | Документация для разработчиков

Проект SaluteBot

Обновлено 13 января 2023

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

Для подключения бота в каналы Jivo, создайте сценарий в инструментах Graph или Code.

Как создать проект

Вы можете создать проект:

  • в Studio — можно редактировать;
  • в Личном кабинете Jivo — нельзя редактировать в Studio.

Проект в Studio

  1. Авторизуйтесь в Studio.
  2. Перейдите в личное или корпоративное пространство.
  3. Выберите тип проекта:
    • SaluteBot конструктор – сценарий будет сделан в Graph;
    • SaluteBot IDE – сценарий будет сделан в Code;
    • SaluteBot под ключ – будет создана заявка на разработку бота.
  4. Выберите язык, на котором пользователи будут взаимодействовать с ботом. У каждого языка свой набор локализованных интентов. Вы можете выбрать русский, английский и португальский языки.
danger

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

  1. Нажмите Создать проект.

SaluteBot конструктор

После того, как вы выбрали SaluteBot конструктор, откроется окно с шаблонами.

Для завершения настройки проекта:

  1. Выберите готовый шаблон или сделанный вами ранее сценарий: проект Graph или создайте новый проект с нуля.
  2. Нажмите Далее.
  3. Подтвердите согласие с условиями использования сервиса, если не сделали этого ранее.
  4. При необходимости укажите новое название бота и группу проекта.
  5. Нажмите Создать проект.

SaluteBot IDE

После того, как вы выбрали SaluteBot IDE, откроется окно с шаблонами.

При создании такого проекта доступен только шаблон Кнопки в виджете Jivo.

Для завершения настройки проекта:

  1. Выберите готовый шаблон или сделанный вами ранее сценарий: проект Code. Сейчас доступен только шаблон «Кнопки в виджете Jivo».
  2. Нажмите Далее.
  3. При необходимости подключите внешний репозиторий или пропустите этот шаг.
  4. При необходимости укажите новое название бота и группу проекта.
  5. Нажмите Создать проект.

SaluteBot под ключ

Если вы выбрали SaluteBot под ключ, вам откроется форма заказа на создание бота SaluteBot. Заполните все необходимые поля и отправьте заявку.

Подключение аккаунта Jivo

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

Для подключения проекта к аккаунту Jivo:

  1. Откройте проект SaluteBot.

  2. В разделе Аккаунт Jivo нажмите кнопку Добавить аккаунт Jivo.

    Откроется окно Вход в Jivo.

  3. Укажите почту и пароль своего аккаунта Jivo и нажмите кнопку Войти.

Проект в Личном кабинете Jivo

  1. Авторизуйтесь в Личном кабинете Jivo.
  2. Откройте УправлениеРасширенияИнтеграции.
  3. Создайте JivoBot со сценарием Готовые ответы.

Проект появится в вашем пространстве в Studio.

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

Как создать сценарий

Для SaluteBot можно создать свой сценарий на инструментах Graph или Code. Для этого:

  1. Авторизуйтесь в Studio и перейдите в проект SaluteBot конструктор или SaluteBot IDE.
  2. Выберите язык, на котором пользователи будут взаимодействовать с ботом. У каждого языка свой набор локализованных интентов. Вы можете выбрать русский, английский и португальский языки.
  3. Выберите тип сценария бота: Готовый сценарий, Graph или Code.
  4. В поле Сценарий выберите готовый проект либо создайте новый.
  5. При желании загрузите иконку проекта SaluteBot.
  6. Нажмите Сохранить.

При создании проекта в Code доступен только шаблон Кнопки в виджете Jivo.

danger

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

При создании сценария некоторые функции будут недоступны для Graph и Code. Например, в боте для Jivo нельзя использовать аудио, push-уведомления и персональные данные.

Как подключить бота в канал

Каналы — это способ общения с клиентов с ботами. Это могут быть соцсети, например ВКонтакте, мессенджеры (Telegram, WhatsApp), почта, сайт и другие ресурсы.

Полный список каналов для подключения SaluteBot вы найдете в личном кабинете Jivo в разделе Управление > Каналы связи.

Как настроить каналы в Jivo

Для подключения бота в один из каналов, доступных в Jivo:

  1. Откройте проект SaluteBot.

  2. В разделе Каналы для публикации нажмите кнопку Изменить и перейдите в личный кабинет Jivo.

  3. Выберите УправлениеРасширениеПодключенные.

  4. Нажмите кнопку Опции в строке с ботом.

  5. Выберите в списке каналы, которые необходимо подключить к боту.

    tip

    Подробную информацию о подключении каналов ищите в Базе знаний Jivo.

  6. Нажмите кнопку Сохранить.

После этого бот будет работать в подключенных каналах Jivo.

note

Один канал можно подключить только к одному SaluteBot.

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней