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

---

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

• Тикеты

  • Новый тикет

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

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

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

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

• Контакты

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

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

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

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

---

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

Начать чат с оператором через 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) * – Тема

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

• 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) –

Поиск тикета

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

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

• uid (int) * – Идентификатор тикета в Usedesk

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

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

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

• uid (int) * – Идентификатор тикета

• subject (str) * – Тема

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

• 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) *. – Имя

• phone_number (str) * – Номер телефона

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

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

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

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

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

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

• query (str) –

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

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

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

• uid (int) * – Идентификатор контакта в Usedesk

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

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

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

• uid (int) * – Идентификатор контакта

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

• full_name (str) – Имя

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

• phone_number (str) – Номер телефона