Хтось повідомляє про помилку в розмові. Виправлення має потрапити в 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, а не приймається на віру, тож хибний ні до чого не дотягнеться.