Asana

Интеграция c Asana помогает работать с задачами Asana напрямую из Юздеска: создавать их и видеть актуальные статусы, а также привязывать задачи к определённой карточке запроса.


Настройка интеграции

1. Создайте дополнительное поле с типом «текст». Откройте раздел «Настройки» ⟶ «Дополнительные поля», нажмите «Создать».

2. Создайте динамический блок. Откройте раздел «Настройки» ⟶ «Блоки», нажмите «Добавить динамический блок»:

  • Имя – название системы,
  • Заголовок – название блока, которое будет отображаться в карточке запроса,
  • URL – заполните поле значением https://asana.usedesk.ru/,
  • Включен – установите флажок для активации блока,
  • Добавить параметр – POST параметры (см. п. 3).

3. Добавьте параметры (POST):

  • field_id — id дополнительного поля,
  • asana_token — токен Asana. Его нужно сгенерировать в консоли разработчика,
  • usedesk_token — токен Юздеска. Тут мы описываем, как его получить.

4. После внесения всех изменений нажмите «Сохранить».


Принцип работы интеграции

В карточке запроса дополнительный блок расположен в правой части страницы под карточкой клиента и другими дополнительными блоками (при наличии).

Дополнительное поле, которое вы использовали для настройки, можете скрыть, и убрать возможность редактирования (настройка в дополнительном поле).


Создание задачи

При нажатии на кнопку «Создать» отображается форма создания задачи:


«Название задачи» — произвольное поле. В поля «Workspace», «Проект» и «Исполнитель» автоматически подтянутся значения из Asana по мере заполнения карточки. Поле «Дедлайн» позволяет указать дату в формате «ДД-ММ-ГГГГ». В описании можно подробнее указать описание созданной задачи. Созданная задача автоматически прикрепится к запросу.


Прикрепление задачи в карточку запроса

К карточке запроса вы можете привязать одну или несколько задач. Связь будет отображаться в дополнительном поле из п. 1. Привязать = видеть информацию по конкретной задаче (задачам) в карточке запроса. Для этого нажмите «Связать» и заполните поле «Номер», вписав ключ задачи Asana. Например: 1200006350188623.


Информация в дополнительном блоке карточки запроса

Дополнительный блок карточки запроса включает в себя следующую информацию и функции:


Нет прикрепленных задач

Если с текущим запросом не связали ни одной задачи, мы покажем сообщение «Связанных задач нет» и две кнопки: «Создать» и «Связать», с помощью которых вы можете добавить задачи к запросу:


Прикреплена одна задача

Помимо кнопок «Создать» и «Связать» появляется кнопка «Отвязать». Также показываются детали задачи:


По клику на название задачи можно перейти в задачу в Asana — например, чтобы увидеть подзадачи.


Прикреплено несколько задач

Если к запросу привязано несколько задач, мы покажем их список. При нажатии на заголовок открывается карточка задачи, а при нажатии на иконку рядом с заголовком вы перейдёте в Asana. Тут же можно создать ещё одну задачу:


Чтобы вернуться к списку привязанных задач, обновите дополнительный блок с помощью кнопки с двумя стрелочками.


Комментарии в запросе

При создании, связке и отвязке задачи мы укажем детали во внутреннем комментарии: