アナウンス

翻訳ボタン付きのアナウンスを投稿できます。すべてのサーバーで無料です。

アナウンスとは、下に最大 5 個の翻訳ボタンが付いたメッセージです。メンバーがボタンをクリックすると、自分だけに表示される返信で、その言語に翻訳されたアナウンスを読めます。

仕組み

ボタンはサーバー全体で一度だけ設定します。言語、ラベル・絵文字またはその両方、そして色（ブラープル、グレー、緑、赤）を指定します。
最大 {max} 個のボタンを、この順番ですべてのアナウンスの下に表示します。各ボタンはアナウンスをその言語に翻訳します。同じ言語を 2 つのボタンに設定することはできません。
クリックすると、アナウンスのテキストと埋め込みが翻訳されます。添付ファイルは翻訳されません。
返信モードでは、元のメッセージが編集された後でも、クリックすると常に現在のテキストが翻訳されます。
アナウンスはすべてのサーバーで無料で、1 日 3 件まで投稿できます。

アナウンスを投稿する 4 つの方法

ダッシュボードの「作成」タブ: メッセージを書き、プレビューを確認して送信します。
外部ウェブフック: Discord のウェブフックに投稿できるツールなら何でも使える URL です。
既存のメッセージに対するコンテキストコマンド。
アナウンスチャンネル: そこに投稿されたメッセージはすべてアナウンスになります。

作成

ダッシュボードの「作成」タブ: メッセージを書き、プレビューを確認して送信します。

形式を「コンテナ」に切り替えると、Components V2 カードを投稿できます：テキスト、区切り線、セクション（右側にリンクボタンまたは画像を置いたテキスト）、メディアギャラリー、リンクボタンに、任意でアクセントカラーを付けられます。画像にはリンクか添付ファイルを使えます。カードで使わない添付ファイルはカードの下に表示されます。

どちらの形式でも、アナウンスには独自のリンクボタンを最大 5 個付けられます。翻訳ボタンの上の専用の列に表示されます。

外部ウェブフック

ウェブフック URL を使うと、他のツールやサービスから 1 つのチャンネルにボタン付きのアナウンスを投稿できます。

この URL は Discord のウェブフックと同じリクエストを受け付けます。Discord のウェブフックに投稿できるツールなら、アナウンスも投稿できます。ツールで Discord のウェブフック URL を求められたら、この URL を貼り付けてください。

メッセージを送信:

curl -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello everyone!"}'

ファイル付きのメッセージを送信:

curl -X POST "$WEBHOOK_URL" \
  -F 'payload_json={"content": "New screenshots"}' \
  -F 'files[0][email protected]'

Components V2 メッセージを送信:

curl -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"flags": 32768, "components": [{"type": 17, "components": [{"type": 10, "content": "## Patch notes"}, {"type": 14}, {"type": 9, "components": [{"type": 10, "content": "..."}], "accessory": {"type": 2, "style": 5, "label": "Changelog", "url": "https://example.com"}}]}]}'

Components V2 メッセージにも対応しています：flags を 32768 に設定し、テキスト、区切り線、セクション、メディアギャラリー、リンクボタンの列で構成したコンテナを送信してください。画像は attachment:// にファイル名を続けることで、アップロードしたファイルを指定できます。リンクボタンは 1 メッセージにつき最大 5 個です。それ以外のボタンやセレクトメニューは拒否されます：ボットが最後の列に独自の翻訳ボタンを追加するためです。

リクエストで username や avatar_url を送ると、そのメッセージに限り、Webhook に保存された名前とアバターの代わりに使われます。

アナウンスに変換

メッセージを右クリック（モバイルでは長押し）して「アプリ」を開き、アナウンスに変換 を選びます。表示されるのはメッセージを管理できるメンバーだけです。すでにアナウンスになっているメッセージは変換できません。

アナウンスチャンネル

これらのチャンネルにメンバーが投稿したメッセージは、すべて自動的にアナウンスになります。1 日の上限に達すると、メッセージはそのまま残ります。

モード

コンテキストコマンドとアナウンスチャンネルは、3 つのモードのいずれかで既存のメッセージをアナウンスに変換します。サーバーのデフォルトがすべての場所に適用され、アナウンスチャンネルごとに上書きできます。

項目	説明
自動	ボットが投稿者の名前とアバターでメッセージをボタン付きで再投稿し、元のメッセージを削除します。再投稿できない場合（返信、スタンプ、投票、大きすぎるファイルなど）は、代わりにボタン付きで返信します。
返信のみ	メッセージはそのまま残り、ボットがボタン付きで返信します。メッセージを削除すると返信も削除されます。
再投稿のみ	メッセージは常に再投稿されます。再投稿できない場合は変換されず、エラーが表示されます。

プレミアム翻訳文字数

ボタンのクリックを、無料エンジンではなくこのサーバーのプレミアムエンジンで翻訳します。料金は 1 つのアナウンスにつき言語ごとに 1 回だけで、翻訳は 90 日間保存されるため、その後のクリックは無料です。文字数がなくなると無料エンジンに切り替わります。

アナウンスが編集されると、翻訳は一度だけやり直されます。プレミアム翻訳に失敗した場合は、代わりに無料エンジンが応答します。

1 日の上限

どの方法で投稿されたかにかかわらず、各サーバーは 1 日に 3 件までアナウンスを投稿できます。カウンターは UTC の午前 0 時にリセットされます。

「作成」タブと外部ウェブフック: アナウンスはエラーで拒否されます。
コンテキストコマンド: 上限がリセットされる時刻がエラーで表示されます。
アナウンスチャンネル: メッセージは通知なしでそのまま残ります。

コマンド

すべての設定は Discord からも行えます。これらのコマンドはモデレーター専用です。

項目	説明
`/アナウンスボタン設定`	翻訳ボタンを追加または置き換えます。
`/アナウンスボタン削除`	翻訳ボタンを削除します。
`/アナウンスチャンネル追加`	チャンネルのすべてのメッセージをアナウンスにします。
`/アナウンスチャンネル削除`	チャンネルのメッセージを自動でアナウンスにするのを停止します。
`/アナウンスモード`	翻訳ボタンのデフォルトの追加方法を選択します。
`/アナウンス premium翻訳`	クリック時の翻訳に、無料エンジンではなくプレミアムエンジンを使用します。
`/アナウンス返信テキスト`	返信でボタンを追加するときに、ボタンの上に表示するテキストを設定します。
`/アナウンス表示`	このサーバーのアナウンス設定を表示します。

スラッシュコマンド

/アナウンス ボタン 設定
/アナウンス ボタン 削除
/アナウンス チャンネル 追加
/アナウンス チャンネル 削除
/アナウンス モード
/アナウンス premium翻訳
/アナウンス 返信テキスト
/アナウンス 表示