Integrazioni della piattaforma

Collega Discord, Telegram e WhatsApp per pubblicare automaticamente aggiornamenti RSVP e condividere i riepiloghi delle partite con la tua community.

Intermedio
12 minuti

Prerequisiti

Prima di configurare le integrazioni, è necessario:

  • Un account Balla Stats
  • Piano PRO o abbonamento superiore
  • Ruolo di amministratore o proprietario nel gruppo
  • Un server Discord, un gruppo Telegram o un account WhatsApp Business

Limiti del piano: GRATUITO = 0 integrazioni, PRO = 2, TEAM = 5, ENTERPRISE = 50. Aggiorna il tuo piano se hai bisogno di più integrazioni.

Connetti le tue piattaforme

Pubblica automaticamente aggiornamenti RSVP sui canali della tua community quando i giocatori si registrano per le partite. Condividi riepiloghi formattati per l'inoltro manuale.

Discord

Incorporamenti ricchi con aggiornamenti di stato RSVP codificati a colori

Telegram

Messaggi formattati con pulsanti di azione in linea

WhatsApp

Messaggi modello per gli utenti che hanno aderito tramite API Business

Cosa imparerai
  • Passare alle impostazioni delle integrazioni
  • Configura i webhook Discord
  • Configura l'integrazione del bot di Telegram
  • Configura l'API WhatsApp Business
  • Come funziona la pubblicazione automatica
  • Condividi manualmente i riepiloghi RSVP
1
Passare a Integrazioni

Vai alla pagina Impostazioni del tuo gruppo e fai clic sulla scheda "Integrazioni". Qui è dove gestisci tutte le connessioni alla piattaforma per il tuo gruppo.

Pagina delle impostazioni del gruppo con la scheda Integrazioni evidenziata
2
Imposta Discord

Crea un webhook Discord nelle impostazioni del canale del tuo server, quindi incolla l'URL del webhook in Balla Stats. Gli aggiornamenti RSVP verranno pubblicati come rich incorporamenti con indicatori di stato codificati a colori.

Campo di immissione URL webhook Discord

Crea il webhook in un canale dedicato (ad esempio, #match-updates) per mantenere le notifiche organizzate ed evitare di ingombrare la chat generale.

3
Configura Telegram

Crea un bot utilizzando @BotFather su Telegram, aggiungi il bot alla chat di gruppo, quindi inserisci il token del bot e l'ID chat in Balla Stats. I messaggi vengono inviati con testo formattato e pulsanti in linea.

Configurazione del token bot di Telegram e dell'ID chat

Per ottenere il tuo ID chat, aggiungi il bot al tuo gruppo, invia un messaggio, quindi visita https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates per trovare l'ID chat.

4
Configura WhatsApp

Collega il tuo account API WhatsApp Business con il tuo token di accesso e l'ID del numero di telefono. Gli utenti devono attivare la ricezione dei messaggi. I messaggi modello vengono inviati per gli aggiornamenti RSVP.

Modulo credenziali API WhatsApp Business
Carta di attivazione WhatsApp per gli utenti

L'API WhatsApp Business richiede un account Meta Business approvato e modelli di messaggi preapprovati. Gli utenti devono acconsentire esplicitamente prima di poter ricevere i messaggi.

5
Come funziona la pubblicazione automatica

Quando un giocatore si registra o aggiorna il proprio stato RSVP per una partita, il sistema invia automaticamente aggiornamenti formattati a tutte le integrazioni attive per quel gruppo.

Discord

Incorporamenti con codice colore: verde per confermato, giallo per provvisorio, blu per interessato, grigio per rifiutato, rosso per annullato.

Telegram

Messaggi MarkdownV2 formattati con un pulsante in linea "Visualizza RSVP" che collega alla pagina di registrazione pubblica.

WhatsApp

Messaggi modello inviati agli utenti iscritti con dettagli della partita, nome del giocatore e stato aggiornato.

6
Condividi riepiloghi RSVP

Nella pagina dei dettagli della partita, utilizza il menu a discesa Condividi per generare riepiloghi RSVP formattati per WhatsApp, Telegram, Discord o copiare un collegamento condivisibile. Ciò ti consente di inoltrare manualmente gli aggiornamenti a gruppi o canali.

Condividi il menu a discesa RSVP con le opzioni della piattaforma
Suggerimenti

Utilizza canali dedicati

Crea un canale o un gruppo dedicato per gli aggiornamenti sulle partite per mantenere le notifiche organizzate e facili da trovare.

Prova prima di andare in diretta

Utilizza il pulsante "Test" accanto a ciascuna integrazione per verificarne il funzionamento prima di fare affidamento su di esso per aggiornamenti sulle partite reali.

Rispetta la privacy di WhatsApp

Solo gli utenti abilitati ricevono i messaggi WhatsApp. Incoraggia gli utenti ad aderire tramite la pagina delle impostazioni del gruppo.

Disabilitazione automatica in caso di errore

Le integrazioni vengono disabilitate automaticamente dopo 10 errori di consegna consecutivi. Controlla e correggi la configurazione, quindi riattivala.

Problemi comuni

Messaggi di Telegram non inviati

  • Verifica che il token del bot sia corretto (ottienilo da @BotFather)
  • Assicurati che il bot sia stato aggiunto alla chat del gruppo target
  • Controlla che l'ID della chat sia corretto (usa l'API getUpdates)

Il webhook Discord non funziona

  • Verificare che l'URL del webhook sia valido e non scaduto
  • Verifica che il webhook non sia stato eliminato dal server Discord
  • Assicurati che il canale esista ancora e che il webhook abbia l'autorizzazione per pubblicare

Messaggi WhatsApp non consegnati

  • Verifica che le tue credenziali API Meta Business siano corrette
  • Verifica che il modello del messaggio sia stato approvato da Meta
  • Assicurati che gli utenti abbiano acconsentito a ricevere messaggi