Подключение

1. Конфигурация бота на стороне Платформы

⁠

⁠

⁠

Нажмите кнопку Add channel ​

⁠

⁠

Выберите в поле Channel

@Коннектор

⁠

“Jivo”. ​

⁠

⁠

По необходимости пропишите заголовок для данного

@Канал Агента

⁠

в поле Title. ​

⁠

⁠

После выбора “Jivo” в поле Channel webhook: Token будет указан автоматически сгенерированный токен, который потребуется указать в настройках

Jivo

⁠

⁠

⁠

⁠

Примечание: Chatbot webhook: Token и Channel webhook: Token синхронизированы и будут идентичны, но поле Chatbot webhook: Token защищено от редактирования. Вы можете заменить токен на произвольный, установив новый токен в поле Channel webhook: Token или сгенерировать новый кнопкой Generate New

Активируйте канал переключением тумблера для того, чтобы

@Агент

⁠

начал отвечать в нем. ​

⁠

⁠

⁠

⁠

⁠

⁠

⁠

⁠

Важно: Все настройки будут применены только после сохранения.

2. Конфигурация бота на стороне Jivo

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

документации

⁠

Jivo

⁠

⁠

⁠

⁠

⁠

⁠

⁠

⁠

⁠

Общение

Маппинг Канальных переменных из канала Jivo

Маппинг Канальных переменных из канала Jivo

Not synced yet

Канальная переменная

Конечный канал

Переменная в теле входящего запроса из канала

Особенности

Канальная переменная

Конечный канал

Переменная в теле входящего запроса из канала

Особенности

1

channel_visitor_id

Jivo

client_id

​

2

channel_conversation_id

Jivo

sender.id

​

3

channel_visitor_firstname

Jivo

sender.name (необязательное)

​

4

channel_visitor_lastname

Jivo

нет

​

5

channel_visitor_account

Jivo

нет

​

6

channel_visitor_phone

Jivo

sender.phone (необязательное)

Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу

7

channel_visitor_email

Jivo

sender.email (необязательное)

Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу

8

channel_visitor_auth

Jivo

sender.user_token (необязательное)

​

9

channel_visitor_source

Jivo

sender.url (необязательное)

Содержит ссылку на страницу, где размещен виджет, либо на страницу Авито В ссылке содержится информация о канале, через который происходит общение

10

channel_reply_to

Jivo

нет

​

There are no rows in this table

⁠

Сервисные сообщения из Jivo

Сервисные сообщения из Jivo

Not synced yet

Сообщение

Конечный канал

Client message

Описание

Сообщение

Конечный канал

Client message

Описание

1

Оператор Jivo принял чат от бота

Jivo

Строка: jivo: operator joined chat

Проблема: логика обработки сервисного сообщения нарушена со стороны chatme. Сервисное сообщение chat_closed трактуется как сообщение о заходе оператора в чат.

There are no rows in this table

⁠

Возможности общения в Канале Jivo

Возможности общения в Канале Jivo

Not synced yet

Функционал

Конечный канал

Наличие в канале

Описание

Функционал

Конечный канал

Наличие в канале

Описание

1

channel_chat_id

Jivo

Да

формат <jivo сlient_id>|jivosite

2

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

Jivo

Частично

диалог в Jivo длится 2 часа, сообщения дойдут до

@Собеседник

⁠

а только в течение этого времени

3

Кнопки

Jivo

Да

в

Telegram

⁠

приходят клавиатурные кнопки

4

Перевод на оператора

Jivo

Да

с помощью слота

Change Chat Mode

⁠

5

Передача файлов в виде файлов от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )

Jivo

Нет

​

6

Передача файлов в виде ссылок от Агента (https://coda.io/d/_dQZi0KPCnEG/_suBXn )

Jivo

Да

в

Telegram

⁠

ссылки на изображения автоматически выводят изображение в сообщении

7

Получение файла от Собеседника в сценарий

Jivo

Да

Метаданные файла (тип, ссылка) записываются в переменную

@client_message

⁠

, файл в платформу не закачивается.

8

Получение геолокации от собеседника в сценарии

Jivo

Да

⁠

@client_message

⁠

при отправке геолокации: 📍 Location https://www.google.com/maps/@54.855614,83.049903,14z

9

Доставка сообщений более 1000 символов от Агента до Собеседника

Jivo

Частично

В ОК, ФБ, ВК сообщения более 1000 байтов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком

10

Получить ссылку на источник лида

Jivo

Частично

В переменную

@channel_visitor_source

⁠

записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не рабоатет

11

Использование маркдауна

Jivo

Частично

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

@Markdown

⁠

, в остальных каналах зависит от самих каналов.

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

*курсив*

_курсив_

__жирный шрифт__

*__жирный курсив__*

[ссылка](http://www.example.com/)

Известные особенности: в Telegram и ВКонтакте

@Markdown

⁠

не поддерживается, текст приходит без разметки.

12

Рассылки с помощью Notification

Jivo

Нет

​

There are no rows in this table

⁠

Перевод на оператора

Переключение на оператора при отсутствии ответа от Агента