🤖 Telegram Bot

PulseHub は Bot API を介して Telegram に接続します。ユーザーが Telegram ボットにメッセージを送信すると、そのメッセージが PulseHub に表示されます。

---

前提条件

Telegram アカウントと、ボットを作成するための @BotFather へのアクセス。

---

セットアップ手順

1. BotFather でボットを作成

1. Telegram を開き、@BotFather を検索します
2. /newbot を送信します
3. 表示名を選択します（例：「Acme サポート」）
4. bot で終わるユーザー名を選択します（例：acmesupport_bot）
5. BotFather が Bot Token を返信します

2. PulseHub でチャネルを追加

1. Channels → Add Channel に移動
2. Telegram を選択
3. Bot Token を貼り付けます
4. Save Channel をクリック
5. Webhook URL をコピー

3. Telegram に Webhook を登録

ブラウザで以下の URL を開きます：

https://api.telegram.org/bot{YOUR_BOT_TOKEN}/setWebhook?url={YOUR_PULSEHUB_WEBHOOK_URL}

Telegram は次のように応答します：{"ok": true, "result": true, "description": "Webhook was set"}

4. テスト

Telegram でボットを開いてメッセージを送信します。数秒以内に PulseHub に表示されるはずです。

---

Telegram の Webhook 要件

• Webhook URL は有効な SSL 証明書を持つ HTTPS を使用する必要があります
• Telegram は 60 秒以内に 200 レスポンスを期待します

---

よくある問題

症状	考えられる原因
Webhook が設定されていない	URL は有効な証明書を持つ HTTPS である必要があります
ボットが応答しない	telegram_chat_id が contacts.external_ids にあるか確認してください
古いメッセージが再配信される	Webhook 再登録時の正常な動作です