> 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/hubspot/methods.md).

# Hubspot: Процедуры

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

***

* [Контакты](#kontakty)
  * [Новый контакт](#novyi-kontakt)
  * [Поиск контакта](#poisk-kontakta)
  * [Изменение контакта](#izmenenie-kontakta)
  * [Заметка для контакта](#zametka-dlya-kontakta)
* [Сделки](#sdelki)
  * [Новая сделка](#novaya-sdelka)
  * [Список сделок](#spisok-sdelok)
  * [Поиск сделки](#poisk-sdelki)
  * [Изменение сделки](#izmenenie-sdelki)
  * [Заметка для сделки](#zametka-dlya-sdelki)
* [Задачи](#zadachi)
  * [Новая задача](#novaya-zadacha)
  * [Поиск задачи](#poisk-zadachi)
  * [Изменение задачи](#izmenenie-zadachi)

***

## Контакты

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

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

Создать контакт в Hubspot.

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

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

Дополнительные поля:

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

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

Получить информацию о контакте в Hubspot.

```
{% hubspot.get_contact <id> <параметры> as contact %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона
* `email` *(str)* <mark style="color:red;">\*</mark> – Адрес электронной почты&#x20;

Дополнительные параметры:

* `in_fields` *(list)* – Кастомные поля

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

* Используйте только один из идентификаторов: `uid`, `phone_number` или `email`
* Допускается не больше 4х значений для `in_fields`

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### Заметка для контакта

Создать заметку для контакта в Hubspot.

```
{% hubspot.create_note contact_id=<id контакта> body=<содержание заметки> as note %}
```

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

## Сделки

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

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

Создать сделку в Hubspot.

```
{% hubspot.create_deal name=<название> <поля сделки> as deal %}
```

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

Поля сделки:

* `pipline` *(str)* – Воронка для сделки
* `dealstage` *(str)* – Этап сделки
* `contact_id` *(str)* – Идентификатор контакта
* `custom_fields` *(dict)* – Дополнительные поля

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

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

```
{% hubspot.get_deals contact_id=<id контакта> limit=100 <параметры> as deals %}
```

* `contact_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `limit` *(int)* <mark style="color:red;">\*</mark> – Кол-во сделок в ответе (по умолчанию 100, максимально 100)

Дополнительные параметры:

* `exclude_status_ids` *(list)* – Идентификаторы этапов
* `exclude_pipeline_ids` *(list)* – Идентификаторы воронок

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

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

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

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

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

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

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

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

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

* `name` *(str)* – Название для сделки
* `pipline` *(str)* – Воронка для сделки
* `dealstage` *(str)* – Этап сделки
* `custom_fields` *(dict)* – Дополнительные поля

### Заметка для сделки

Создать заметку для сделки в Hubspot.

```
{% hubspot.create_note deal_id=<id сделки> body=<содержание заметки> as note %}
```

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

`body` *(str)* <mark style="color:red;">\*</mark> – Содержание заметки

## Задачи

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

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

Создать задачу можно для сделки или для контакта в Hubspot.

#### Создать задачу для контакта

```
{% hubspot.create_task contact_id=<id контакта> body=<задача> due_at=<срок> <поля задачи> as task %}
```

* `contact_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `body` *(str)* <mark style="color:red;">\*</mark> – Содержание задачи
* `due_at` *(datetime)* <mark style="color:red;">\*</mark> – Срок

Дополнительные поля:

* `subject` *(str)* – Тема для задачи

#### Создать зачачу для сделки

```
{% hubspot.create_task deal_id=<id cделки> body=<задача> due_at=<срок> <поля задачи> as task %}
```

* `deal_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор сделки
* `body` *(str)* <mark style="color:red;">\*</mark> – Содержание задачи
* `due_at` *(datetime)* <mark style="color:red;">\*</mark> – Срок

Дополнительные поля:

* `subject` *(str)* – Тема для задачи

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

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

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

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

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

Редактировать информацию о задаче в Hubspot.

```
{% hubspot_edit_task task_id=<id задачи> <поля задачи> as task %}
```

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

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

* `subject` *(str)* – Тема для задачи
* `body` *(str)* – Содержание задачи