# 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)

## Общение

<table><thead><tr><th>Функционал общения</th><th>Конечный канал</th><th>Доступность в канале</th><th>Примечания</th></tr></thead><tbody><tr><td>channel_chat_id</td><td>Bitrix24</td><td>Да</td><td>Имеет формат:chatme-ai.bitrix24.ru:128:chat106|bitrix24-open-channels</td></tr><tr><td>Сообщения дойдут до собеседника, если агент напишет первый в существующем чате</td><td>Bitrix24</td><td>Да</td><td></td></tr><tr><td>Кнопки</td><td>Bitrix24</td><td>Нет</td><td><p>Если добавить Button Menu, у Собеседника выведется сообщение :</p><pre><code>Type a button value:1: Button 12: Button 2
</code></pre></td></tr><tr><td>Перевод на оператора</td><td>Bitrix24</td><td>Да</td><td>Перевод осуществляется только при помощи External Request</td></tr><tr><td>Передача файлов в виде файлов от Агента (Attachment)</td><td>Bitrix24</td><td>Да</td><td></td></tr><tr><td>Передача файлов в виде ссылок от Агента (Attachment)</td><td>Bitrix24</td><td>Да</td><td></td></tr><tr><td>Получение файла от Собеседника в сценарий</td><td>Bitrix24</td><td>Да</td><td></td></tr><tr><td>Получение геолокации от собеседника в сценарии</td><td>Bitrix24</td><td>Нет</td><td></td></tr><tr><td>Доставка сообщений более 1000 символов от Агента до Собеседника</td><td>Bitrix24</td><td>Да</td><td></td></tr><tr><td>Получить ссылку на источник лида</td><td>Bitrix24</td><td>Нет</td><td></td></tr><tr><td>Использование маркдауна</td><td>Bitrix24</td><td>Нет</td><td></td></tr><tr><td>Рассылки с помощью Notification</td><td>Bitrix24</td><td>Нет</td><td></td></tr></tbody></table>

| Переменная                  | Конечный канал | Переменная в запросе из канала |
| --------------------------- | -------------- | ------------------------------ |
| 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       | Нет                            |


---

# Agent Instructions: 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/bitrix24.md?ask=<question>
```

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.