Docs

Integración para Desarrolladores

Conecta todance.today con Telegram, herramientas de IA y flujos de trabajo automatizados.

Telegram Auto-Post

Premium
Publica automáticamente nuevos eventos en tu canal de Telegram cuando los publiques en todance.today. Requiere una cuenta Premium de organizador.
Paso 1 — Crear un Bot de Telegram
  1. 1. Abre Telegram y busca @BotFather.
  2. 2. Envía /newbot y sigue las instrucciones.
  3. 3. Copia el Token del Bot — tiene este formato: 123456:ABC-DEF...
Paso 2 — Añadir el Bot al Canal
  1. 1. Abre tu canal de Telegram → Administradores → Añadir administrador.
  2. 2. Busca tu bot por nombre de usuario y concede el permiso Publicar mensajes.
  3. 3. Encuentra tu ID de canal: reenvía cualquier mensaje del canal a @userinfobot. El ID empieza con -100...
Paso 3 — Conectar en tu Perfil
  1. 1. Ve a Perfil → Redes sociales y configuración de IA.
  2. 2. Pega tu Token de Bot e ID de Canal.
  3. 3. Activa Auto-publicar en Telegram.
  4. 4. La próxima vez que publiques un evento, se publicará automáticamente.

IA / Integración MCP

Conecta todance.today con Claude Desktop, Cursor o cualquier herramienta de IA compatible con MCP. Crea, actualiza y gestiona eventos simplemente hablando con tu asistente de IA.
Paso 1 — Generar una Clave API
  1. 1. Ve a tu Perfil → Claves API.
  2. 2. Haz clic en Crear nueva clave y asígnale una etiqueta (p. ej. «MCP en casa»).
  3. 3. Copia la clave de inmediato — solo se muestra una vez.
Paso 2 — Instalar Node.jsDescarga e instala Node.js LTS desde nodejs.org (configuración única, no se requiere programar).
Paso 3 — Configurar Claude DesktopAbre el archivo de configuración de Claude Desktop en un editor de texto:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Pega lo siguiente (reemplaza tdapi_TU_CLAVE_AQUÍ con tu clave):
{
  "mcpServers": {
    "todance": {
      "command": "npx",
      "args": ["-y", "todance-mcp"],
      "env": {
        "TODANCE_API_KEY": "tdapi_YOUR_KEY_HERE"
      }
    }
  }
}
Paso 4 — Reiniciar Claude Desktop y ComenzarReinicia Claude Desktop completamente. En la ventana de chat haz clic en el icono +, luego en Conectores encontrarás todance. Haz clic en Gestionar para ver todas las herramientas disponibles.
«Crea una social de Bachata semanal cada viernes en agosto, 20–23h, en Tanzschule Mitte, Torstraße 20 Berlín»
Herramientas de IA disponibles
list_eventsList your upcoming events with stats
create_eventCreate a single or recurring event
update_eventUpdate name, description, or URLs
delete_eventDelete an instance or full series
extend_seriesExtend a recurring series by weeks
get_analyticsViews, registrations, interests
upload_flyerUpload a flyer image, returns flyer_url
list_dancesReference: all valid dance codes

Referencia de la API

Todos los endpoints v1 utilizan Authorization: Bearer tdapi_... — no se requiere sesión.
POST/api/v1/flyerUpload flyer image → returns flyer_url
GET/api/v1/dancesList all dance type codes
GET/api/v1/eventsList own events + instance counts
POST/api/v1/eventsCreate event or series (JSON)
GET/api/v1/events/[id]Event instance detail
PATCH/api/v1/events/[id]Update name / description / URLs
DELETE/api/v1/events/[id]Delete instance (?deleteSeries=true)
POST/api/v1/events/series/[id]/extendExtend series { weeks: 4|8|12|26|52 }
GET/api/v1/analyticsViews, registrations, interests
Volver al inicio