# Bitrix24 Bitrix24 — одна из омниканальных платформ для общения с клиентами в текстовых каналах. Используя омниканальную платформу Bitrix24, можно разместить Бота в одном или нескольких каналах общения. ## Подключение ### 1. Конфигурация бота на стороне Bitrix24 В первую очередь нужно подключить каналы общения к Bitrix24. 1. Авторизуйтесь в Bitrix24 в вашем рабочем спейсе. 2. Предоставьте поддержке [Chatme.ai](http://chatme.ai) доменное имя вашего рабочего спейса, в котором необходимо вывести Бота. \ Для того, чтобы узнать доменное имя, откройте страницу в Bitrix24, где находится ваш спейс, выделите и скопируйте часть URL как указано ниже.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-4iiBDy9ItV/d6f0047eb2795ab4b946e28517e49b1c7627719cdf9d9c7935d5ce1dbdcff95ca28234803030a0caf50c399d5b60a3f747817a7c3f9e04d8ea57f3acaf165cc410052a42c2ac23ec91a0efb81a24ef9cf809a002641b2c1381e441a32cb0c50ad8850b0f) 3. Получите от поддержки [Chatme.ai](http://chatme.ai) сгенерированную ссылку для установки приложения. 4. Перейдите по ссылке и установите приложение.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-mo26K6ORQK/ae00cc0beb72e1cda9faee2d2fda31bfce4bf1b48e2ac63b355262c61a22b17da046a4dc1e69cdce7a4a740b3bc61fcf2b05c3f82f03009709656f7ba6a8ed775f3030457d6d3a9dbf52a3c83a917812b238aabdebf95d9be7ca335f09d614b5b4d70173) 5. Настройте канал агента на платформе для того, чтобы Бот начал отображаться в настройках линии. 6. После активации канала агента на платформе перейдите в раздел Контакт-центр.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-wi8hXbAtyC/3ac1f787552637f908f4463afdd26fdacf115ab532f16caf95f7b680d662365ddee8e26c4508a987557e6fc7083d11a9e451cb7c2948c6e7114cf2df0c67172320441ac606b162b0dd7577d166445a2f72e744ec93d285070e9e6f972bc3c7a15804f2d7) 7. Создайте открытую линию в нужном вам канале (например, Telegram).\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-DYbXRyH3C9/2d42e6e9520fb39b152f64b2e69477d38ea8f9167297564e8c316fff382086fbe587e177007fa9839dfacc85305e748af733ddb8d85a3e03e0cf8064ccec0ddd5e85df5ce2f7b786e423b06c1fdc41bf33fc4a0ebb0215c4c3788861ffc7188ef1152a6e)\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-vuHrWZVTlb/a71d3f6fb937c1cd6de4b9604c4301d8a58c84331f50e75c434480fab18096c231d812bda29fbb7b773c8acdf866f9c919f2afa055436d0676761d47aee2b190e855b819b05896775bda39470f3c2d51aac4b900d24bba96d5aa0297d8dcbe520a6fc3be) 8. Перейдите в настройки созданной линии.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-uk0MNFWg80/0d56ee0aaed9ded7eafdf7707123e60735eebf0b496875425b795cb6ad7f71d3b8e6281fe4aafbc99fda531a5b010a4d27065a572a91af0b72cdbdc89a361c19d4894db5eadccc67bdca5115006a30824dd4c1047369510491b9830ee0f6cba60286a07d) 9. Перейдите в раздел Чат-боты.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-W88PlECa0-/ad4806f56c23e8e26046734feedc125fee34eca781373cd479af99263b457d79ea87f5660db109e80958ba09579b42811a4efbab44696a880eef13f3cd26e81b4f6eebea78d518a8a152312554acf454c01d94a3d27acde08d1b159075227e384fbdac2c) 10. Назначьте Бота Чатми ответственным при обращении клиента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-VLPvpgopM_/633b9d1827cb249ba5a5bae4b1d544f0be122aeadaa2c9a2a4ec3d687bee48d630a1d86cd9fbf5abed38f91282d7ae41a75c705a6c31d9c6f63b1dbb430a300795367bcb8d066aad22583d7638e81f8c07dca0a5e194b1e53bf90e66d281f8952635f765)\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-af43qPOro_/44c93f1063d1504a19ee9f049074853a1eaf226f7b83c82d8ddeb03248b75c62779efc70bbb9ef3a50e38f31a541d84b05e7b40dea95c0df7f8677506badb40238ce885ca41645bd88232eea77ac5cd9c1ce131bfb16c069e3fa4415734cbbcffb1ab195) 11. Сохраните настройки.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-fGeRSFMUeH/c3081e2e15b4c0bd2276e89c4fc846a58855c5d5ab4d0db4b7367a857b5fa1ec2d2ae2d4f77388cea005307f34699947b24dfa4e22bf62c594e0460d6e89709ca8c677a44973fdf460f9015b3540f69021568d7b6d75b4ed33bd97dd5c52ca0a4dc428cf) ### 2. Конфигурация канала агента в Платформе Агенту необходимо создать и настроить Канал Проекта с Коннектором “Bitrix24 Open Channels”. 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-pjDV88rdoH/d3e2309fc1b5e242dcfb50c4a21f1b3852fb149048bb4e822667eb78885d13cb92f66739b9fd34baa39bdeb65f82b3e81a3ee8905cffe15fc8cacd8866bb053e740659682317c1f19f7b7c798019fa599fa1549d1a260876b71aa0dc78b71e4e0bb9b47c) 4. Выберите Bitrix24. 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-I7d301Lpv5/accecd533e4288b26e1ab2fb65e8cf0079e95668d78786c7e8b38442b3a364ecd874344f09da02703dff7436d1f026a8fcca5d709cd1a4d886fac6709a6518f9fee11e1f719aa4dbcc31394a110c52470fd9427725d4226245f4d56dcec66e0f1d29eea7) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-piktaAx31j/f2e953c9fab72a69804fa1ba24d069ea97ad6ca878ad4ed7b240c0d6327a7c338c0f909261df19124ece22678b59547fcd399bf80ed1f9e0081331a843752805e0dd0168eb6a7e46b7b272bb4a505ee53f8c6533d60f10cb4b26ee4fd057dfe487cb42c7) 7. Укажите доменное имя вашего спейса в поле Bitrix24 workspace domain.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Irzge1bZuW/541bf9d272fe0bab75d73fbb1f5d6d76bc0c20964df7accda95937d717f00ed2b75b004c6e3b666e379da36e303820c434979bf4cec4142a9438883d9a2650ea56f9c137a3322bdc7ee087295c93f0617c0893b44f475f9bbf79c63d89aba945642f8369) 8. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-0ga4wDkd9h/7b73977d0e06fd819babaca784cf130da466aba24ce1c78f349e7620b86d1c557ca48f4eff1eadded3c5bc7c285a7c0f9116a9472b8df584546b20a29a52a6191837c707471843e69fe33bb0ac715c7257132e0bfba98401ac8da71527fe598b775a6347) 9. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Jvv-ad4Rjf/143168bd88dc78eab3cf89b59e5d2b93247a5ee6634ed26ff23da2f764686f89829a31a63b53dfa6a6d24a25deb33fb08f53cbdedd86e49d2c71e0c5ae975199b873f2efde249de56d360cfdfc92e4d2e5c9adae42861b00dbc1451278434d5be9ff3ec1) 10. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. будет доступен адрес Канал Проекта; 3. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 11. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-bgAQtq5e4e/3102c75c9ac8934636dfae507e086aae4871d4f161aa5b197ed72b637854a5976906eb8ba600e611de422bf7d5e49675e605a8db25ab30bcbf7da6bc36b8b0f4f4b2a8d1db42d838e73b9b59dd0ca44bd8cd1bb06fcd0224a4b49a32bcaf8157008393dd) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-9X42MTQQcJ/653d0da02caaccde24469fa388d31fa861eeb494b5d7cea5d1eb5ba3978612b0db897717b89e013641894e0c857c2555499052ab18f2e39e9d83d3af797dd52e35a9562daf3b1e154e2a5372a82d21770363e4003d6d83418ad17eef5244ec8d46ca6b76) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-niyANSt-9l/881146abb235ccffab4d92960733be0e301225cce4629e08e09ac8680303d038407f81c3bba0bdbeac556926195f65337fd5f00619f896316963472b7e835ec58b94a81e96ce8816010ec3dbd288f4cb22dad42c7e91e2f0827e6cc66ea1bc24e2e1b083) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. будет доступен адрес Канал Проекта; 3. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-i6wSh-fWQn/08158f8a7488a8eb4caafd2a35c44f424a9a4761be27f174b26aa169a0afb191ee69289cc8a33e2a972ae907d5dc420d744ca677a25f9b163ccb6ef48fc3528bfcc81b18f9c4036044962965b032746575b9d53477c2f62e9efbedf507e0f10ea629da58) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Y7iqfKc8GU/55d5d7f69efa7aacdbc12f52ec66b4367f492023468b58f1cf78039330e89d645405a5b0110a3c06ef40c04606dd178d392c72715e1ce02228a9aacc079a94eeaf3ffd48d9555e2e68cc39e5ec0fad7752cc499c4dd47a57b4497f10648f896b16cce7fd) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-7owcfB46Gi/45d7fcc3a78bdc4e8025ee13ffe243bb1d1852babde72c6a9edd4af4507e802dc1207449c170e333ae9c8d6e9ad9dc91a11eab0ce2da9ee1309bc378ec144e9ad9b5dff34608102e28cfcde9b387fab7a182ce1ce95b07621601655eed97960536515778) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. будет доступен адрес Канал Проекта; 3. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-2RY8wXR4Dp/271d8f87ecdcb0917c113d4759cf8f6e4f822fbd83bddc55b3e8654e5a89e09939b0312bc2f4f786ba494bc75ccc5be1c35dc67447ae72e137cfb79fa00d2db61fbfced7ebfe291e4249d9ee24b74c9dace8d0c7133a238a229d18d7acdda74e0157dfca) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-12AUNVphbW/803ae7e7bf9358d6eb66625be7812dd1b616afabaddcdd5914d484518bde9edac857ce0b2bb1570cd4ef66586c7969a2c3b5d2298ea97d90fc2b8a2e1243ecb689696b9e8e13500bb560d614040dbf32d1cf40e27aadb30f031ea2980284d3aba5b1dc56) ## Общение
Функционал общенияКонечный каналДоступность в каналеПримечания
channel_chat_idBitrix24ДаИмеет формат:chatme-ai.bitrix24.ru:128:chat106|bitrix24-open-channels
Сообщения дойдут до собеседника, если агент напишет первый в существующем чатеBitrix24Да
КнопкиBitrix24Нет

Если добавить Button Menu, у Собеседника выведется сообщение :

Type a button value:1: Button 12: Button 2
Перевод на оператораBitrix24ДаПеревод осуществляется только при помощи External Request
Передача файлов в виде файлов от Агента (Attachment)Bitrix24Да
Передача файлов в виде ссылок от Агента (Attachment)Bitrix24Да
Получение файла от Собеседника в сценарийBitrix24Да
Получение геолокации от собеседника в сценарииBitrix24Нет
Доставка сообщений более 1000 символов от Агента до СобеседникаBitrix24Да
Получить ссылку на источник лидаBitrix24Нет
Использование маркдаунаBitrix24Нет
Рассылки с помощью NotificationBitrix24Нет
| Переменная | Конечный канал | Переменная в запросе из канала | | --------------------------- | -------------- | ------------------------------ | | channel\_visitor\_id | Bitrix24 | Нет | | channel\_conversation\_id | Bitrix24 | Нет | | channel\_visitor\_firstname | Bitrix24 | visitor\_first\_name | | channel\_visitor\_lastname | Bitrix24 | visitor\_last\_name | | channel\_visitor\_account | Bitrix24 | Нет | | channel\_visitor\_phone | Bitrix24 | Нет | | channel\_visitor\_email | Bitrix24 | Нет | | channel\_visitor\_source | Bitrix24 | Нет | | channel\_visitor\_auth | Bitrix24 | Нет | | channel\_visitor\_location | Bitrix24 | Нет | | channel\_message\_id | Bitrix24 | Нет | | channel\_message\_recipient | Bitrix24 | Нет |