プラットフォームの統合
Discord、Telegram、WhatsApp に接続すると、RSVP アップデートが自動的に投稿され、試合の概要がコミュニティと共有されます。
前提条件
統合を設定する前に、以下が必要です。
- Balla Stats アカウント
- PRO プラン以上のサブスクリプション
- グループ内の管理者または所有者の役割
- Discord サーバー、Telegram グループ、または WhatsApp Business アカウント
プランの制限: FREE = 0 の統合、PRO = 2、TEAM = 5、ENTERPRISE = 50。さらに多くの統合が必要な場合は、プランをアップグレードしてください。
プレイヤーが試合に登録すると、コミュニティ チャンネルに RSVP 更新情報が自動的に投稿されます。手動転送用にフォーマットされた概要を共有します。
Discord
色分けされた RSVP ステータス更新を含む豊富な埋め込み
Telegram
インラインアクションボタンを備えたフォーマット済みメッセージ
ビジネス API を介したオプトイン ユーザーへのテンプレート メッセージ
- 統合設定に移動します
- Discord Webhook を設定する
- Telegram ボット統合のセットアップ
- WhatsApp ビジネス API をセットアップする
- 自動投稿の仕組み
- 出欠確認の概要を手動で共有する
グループの設定ページに移動し、「統合」タブをクリックします。ここで、グループのすべてのプラットフォーム接続を管理します。
サーバーのチャネル設定で Discord Webhook を作成し、その Webhook URL を Balla Stats に貼り付けます。 RSVP 更新は、色分けされたステータス インジケーターを備えたリッチな埋め込みとして投稿されます。
専用チャネル (#match-updates など) で Webhook を作成して、通知を整理し、一般的なチャットが乱雑になるのを防ぎます。
Telegram で @BotFather を使用してボットを作成し、そのボットをグループ チャットに追加して、Balla Stats にボット トークンとチャット ID を入力します。メッセージは、書式設定されたテキストとインライン ボタンを使用して送信されます。
チャット ID を取得するには、ボットをグループに追加してメッセージを送信し、https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates にアクセスしてチャット ID を見つけます。
WhatsApp Business API アカウントをアクセス トークンと電話番号 ID に接続します。ユーザーはメッセージを受信するにはオプトインする必要があります。 RSVP 更新のためにテンプレート メッセージが送信されます。
WhatsApp Business API には、承認されたメタ ビジネス アカウントと事前承認されたメッセージ テンプレートが必要です。ユーザーはメッセージを受信する前に明示的にオプトインする必要があります。
プレーヤーが試合の RSVP ステータスを登録または更新すると、システムはそのグループのすべてのアクティブな統合にフォーマットされた更新を自動的に送信します。
Discord
色分けされた埋め込み: 緑色は確認済み、黄色は暫定、青色は興味あり、灰色は拒否、赤色はキャンセル。
Telegram
公開登録ページにリンクするインラインの「View RSVP」ボタンを備えた、フォーマットされた MarkdownV2 メッセージ。
試合の詳細、プレーヤー名、更新されたステータスを含む、オプトインしたユーザーに送信されるテンプレート メッセージ。
試合の詳細ページで、[共有] ドロップダウンを使用して、WhatsApp、Telegram、Discord の書式設定された RSVP 概要を生成するか、共有可能なリンクをコピーします。これにより、更新をグループまたはチャネルに手動で転送できます。
専用チャネルを使用する
試合更新専用のチャンネルまたはグループを作成して、通知を整理して見つけやすくします。
本番稼働前にテストする
実際の一致の更新に依存する前に、各統合の横にある [テスト] ボタンを使用して、機能することを確認します。
WhatsAppのプライバシーを尊重する
オプトインしたユーザーのみが WhatsApp メッセージを受信します。ユーザーにグループ設定ページからオプトインするよう促します。
失敗時に自動無効化
配信が 10 回連続して失敗すると、統合は自動的に無効になります。構成を確認して修正し、再度有効にします。
電報メッセージが送信されない
- ボット トークンが正しいことを確認します (@BotFather から取得します)。
- ボットがターゲット グループ チャットに追加されていることを確認します
- チャット ID が正しいことを確認します (getUpdates API を使用します)。
Discord Webhook が機能しない
- Webhook URL が有効であり、有効期限が切れていないことを確認します。
- WebhookがDiscordサーバーから削除されていないことを確認してください
- チャネルがまだ存在し、Webhook に投稿権限があることを確認してください。
WhatsApp メッセージが配信されない
- Meta Business API 認証情報が正しいことを確認してください
- メッセージテンプレートがメタによって承認されていることを確認してください
- ユーザーがメッセージの受信をオプトインしていることを確認する