Integraciones de Plataforma

Conecta Discord, Telegram y WhatsApp para publicar automaticamente actualizaciones de RSVP y compartir resumenes de partidos con tu comunidad.

Intermedio
12 minutos

Requisitos Previos

Antes de configurar integraciones, necesitas:

  • Una cuenta de Balla Stats
  • Suscripcion plan PRO o superior
  • Rol de Administrador o Propietario en el grupo
  • Un servidor Discord, grupo de Telegram o cuenta de WhatsApp Business

Limites del plan: FREE = 0 integraciones, PRO = 2, TEAM = 5, ENTERPRISE = 50. Mejora tu plan si necesitas mas integraciones.

Conecta tus Plataformas

Publica automaticamente actualizaciones de RSVP en los canales de tu comunidad cuando los jugadores se registran para partidos. Comparte resumenes formateados para reenvio manual.

Discord

Embeds enriquecidos con actualizaciones de estado RSVP codificadas por color

Telegram

Mensajes formateados con botones de accion en linea

WhatsApp

Mensajes de plantilla a usuarios que optaron via Business API

Lo que Aprenderas
  • Navegar a ajustes de integraciones
  • Configurar webhooks de Discord
  • Configurar integracion de bot de Telegram
  • Configurar WhatsApp Business API
  • Como funciona la publicacion automatica
  • Compartir resumenes de RSVP manualmente
1
Navegar a Integraciones

Ve a la pagina de Ajustes de tu grupo y haz clic en la pestana "Integraciones". Aqui es donde gestionas todas las conexiones de plataforma para tu grupo.

Pagina de ajustes del grupo con pestana de Integraciones resaltada
2
Configurar Discord

Crea un webhook de Discord en los ajustes del canal de tu servidor, luego pega la URL del webhook en Balla Stats. Las actualizaciones de RSVP se publicaran como embeds enriquecidos con indicadores de estado codificados por color.

Campo de entrada de URL de webhook de Discord

Crea el webhook en un canal dedicado (ej., #actualizaciones-de-partidos) para mantener las notificaciones organizadas y evitar desordenar el chat general.

3
Configurar Telegram

Crea un bot usando @BotFather en Telegram, agrega el bot a tu chat de grupo, luego ingresa el token del bot y el ID del chat en Balla Stats. Los mensajes se envian con texto formateado y botones en linea.

Configuracion de token de bot y ID de chat de Telegram

Para obtener tu ID de chat, agrega el bot a tu grupo, envia un mensaje, luego visita https://api.telegram.org/bot<TU_TOKEN>/getUpdates para encontrar el ID del chat.

4
Configurar WhatsApp

Conecta tu cuenta de WhatsApp Business API con tu token de acceso e ID de numero de telefono. Los usuarios deben optar por recibir mensajes. Los mensajes de plantilla se envian para actualizaciones de RSVP.

Formulario de credenciales de WhatsApp Business API
Tarjeta de opt-in de WhatsApp para usuarios

WhatsApp Business API requiere una cuenta Meta Business aprobada y plantillas de mensajes pre-aprobadas. Los usuarios deben optar explicitamente antes de poder recibir mensajes.

5
Como Funciona la Publicacion Automatica

Cuando un jugador se registra o actualiza su estado de RSVP para un partido, el sistema envia automaticamente actualizaciones formateadas a todas las integraciones activas para ese grupo.

Discord

Embeds codificados por color: verde para confirmado, amarillo para tentativo, azul para interesado, gris para declinado, rojo para cancelado.

Telegram

Mensajes formateados en MarkdownV2 con un boton en linea "Ver RSVP" que enlaza a la pagina publica de registro.

WhatsApp

Mensajes de plantilla enviados a usuarios que optaron con detalles del partido, nombre del jugador y estado actualizado.

6
Compartir Resumenes de RSVP

En la pagina de detalle del partido, usa el menu desplegable Compartir para generar resumenes de RSVP formateados para WhatsApp, Telegram, Discord o copiar un enlace compartible. Esto te permite reenviar actualizaciones manualmente a grupos o canales.

Menu desplegable de compartir RSVP con opciones de plataforma
Consejos

Usa Canales Dedicados

Crea un canal o grupo dedicado para actualizaciones de partidos para mantener las notificaciones organizadas y faciles de encontrar.

Prueba Antes de Activar

Usa el boton "Probar" junto a cada integracion para verificar que funciona antes de depender de ella para actualizaciones reales de partidos.

Respeta la Privacidad de WhatsApp

Solo los usuarios que optaron reciben mensajes de WhatsApp. Anima a los usuarios a optar a traves de la pagina de ajustes del grupo.

Desactivacion Automatica por Fallos

Las integraciones se desactivan automaticamente despues de 10 fallos consecutivos de entrega. Revisa y corrige la configuracion, luego vuelve a habilitar.

Problemas Comunes

Mensajes de Telegram No se Envian

  • Verifica que el token del bot sea correcto (obtenerlo de @BotFather)
  • Asegurate de que el bot haya sido agregado al chat de grupo objetivo
  • Verifica que el ID del chat sea correcto (usa la API getUpdates)

Webhook de Discord No Funciona

  • Verifica que la URL del webhook sea valida y no haya expirado
  • Verifica que el webhook no haya sido eliminado del servidor Discord
  • Asegurate de que el canal aun exista y el webhook tenga permiso para publicar

Mensajes de WhatsApp No se Entregan

  • Verifica que tus credenciales de Meta Business API sean correctas
  • Verifica que la plantilla de mensaje haya sido aprobada por Meta
  • Asegurate de que los usuarios hayan optado por recibir mensajes