> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/intagrations/bitrix24/methods.md).

# Битрикс24: Процедуры

## Битрикс24: Процедуры для настройки сценариев

***

* [Чат с оператором](#chat-s-operatorom)
* [Контакты](#kontakty)
  * [Новый контакт](#novyi-kontakt)
  * [Поиск контакта](#poisk-kontakta)
  * [Изменение контакта](#izmenenie-kontakta)
  * [Поля контакта](#polya-kontakta)
* [Сделки](#sdelki)
  * [Новая сделка](#novaya-sdelka)
  * [Список сделок](#spisok-sdelok)
  * [Поиск сделки](#poisk-sdelki)
  * [Изменение сделки](#izmenenie-sdelki)
* [Лиды](#lidy)
  * [Новый лид](#novyi-lid)
  * [Поиск лида](#poisk-lida)
  * [Поиск поля](#poisk-polya)
* [Задачи](#zadachi)
  * [Новая задача](#novaya-zadacha)
  * [Список задач](#spisok-zadach)
  * [Поиск задачи](#poisk-zadachi)
  * [Изменение задачи](#izmenenie-zadachi)

***

## Чат с оператором

Начать чат с оператором через Битрикс24.

```
{% bitrix.enable text=<Тест сообщения> <параметры> %}
```

* `text` *(string)* <mark style="color:red;">\*</mark> – Текст сообщения

Параметры процедуры:

* `team` *(string)* – Название команды операторов в Fasttrack
* `operator_email` *(string)* – Почта оператора в Fasttrack
* `lead_id` *(integer)* – Идентификатор лида
* `contact_id` *(integer)* – Идентификатор контакта

\[ ⚠️ ] Ограничения:

* Нельзя одновременно указывать `team` и `operator_email`
* Нельзя одновременно указывать `lead_id` и `contact_id`

## Контакты

Процедуры для работы с контактами в Битрикс24.

### Новый контакт

Создать контакт в Битрикс24.

```
{% bitrix.create_contact phone_number=<телефон> as contact %}
```

* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона

Поля для заполнения:

* `email` *(str)* – Адрес электронной почты
* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `custom_fields` *(dict)* – Дополнительные поля

### Поиск контакта

Получить информацию о контакте в AmoCRM по его id, телефону или почте.

#### Найти контакт по ID

```
{% bitrix.get_contact_by_uid uid=<id контакта> as contact %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта

#### Найти контакт по номеру телефона

```
{% bitrix.get_contact_by_phone_number phone_number=<телефон> as contact %}
```

* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона

#### Найти контакт по адресу эл. почты

```
{% bitrix.get_contact_by_email email=<почта> as contact %}
```

* `email` *(str)* <mark style="color:red;">\*</mark> – Адрес электронной почты

### Изменение контакта

Редактировать информацию о контакте в AmoCRM по его id, телефону или почте.

#### Редактировать контакт по ID

```
{% bitrix.edit_contact_by_uid uid=<id контакта> <поля контакта> as contact %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта

Поля для редактирования:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `custom_fields` *(dict)* – Дополнительные поля

#### Редактировать контакт по номеру телефона

```
{% bitrix.edit_contact_by_phone_number phone_number=<телефон> <поля контакта> as contact  %}
```

* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона

Поля для редактирования:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `custom_fields` *(dict)* – Дополнительные поля

#### Редактировать контакт по адресу эл. почты

```
{% bitrix.edit_contact_by_email email=<почта> <поля контакта> as contact %}
```

* `email` *(str)* <mark style="color:red;">\*</mark> – Адрес электронной почты

Поля для редактирования:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `custom_fields` *(dict)* – Дополнительные поля

### Поля контакта

Получить список всех полей, связанных с контактом в Битрикс24.

{% hint style="info" %}
Информация в этом блоке обновляется.
{% endhint %}

## Сделки

Процедуры для работы со сделками в Битрикс24.

### Новая сделка

Создать сделку в Битрикс24.

```
{% bitrix.create_deal contact_id=<id контакта> <поля сделки> as deal %}
```

* `contact_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта

Поля для редактирования:

* `title` *(str)* – Заголовок
* `custom_fields` *(dict)* – Дополнительные поля

### Список сделок

Получить список сделок, связанных с контактом в Битрикс24.

```
{% bitrix.get_deals contact_uid=<id контакта> as deals %}
```

* `contact_uid` *(str)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `stage` *(str)* <mark style="color:red;">\*</mark> – Статус

### Поиск сделки

Получить информацию о сделке в Битрикс24.

```
{% bitrix.get_deal uid=<id сделки> as deal %}
```

* `uid` *(int)*  <mark style="color:red;">\*</mark> – Идентификатор сделки

### Изменение сделки

Редактировать информацио о сделке в Битрикс24.

```
{% bitrix.edit_deal uid=<id сделки> <поля сделки> as deal %}
```

* `uid` *(int)*  <mark style="color:red;">\*</mark> – Идентификатор сделки

Поля для редактирования:

* `stage_id` *(str)* – Идентификатор статуса
* `title` *(str)* – Заголовок
* `contact_id` *(int)* – Идентификатор контакта
* `custom_fields` *(dict)* – Дополнительные поля

## Лиды

Процедуры для работы с лидами в Битрикс24.

### Новый лид

Создать лид в Битрикс24.

```
{% bitrix.create_lead title=<заголовок> <поля лида> as lead %}
```

* `title` *(str)* <mark style="color:red;">\*</mark> – Заголовок

Поля для заполнения:

* `status_id` *(str)* – Идентификатор статуса
* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `phone_number` *(str)* – Номер телефона
* `email` *(str)* – Адрес электронной почты
* `telegram_username` *(str)* – Имя пользователя в Telegram
* `facebook_username` *(str)* – Имя пользователя в Facebook
* `vk_username` *(str)* – Имя пользователя в VK
* `skype_username` *(str)* – Имя пользователя в Skype
* `viber_username` *(str)* – Имя пользователя в Viber
* `instagram_username` *(str)* – Имя пользователя в Instagram
* `utm_campaign` *(str)* – UTM campaign
* `utm_content` *(str)* – UTM content
* `utm_medium` *(str)* – UTM medium
* `utm_source` *(str)* – UTM source
* `utm_term` *(str)* – UTM term
* `custom_fields` *(dict)* – Дополнительные поля

### Поиск лида

Получить информацио о лиде в Битрикс24.

```
{% bitrix.get_lead_by_uid uid=<id лида> as lead %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор лида

### Изменение лида

Редактировать информацию о лиде в Битрикс24.

```
{% bitrix.edit_lead_by_uid uid=<id лида> <поля лида> as lead %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор лида

Поля для редактирования:

* `telegram_username` *(str)* – Имя пользователя в Telegram
* `facebook_username` *(str)* – Имя пользователя в Facebook
* `vk_username` *(str)* – Имя пользователя в VK
* `skype_username` *(str)* – Имя пользователя в Skype
* `viber_username` *(str)* – Имя пользователя в Viber
* `instagram_username` *(str)* – Имя пользователя в Instagram
* `utm_campaign` *(str)* – UTM campaign
* `utm_content` *(str)* – UTM content
* `utm_medium` *(str)* – UTM medium
* `utm_source` *(str)* – UTM source
* `utm_term` *(str)* – UTM term
* `email` *(str)* – Адрес электронной почты
* `phone_number` *(str)* – Номер телефона
* `custom_fields` *(str)* – Дополнительные поля

### Поиск поля

Получить информацию о поле, которое связанно с лидом.

```
{% bitrix.get_lead_field name=<название поля> as lead_field %}
```

* `name` *(str)* <mark style="color:red;">\*</mark> – Название поля

## Задачи

Процедуры для работы с задачами в Битрикс24.

### Новая задача

Создать задачу в Битрикс24.

```
{% bitrix.create_task responsible_id=<id ответственного> title=<заголовок> as task %}
```

* `responsible_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор ответственного
* `title` *(str)* <mark style="color:red;">\*</mark> – Заголовок задачи

Поля для заполнения:

* `description` *(str)* – Описание задачи
* `deadline_at` *(*&#x64;atetim&#x65;*)* – Срок выполнения

### Список задач

Получить список задач из Битрикс24.

```
{% bitrix.get_tasks responsible_id=<id ответственного> as tasks %}
```

* `responsible_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор ответственного

### Поиск задачи

Получить информацию о задаче в Битрикс24.

```
{% bitrix.get_task uid=<id задачи> as task %}
```

* `responsible_id` (in&#x74;*)* <mark style="color:red;">\*</mark> – Идентификатор ответственного

### Изменение задачи

Редактировать информацию об ответственом для задачи в Битрикс24.

```
{% bitrix.edit_task uid=<id задачи> responsible_id=<id ответственного> as task %}
```

* `responsible_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор ответственного