OpenIntegrations/docs/ru/md/Instructions/Bitrix24.md

id, sidebar_class_name, keywords

id	sidebar_class_name	keywords
Bitrix24	Bitrix24	1C 1С 1С:Предприятие 1С:Предприятие 8.3 API Интеграция Сервисы Обмен OneScript CLI Bitrix24

<img src={require('../../static/img/APIs/Bitrix24.png').default} width='64px' />

Bitrix24

Этот раздел посвящен библиотеке для работы с Bitrix24 API в 1С:Предприятие, OneScript и CLI. На данной странице описаны все действия, необходимые для полноценного начала работы

Начало работы

Для начала работы с Bitrix24 через API необходимо получить данные для авторизации. Сделать это можно одним из двух способов: через создание Webhook или через создание локального приложения. Оба эти способа описаны ниже

Работа через Webhook

1. Перейти в подраздел Разработчикам в разделе Приложения боковой панели
2. Выбрать пункт Другое
3. Выберите пункт Входящий вебхук
4. Заполните необходимые разрешения в Настройках прав и сохраните URL вебхука. Он будет использоваться для выполнения методов библиотеки как параметр URL. Необязательный параметр Токен в данном случае будет всегда оставаться пустым

Работа через локальное приложение

1. Перейти в подраздел Разработчикам в разделе Приложения боковой панели Bitrix24
2. Выбрать пункт Другое
3. Выберите пункт Локальное приложение
4. Выберите URL обработчика. Если приложение не подразумевает авторизацию других пользователей, а только управление Bitrix через один аккаунт администратора, то можно выбрать любой адрес, например https://localhost.
5. Поставьте галочку Использует только API (если необходим только функционал вызова методов библиотеки) и заполните необходимые права
6. Сохраните ключ и код приложения
7. Передайте ключ приложения в функцию ПолучитьСсылкуАвторизацииПриложения и перейдите по полученной ссылке в браузере
8. Авторизуйтесь и скопируйте полученный код из адресной строки или получите его на обработчик, адрес которого был указан в пункте 4
9. Передайте полученный код, вместе с ключом и секретом приложения, в функцию ПолучитьТокен
10. Сохраните полученные access и refresh токены

:::important Время жизни токенов ограничено. Для получение нового токена можно воспользоваться функцией ОбновитьТокен, передав туда refresh токен, ключ и секрет приложения. При обновлении создается не только новый access, но и refresh токен - его необходимо сохранить заново :::