Platform Integrations
Connect Discord, Telegram, and WhatsApp to automatically post RSVP updates and share match summaries with your community.
Prerequisites
Before setting up integrations, you need:
- A Balla Stats account
- PRO plan or higher subscription
- Admin or Owner role in the group
- A Discord server, Telegram group, or WhatsApp Business account
Plan limits: FREE = 0 integrations, PRO = 2, TEAM = 5, ENTERPRISE = 50. Upgrade your plan if you need more integrations.
Automatically post RSVP updates to your community channels when players register for matches. Share formatted summaries for manual forwarding.
Discord
Rich embeds with color-coded RSVP status updates
Telegram
Formatted messages with inline action buttons
Template messages to opted-in users via Business API
- Navigate to integrations settings
- Set up Discord webhooks
- Set up Telegram bot integration
- Set up WhatsApp Business API
- How auto-posting works
- Share RSVP summaries manually
Go to your group's Settings page and click the "Integrations" tab. This is where you manage all platform connections for your group.
Create a Discord webhook in your server's channel settings, then paste the webhook URL into Balla Stats. RSVP updates will be posted as rich embeds with color-coded status indicators.
Create the webhook in a dedicated channel (e.g., #match-updates) to keep notifications organized and avoid cluttering general chat.
Create a bot using @BotFather on Telegram, add the bot to your group chat, then enter the bot token and chat ID in Balla Stats. Messages are sent with formatted text and inline buttons.
To get your chat ID, add the bot to your group, send a message, then visit https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates to find the chat ID.
Connect your WhatsApp Business API account with your access token and phone number ID. Users must opt in to receive messages. Template messages are sent for RSVP updates.
WhatsApp Business API requires an approved Meta Business account and pre-approved message templates. Users must explicitly opt in before they can receive messages.
When a player registers or updates their RSVP status for a match, the system automatically sends formatted updates to all active integrations for that group.
Discord
Color-coded embeds: green for confirmed, yellow for tentative, blue for interested, gray for declined, red for cancelled.
Telegram
Formatted MarkdownV2 messages with an inline "View RSVP" button linking to the public registration page.
Template messages sent to opted-in users with match details, player name, and updated status.
On the match detail page, use the Share dropdown to generate formatted RSVP summaries for WhatsApp, Telegram, Discord, or copy a shareable link. This lets you manually forward updates to groups or channels.
Use Dedicated Channels
Create a dedicated channel or group for match updates to keep notifications organized and easy to find.
Test Before Going Live
Use the "Test" button next to each integration to verify it works before relying on it for real match updates.
Respect WhatsApp Privacy
Only opted-in users receive WhatsApp messages. Encourage users to opt in through the group settings page.
Auto-Disable on Failure
Integrations are automatically disabled after 10 consecutive delivery failures. Check and fix the configuration, then re-enable.
Telegram Messages Not Sending
- Verify the bot token is correct (get it from @BotFather)
- Ensure the bot has been added to the target group chat
- Check that the chat ID is correct (use the getUpdates API)
Discord Webhook Not Working
- Verify the webhook URL is valid and not expired
- Check that the webhook has not been deleted from the Discord server
- Ensure the channel still exists and the webhook has permission to post
WhatsApp Messages Not Delivering
- Verify your Meta Business API credentials are correct
- Check that the message template has been approved by Meta
- Ensure users have opted in to receive messages