# Битрикс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> – Идентификатор ответственного


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fstrk.io/knowledge_base/intagrations/bitrix24/methods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.