手動でのセットアップを省略したい場合は、このページのリンクを Devin のセッションに貼り付けて、すべてのセットアップを依頼してください。 Devin は API 呼び出しを認証するために [service user tokens](/ja/api-reference/v3/overview) を使用します。これは本番環境の自動化に推奨される方法です。 1. [app.devin.ai](https://app.devin.ai/?utm_source=docs\&utm_medium=use-case-gallery) > **Settings** > **Service Users** に移動し、`ManageOrgSessions` 権限を持つ新しい service user を作成します 2. 作成後に表示される API トークンをコピーして安全に保管します — このトークンは一度しか表示されず、webhook ハンドラ内で `DEVIN_API_KEY` として使用します組織 ID を確認するには、トークンを使用して `GET https://api.devin.ai/v3/enterprise/organizations` を呼び出します — この URL では org のスラッグのみが表示され、ID は表示されません。次の curl コマンドで動作を確認できます: ```bash theme={null} curl -X POST https://api.devin.ai/v3/organizations/YOUR_ORG_ID/sessions \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{"prompt": "Say hello — this is a test session."}' ``` `session_id` と `url` が返されます。Devin の Web アプリでテストセッションを削除して、次に進んでください。このパターンは、**オンプレミスのチケット管理システム** (セルフホスト型の Jira、Redmine、Bugzilla など) や、**ネイティブな Devin 連携を持たないチケット管理ツール** (組み込みサポートがある [Linear](/ja/integrations/linear) や [Jira Cloud](/ja/integrations/jira) とは異なる) に最適です。チケット管理システムが webhook をサポートしていれば、小さなサービスを挟むことで Devin と連携できます。プロンプト内にチケット管理システムの API ドキュメントへのリンクを含めておき、Devin がチケットにコメントを投稿し直す方法を理解できるようにします。チケット管理 API トークンは [session secret](/ja/api-reference/common-flows) として渡し、Devin が直接認証できるようにします。 Devin にひな形の作成を依頼します: ```txt カスタムチケティング用の Webhook ハンドラー theme={null} Build an Express.js service that: 1. Accepts POST /webhooks/tickets with a JSON body containing id, title, description, and labels 2. Verifies the webhook signature using HMAC-SHA256 3. Skips tickets without a "devin-autofix" or "devin-feature" label 4. Calls POST https://api.devin.ai/v3/organizations/{org_id}/sessions with a prompt built from the ticket fields, a playbook_id based on the label, and the ticketing API token as a session secret Read DEVIN_API_KEY, DEVIN_ORG_ID, TICKET_API_TOKEN, and WEBHOOK_SECRET from environment variables. ``` コアとなるハンドラーは次のようになります: ```javascript theme={null} const PLAYBOOKS = { 'devin-autofix': 'playbook-a1b2c3d4e5f6', 'devin-feature': 'playbook-f6e5d4c3b2a1', }; app.post('/webhooks/tickets', async (req, res) => { if (!verifySignature(req)) return res.status(401).send('Bad signature'); const { id, title, description, labels } = req.body; const label = labels.find(l => PLAYBOOKS[l]); if (!label) return res.status(200).send('No Devin label — skipped'); const orgId = process.env.DEVIN_ORG_ID; const { session_id } = await fetch( `https://api.devin.ai/v3/organizations/${orgId}/sessions`, { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.DEVIN_API_KEY}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ prompt: [ `Ticket ${id}: ${title}`, description, `Reference ticket ${id} in your commit message.`, `When done, post a comment on ticket ${id} with a summary of your`, `changes and a link to the PR. Use the ticketing API at`, `https://your-ticketing-system.com/api/docs to post the comment.`, `Authenticate with the $TICKET_API_TOKEN environment variable.`, ].join('\n\n'), playbook_id: PLAYBOOKS[label], session_secrets: [ { key: 'TICKET_API_TOKEN', value: process.env.TICKET_API_TOKEN }, ], }), }).then(r => r.json()); res.json({ session_id }); }); ``` `PLAYBOOKS` マップは、チケットラベルを **Settings > Playbooks** で作成した[プレイブック](/ja/product-guides/creating-playbooks)に対応付けます。バグ修正用のプレイブックには *「必ず回帰テストを追加する」*、機能追加用のプレイブックには *「ドラフト PR を作成してレビューを依頼する」* といった内容を記載できます。プロンプトには、Devin がコメントを投稿する方法を理解できるように、利用しているチケットシステムの API ドキュメントへのリンクを含めます。`TICKET_API_TOKEN` は[セッションシークレット](/ja/api-reference/common-flows)として渡されます — そのセッションでのみ環境変数として注入され、保存されることはありません。API ドキュメントの URL を、実際に利用しているチケットシステムのドキュメントに置き換えてください。ハンドラーは HTTPS の POST リクエストを受け取れる任意の環境にデプロイします — クラウドファンクション (AWS Lambda、Google Cloud Functions) 、コンテナ、または VPS などです。その URL をチケットシステムの通知またはインテグレーション設定で webhook として登録し、**ticket created** イベントを対象にフィルタします。 `devin-autofix` ラベル付きのテストチケットを作成し、フルループを検証します: チケット作成 → webhook 発火 → Devin セッション開始 → PR 作成 → Devin がチケットにコメントを投稿。