# 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 сек), до тех пор, пока не будет получен штатный успешный ответ, иначе клиент переводится на оператора.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://chatme-ai-4.gitbook.io/docs/kak-vyvesti-agenta-v-konechnye-kanaly/vyvod-agenta-v-omnikanalnye-platformy/jivo.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.