誰かが会話の中でバグを報告します。直す作業は、開発者が見ている Jira にあるべきで、あとで誰かがコピーしてくれるはずのメモの中にあってはいけません。キー 1 つで、両側に届きます。メッセージが届いたチャネルと、それを課題にしたい 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 はそのメンバーとして記録するので、履歴は、本人が Jira に直接入力した場合と同じになります。
エージェントにやらせる
両方のエージェントにチェックを入れたプロジェクトルームでは、一文ですべて済みます。エージェントが会話を読み、課題を作り、どの課題かを伝えます。
- @scout 今朝 Dana が WhatsApp で報告した件で Jira の課題を作って、番号を彼女に伝えて。
よくある質問
そのたびに頼まなくても、エージェントにやらせられますか？
指示にそう書けば、できます。ルームは、すべての返答をその中の全員に見せます。そのため、課題がお客様に届くことになる場合は、何を作ろうとしているかを言って、誰かが「進めて」と言うのを待つよう、指示を書いてください。
プロジェクト ID が間違っていたら？
404 で、あなたのものではない接続とまったく同じ文面です。プロジェクト ID は、信用せず、呼び出しのたびに Jira で調べるので、間違った ID は何にも届きません。