設定すること
- 現時点で、汎用のWebhookエンドポイントと間に挟む自動化ツールを使って、ElidoをPMツールに接続する計画。
- 各ツールに適した認証トークン：パーソナルアクセストークン（Asana、Monday）、APIトークン + List ID（ClickUp）、APIキー + トークン + ボード/リストID（Trello）。
- 現在タスクの作成に使えるElidoのイベント：リンク切れ、期限切れリンク、クリック上限、ドメインの障害、使用量の上限。
どのPMツールも同じ原理で動作します。Elidoが外部向けイベントを発行し、選択したプロジェクトにタスク、カード、またはアイテムが作成されます。現在は自分で構築できます。Settings → Webhooks にイベントエンドポイントを追加し、次のイベントを使います：link.broken、link.expired、link.cap_reached、domain.ssl_failed、usage.threshold_80、usage.threshold_100。Webhookガイドとn8nガイドを参照してください。
簡易比較
| ツール | 認証 | ステータス | 最適な用途 |
|---|---|---|---|
| Asana | パーソナルアクセストークン | 予定 | すでにAsana Projectsでキャンペーンを運用しているチーム |
| ClickUp | APIトークン + List ID | 予定 | 自動化を活用するClickUpネイティブのチーム |
| Trello | APIキー + トークン + ボード/リストID | 予定 | 手間のかからないシンプルなカンバンボード |
| Monday.com | パーソナルAPIトークン | 予定 | アイテム単位でステータスを追跡するビジュアルボード |
Asana
パーソナルアクセストークンを取得する：
- Asana → My Settings → Apps → Manage Developer Apps → Create New Personal Access Token。
- 「Elido」と名付け、トークンをコピーします。
Elidoでの設定（予定）：
- 予定：Dashboard → Webhooks → Add Asana（まだ利用できません）。
- トークンを貼り付け、Fetch projects をクリックします。アカウントから見えるすべてのプロジェクトがElidoに一覧表示されます。
- 対象のプロジェクトと、必要に応じて担当者を選びます。
- イベントを選びます。予定：リンク切れイベントで「Investigate broken link」タスクを作成します。
AsanaのAPIは tasks:write と projects:read を使用します。トークンのスコープ画面にこれらが表示されます。
ClickUp
APIトークンを取得する：
- ClickUp → Settings → Apps → API Token → Generate。
List IDを調べる：
タスクを作成したいリストが必要です。最も簡単な方法は、ClickUpでそのリストを開くことです。URLにリストIDが含まれています。例：https://app.clickup.com/1234/v/li/987654 の /li/ の後ろの数字がList IDです。または、トークンを使って GET https://api.clickup.com/api/v2/team を呼び出し、スペース → フォルダ → リストの順にたどります。
Elidoでの設定（予定）：
- 予定：Dashboard → Webhooks → Add ClickUp（まだ利用できません）。
- APIトークンとList IDを貼り付けます。
- イベントを選んで保存します。
Trello
Trelloは、キーとトークンの2段階で認証します。
ステップ1：APIキー
https://trello.com/power-ups/admin → New → 「Elido」と名付け → APIキーをコピーします。
ステップ2：トークン
次のURLにアクセスします（KEY をキーに置き換えてください）：
https://trello.com/1/authorize?key=KEY&name=Elido&expiration=never&scope=read,write&response_type=token
Trelloが画面にトークンを表示します。それをコピーします。
ステップ3：ボードIDとリストID
対象のTrelloボードを開き、URLに .json を付けます：
https://trello.com/b/XXXX/your-board.json
lists キーの下から目的のリストを探し、その id をコピーします。
Elidoでの設定（予定）：
- 予定：Dashboard → Webhooks → Add Trello（まだ利用できません）。
- APIキー、トークン、リストIDを貼り付けます。
- イベントを選んで保存します。
Monday.com
パーソナルAPIトークンを取得する：
- Monday → アバターをクリック → Developers → My Access Tokens。
- トークンをコピーします。
ボードIDを調べる：
対象のボードを開きます。URLは https://monday.com/boards/1234567890 の形式で、この数字がボードIDです。これをコピーします。
Elidoでの設定（予定）：
- 予定：Dashboard → Webhooks → Add Monday（まだ利用できません）。
- APIトークンとボードIDを貼り付けます。
- イベントを選んで保存します。各イベントは、ボードの最初のグループに新しいアイテムを作成します。
トラブルシューティング
Asana：「Not a member of that project」。 PATの所有者が、選択したプロジェクトにアクセスできません。Asanaでそのユーザーをプロジェクトに追加するか、別のPATを使ってください。
ClickUp：タスクが間違ったリストに作成される。 List IDを確認してください。スペースIDやフォルダIDと混同しやすいので、上記のURLの方法で確かめてください。
Trello：トークンの期限切れ。 expiration=never で作成したトークンでも、Trelloがセキュリティ上の問題を検知すると期限切れになります。認証URLをもう一度実行して新しいトークンを取得してください。
Monday.com：「Error 200: invalid column value」。 ボードに、既定値のない必須列があります。Monday側でそれらを埋めるか、すべての必須列に既定値があるグループやボードを選んでください。