Битрикс24 как замена Telegram

Часто бывает, что руководитель, когда находится в командировке или в отпуске, хочет получать важные уведомления из 1С и согласовывать их, не заходя в эту самую 1С. Раннее зачастую такие реализации делались через боты в мессенджерах.

В данной статье пойдёт речь о реализованном кейсе согласования в Битрикс24 такого документа системы 1С, как «Заявка на расходование ДС». В статье мы расскажем, как возможна реализация двустороннего обмена между 1С:УПП и Битрикс24, а также согласование документов 1С силами самого Битрикс24.

Стоит отметить, что в данном кейсе ранее у Заказчика уже была внедрена подобная схема интеграции через Telegram-бота, но после начала блокировки работы Telegram в России канал связи стал нестабильным, а перебои - регулярными. Поэтому появилась задача найти альтернативный, более надёжный способ реализации, который позволил бы сохранить быстрый доступ к согласованию с мобильного устройства.

Было принято решение отказаться от внешнего мессенджера и перенести весь процесс согласования в Битрикс24. Эта система уже используется у Заказчика как корпоративный портал, поэтому для освоения не пришлось бы изучать новые инструменты, всё работает в привычном интерфейсе.

Типового обмена между 1С:УПП и Битрикс24 не существует, поэтому потребовалась разработка обмена. Технической основой интеграции стали вебхуки — механизм, позволяющий системам обмениваться данными без сложного программирования. Вебхуки представляют собой веб-адреса с набором определённых параметров и делятся на входящие и исходящие. Входящие вебхуки активируются при запросе из внешней системы, исходящие используются для отправки данных из Битрикс24 на внешний адрес при наступлении события. Именно эта технология лежит в основе описываемого решения.

Как это выглядит для пользователя

Руководитель, находясь в командировке, заходит в мобильное приложение Битрикс24 и в пару кликов запускает специальный бизнес-процесс для запроса актуальных заявок. После этого запроса пользователю приходит список заявок в виде личного сообщения от технической учётной записи «Диспетчер» с разбивкой по статусам. Заявки на сегодня – дата оплаты сегодня, срочные – дата оплата не сегодня, но указан статус «Срочно», прочие – все остальные. Список заявок на согласование также доступен пользователю в специальном разделе основного меню.

Вид сообщения от «Диспетчера»

Каждая заявка представлена отдельной кликабельной ссылкой, ведущей на карточку согласования. В этой карточке сотрудник сможет согласовать или отклонить заявку нажатием одной кнопки.

Информация о заявке в задании согласования

Как это работает изнутри

Запрос заявок вызывает исходящий вебхук в 1С. После вызова вебхука на стороне 1С активируется обработчик с программным кодом, который по каждой заявке вызывает входящий вебхук в Битрикс24 с передачей всей необходимой информации в формате JSON для создания заявки. При создании заявок активируются встроенные в Битрикс24 автоматизации, которые собирают их в единый список и запускают по каждой из них процесс согласования.

Затем по окончании процесса согласования также срабатывает исходящий вебхук в 1С, в котором уже Битрикс24 передаёт информацию о том, с каким результатом завершился процесс, и обработчик на стороне 1С совершает необходимые действия. Аналогично, если в Битрикс24 уже была создана заявка и запущен процесс согласования, но в итоге согласование произошло в 1С, то активируется входящий вебхук в Битрикс24 для прерывания запущенного процесса.

Как выглядит входящий вебхук?

Как уже было сказано, вебхуки — это веб-адресы с набором определённых параметров для вызова метода API. Входящий вебхук в Битрикс24 состоит из нескольких частей:

1. Протокол и адрес портала Битрикс24, к которому идёт обращение.

2. Стандартный префикс для всех API-запросов Битрикс24.

3. ID пользователя, от имени которого создан вебхук. Все действия через этот вебхук будут выполняться с его правами доступа.

4. Уникальный генерируемый системой секретный код для доступа к аккаунту. Токен является секретным, и раскрывать его посторонним нельзя.

5. Название конкретного метода API, который необходимо вызвать. В данном случае — метод для принудительного завершения бизнес-процесса.

6. Параметры, которые мы передаём. Например, для заполнения полей или поиска конкретных элементов. В данном случае требуется указать ID бизнес-процесса.

Пример вебхука

Вебхуки — простой и эффективный способ связать Битрикс24 с разными системами без сложных технических решений. Переход с Telegram-бота на встроенный механизм Битрикс24 не только решил проблему с блокировками, но и упростил поддержку системы и позволил достичь самого главного требования Заказчика – сохранить быстрый доступ к согласованию 1С через мобильное устройство.

Если в вашей компании стоит задача по реализации интеграции Битрикс24 и 1С, мы с радостью вам поможем.