Перейти к основному содержимому

Подключение Jira

MonoPbx подключается к вашей Jira, чтобы функции звонков могли её использовать: открытые обращения клиента на экране звонка, задачи, созданные из звонков, заметки и списания времени по звонкам, а также звонок клиенту из задачи. На этой странице описаны подключение, сопоставление полей и проверка связи. Функции звонков описаны на отдельной странице Jira и звонки.

Для подключения нужно право jira:write, для просмотра подключения — jira:read. Встроенная роль Owner имеет оба.

Выберите способ входа​

РежимПодходит дляКак выполняется вход
Вход через Atlassian (OAuth 2.0)Jira CloudАдминистратор один раз входит в Atlassian. MonoPbx хранит токены доступа и обновления в зашифрованном виде, ключом компании.
API-токенJira CloudВы вводите e-mail учётной записи Atlassian и API-токен. MonoPbx хранит их в зашифрованном виде и больше не показывает.

Для входа через Atlassian оператор регистрирует OAuth 2.0-приложение в консоли разработчика Atlassian с адресом обратного вызова https://<ваш PBX>/admin/jira и областями read:jira-work write:jira-work read:jira-user offline_access. Atlassian меняет токен обновления при каждом обновлении. MonoPbx сохраняет новый токен до того, как его использовать. Если Atlassian отказывает в обновлении, подключение получает статус отозвано, пока вы не подключитесь заново.

Чтобы создать API-токен, войдите на id.atlassian.com, откройте раздел Безопасность, затем Токены API.

Отключение удаляет из MonoPbx все токены и секреты. Atlassian не предоставляет способа отозвать вход со своей стороны, поэтому также удалите приложение в вашей учётной записи Atlassian в разделе Подключённые приложения.

Сопоставьте поля​

Сопоставления задают проект Jira и тип задачи для новых задач, а также поле Jira, в котором хранится каждое наше значение.

Наше полеЧто хранится
customer_phone, customer_emailНомер и e-mail клиента. По customer_phone выполняется поиск клиента по номеру.
caller_number, called_numberНомера в звонке.
call_id, call_direction, call_duration, recording_urlФакты о звонке.
agent, queueАгент и очередь, которые приняли звонок.

Каждое значение — это идентификатор поля Jira, например customfield_10050. Ключи проектов и идентификаторы проверяются строго, потому что они попадают в JQL и в адреса Jira. Используйте идентификаторы полей вашего сайта Jira, а не их названия.

Проверьте подключение​

Нажмите Проверить подключение на странице настроек Jira. MonoPbx проверяет, что учётные данные работают, что выданных областей достаточно (только для OAuth), и что сопоставленный проект существует.

Если проверка не проходит, подключение получает статус с ошибкой или отозвано, и администраторы компании получают оповещение JiraConnectionFailing, пока проверка не пройдёт.

Вебхук из Jira (необязательно)​

Включите вебхук, чтобы видеть изменения в Jira в MonoPbx по мере их появления. MonoPbx создаёт закрытый адрес и секрет. Оба показываются один раз: скопируйте их в Jira, в разделе Система, WebHooks, для событий issue created и issue updated.

MonoPbx принимает доставку, только если подпись совпадает с секретом, метка времени не старше пяти минут и такая доставка ещё не поступала. Принятые изменения появляются как события jira.issue_changed, которые содержат только идентификаторы и названия изменённых полей.

Перед началом​

  • Jira Cloud. И вход через Atlassian, и API-токен требуют Jira Cloud. Jira Server и Data Center не поддерживаются.
  • Публичный HTTPS. Jira должна достучаться до адреса вебхука, а этот адрес должен быть публичным именем.
  • Сопоставленное поле клиента. Без сопоставления customer_phone клиент по номеру телефона не находится.