---
id: Bitrix24
sidebar_class_name: Bitrix24
keywords: [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 токен - его необходимо сохранить заново
:::
