ElidoをDiscordに接続する

ElidoはIncoming Webhook経由でDiscordに投稿します。Botアカウントは不要で、Webhookの作成以外にサーバー権限も要りません。メッセージを受け取るチャンネルを正確に指定できます。

始める前に

DiscordサーバーでManage Webhooks権限が必要です。サーバー管理者は既定でこの権限を持っています。管理者でない場合は、管理者にWebhookの作成とURLのコピーを依頼してください。

DiscordのWebhookを作成する

1. Discordで、アラートを受け取りたいチャンネルを右クリックし、Edit Channelをクリックします。
2. Integrations → Webhooks → New Webhookに進みます。
3. 名前（「Elido」）を付け、必要に応じてアバターを設定します。
4. Copy Webhook URLをクリックします。https://discord.com/api/webhooks/1234.../AbcD... のような形式です。

ElidoにWebhookを追加する

1. Settings → Notifications → Add channel → Discordを開きます。
2. WebhookのURLを貼り付けます。
3. Saveをクリックします。Elidoはすぐにテストメッセージを投稿します。2〜3秒以内にDiscordに表示されるはずです。

転送するイベントを選ぶ

保存後、Configure eventsをクリックします。チャンネルごとに、次の各イベントを有効または無効にできます：

• link.created: ワークスペースでリンクが作成された。
• link.expired: リンクが有効期限に達した。
• link.cap_reached: リンクがクリック上限に達した。
• link.broken: リンク切れモニターが、動作しなくなった宛先を検出した。
• domain.verified と domain.ssl_failed: カスタムドメインの検証と証明書の問題。
• usage.threshold_80 と usage.threshold_100: ワークスペースがプラン上限の80%または100%を使用した。

イベントタイプの完全な一覧はWebhookガイドにあります。

Discordの各メッセージは、イベントタイプ、タイトル、イベントのフィールド、重大度に応じた色（作成は緑、更新は青、失敗は赤）を持つEmbedとして届きます。

Embedのペイロードは次のようになります：

{
  "username": "Elido",
  "embeds": [
    {
      "title": "Link expired",
      "description": "elido.me/spring-2026",
      "color": 15680580
    }
  ]
}

連携を解除する

Discordで Webhook を削除する（Channel Settings → Integrations → Webhooks → Delete）か、Elidoでチャンネルを削除します（Settings → Notifications → Discord → Remove）。どちらでも配信は停止します。

トラブルシューティング

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

数日後にメッセージが止まった。 Discordは、Webhookが繰り返し4xxを返す（例：チャンネルが削除された）場合、通知なしに無効化します。新しいWebhookを作成し、Elidoに追加し直してください。

Elidoの配信ログに「Unknown Webhook」エラーが出る。 DiscordでWebhookが削除されています。新しく作成してください。

メッセージが多すぎる。 Configure eventsを開き、不要なイベントをオフにしてください。DiscordはWebhookをチャンネルあたり毎分約30メッセージにレート制限するため、専用のアラートチャンネルを使うことをおすすめします。