Telegram連携

フィードバックに注意が必要なときに、Telegramでメッセージを受け取れます。VoxtricsからTelegramへの投稿はアラートを通じて行われます。アラートは、たとえば「1時間以内に評価2以下が3件以上」のように、届いた回答を監視するルールです。メッセージは自分で作成したTelegramボットから、選んだチャット（グループ、チャンネル、またはボットとの個人チャット）に届きます。Voxtricsに必要なのは、ボットのトークンとチャットのIDの両方を含む1つのアドレスです。

ボットを作成する

  1. Telegramで@BotFatherを開き、/newbotを送信します。
  2. ボットに名前（例：Voxtrics alerts）と、botで終わるユーザー名を付けます。
  3. BotFatherから、123456789:AAHf0x... のような形式のボットのトークンが届きます。これをコピーします。

ボットをチャットに追加する

  • グループ： ボットをメンバーとして追加します。
  • チャンネル： メッセージの投稿を許可した管理者としてボットを追加します。
  • 個人チャット： ボットを開いてStart（「開始」）を押します。ボットは、自分を開始していない相手にはメッセージを送れません。

次に、そのチャットで何かメッセージを送信してください。次の手順でTelegramが表示する情報になります。

チャットのIDを調べる

  1. YOUR_TOKENを自分のトークンに置き換えて、次のアドレスをブラウザで開きます。

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

  2. 応答の中から"chat":{"id":を探し、その後の数字をコピーします。グループやチャンネルのIDは -1001234567890 のようにマイナス記号で始まります。マイナス記号も含めてください。

応答が空（"result":[]）の場合は、チャットでもう一度メッセージを送ってから、ページを再読み込みしてください。Telegramはこの情報を24時間しか保持しません。

アラートをTelegramに送る

  1. トークンとチャットのIDを次のアドレスに入れます。

    https://api.telegram.org/botYOUR_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID

  2. アラートを開き、新しいアラート、または既存のルールの鉛筆アイコン（編集）をクリックします。

  3. アラートの説明に従って、ルールの名前、対象範囲、時間枠、条件を設定します。

  4. 通知方法でTelegramを選び、TelegramのWebhook URLにアドレスを貼り付けます。

  5. アラートを作成、既存のルールの場合は変更を保存をクリックします。

アドレスは、そこで指定したチャットにだけ投稿します。同じアラートを別のチャットでも受け取るには、そのチャット用のアドレスを作成し、Telegramのチャットを追加でルールに追加してください。複数のルールで同じアドレスを使うこともできます。

メッセージの内容

ルールが発生するたびに、チャットには英語の短いテキストメッセージが届きます。ルールの名前、ドメイン、時間枠内で条件に一致した回答の数、ルールが発生した理由が含まれます。回答そのものは含まれません。回答を確認するには、アラートで該当する発生を開いてください。

ルールが発生するのは最大で30分に1回で、再発生間隔を設定した場合はそれより少なくなります。1つのスペースのアラートからTelegramとSlackに投稿されるメッセージは、合わせて1日最大200件です。それを超えてもルールは発生し、その発生は「アラート」に表示されますが、何も投稿されません。

メッセージが届かない場合

  • アラートが保存されない場合は、アドレスが https://api.telegram.org/ で始まっているか確認してください。Voxtricsが受け付けるのはTelegramのBot APIのアドレスだけで、チャットやボットへのt.meリンクは受け付けません。
  • ルールが有効になっていて、発生しているかを確認してください。すべての発生はアラートに一覧表示されます。
  • ルールが発生しているのにTelegramに何も届かない場合は、ボットがまだチャットにいるか（チャンネルでは管理者か）、チャットのIDにマイナス記号が残っているか、トークンが取り消されていないかを確認してください。Telegramがグループをスーパーグループに変えると、IDが変わります。IDを調べ直して、アドレスを更新してください。