Библиотека для работы с Bitrix24: живая лента, задачи, файлы и личные сообщения

22.07.24

Интеграция - WEB-интеграция

Новое обновление Открытого пакета интеграций - несколько больших блоков методов для работы с Bitrix24 через API

Если вы не слышали ранее об Открытом Пакете Интеграций (что вполне вероятно), то небольшая вводная часть ниже, под катом. Для тех, кто уже знаком с ОПИ, данный раздел можно пропустить.

 
 Что такое Открытый Пакет Интеграций

 

Открытый Пакет Интеграций (ОПИ) - это open-source набор методов для простой и быстрой интеграции с различными популярными API. Он состоит из аналогичных по функционалу 1С-расширения (CFE), OS-пакета и программы для Windows и Linux, которые предоставляют готовые функции для работы с целым набором различных онлайн-сервисов.


  • ОПИ бесплатен и имеет открытый исходный код на GitHub. Вы всегда можете получить последнюю версию библиотеки на странице репозитория, а подписавшись - узнавать о выходе обновлений. Все релизы сопровождаются статьями на Инфостарт и разделами единой документации. На Инфостарт вы можете подписаться уже хоть сейчас, а про документацию я расскажу далее.

 

 

 

  • Удобная единая документация. Она расположена на сайте opi.neocities.org и содержит в себе всю информацию, необходимую для работы: инструкции по предварительным действиям для начала интеграции, описания всех методов с параметрами и возвращаемыми значениями, примеры кода и т.д. Каждый API имеет там свой раздел.

 

 

 

 

  • Простая установка. ОПИ распространяется во множестве вариантах: как XML файлы расширения, как EDT проект расширения, как файл расширения формата .cfe (версия 1С 8.3.9), как файл пакета для OneScript и еще в целом наборе пакетов и файлов для Windows и Linux. Из этого набора вы всегда сможете выбрать тот способ установки, который лучше подойдет для вашей конкретной задачи

 

На момент последнего обновления данной статьи, доступны следующие API:

Наиболее актуальную информацию можно посмотреть в репозитории или на вводной странице документации.

 

 

Bitrix24. Думаю, в представлении не нуждается: это крайне популярная отечественная CRM система, и особенно популярная там, где есть 1С

 

 

В текущем обновлении ОПИ появились методы для работы с данным сервисом - достаточно много, но не настолько, чтобы покрыть весь его доступный функционал. Однако, к текущему моменту, с большего, уже готово несколько достаточно крупных блоков, которые можно использовать в работе, а именно

  • Работа с задачами
  • Работа с новостями
  • Работа с чатами, диалогами и сообщениями
  • Работа с файлами

 

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

 

 
 Работа с задачами
 
 Работа с новостями
 
 Работа с чатами и диалогами
 
 Работа с файлами

 

Для наглядности, ниже приведено несколько простых примеров работы с данными методами

 

 
 Создание задачи
 
 Создание новости
 
 Отправка в чат сообщения с вложениями
 
 Загрузка файла в каталог

 


 

Способы авторизации

 

При использовании любого из доступных методов, необходимо авторизовать себя в Bitrix24, для чего во всех функциях библиотеки есть параметры URL и Токен. Но их заполнение может отличаться - это зависит от выбранного способа авторизации, которых поддерживается два: Webhook и Локальное приложение:
 

  • При использовании Webhook, достаточно передавать в параметр URL адрес вашего веб-хука
  • При использовании Локального приложения, в URL передается основной адрес вашего Bitrix24 без дополнительных параметров, а в Токен - токен приложения

 

Подробнее о настройке и начале использования обоих этих методов вы можете узнать в документации

 

 


 

Изменения в документации. Снова

 

Для новых пользователей, которые не знакомы с ОПИ, отмечу, что у проекта есть большая подробная документация. Она находится по адресу openintegrations.dev и там вы можете найти все необходимое, начиная от инструкций по началу работы с понравившимся API, заканчивая примерами кода и списком параметров под каждый метод библиотеки отдельно

 

Для тех же, кто уже знаком с ОПИ, отмечу, что в документации опять произошли некоторые изменения. Во-первых, сервисы на боковой панели теперь делятся по разделам, так как они перестают влезать в высоту экрана. Во-вторых, теперь на страницах методов есть ссылки на оригинальную документацию API. Вернее они должны там быть: сейчас это актуально для Bitrix24, но в процессе они дозаполнятся и для остальных сервисов
 

 


 

Скачивание и обратная связь

 

Думаю, необходимо посвятить немного времени путеводителю по репозиторию проекта, так как Github все еще остается новой платформой в нашем сообществе, и работа с ним может вызывать вопросы у многих пользователей

 

Проект ОПИ распространяется на GitHub - найти его там можно по адресу github.com/Bayselonarrend/OpenIntegrations. Это страница его репозитория. Перейдя туда вы увидите структуру файлов и, ниже, основную информацию о проекте. Если вы хотите просто скачать расширение для 1С, то вам необходимо перейти на страницу Releases, ссылка на которую есть на правой панели (картинки будут ниже). Там, пролистав чуть ниже, будет блок Скачать/Download, а одним из пунктов в нем - CFE. На него просто необходимо нажать

 

 
 Где? Куда?

 

Кстати, кроме CFE, у проекта есть другие варианты релизов: возможно, вас также сможет заинтересовать пакет для OneScript или приложение для командной строки, которое позволяет выполнять любые методы пакета без привязки к 1С. Подробнее об этом можно узнать здесь

 

Кроме скачивания, функционал Github еще позволяет сообщать о проблемах или пожеланиях, связанных с проектом, прямо внутри репозитория. Для этого есть вкладка Issues, перейдя на которую можно открыть новое обращение по интересующему вас вопросу. Это самый предпочтительный способ коммуникации в рамках проекта, так как он позволяет сохранять историю проблем и решений в одном месте, а также обращаться к ней при необходимости

 

Так что, если вам нужна помощь в работе с ОПИ - обязательно пишите, но, желательно, именно в Issue. Сделать это можно, если у вас есть аккаунт Github, но, если нет, то пройти регистрацию не займет много времени. Все равно пора уже - там есть много всего интересного :)

 

Также не забывайте ставить звездочку этому и другим проектам, если они вам понравилась! Проектам это помогает в развитии, а вам - в отслеживании новостей о выходе новых версий

 

Спасибо за внимание!

 

 

Репозиторий ОПИ: github.com/Bayselonarrend/OpenIntegrations

Последний релиз: github.com/Bayselonarrend/OpenIntegrations/releases/latest

 

Другие статьи про Открытый пакет интеграций на Инфостарт:

 

 

 Мой GitHub:    https://gitub.com/Bayselonarrend 
 OpenYellow:    https://openyellow.notion.site
 Лицензия MIT:  https://mit-license.org

интеграция bitrix24 обмен API http web CRM

См. также

Сайты и интернет-магазины WEB-интеграция Системный администратор Программист Пользователь Платформа 1С v8.3 Конфигурации 1cv8 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020    17958    18    22    

17

Сайты и интернет-магазины Интеграция WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Управленческий учет Платные (руб)

Интеграция 1С и Битрикс 24. Разработка имеет двухстороннюю синхронизацию 1С и Bitrix24 задачами. Решение позволяет создавать пользователя в 1С из Битрикс24 и наоборот. Данная разработка технически подходит под все основные конфигурации линейки продуктов 1С:Предприятие 8.3 (платформа начиная с 8.3.23). При приобретении предоставляется 1 месяц бесплатных обновлений разработки. Доступна демо-версия продукта с подключением Вашего Битрикс24

7200 руб.

04.05.2021    20085    13    19    

17

WEB-интеграция 8.3.8 Конфигурации 1cv8 Автомобили, автосервисы Беларусь Украина Россия Казахстан Управленческий учет Платные (руб)

Расширение предназначено для конфигурации "1С:Предприятие 8. Управление Автотранспортом. ПРОФ". Функционал модуля: 1. Заполнение регистров сведений по подсистеме "Мониторинг", а именно: события по мониторингу, координаты по мониторингу, пробег и расход по мониторингу, текущее местоположение ТС по мониторингу 2. Заполнение путевого листа: пробег по мониторингу, время выезда/заезда, табличная часть ГСМ, места стоянок по геозонам. 3. Отчеты по данным загруженным в регистры сведений. 4. Предусмотрена автоматическая загрузка данных в фоновом режиме (условия работы данной загрузке читайте в описании товара) Модуль работает без включенной константы по настройкам мониторинга. Модуль формы предоставляется с открытым кодом, общий модуль защищен. Любой заинтересованный пользователь, имеет возможность скачать демо-версию расширения.

22656 руб.

25.05.2021    14535    42    8    

18

WEB-интеграция Программист Руководитель проекта Платформа 1С v8.3 Конфигурации 1cv8 1С:Франчайзи, автоматизация бизнеса Платные (руб)

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки.

24000 руб.

27.09.2024    1643    1    0    

3
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. seperblunt2 22.07.24 09:33 Сейчас в теме
2. starik-2005 3091 22.07.24 10:12 Сейчас в теме
За любоффь к искусству )
3. aleksey2 89 22.07.24 11:59 Сейчас в теме
в бесплатном битриксе это есть (хуки, приложения)?
4. bayselonarrend 2131 22.07.24 11:59 Сейчас в теме
(3) Нет, нужен хотя бы самый простой платный тариф
5. support 4453 22.07.24 12:03 Сейчас в теме
(4) а почему конечную сборку не выкладывайте на инфостарт?
Можно же добавить с бесплатным доступом.
6. bayselonarrend 2131 22.07.24 12:16 Сейчас в теме
(5) Ну, у меня есть релиз на GH из 16 файлов, который сам туда собирается скриптом и публикуется с прямыми ссылками на скачивание. Не вижу особого смысла дублировать это все добро руками в статью, чтобы потом, если надо будет что-то поменять, еще и перегружать в двух местах

+ там что-то не совсем просто с бесплатным доступом вроде
Прикрепленные файлы:
8. support 4453 22.07.24 13:00 Сейчас в теме
(6) есть даже API для обновления файла.
И уж лицензии ты умеешь читать, все там нормально
9. bayselonarrend 2131 22.07.24 13:05 Сейчас в теме
(8) Ну хорошо, можно в теории еще поразбираться в API и лицензии, но только какие от этого кому плюсы мне все равно непонятно
12. kuzyara 2095 23.07.24 06:42 Сейчас в теме
(9) Насколько я понял правилами запрещено публиковать свою разработку и одновременно прикладывать прямую ссылку на скачивание с гитхаба.
13. bayselonarrend 2131 23.07.24 07:24 Сейчас в теме
(12) По-моему, ссылка на релиз все равно более прямая, чем получение по почте. Но я немного о другом: файл бесплатный - ИФ с него не заработает так и так, обратная ссылка на ИФ в репозитории есть, тут статья. Все в плюсе, еще и место на сервере не занимается, нет?
KirillZ44; +1 Ответить
7. Teplotrassamen 22.07.24 12:35 Сейчас в теме
Отлично, буквально неделю назад раскурил как делать отправку в живую ленту, создание задач и отправку сообщения в диалог или чат.
А тут уже все готовое.
10. bayselonarrend 2131 22.07.24 13:14 Сейчас в теме
11. Teplotrassamen 22.07.24 13:52 Сейчас в теме
(10) я перед тем как разбираться, смотрел есть ли это в ОПИ, этого не было и я подумал хорошо бы чтобы появилось. А сегодня вижу что появилось, словно мои мысли были прочитаны и появилось как по волшебству)
bayselonarrend; +1 Ответить
14. user929348 02.09.24 20:26 Сейчас в теме
Не понятно, в базе знаний описано, что функция получить токен возвращает
Результат
{
"error": "expired_token",
"error_description": "The authorization token provided has expired."
}
У меня так и возвращает. Но чтобы обновить, нужно передать refresh_token

Откуда его взять, если сразу возвращается error?
15. bayselonarrend 2131 02.09.24 20:31 Сейчас в теме
(14) Нужно получить не refresh_token, а код, перейдя по ссылке авторизации
Последние несколько пунктов здесь: https://openintegrations.dev/docs/Instructions/Bitrix24/
16. user929348 02.09.24 20:33 Сейчас в теме
Да, в браузере переходил, и code получал, но возвращает все равно error": "expired_token". Какой срок действия у токена? Я предположил, что нужно в коде постоянно обновлять токен.
17. bayselonarrend 2131 02.09.24 20:37 Сейчас в теме
(16)
Какой срок действия у токена?


У кода, который из браузера, очень маленький - он вообще рассчитан на прилет в какой-нибудь автоматический обработчик (как http-сервис, например). Если я не ошибаюсь, там буквально пол минуты или около того

У настоящего токена время жизни один час
18. user929348 02.09.24 20:39 Сейчас в теме
(17)
У кода, который из браузера, очень маленький - он вообще рассчитан на прилет в какой-нибудь автоматический обработчик (как http-сервис, например). Если я не ошибаюсь, там буквально пол минуты или около того

У настоящего токена время жизни один час


А как получить настоящий токен? В БЗ написано только "перейдите по полученной ссылке в браузере".
19. bayselonarrend 2131 02.09.24 20:42 Сейчас в теме
(18) Перейти по ссылке -> быстро скопировать из браузера код -> быстро выполнить ПолучитьТокен, где код это последний параметр

В БЗ написано только "перейдите по полученной ссылке в браузере"


Нет, там не только это написано)
20. user929348 02.09.24 20:57 Сейчас в теме
(19)
последний


Спасибо! Получилось

А в БЗ может не туда смотрю?
Прикрепленные файлы:
21. bayselonarrend 2131 02.09.24 20:59 Сейчас в теме
(20) Отлично

А в БЗ может не туда смотрю?


Собственно, туда - п.5)
22. bayselonarrend 2131 02.09.24 21:00 Сейчас в теме
(20) Если не сложно, можете поставить проекту звездочку на GH
23. user929348 02.09.24 21:06 Сейчас в теме
24. bayselonarrend 2131 02.09.24 21:07 Сейчас в теме
Оставьте свое сообщение