> For the complete documentation index, see [llms.txt](https://chatme-ai-4.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatme-ai-4.gitbook.io/docs/kak-vyvesti-agenta-v-konechnye-kanaly/vyvod-agenta-v-omnikanalnye-platformy/jivo.md). # Jivo [Jivo](https://www.jivo.ru/) — одна из популярных омниканальных платформ, предоставляющая инструмент для общения операторов с клиентами в социальных сетях, мессенджерах, мобильных приложениях и собственном веб-виджете. ## Подключение ### 1. Конфигурация бота на стороне Платформы Агенту необходимо создать и настроить Канал Проекта с Коннектором “Jivo”. 1. Кликните по кнопке настроек Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m_bL4GvN1_/de0e6c51b47058d8e7854370e44e3e29e8d1195855e34484c55e0ba55e6f4cbc2f103ac4ebcc2b78bf606d6b02118303275d07760b64f89e5ea954cd86466379ab9850814435bbe8d5ab7d3e80e7ac68c8a471b3ba0022e97fb3209a771f11a86b6c817e) 2. Нажмите кнопку Add channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KJ7zJqauLN/e76804ae1c32c84507914bcbac89b59e5fa7160e857084643655c65f3192dbec4709a2cd8abae87edc6a858acbd80d17c3296d23c47a2c39eccf56433201a9779ccf4ea2580c347508e5f68b0ee94654585fa349ceadd2e6587a4bdebd6c5d9715835322) 3. Откроется панель выбора Конечный канал.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Nf2SoBB7k6/c45da3c18aa5da57a0732fe62e68641a1cd08f00c827394d8ab1ddba8287f13fa1584f2d7d950442ec2d463e2ef25ccef8ab6f336940d3f195ab59d9f7dec5921182175e39f2ff3cb8dea03c7de252107738304f22aec8e6ae15f05d537847019a2164a3) 4. Выберите Jivo. 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-uKNAqVK_QP/5fe19124b70fae90218e01235478ff4c16b1ce5c50c094b42f59aa18c6b9d78c34b98b12cf20b1ba2c66f97020d072d1809b7e7e4c5e20d7841d13e69abc658400c019715cd525d2f1fbcaa04b67a4d50c190418f0b9030ab355c6b5ad1b68d93e793d4e) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-LbJuW6VeRp/462d598d0794b15b545b348293dcdab389f3628899c7aedce6684c6ae9d894acede9896173fcd1917c0506059b236f632fedde9358990db3f9a8bfa89be7a5c7811c2d0e38e7465574462d74b2ed62df7c969a5b84ae280883c1b4544d49b00087e3a3d7) 7. В поле Jivo token будет указан автоматически сгенерированный токен, который потребуется указать в настройках Jivo.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VRgyaamMMG/92b0d946f18d3c62847c5dbab8695b62184d13c2497b0f202f00e099dc77e4249d5d61b853103156a767b85b59d989a9ad77682f03ee525ec63d809a0be52cfd50fee5a348acf84fea770e8868bdd0fa0f3f5285a8f0665d7e990d346c2226d95d979435) 8. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-_o9HpC8uZP/01e77cce8b84dc0e99e01bc7b447c4e8f284a08d1246b248ac1143884e3775fd35d958653bdd46f314280d8d69d6ba208f970b86c73004a7a01be38fecab4f5693a3b0219e9491c70caad1ac6d73b03015651e0e37ea7216c9c9249ff5ca8c8cd4c7f504) 9. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-QxVHxBCoz1/cd4933c2285480ad1492d60985cc2a4856bbb14275e3252201b4906bc36c01afbf8d55a1d0c8755f2a097a45736bceb54f6f3282dcb5220dd0261286c2f878b72e16d10c5534be93f2923404643c6f05f1b26d11b74b792989f0ca1f6bdb16a7c5677aed) 10. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-kSv1FXRMnm/ce5920ec2842242613bf1922cd7e83ea5bfe54447e3d1d559efc4848ae97d89f9d1928b388428839c9f9a5e5bfbfcea8a67927a3bf363cb7dd0c5adeb91f8adfcd3cebd03a320eded1fb0eb10bf1649d341a362444544808a2b7cbb4841be817cb4800ea) 11. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 12. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-7dgOh6ECXu/a28176550bc5b906129f13ee959da0548554ef4f339ca36f4bb39a7878c467297570dfce4104d0bc204d440eb58c6df6de858260e3fa40e04b8135bc79876c5375b22afdd1f20566dc39d822a75c24c38bc73c2688b5c207f0ed4a1166e291eee72036ab) ### 2. Конфигурация бота на стороне Jivo > Примечание: В данной статье рассматривается только интеграция Jivo с ботами, о том как организовать маршрутизацию диалогов между ботами и операторами см. в [документации](https://www.jivo.ru/help/) Jivo 1. Зайдите в аккаунт [Jivo](https://www.jivo.ru/). 2. Перейдите по ссылке 3. Для собеседников боты в Jivo выглядят как операторы (виртуальные-сотрудники). 4. Заполните следующие поля: 5. 1. Аватар — изображение, которое будет отображаться в качестве аватара сотрудника в фирменном веб-виджете Jivo; 2. Имя — то, что будет отображено в фирменном веб-виджете Jivo в качестве имени сотрудника; 3. Должность — то, что будет отображено в фирменном веб-виджете Jivo в качестве должности сотрудника. 4. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-kxs44svtxy/b315d76984d9203c755d664b7710011598ffde99819a5ffd2146d1d886df2bbcd4e25ae41b74ba3294312d4c5ea662bcde0b4ed2141802110c5fecd31fc30ad1f261c1f9c0bad33bd5fb92dbc09cf3500a9a10346eafe7ec780d75b71d88a1c5ed3a53c4) 6. Скопированный с Платформы в п.1.7 токен вставьте в поле Токен бота. 7. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-3z1Rvkgya2/d3525169f58b02531f25e8c112b62925ba6392ca6d232409173adfd9b2c35a28dfa1e1099a7df7e7735be2cdc9a1ce90c89a2dd479e2313a395e4a15d5b31d5d9c756361ef92c595fb8520cee9e70474ed57c9e04163e563df3b96b90310e94dee4217f6) 8. Выберите каналы для подключения в разделе Подключить для следующих каналов, проставив галочку напротив необходимых каналов, и нажмите кнопку Сохранить. 9. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-rh1HpkHZuR/4130631fc987ad48586cce700dbc62fcdae35258e921929b4f4b19bc1a0c9404187e331c6d176ad8855edec96f785600850e57caf47000a912121084f454b5bd4f4423e3c6b6cf5f22103a91f61e0cc46965297f8355c758e801b569ca00697e5681d210) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-_nxprcCmi3/a41c6d4450ce0c017b2ef7282eb047736a7a48f5b12299d5d6fab990b36f58ebe46da946d37862b4edfcc86bae69a5ffc3cb1c72e6430942315a12e29c58fa3ea166bac3fa417a5ff52fd83516a076f1599923f957599a6d5e4c4e32aaedf733637f8d90) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-U4J_FTn5KG/a783fd7e6c09078ee67a641a5687d8cd3286c453a5ecc81128681f1a8aabe75117714039a2a3715e1173b4f99099e1c8759c0b2d61ed37f8fdcc7cada323cc9105d26ea385027e4648973ac31d3270a05f45f6146cfd89702f1eef96ac9f000e9af840ea) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--gDmrPG3XB/615dacd204bd5a549a5586158ad5f51baceee43bce956356f572f5bdaba1558cb90e5ee93a1a78fdf2d2d091d66da1a4b47957a7426b54ea4cb2a9f3ff2f23f5c555b7145de80601f7dec1707f74bf754945f8834bf0115806f22fa940b045794d1d7b53) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-BvEToRq1OH/e66bc1e50f2ecce43c4248fcb2f75ad9c14b699f3d2908f3856fe96f958c2c82650e2faaf296547746cf6708cd19e6db9909377ee26ef155d5972f13ef00910ce6f890c3c157d8850c4eead67689a59b302970cc4327c06681753a52f39f8bc8aaf3f6fc) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-jnT6fsX4cw/51eba6a3f7b543ec57b520c76373ea62a97f9da25dbc319a8784c52d166d55c8c910718ed2af32a02084990c61d98d148cc7f921f6d017007b2d64f48fcf5e07eeb9ec80fb64cade2b2c89c6ae9ce5927736259e96296d7b141f63c44f50546f02949d41) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. токен в поле Jivo token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-8rhPdn12YK/acf5ec2f4ea3982c700487e986fe4f54b06879dc7923a999bcbe2cd66868369b107e64c109445856d06557f00c8b4f8960d3c5bd57f3b31ad5deb7585b7b3ff502631475160aecd5f45aa7115d682384402a9bb9722926fcc26e02778344391a6594dfa1) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Ig98JDVS-Q/e7a170d4f36aeeb33a831d05491dba3d6167c48dd23c6597514c30a5b389f983d41002c30ebf2ea0d0b84ee2218bf347da35f5e7f1f9a57a07d1150aa248c09e1f1ddd3856bd64b9da5690ab9e379281e888dcf1bd367998467effe95c1c94107e3550ca) ## Общение | Переменная | Конечный канал | Переменная в запросе из канала | Примечания | | --------------------------- | -------------- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | channel\_visitor\_id | Jivo | client\_id | | | channel\_conversation\_id | Jivo | sender.id | | | channel\_visitor\_firstname | Jivo | sender.name (необязательное) | | | channel\_visitor\_lastname | Jivo | нет | | | channel\_visitor\_account | Jivo | нет | | | channel\_visitor\_phone | Jivo | sender.phone (необязательное) | Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу | | channel\_visitor\_email | Jivo | sender.email (необязательное) | Важно: Эта переменная не приходит, если у Jivo и стенда не заключено соглашение на ее передачу | | channel\_visitor\_auth | Jivo | sender.user\_token (необязательное) | | | channel\_visitor\_source | Jivo | sender.url (необязательное) |

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

| | Сообщение | Конечный канал | Client message | Описание | | -------------------------------- | -------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Оператор Jivo принял чат от бота | Jivo | Строка: jivo: operator joined chat | После выполнения Перевод общения на оператора в слоте Change Chat Mode операторы Jivo должны нажать кнопку “Принять диалог, чтобы включиться в разговор. По нажатию этой кнопки мы получаем событие в client\_message, если для данного Канал Проекта активированы Сервисные сообщения канала | | Функционал общения | Конечный канал | Доступность в канале | Примечания | | ------------------------------------------------------------------------------ | -------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | channel\_chat\_id | Jivo | Да | формат \\|jivosite | | Сообщения дойдут до собеседника, если агент напишет первый в существующем чате | Jivo | Частично | диалог в Jivo длится 2 часа, сообщения дойдут до Собеседника только в течение этого времени | | Кнопки | Jivo | Да | в Telegram приходят клавиатурные кнопки | | Перевод на оператора | Jivo | Да | с помощью слота Change Chat Mode | | Передача файлов в виде файлов от Агента (Attachment) | Jivo | Нет | | | Передача файлов в виде ссылок от Агента (Attachment) | Jivo | Да | в Telegram ссылки на изображения автоматически выводят изображение в сообщении | | Получение файла от Собеседника в сценарий | Jivo | Да | Метаданные файла (тип, ссылка) записываются в переменную client\_message, файл в платформу не закачивается. | | Получение геолокации от собеседника в сценарии | Jivo | Да | client\_message при отправке геолокации: 📍 Location | | Доставка сообщений более 1000 символов от Агента до Собеседника | Jivo | Частично | В ОК, ФБ, ВК сообщения более 1000 байтов разбиваются на несколько по абзацам. В Мессенджерах передаются целиком | | Получить ссылку на источник лида | Jivo | Частично | В переменную channel\_visitor\_source записана ссылка на страницу, где размещен виджет, либо на страницу Авито. Для других мессенджеров не рабоатет | | Использование маркдауна | Jivo | Частично | Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах зависит от самих каналов.Поддерживаются следующие типы разметки:\*курсив\*\_курсив\_\_\_жирный шрифт\_\_\*\_\_жирный курсив\_\_\*\[ссылка]\( особенности: в Telegram и ВКонтакте Markdown не поддерживается, текст приходит без разметки. | | Рассылки с помощью Notification | Jivo | Нет | | ## Перевод на оператора При использовании Слота Change Chat Mode происходит переключение на оператора. После переключения на оператора диалог завершается и отображается на странице Аналитики(Вкладка Аналитики). ### Переключение на оператора при отсутствии ответа от Агента Все события от Jivo к бот-провайдеру и обратно отправляются в виде HTTPS-запросов, методом POST в формате application/json. Timeout запроса составляет 3 секунды, кол-во повторных попыток равно 2 (итого 3 попытки по 3 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.