BotShadeTwitch 配信通知
Twitch 配信通知は、登録した Twitch の配信者が配信を始めると、サーバーのチャンネルへお知らせする機能です。アドオンのため、インストールしてから使います。現在はベータ版です。
配信者の登録と設定は、ダッシュボードの「サーバー別」タブでサーバーごとに行うほか、Discord 上の /twitch コマンドでも行えます。
配信者ごとの設定
| 設定項目 | 内容 |
|---|---|
| 「投稿先チャンネル」 | 未設定のあいだは、その配信者の通知は送信されません。 |
| 「メンションするロール」 | 最大 5 つまで選べます。鳴らすのは配信開始の投稿だけです。 |
| 「配信開始を通知する」 | 既定はオンです。 |
| 「配信終了を反映する」「タイトル・カテゴリの変更を反映する」 | 既定はオフです。終了・変更の反映をご覧ください。 |
| 絞り込み | 「タイトルに含む語」「除外する語」「通知しない時間帯」(日本時間)で、通知する配信を絞り込めます。絞り込みはダッシュボードでのみ設定でき、/twitch settings には含まれません。 |
終了・変更の反映
終了と変更は、配信者ごとの「配信終了を反映する」「タイトル・カテゴリの変更を反映する」をオンにした場合だけ知らせます。
タイトル・カテゴリの変更は、配信開始の投稿を書き換えて知らせます。配信の終了の知らせ方は、「メッセージ」の配信終了の欄にある「配信終了を新しい投稿として送る」でサーバーごとに選べます(既定はオフ)。
| 「配信終了を新しい投稿として送る」 | 配信の終了 |
|---|---|
| オフ | 配信開始の投稿を終了の文面に書き換えます。 |
| オン | 終了の文面を新しく投稿します。開始の投稿が見つからない場合(未送信・削除済み)も投稿します。 |
開始の投稿が無い配信(登録する前に始まっていた配信など)では、変更と、オフのときの終了は反映されません。
メッセージの文面
配信開始と配信終了の文面は、サーバーごとに編集できます。メンションは、配信者ごとの「メンションするロール」が本文の先頭に自動で付きます。文面にロールや @everyone を書いても鳴りません。
文面では次の変数を使えます。
| 変数 | 内容 |
|---|---|
{Twitch.streamerName} | 配信者の表示名 |
{Twitch.streamerLogin} | 配信者のユーザー名 |
{Twitch.url} | 配信ページの URL |
{Twitch.title} | 配信のタイトル |
{Twitch.category} | 配信のカテゴリ |
{Twitch.startedAt} | 配信の開始日時 |
{Twitch.startedAtRelative} | 配信の開始日時(「3 分前」のような相対表示) |
{Twitch.endedAt} | 配信の終了日時 |
{Twitch.duration} | 配信時間(例: 1 時間 9 分) |
{Twitch.status} | 配信中 または 配信終了 |
コマンド一覧
いずれも既定で「サーバー管理」権限が必要です。変更するときはコマンド権限設定の使い方をご覧ください。
| コマンド | 動作 |
|---|---|
/twitch add | 配信者を登録し、投稿先チャンネルとメンションするロール(任意)を設定します。 |
/twitch remove | 登録した配信者を削除します。 |
/twitch list | 登録済みの配信者と通知の状態を表示します。 |
/twitch settings | 配信者ごとに、通知のオン・オフ、投稿先、メンション、通知の種類を切り替えます。 |
登録できる配信者の数
登録できる配信者の数は、プランごとに Bot 全体で数えます。同じ配信者を複数のサーバーで登録しても 1 人と数えます。
| Free | Plus | Pro | Max |
|---|---|---|---|
| 3 人 | 10 人 | 30 人 | 100 人 |
上限に達していると、/twitch add では新しい配信者を登録できません。
ダッシュボードからの登録やプランを下げたことで上限を超えた場合は、登録の古い順に上限まで通知し、新しく登録した配信者から通知が止まります。止まった配信者は状態が「上限超過」になりますが、登録は消えません。プランを上げると、自動的に「有効」に戻ります。「見つかりません」「確認中」など、有効でない登録は数に含みません。
注意点
- 登録した時点ですでに始まっている配信は通知されません。次の配信から通知されます。
- 配信者がユーザー名を変更しても、通知は続きます。配信者のアカウントが停止または削除されると、通知は止まります。
うまくいかないとき
- Bot が投稿先チャンネルで「チャンネルを見る」「メッセージを送信」「埋め込みリンク」「メッセージ履歴を読む」の権限を持っている必要があります。
- メンションが鳴らないときは、そのロールの「このロールに対して@mentionを許可する」を有効にするか、Bot に「@everyone、@here、全てのロールにメンション」権限を付けてください。
関連ページ
- モジュールの基本と共通操作 — アドオンのインストールとアンインストール
- コマンド権限設定の使い方 — コマンドを使えるロールや権限の設定
最終更新: