Docs

Integração para Programadores

Conecta o todance.today ao Telegram, ferramentas de IA e fluxos de trabalho automatizados.

Telegram Auto-Post

Premium
Publica automaticamente novos eventos no teu canal do Telegram quando os publicares no todance.today. Requer conta Premium de organizador.
Passo 1 — Criar um Bot do Telegram
  1. 1. Abre o Telegram e procura @BotFather.
  2. 2. Envia /newbot e segue as instruções.
  3. 3. Copia o Token do Bot — tem este formato: 123456:ABC-DEF...
Passo 2 — Adicionar o Bot ao Canal
  1. 1. Abre o teu canal do Telegram → Administradores → Adicionar administrador.
  2. 2. Procura o teu bot pelo nome de utilizador e concede permissão para Publicar mensagens.
  3. 3. Encontra o ID do canal: reencaminha uma mensagem do canal para @userinfobot. O ID começa com -100...
Passo 3 — Ligar no Perfil
  1. 1. Vai a Perfil → Configurações de Redes Sociais e IA.
  2. 2. Cola o Token do Bot e o ID do Canal.
  3. 3. Ativa Auto-postar no Telegram.
  4. 4. Da próxima vez que publicares um evento, será publicado automaticamente.

IA / Integração MCP

Liga o todance.today ao Claude Desktop, Cursor ou qualquer ferramenta de IA compatível com MCP. Cria, atualiza e gere eventos simplesmente conversando com o teu assistente de IA.
Passo 1 — Gerar uma Chave de API
  1. 1. Vai ao teu Perfil → Chaves de API.
  2. 2. Clica em Criar nova chave e dá-lhe um nome (ex: «MCP em casa»).
  3. 3. Copia a chave imediatamente — só é mostrada uma vez.
Passo 2 — Instalar Node.jsDescarrega e instala o Node.js LTS em nodejs.org (configuração única, sem programação necessária).
Passo 3 — Configurar o Claude DesktopAbre o ficheiro de configuração do Claude Desktop num editor de texto:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Cola o seguinte (substitui tdapi_A_TUA_CHAVE_AQUI pela tua chave):
{
  "mcpServers": {
    "todance": {
      "command": "npx",
      "args": ["-y", "todance-mcp"],
      "env": {
        "TODANCE_API_KEY": "tdapi_YOUR_KEY_HERE"
      }
    }
  }
}
Passo 4 — Reiniciar o Claude Desktop e ComeçarReinicia o Claude Desktop completamente. Na janela de chat clica no ícone +, depois em Conectores encontrarás o todance. Clica em Gerir para ver todas as ferramentas disponíveis.
«Cria um social de Bachata semanal cada sexta-feira em agosto, das 20–23h, na Tanzschule Mitte, Torstraße 20 Berlim»
Ferramentas de IA disponíveis
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

Referência da API

Todos os endpoints v1 usam Authorization: Bearer tdapi_... — sem sessão necessária.
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
Voltar ao início