---
id: Bitrix24
sidebar_class_name: Bitrix24
---

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

# Bitrix24

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

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

Работать и Bitrix24 через API можно двумя способами: через **Webhook** и через **локальное приложение**. Для обоих вариантов необходимо:

1. Перейти в подраздел **Разработчикам** в разделе **Приложения** боковой панели

![BF](../../static/img/Docs/Bitrix24/1.png)

2. Выбрать пункт **Другое**

![BF](../../static/img/Docs/Bitrix24/2.png)

<hr/><br/>

### Для работы через Webhook

1. Выберите пункт **Входящий вебхук**
	
![BF](../../static/img/Docs/Bitrix24/3.png)

2. Заполните необходимые разрешения в **Настройках прав** и сохраните URL вебхука. Он будет использоваться для выполнения методов библиотеки как параметр **URL**. Необязательный параметр **Токен** в данном случае будет всегда оставаться пустым

![BF](../../static/img/Docs/Bitrix24/4.png)

<hr/><br/>

## Для работы через Локальное приложение

1. Выберите пункт **Локальное приложение**
	
![BF](../../static/img/Docs/Bitrix24/5.png)

2. Выберите путь обработчика (если приложение не подразумевает авторизацию других пользователей, но только управление Bitrix через один аккаунт администратора, то можно выбрать любой адрес, например https://localhost), поставьте галочку **Использует только API** (если необходим только функционал вызова методов библиотеки) и заполните необходимые права

![BF](../../static/img/Docs/Bitrix24/6.png)

3. Сохраните **ключ** и **код** приложения

![BF](../../static/img/Docs/Bitrix24/7.png)

4. При помощи ключа приложения вызовите функцию **ПолучитьСсылкуАвторизацииПриложения** и перейдите по полученной ссылке в браузере. После авторизации, скопируйте полученный код из адресной строки (или получите его на обработчик, адрес которого был указан в пункте 2)

![BF](../../static/img/Docs/Bitrix24/8.png)

5. Передайте полученный код, вместе с ключем и секретом приложения, в функцию **ПолучитьТокен**. Сохраните полученные **access** и **refresh токены**

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