Docs

Intégration Développeur

Connecte todance.today à Telegram, aux outils IA et aux workflows automatisés.

Telegram Auto-Post

Premium
Publie automatiquement de nouveaux événements sur ta chaîne Telegram lorsque tu les publies sur todance.today. Nécessite un compte organisateur Premium.
Étape 1 — Créer un Bot Telegram
  1. 1. Ouvre Telegram et recherche @BotFather.
  2. 2. Envoie /newbot et suis les instructions.
  3. 3. Copie le Token du Bot — il ressemble à : 123456:ABC-DEF...
Étape 2 — Ajouter le Bot à la Chaîne
  1. 1. Ouvre ta chaîne Telegram → Administrateurs → Ajouter un administrateur.
  2. 2. Recherche ton bot par nom d'utilisateur et accorde la permission Publier des messages.
  3. 3. Trouve l'ID de ta chaîne : transfère un message de la chaîne à @userinfobot. L'ID commence par -100...
Étape 3 — Connecter dans ton Profil
  1. 1. Va dans Profil → Paramètres Réseaux Sociaux et IA.
  2. 2. Colle ton Token de Bot et l'ID de la Chaîne.
  3. 3. Active Auto-publier sur Telegram.
  4. 4. La prochaine fois que tu publieras un événement, il sera posté automatiquement.

IA / Intégration MCP

Connecte todance.today à Claude Desktop, Cursor ou tout outil IA compatible MCP. Crée, modifie et gère des événements simplement en parlant à ton assistant IA.
Étape 1 — Générer une Clé d'API
  1. 1. Va dans ton Profil → Clés API.
  2. 2. Clique sur Créer une nouvelle clé et donne-lui un nom (ex. : « MCP maison »).
  3. 3. Copie la clé immédiatement — elle n'est affichée qu'une seule fois.
Étape 2 — Installer Node.jsTélécharge et installe Node.js LTS depuis nodejs.org (configuration unique, aucune programmation requise).
Étape 3 — Configurer Claude DesktopOuvre le fichier de configuration de Claude Desktop dans un éditeur de texte :
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Colle ce qui suit (remplace tdapi_TA_CLE_ICI par ta clé) :
{
  "mcpServers": {
    "todance": {
      "command": "npx",
      "args": ["-y", "todance-mcp"],
      "env": {
        "TODANCE_API_KEY": "tdapi_YOUR_KEY_HERE"
      }
    }
  }
}
Étape 4 — Redémarrer Claude Desktop et CommencerRedémarre complètement Claude Desktop. Dans la fenêtre de chat, clique sur l'icône +, puis sous Connecteurs tu trouveras todance. Clique sur Gérer pour voir tous les outils disponibles.
« Crée une social de Bachata hebdomadaire chaque vendredi en août, 20–23h, à la Tanzschule Mitte, Torstraße 20 Berlin »
Outils 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

Référence de l'API

Tous les endpoints v1 utilisent Authorization: Bearer tdapi_... — aucune session requise.
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