# 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)* – Номер телефона


---

# 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/usedesk/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.