設定すること
- BotFatherで作成するTelegramボット。トークンはあなたが所有し、Elidoは暗号化して保存します。
- プライベートDMでもグループ（
-100プレフィックス付きのスーパーグループを含む）でも使える、数値のチャットID。 - リンク、ドメイン、使用量上限のアラートに対する、イベントごとの設定。
Elidoは、あなたが作成したボットを通じてTelegramの通知を送信します。ボットは特定のチャット（自分とのプライベートDM、またはグループ）にメッセージを送ります。ボットトークンはあなたが所有し、Elidoは暗号化して保存するだけです。
ステップ1：BotFatherでボットを作成する
- Telegramを開き、
@BotFatherを検索するか、https://t.me/BotFatherを開きます。 /newbotを送信します。- 指示に従い、表示名を選び、次にユーザー名を選びます（
botで終わる必要があります。例：AcmeElidoBot）。 - BotFatherがAPIトークンを返信します。
123456789:AABBccDD...のような形式です。今すぐコピーしてください。あとで/mybotsから取得することもできますが、先にコピーしておくほうが早いです。
ステップ2：チャットIDを調べる
メッセージの送信先となるチャットの、数値のチャットIDが必要です。
DMの場合（自分だけ）：
-
作成したボットに、任意のメッセージを送信します。
-
ブラウザで次のURLを開きます（
TOKENを自分のトークンに置き換えてください）：https://api.telegram.org/botTOKEN/getUpdates -
レスポンスの中から
"chat":{"id":...}を探します。その数字がチャットIDです。個人チャットでは通常、正の9桁の整数です。
グループの場合：
- ボットをグループに追加します。
- グループ内で、ボットに@メンションしたメッセージを送信します（例：
@AcmeElidoBot hello）。 - 上と同じ
getUpdatesのURLを開きます。グループのチャットIDは負の数です（例：-1001234567890）。
ステップ3：Elidoを設定する
- Settings → Notifications → Telegram → Add channelに進みます。
- ボットトークンとチャットIDを貼り付けます。
- Saveをクリックします。Elidoがテストメッセージを送信します。Telegramに2秒以内に届くはずです。
イベントを選ぶ
接続後、Configure eventsをクリックして、メッセージのトリガーとなるイベントを選択します：
link.broken: 最初におすすめのイベント。リンク切れモニターが、動作しなくなった宛先を検出した。usage.threshold_80とusage.threshold_100: ワークスペースがプラン上限の80%または100%を使用した。link.expiredとlink.cap_reached: リンクが期限切れになった、またはクリック上限に達した。link.created: 新しいリンクを把握したい共有ワークスペースで便利です。domain.verifiedとdomain.ssl_failed: カスタムドメインの状態。
イベントタイプの完全な一覧はWebhookガイドにあります。
連携を解除する
Settings → Notifications → Telegram → Removeに進みます。これにより、Elidoのデータベースからボットトークンが削除されます。必要に応じて、BotFatherで /revoke を使ってボット自体も失効させてください。
トラブルシューティング
配信ログに「Unauthorized」と表示される。 トークンが間違っています。次のURLをブラウザに貼り付けて、再確認してください：
https://api.telegram.org/botTOKEN/getMe
{"ok":false,...} が返る場合、トークンは無効です。
「Chat not found」。 チャットIDが間違っているか、ボットがグループに追加されていません。グループの場合は、ボットがメンバーであることを確認し、getUpdates を呼び出す前にボットをメンションしたメッセージを送信してください。
Testをクリックしてもメッセージが届かない。 getUpdates を確認し、ボットが何らかのやり取りを受け取ったかを確かめてください。レスポンスが空の場合、Telegramはユーザー/グループとボットの間のやり取りをまだ記録していません。
グループ内でメッセージが見えない。 Telegramのグループによっては、「スローモード」や管理者のみの投稿が設定されています。ボットを管理者にし、「Post messages」権限を付与してください。