Docs

Entwickler-Integration

Verbinde todance.today mit Telegram, KI-Tools und automatisierten Workflows.

Telegram Auto-Post

Premium
Neue Events automatisch in deinem Telegram-Kanal posten, wenn du sie auf todance.today veröffentlichst. Erfordert ein Premium-Organizer-Konto.
Schritt 1 — Telegram-Bot erstellen
  1. 1. Öffne Telegram und suche nach @BotFather.
  2. 2. Sende /newbot und folge den Anweisungen.
  3. 3. Kopiere den Bot-Token — er sieht so aus: 123456:ABC-DEF...
Schritt 2 — Bot zum Kanal hinzufügen
  1. 1. Öffne deinen Telegram-Kanal → Administratoren → Administrator hinzufügen.
  2. 2. Suche nach deinem Bot und erteile die Berechtigung Nachrichten posten.
  3. 3. Finde deine Kanal-ID: Leite eine Nachricht aus dem Kanal an @userinfobot weiter. Die ID beginnt mit -100...
Schritt 3 — Im Profil verbinden
  1. 1. Gehe zu Profil → Social Media & KI-Einstellungen.
  2. 2. Füge Bot-Token und Kanal-ID ein.
  3. 3. Aktiviere Auto-Post an Telegram.
  4. 4. Beim nächsten Event wird es automatisch gepostet.

KI / MCP-Integration

Verbinde todance.today mit Claude Desktop, Cursor oder einem anderen MCP-fähigen KI-Tool. Erstelle, bearbeite und verwalte Events einfach per Spracheingabe.
Schritt 1 — API-Schlüssel erstellen
  1. 1. Gehe zu Profil → API-Schlüssel.
  2. 2. Klicke auf Neuen Schlüssel erstellen und vergib ein Label (z. B. „Zuhause MCP").
  3. 3. Kopiere den Schlüssel sofort — er wird nur einmal angezeigt.
Schritt 2 — Node.js installierenLade Node.js LTS von nodejs.org herunter und installiere es (einmalige Einrichtung, kein Code erforderlich).
Schritt 3 — Claude Desktop konfigurierenÖffne die Claude Desktop-Konfigurationsdatei in einem Texteditor:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Füge folgendes ein (ersetze tdapi_DEIN_KEY_HIER mit deinem Schlüssel):
{
  "mcpServers": {
    "todance": {
      "command": "npx",
      "args": ["-y", "todance-mcp"],
      "env": {
        "TODANCE_API_KEY": "tdapi_YOUR_KEY_HERE"
      }
    }
  }
}
Schritt 4 — Claude Desktop neu starten & loslegenStarte Claude Desktop komplett neu. Im Chatfenster auf das + Symbol klicken, dort unter Konnektoren erscheint todance. Über Verwalten kannst du alle verfügbaren Tools einsehen.
„Erstelle ein wöchentliches Bachata-Event jeden Freitag im August, 20–23 Uhr, im Tanzschule Mitte, Torstraße 20 Berlin"
Verfügbare KI-Tools
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

API-Referenz

Alle v1-Endpunkte verwenden Authorization: Bearer tdapi_... — kein Login erforderlich.
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
Zurück zur Startseite