TelegramをElidoに接続する

Elidoはユーザーが作成したボットを通じてTelegram通知を送信します。ボットは特定のチャット（自分とのプライベートDMまたはグループ）にメッセージを送ります。ボットトークンはユーザーが所有し、Elidoは暗号化した状態でのみ保存します。

ステップ1 — BotFatherでボットを作成する#

1. Telegramを開いて @BotFather を検索するか、https://t.me/BotFather にアクセスします。
2. /newbot を送信します。
3. 手順に従い、表示名を選択してからユーザー名を選択します（bot で終わる必要があります、例：AcmeElidoBot）。
4. BotFatherがAPIトークンを返信します。123456789:AABBccDD... のような形式です。今すぐコピーしてください。後で /mybots から取得できますが、今コピーする方が手間が省けます。

ステップ2 — chat IDを確認する#

メッセージを送る場所のチャットIDが必要です。

DM（自分のみ）の場合：

1. 新しいボットに任意のメッセージを送ります。

2. ブラウザでこのURLを開きます（TOKEN を自分のトークンに置き換えてください）：

   https://api.telegram.org/botTOKEN/getUpdates
   

3. レスポンスで "chat":{"id":...} を探します。その数字がchat IDです。個人チャットの場合は通常9桁の正の整数です。

グループの場合：

1. ボットをグループに追加します。
2. グループでボットを@-メンションするメッセージを送ります（例：@AcmeElidoBot hello）。
3. 上記の同じ getUpdates URLを開きます。グループチャットIDは負の数です（例：-1001234567890）。

ステップ3 — Elidoを設定する#

1. Settings → Notifications → Telegram → Add channel に移動します。
2. ボットトークンとchat IDを貼り付けます。
3. Save をクリックします。Elidoはテストメッセージを送信します。2秒以内にTelegramに届きます。

イベントを選ぶ#

接続後、Configure events をクリックして、どのイベントがメッセージを送信するか選択します：

• threshold.exceeded — 推奨の開始点。
• scan.failed — 自分がコントロールしていない宛先の任意のリンクに直ちに役立ちます。
• link.created — 新規リンクの可視性が必要な共有ワークスペースに便利。

インテグレーションを削除する#

Settings → Notifications → Telegram → Remove に移動します。これによりElidoのデータベースからボットトークンが削除されます。必要に応じてBotFatherで /revoke を使ってボット自体を失効させることもできます。

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

配信ログに「Unauthorized」 — トークンが間違っています。https://api.telegram.org/botTOKEN/getMe をブラウザに貼り付けて確認してください。{"ok":false,...} が返される場合、トークンは無効です。

「Chat not found」 — chat IDが間違っているか、ボットがグループに追加されていません。グループの場合は、ボットがメンバーであることを確認し、getUpdates を呼び出す前にボットをメンションするメッセージを送ってください。

Testをクリックしてもメッセージが届かない — getUpdates を確認してボットが何らかのインタラクションを受け取っているかチェックしてください。レスポンスが空の場合、Telegramはまだユーザー/グループとボットの間の接触を記録していません。

グループのメッセージが見えない — 一部のTelegramグループには「スロウモード」または管理者のみが投稿できる設定があります。ボットを「メッセージの投稿」権限付きの管理者にしてください。