Docs
Intégration Développeur
Connecte todance.today à Telegram, aux outils IA et aux workflows automatisés.Telegram Auto-Post
PremiumÉtape 1 — Créer un Bot Telegram
- 1. Ouvre Telegram et recherche @BotFather.
- 2. Envoie /newbot et suis les instructions.
- 3. Copie le Token du Bot — il ressemble à : 123456:ABC-DEF...
Étape 2 — Ajouter le Bot à la Chaîne
- 1. Ouvre ta chaîne Telegram → Administrateurs → Ajouter un administrateur.
- 2. Recherche ton bot par nom d'utilisateur et accorde la permission Publier des messages.
- 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. Va dans Profil → Paramètres Réseaux Sociaux et IA.
- 2. Colle ton Token de Bot et l'ID de la Chaîne.
- 3. Active Auto-publier sur Telegram.
- 4. La prochaine fois que tu publieras un événement, il sera posté automatiquement.
IA / Intégration MCP
Étape 1 — Générer une Clé d'API
- 1. Va dans ton Profil → Clés API.
- 2. Clique sur Créer une nouvelle clé et donne-lui un nom (ex. : « MCP maison »).
- 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 statscreate_eventCreate a single or recurring eventupdate_eventUpdate name, description, or URLsdelete_eventDelete an instance or full seriesextend_seriesExtend a recurring series by weeksget_analyticsViews, registrations, interestsupload_flyerUpload a flyer image, returns flyer_urllist_dancesReference: all valid dance codesRéférence de l'API
Authorization: Bearer tdapi_... — aucune session requise.POST
/api/v1/flyerUpload flyer image → returns flyer_urlGET
/api/v1/dancesList all dance type codesGET
/api/v1/eventsList own events + instance countsPOST
/api/v1/eventsCreate event or series (JSON)GET
/api/v1/events/[id]Event instance detailPATCH
/api/v1/events/[id]Update name / description / URLsDELETE
/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