FlowCastle

Construa, edite e implante bots do Telegram na plataforma visual hospedada do FlowCastle.

Documentação

Modelos de bot para Telegram + servidor MCP para desenvolvimento de bots com IA

Modelos de bot para Telegram prontos para uso e um servidor MCP — crie, edite e implante bots para Telegram a partir do Claude Code, Codex, Cursor ou qualquer agente de IA compatível com MCP. Sem código boilerplate de SDK: descreva o bot e seu agente monta o fluxo.

FlowCastle é um construtor visual de fluxos de trabalho para bots do Telegram e chat web: fluxos, gatilhos, condições, etapas de IA, pagamentos (Stripe / YooKassa / Telegram Stars), transmissões, sequências programadas e integrações (Gmail, Google Sheets, Notion, OpenAI, …) — com uma API REST e um servidor MCP, para que o desenvolvimento de bots funcione diretamente no seu agente de codificação de IA. Cada bloco que um agente cria via MCP é o mesmo bloco que você pode arrastar, conectar e editar visualmente.

Este repositório é para desenvolvedores. Ele contém:

Caminho	O que é
`templates/`	23 modelos de bot de produção em JSON — a mesma fonte que alimenta a galeria de modelos e a ferramenta `get_flow_example` do MCP
`mcp/`	Referência do servidor MCP: endpoint, autenticação, todas as 16 ferramentas e um snapshot do esquema de ações de fluxo usado por `apply_actions`

Crie um bot a partir do seu agente de IA (MCP)

O FlowCastle expõe um servidor MCP via Streamable HTTP:

POST https://api.flowcastle.ai/api/mcp
Authorization: Bearer <your-application-api-key>   # starts with app_

Obtenha uma chave: cadastre-se → crie um aplicativo → página API → aba MCP.

Claude Code

export FLOWCASTLE_MCP_TOKEN='<your-application-api-key>'

claude mcp add --transport http flowcastle https://api.flowcastle.ai/api/mcp \
  --header "Authorization: Bearer $FLOWCASTLE_MCP_TOKEN"

Codex

codex mcp add flowcastle \
  --url https://api.flowcastle.ai/api/mcp \
  --bearer-token-env-var FLOWCASTLE_MCP_TOKEN

Cursor / qualquer cliente MCP (configuração JSON)

{
  "mcpServers": {
    "flowcastle": {
      "type": "http",
      "url": "https://api.flowcastle.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <your-application-api-key>"
      }
    }
  }
}

Depois, basta pedir coisas como:

"Veja meu workspace do FlowCastle e adicione um fluxo de qualificação de leads: cumprimente em /start, faça três perguntas com botões, salve as respostas nas variáveis de contato e me notifique."

O agente lê seu workspace com get_workspace_summary / get_flow_context, elabora um lote de ações do construtor de fluxos, valida com validate_actions e aplica com apply_actions. Consulte mcp/README.md para a referência completa das ferramentas.

Modelos

Cada arquivo JSON em templates/ é um bot completo: metadados (título, resumo, casos de uso, variáveis sugeridas, módulos necessários) além de um array schemaExample.actions — um lote ordenado de operações create_flow / create_block / create_link / create_variable no formato exato que apply_actions aceita.

Três formas de usá-los:

Instalação com um clique pela galeria: flowcastle.ai/templates
Via MCP — peça ao seu agente para search_flow_examples / get_flow_example e aplicar um (opcionalmente personalizado) ao seu workspace
Como referência — estude como fluxos reais conectam gatilhos, condições, etapas de aguardar resposta, pagamentos e blocos de IA

Índice completo e descrição do formato: templates/README.md.

API REST pública

API REST com escopo de aplicativo para contatos, variáveis de contato, eventos de meta, envios de fluxo e transmissões:

URL base: https://api.flowcastle.ai/api/public/v1
Documentação interativa (Swagger): https://api.flowcastle.ai/api/public/docs
Especificação OpenAPI: https://api.flowcastle.ai/api/public/openapi.json

A autenticação usa a mesma chave de aplicativo app_… (Authorization: Bearer ou X-API-Key).

Guias

Construções passo a passo no blog do FlowCastle:

Contribuindo

Encontrou um bug em um modelo ou criou um fluxo que vale a pena compartilhar? Abra uma issue ou PR — os modelos são JSON simples, e validate_actions (via MCP) informará se um lote está bem formado.

Licença

O conteúdo deste repositório está licenciado sob a Licença MIT.