DiscordをElidoに接続する

Elidoは、受信ウェブフックを介してDiscordに投稿します — ボットアカウントも、ウェブフック作成以外のサーバー権限も不要です。どのチャンネルがメッセージを受信するかを正確に制御できます。

開始する前に#

Discordサーバーでウェブフックの管理権限が必要です。サーバー管理者はこれをデフォルトで持っています。管理者でない場合は、管理者にウェブフックを作成してもらい、URLをコピーしてもらいましょう。

Discordウェブフックを作成する#

1. Discordで、アラートを受け取りたいチャンネルを右クリックし、チャンネルを編集をクリックします。
2. 連携 → ウェブフック → 新しいウェブフックに進みます。
3. 名前（"Elido"）を付け、オプションでアバターを設定します。
4. ウェブフックURLをコピーをクリックします。これはhttps://discord.com/api/webhooks/1234.../AbcD...のようになります。

Elidoにウェブフックを追加する#

1. 設定 → 通知 → チャンネルを追加 → Discordを開きます。
2. ウェブフックURLを貼り付けます。
3. 保存をクリックします。Elidoはすぐにテストメッセージを投稿します — 2～3秒以内にDiscordで確認できるはずです。

転送するイベントを選択する#

保存後、イベントを設定をクリックします。各チャンネルで以下の各イベントを有効または無効にできます。

• link.created — ワークスペースでリンクが作成されると起動します。
• link.clicked — すべてのクリックで起動します（頻繁にクリックされるリンクでは量が多くなります。代わりにしきい値を使用してください）。
• threshold.exceeded — 定義したクリック数を超えると一度だけ起動します。
• scan.failed — 当社のURLスキャナーが宛先をフラグ付けすると起動します。

各Discordメッセージは、リンクスラッグ、イベントタイプ、クリック数、および分析ビューへのディープリンクを含む埋め込みとして届きます。

埋め込みペイロードは次のようになります。

{
  "username": "Elido",
  "embeds": [{
    "title": "elido.me/spring-2026 hit 1,000 clicks",
    "url": "https://app.elido.app/dashboard/links/42",
    "color": 6586590
  }]
}

連携を削除する#

Discordでウェブフックを削除するか（チャンネル設定 → 連携 → ウェブフック → 削除）、またはElidoでチャンネルを削除します（設定 → 通知 → Discord → 削除）。どちらの操作も配信を停止します。

トラブルシューティング#

テストメッセージが届かない — ウェブフックURLをブラウザのアドレスバーに貼り付けます。Discordは無効なURLに対して{"message": "401: Unauthorized"}を返し、有効なURLに対しては"OK"という単語を返します。URLが有効なのにメッセージが届かない場合は、チャンネルの通知設定を確認してください — Discordはサーバーまたはチャンネルレベルでボットからのメッセージを抑制する場合があります。

数日後にメッセージが停止した — Discordは、ウェブフックが繰り返し4xxエラーを返す場合（例：チャンネルが削除されたため）、それを静かに無効化します。新しいウェブフックを作成し、Elidoに再度追加してください。

Elido配信ログに「Unknown Webhook」エラーが表示される — ウェブフックがDiscordで削除されました。新しいものを作成してください。

メッセージが多すぎる — link.clickedからthreshold.exceededに切り替え、より高い数値を設定します。1日10,000クリックのリンクでは、すべてのクリックを転送するとどのチャンネルも氾濫します。