Simplafy
Desenvolvedores

Construa com o Simplafy Hub.

Quatro portas para ligar o Hub ao seu sistema, ao seu assistente de IA e ao seu código: conversar com os agentes, mandar dados, operar o Hub inteiro e publicar agentes como código.

Abrir no ChatGPTAbrir no Claude

Qual porta usar

1 · MCP — o Hub inteiro dentro do seu assistente de IA

Para que serve. Conecte o ChatGPT, o Claude ou qualquer cliente MCP ao Hub e opere tudo conversando: contatos, negócios, funis, agentes, jornadas, campanhas, catálogo, nota fiscal, painéis e mais. Tudo o que a tela faz, o MCP faz.

Como começar
  1. 1No Hub, vá em Configurações › Assistentes de IA e copie o endereço.
  2. 2Cole no seu assistente como servidor MCP (conector personalizado).
  3. 3Entre com a sua conta do Hub e escolha as áreas que ele pode ver e mexer, só leitura ou leitura e escrita.

Prefere o app oficial? Procure «Simplafy Hub» na loja do ChatGPT ou no diretório do Claude.

Endereço do MCP
https://mcp-hub.simplafy.com.br/completo
Colar no seu assistente
Claude

Configurações › Conectores › Adicionar conector personalizado, e cole o endereço.

Claude
https://mcp-hub.simplafy.com.br/completo
ChatGPT

Use o app oficial «Simplafy Hub» na loja do ChatGPT ou, em conectores personalizados, cole o endereço.

ChatGPT
https://mcp-hub.simplafy.com.br/completo
Claude Code

No terminal:

Claude Code
claude mcp add --transport http simplafy-hub https://mcp-hub.simplafy.com.br/completo
Cursor

Em ~/.cursor/mcp.json:

Cursor
{
  "mcpServers": {
    "simplafy-hub": {
      "url": "https://mcp-hub.simplafy.com.br/completo"
    }
  }
}
VS Code

Em .vscode/mcp.json:

VS Code
{
  "servers": {
    "simplafy-hub": {
      "type": "http",
      "url": "https://mcp-hub.simplafy.com.br/completo"
    }
  }
}
Técnico
  • Transporte: MCP Streamable HTTP (JSON-RPC 2.0).
  • Autenticação: OAuth 2.1 com registro automático do cliente e PKCE. Não precisa de chave.
  • O assistente nunca tem mais poder que o papel da pessoa na organização.
  • Mais de 140 ferramentas no acesso completo.
  • Sessão: o acesso renova sozinho por até 30 dias; revogue quando quiser em Configurações › Meus assistentes.
Permissões por área (hub.<área>.read / hub.<área>.write):
Painel e BICaixa de entradaCRMCampanhasExecuçõesAgentesJornadasCanaisFerramentasProvedores de IAPlugins e aplicativosArquivosTabela de DadosCatálogoAdministração

Ver o Hub no ChatGPT e no Claude, para quem não é desenvolvedor →

2 · Agent API — o seu sistema conversa com um agente

Para que serve. O seu site, app ou sistema manda uma pergunta ou uma tarefa e o agente do Hub responde, com as mesmas ferramentas, base de conhecimento e regras que ele usa no WhatsApp. A resposta pode vir em texto, em tempo real, em formato estruturado (JSON) ou em arquivo, como um PDF gerado.

Como começar
  1. 1No Hub, em Integrações › Canais, crie um canal Agent API e ligue a ele o agente.
  2. 2Escolha os comportamentos que quer usar: Executar, Tempo real, Estruturado e Arquivo. Cada um ligado ganha o seu endereço, para copiar.
  3. 3Gere o token do canal. Ele aparece uma vez só; dá para girar e revogar.
Técnico
Base
https://api-hub-v2.simplafy.com.br/api/v1/agent-api/{nome-do-canal}
  • Autenticação: Authorization: Bearer <token do canal>.
  • Cabeçalho obrigatório: Idempotency-Key: <id único do pedido>. Repetir o mesmo id não executa duas vezes.
  • Corpo em JSON, até 256 KiB: { "input": "texto para o agente, até 32 mil caracteres", "data": { …dados opcionais… } }.
RotaO que devolve
POST /runA resposta final: { "version": "1", "requestId", "status": "completed", "text", "parts" }
POST /streamA resposta em tempo real (SSE, eventos AG-UI), com retomada por Last-Event-ID
POST /structuredUm JSON validado no formato definido no canal: { …, "data": {…} }
POST /fileOs arquivos que o agente gerou: { …, "text", "files": [...] }
POST /openai/v1/chat/completionsCompatível com a API da OpenAI (ex.: para ligar a ElevenLabs ao agente)
Exemplo · cURL
curl -X POST https://api-hub-v2.simplafy.com.br/api/v1/agent-api/meu-canal/run \
  -H "Authorization: Bearer $TOKEN_DO_CANAL" \
  -H "Idempotency-Key: pedido-123" \
  -H "Content-Type: application/json" \
  -d '{"input":"Qual o prazo de entrega para Brasília?","data":{"pedido":"123"}}'
Erros

Sempre no mesmo formato:

Formato do erro
{ "version": "1", "requestId": "…", "error": { "code": "INVALID_TOKEN", "message": "…", "retryable": false } }
HTTPcodeQuando
400INVALID_REQUESTCorpo inválido, sem Idempotency-Key, campo além de input/data ou acima de 256 KiB
401INVALID_TOKENToken ausente ou errado
403BEHAVIOR_DISABLEDEsse comportamento está desligado no canal
404CHANNEL_NOT_FOUNDO canal não existe
409AGENT_NOT_LINKEDO canal não está ligado a nenhum agente
422NO_FILE_GENERATEDNa rota /file, o agente não gerou arquivo
503AGENT_UNAVAILABLEO agente está desligado ou indisponível (tente de novo)

3 · Webhook de entrada — mande dados para o Hub

Para que serve. Qualquer sistema, formulário do site, n8n, Make ou Zapier manda dados para o Hub, e o Hub usa isso numa Jornada: criar contato e negócio, mover de etapa, gravar na Tabela de Dados, avisar a equipe ou acionar um agente.

Como começar
  1. 1No Hub, em Integrações › Webhook, crie o webhook e copie o endereço e o token.
  2. 2Na Jornada, use o gatilho «Webhook» e escolha o que fazer com os dados.
Técnico
Exemplo · cURL
curl -X POST https://api-hub-v2.simplafy.com.br/api/v1/webhooks/in/{orgId}/{caminho} \
  -H "X-Webhook-Token: $TOKEN_DO_WEBHOOK" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Maria","telefone":"+55 61 90000-0000"}'
  • Endereço: https://api-hub-v2.simplafy.com.br/api/v1/webhooks/in/{orgId}/{caminho}. A tela entrega pronto, com o exemplo em cURL.
  • Método POST. Aceita JSON, formulário (form-urlencoded) e multipart com arquivo. Funciona direto de formulário HTML (CORS).
  • Autenticação: cabeçalho X-Webhook-Token (ou ?token= na URL). Opcional: Bearer ou assinatura HMAC (X-Webhook-Signature).
  • Dá para trocar o token e desfazer a remoção do webhook.

Ainda não tem: validação do formato do corpo, lista de IPs permitidos e webhook de saída. Para o Hub chamar o seu sistema, use o passo «Chamar endpoint» da Jornada.

4 · ADK — agentes, ferramentas e jornadas como código BETA

Para que serve. Para times técnicos e parceiros: escreva agentes, ferramentas (em Python), tabelas, jornadas e aplicativos em arquivos, guarde no Git, valide na sua máquina e publique no Hub com um comando. O que já está no Hub também pode ser exportado para arquivos.

Como começar
Terminal
npx @simplafy-tec/adk doctor          # confere o ambiente
npx @simplafy-tec/adk login           # entra com a conta do Hub
npx @simplafy-tec/adk init tool minha-tool && cd minha-tool
npx @simplafy-tec/adk build           # valida e procura segredo vazado
npx @simplafy-tec/adk deploy --org <orgId>
Técnico
  • Pacote @simplafy-tec/adk no npm (Node 20 ou mais). Comandos: doctor, login/logout, init tool|mcp|app, build, test, dev, validate, plan, deploy, status, export, mcp-server.
  • Login por OAuth do Hub (fica salvo na máquina e renova sozinho). Para CI: ADK_TOKEN + --org.
  • Publica na ordem ferramenta → agente → jornada; o que falha não derruba o resto e sai num relatório.
  • plan mostra o que vai mudar antes de aplicar; export traz do Hub o que já existe; status lista o que ficou pendente.
  • O build reprova segredo no código: a credencial fica no Hub e é citada pelo nome.

Versão 0.1.0. A documentação completa do ADK ainda está sendo escrita.

Ajuda e status