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

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

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

***

* [Чат с оператором](#chat-s-operatorom)
* [Тикеты](#tikety)
  * [Новый тикет](#novyi-tiket)
  * [Список тикетов](#spisok-tiketov)
  * [Поиск тикета](#poisk-tiketa)
  * [Изменение тикета](#izmenenie-tiketa)
  * [Список полей тикета](#spisok-polei-tiketa)
* [Контакты](#kontakty)
  * [Новый контакт](#novyi-kontakt)
  * [Список контактов](#spisok-kontaktov)
  * [Поиск контакта](#poisk-kontakta)
  * [Изменение контакта](#izmenenie-kontakta)

***

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

Начать чат с оператором через Usedesk.

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

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

* `text` (string) \* – Текст сообщения
* `team` (string) – Название команды операторов в Fasttrack
* `operator_email` *(string)* – Почта оператора в Fasttrack

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

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

## Тикеты

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

### Новый тикет

Создать тикет в Usedesk.

```
{% usedesk.create_ticket message=<содержание> subject=<тема> <поля тикета> as ticket  %}
```

* `message` *(str)* \* – Содержание тикета
* `subject` *(str)* \* – Тема

Поля для заполнения:&#x20;

* `contact_id` *(int)* – Идентификатор контакта
* `contact_name` *(str)* – Имя контакта
* `contact_email` *(str)* – Почта контакта
* `contact_phone` *(str)* – Телефон контакта
* `phone_type` *(str)* – Тип номера телефона
* `field_id` *(str)* – Идентификатор поля
* `field_value` *(str)* – Значение для поля

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

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

### Список тикетов

Получить список всех тикетов в Usedesk.

```
{% usedesk.get_tickets <параметры> as tickets %}
```

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

* `query` *(str)* –&#x20;

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

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

```
{% usedesk.get_ticket uid=<id тикета> as ticket %}
```

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

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

Редактирование информации о тикете в Usedesk.

```
{% usedesk.edit_ticket uid=<id тикета> subject=<тема> <поля тикета> as ticket %}
```

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

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

* `status` *(str)* – Название статуса
* `custom_fields` *(dict)* – Дополнительные поля

### Список полей тикета

Получить список всех полей для тикета в Usedesk.

```
{% usedesk.get_ticket_fields as ticket_fields %}
```

## Контакты

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

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

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

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

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

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

* `email` *(str)* – Адрес электронной почты

### Список контактов

Получить список контактов в Usedesk.

```
{% usedesk.get_contacts <параметры> as contacts %}
```

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

* `query` *(str)* –&#x20;

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

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

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

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

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

Редактирвать информацио о контакте в Usedesk.

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

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

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

* `full_name` *(str)* – Имя
* `email` *(str)* – Адрес электронной почты
* `phone_number` *(str)* – Номер телефона