Подключение 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клиент по номеру телефона не находится.