自作bot機能

サーバー内の全テキストチャンネルまたは指定したテキストチャンネルで、登録した文言と完全に一致する投稿が送られたとき、Webhook名義で任意のメッセージを返信できる機能です。ルールはコントロールパネルから作成・変更・解除します。

使い方

手順 内容
1 コントロールパネルで対象サーバーの「自作bot」を開きます。
2 「サーバー内の全テキストチャンネル」または監視するテキストチャンネルを選びます。
3 反応させる文言と返信内容を入力します。
4 必要に応じてWebhook表示名とアイコンURLを設定し、保存します。

引数

項目 必須 説明
適用範囲 はい サーバー内の全テキストチャンネル、または投稿を監視するテキストチャンネル
反応させる文言 はい 投稿内容と完全一致したときに反応する文字列
返信内容 はい Webhookとして送信するメッセージ
Webhook表示名 いいえ 返信時に表示する名前
アイコンURL いいえ 返信時に表示するHTTPS画像URL

応答・返り値

  • 登録済みルールの一覧
  • ルールの保存、変更、解除の完了表示
  • 一致した投稿へのWebhook返信

必要条件・権限

  • ルールを管理するには、対象サーバーの所有者または「管理者」権限が必要です。
  • coldbotには返信する各チャンネルで「Webhookの管理」権限が必要です。サーバー全体のルールでは、反応させるチャンネルすべてに必要です。

制限・仕様

  • 反応は完全一致で判定します。空白、改行、絵文字も一致している必要があります。
  • サーバー全体のルールでも、返信は投稿されたチャンネルへ送信されます。
  • 同じ文言に対してサーバー全体とチャンネル限定のルールがある場合は、チャンネル限定のルールを優先します。
  • BotとWebhookの投稿は反応対象外です。
  • 返信内のメンションは通知されません。
  • 1サーバーにつき最大50ルールまで登録できます。
  • Webhook返信は1サーバーにつき1分間で最大30件です。

使用例

#generalで「おはよう」と投稿されたら、「おはようございます!」と返信するルールを作成します。

項目 設定値
対象チャンネル `#general`
反応させる文言 `おはよう`
返信内容 `おはようございます!`
Webhook表示名 `あいさつbot`

エラー・注意点

  • 反応しない場合は、投稿内容が登録した文言と完全に一致しているか確認してください。
  • 保存できない場合は、対象チャンネルでcoldbotに「Webhookの管理」権限があるか確認してください。
  • アイコンURLには、ブラウザから開けるHTTPS画像のURLを指定してください。

コメント

タイトルとURLをコピーしました