누군가 대화에서 버그를 알려 옵니다. 고칠 일은 나중에 누가 옮겨 적을 메모가 아니라, 개발자들이 보는 Jira에 있어야 합니다. 키 하나로 양쪽에 닿습니다. 메시지가 도착한 채널, 그리고 그것을 이슈로 만들 Jira 프로젝트입니다.
필요한 것
- 룸 페이지에서 연결한 Jira. API 토큰을, 사이트와 그 토큰의 이메일 주소와 함께 한 번 붙여 넣습니다.
- GET /jira/v1/connections에서 얻는 connection_id, 그리고 GET /jira/v1/connections/{connection_id}/projects에서 얻는 project_id.
- 대화 자체. 도착한 채널 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"}'
응답에는 Jira가 붙인 task_id, 즉 이슈 키가 들어 있습니다. 고객에게 답할 때 쓰는 것도, 끝났을 때 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 오늘 아침 Dana가 WhatsApp으로 알려 준 건으로 Jira 이슈를 만들고, 번호를 그분께 알려 줘.
자주 묻는 질문
에이전트가 매번 부탁받지 않아도 이 일을 할 수 있나요?
지침에 그렇게 적어 두면 할 수 있습니다. 룸은 모든 답을 그 안의 모두에게 보여 줍니다. 그러니 이슈가 고객에게 닿을 수 있다면, 무엇을 열려는지 먼저 말하고 누군가 진행하라고 할 때까지 기다리도록 지침을 쓰세요.
프로젝트 ID가 틀리면요?
404이며, 내 것이 아닌 연결과 똑같은 문구입니다. 프로젝트 ID는 믿고 쓰지 않고 호출할 때마다 Jira에서 조회하므로, 틀린 ID는 아무것에도 닿지 않습니다.