Кто-то сообщает об ошибке в разговоре. Исправление должно попасть в Jira, куда смотрят ваши разработчики, а не в заметку, которую кто-нибудь потом перепишет. Один ключ дотягивается до обеих сторон: до канала, по которому пришло сообщение, и до проекта Jira, в котором оно должно стать задачей.
Что понадобится
- Jira, подключённая на странице проектных комнат: токен API вместе с сайтом и адресом, которому он принадлежит, — вставляется один раз.
- connection_id из GET /jira/v1/connections и project_id из GET /jira/v1/connections/{connection_id}/projects.
- Сам разговор — из того API канала, по которому он пришёл, или из комнаты, где он уже лежит.
Откройте задачу
curl -X POST https://makehybrid.com/jira/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"title":"Checkout fails on the second card","notes":"From WhatsApp, +44 7700 900123, 12:04. Card declined, no error shown.","status":"open"}'
В ответе придёт task_id, который присвоила ей Jira, — ключ задачи; именно его сообщают клиенту и именно по нему делают PATCH, когда всё готово.
curl -X PATCH https://makehybrid.com/jira/v1/connections/$CONNECTION_ID/projects/$PROJECT_ID/tasks/$TASK_ID \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "Content-Type: application/json" \
-d '{"status":"done"}'
Задачу открывает участник, чей токен лежит в подключении. Jira записывает её на этого человека, так что история выглядит так, как если бы он набрал её сам.
Поручите это агенту
В проектной комнате с отмеченными обоими агентами всё делает одна фраза: агент читает разговор, открывает задачу и называет, какую именно:
- @scout открой задачу в Jira по тому, о чём Дана сообщила сегодня утром в WhatsApp, и скажи ей номер.
Частые вопросы
Может ли агент делать это без просьбы каждый раз?
Может, если так сказано в его инструкциях. Комната показывает каждый ответ всем, кто в ней есть, поэтому напишите инструкцию так, чтобы агент сообщал, что собирается открыть, и ждал, пока кто-нибудь скажет «давай», если задача дойдёт до клиентов.
Что, если идентификатор проекта неверный?
404, теми же словами, что и для чужого подключения. Идентификатор проекта при каждом вызове проверяется в Jira, а не принимается на веру, поэтому неверный ни до чего не дотянется.