T-Demand Painel Administrativo Total IP

Acessar

Informe seu e-mail cadastrado para receber um token temporario.

Command Center

Operação T-Demand

Demanda, tasks, roteamento, integrações e status em uma visão de controle para priorização diária.

Throughput

Entrada, processamento e conclusão

Status

Tasks por status

Fluxo operacional

Demandas x Status

SLA

Idade das tasks abertas

Integrações

Saúde das APIs

Financeiro

Dashboard do Meu Ambiente

Ambiente atual

Fatura

Workspaces ativos

Distribuição por workspace (tasks, demandas, roteamentos e runs)

Os percentuais mostram o peso de cada workspace dentro do ambiente atual.

Task importada

Top 5 demandas com mais Tasks importadas

Ranking das 5 demandas com maior volume de importações no ciclo. Útil para identificar quais demandas concentram entrada de dados e impacto inicial de custo.

Execução de Task

Top 5 demandas com mais execuções de Task

Ranking das demandas que mais executaram tarefas no período. Mostra onde está o maior uso operacional e ajuda a priorizar otimização de fluxos.

Roteamentos

Top 5 roteamentos com maior consumo

Exibe os roteamentos com maior volume de runs no ciclo. Ideal para detectar automações caras, avaliar regras de disparo e distribuir melhor a carga entre rotas.

Lançamentos

Últimos eventos do ambiente

Tabela de drilldown dos eventos de cobrança. Navegue por dia e hora para inspecionar cada lançamento, com tipo de evento, workspace, demanda, task, roteamento e volume em runs/criações.

0 eventos

Nome	Tasks	Status	Status inicial	Atualizado	Acoes

Nome	Demanda	Início	Agendamento	Ativo	Ações

Nenhuma integração selecionada

Selecione uma request existente na lista lateral ou crie uma nova integração para configurar, testar e salvar as keys conhecidas.

HTTP Request Nome da request

Auth

Escolha o tipo de autenticação para configurar os campos corretos da request.

Headers da Request Key/value habilitavel

Ativo	Header	Valor	Descrição

Ver JSON

{
  "content-type": "application/json"
}

Body

Variáveis de template Valores padrão para testes

0 variáveis

Variável	Tipo	Valor padrão

Timeout ms Pasta / Demanda Descrição

Keys conhecidas Schema aprendido pelas chamadas

0 keys

Nenhuma key conhecida ainda

Teste ou execute esta Integração para o T-Demand aprender as keys do body de resposta.

Resposta

Status -- -- ms -- KB

Aguardando envio

API Reference

Documentação API T-Demand

Referência para sistemas externos criarem demandas, importarem tasks e consultarem processamento com mais espaço para leitura.

Contrato de integração

Use JSON para demandas e tasks. Campos do tipo file devem enviar metadados e content_base64; o arquivo fica no volume Docker.

Content-Type: application/json

Endpoints externos (sem cookie)

Lista completa dos endpoints que podem ser chamados sem sessão de navegador (API key, webhooks, links públicos e infra).

Criar demanda Define o objeto dinâmico e os status das tasks.

POST/api/demands

A demanda é o template de entrada. Ela define quais atributos cada task deve carregar e qual status nasce como inicial.

{
  "name": "Importação de contratos",
  "description": "Entrada de contratos para validação",
  "task_statuses": [
    { "name": "Recebida", "role": "pending", "initial": true },
    { "name": "Em analise", "role": "waiting", "initial": false },
    { "name": "Resolvida", "role": "success", "initial": false },
    { "name": "Falha", "role": "error", "initial": false }
  ],
  "task_schema": {
    "contractId": { "type": "string", "required": true },
    "amount": { "type": "number", "required": true },
    "attachment": { "type": "file", "required": false }
  }
}

Exemplo cURL

curl -X POST "http://localhost:3000/api/demands" \
  -H "Content-Type: application/json" \
  -H "X-TDemand-Api-Key: tdk_sua_chave" \
  -d '{
    "name": "Importação de contratos",
    "description": "Entrada de contratos para validação",
    "task_schema": {
      "contractId": { "type": "string", "required": true },
      "amount": { "type": "number", "required": true }
    }
  }'

Resposta (201)

{
  "message": "OK",
  "data": {
    "id": 12846,
    "protocol": "DEM-12846",
    "name": "Importação de contratos"
  }
}

Consultar demandas Lista demandas disponíveis no ambiente da chave usada.

GET/api/demands

Autenticação

Authorization: Bearer tdk_sua_chave

ou

X-TDemand-Api-Key: tdk_sua_chave

Resposta

{
  "message": "OK",
  "count": 2,
  "data": [
    {
      "id": 12846,
      "protocol": "DEM-12846",
      "name": "Importação de contratos",
      "description": "Entrada de contratos para validação",
      "task_schema": {
        "contractId": { "type": "string", "required": true },
        "attachment": { "type": "file", "required": false }
      },
      "task_statuses": [
        { "name": "Recebida", "role": "pending", "initial": true },
        { "name": "Resolvida", "role": "success", "initial": false }
      ]
    }
  ]
}

Importar tasks Envia N tasks para uma demanda existente.

POST/api/demands/:id/tasks/import

Em demandas no modo Magica, atributos novos enviados pela API sao aprendidos automaticamente e adicionados ao schema da demanda. Em modo Builder/JSON, os atributos devem seguir o schema definido. Para arquivo, envie name, mime_type e content_base64.

{
  "tasks": [
    {
      "id": "contract-001",
      "contractId": "C-001",
      "customerId": "ABC",
      "amount": 1200,
      "attachment": {
        "name": "contrato.pdf",
        "mime_type": "application/pdf",
        "content_base64": "..."
      }
    }
  ]
}

Exemplo cURL

curl -X POST "http://localhost:3000/api/demands/12846/tasks/import" \
  -H "Content-Type: application/json" \
  -H "X-TDemand-Api-Key: tdk_sua_chave" \
  -d '{
    "tasks": [
      {
        "id": "contract-001",
        "contractId": "C-001",
        "amount": 1200
      }
    ]
  }'

Resposta (201)

{
  "message": "OK",
  "count": 1,
  "data": [
    {
      "id": 501,
      "task_key": "contract-001",
      "status": "Recebida"
    }
  ]
}

Buscar tasks (filtro) Busca paginada via POST com filtros avançados.

POST/api/demands/:id/tasks/filter

Use este endpoint para pesquisa operacional com paginação, busca textual, status e filtros por atributos do payload.

{
  "view": "table",
  "page": 1,
  "page_size": 50,
  "search": "contract-001",
  "status": "Recebida",
  "sort_field": "updated_at",
  "sort_direction": "desc",
  "filters": {
    "logic": "and",
    "conditions": [
      {
        "field": "payload.amount",
        "operator": "greater_or_equal",
        "value": 1000
      }
    ]
  }
}

Exemplo cURL

curl -X POST "http://localhost:3000/api/demands/12846/tasks/filter" \
  -H "Content-Type: application/json" \
  -H "X-TDemand-Api-Key: tdk_sua_chave" \
  -d '{
    "view": "table",
    "page": 1,
    "page_size": 20,
    "search": "contract",
    "status": "Recebida"
  }'

Resposta (200)

{
  "message": "OK",
  "view": "table",
  "count": 20,
  "total_count": 132,
  "page": 1,
  "page_size": 20,
  "page_count": 7,
  "truncated": true,
  "applied_filter": true,
  "data": [
    {
      "id": 123,
      "task_key": "contract-001",
      "status": "Recebida",
      "payload": {
        "amount": 1200
      }
    }
  ]
}

Listar tasks Listagem simples por GET para consultas rápidas.

GET/api/demands/:id/tasks

Resposta

{
  "message": "OK",
  "count": 10,
  "data": [
    {
      "id": 123,
      "task_key": "contract-001",
      "status": "Recebida",
      "payload": {}
    }
  ]
}

Fluxo operacional

Demanda
  -> Importação de Tasks
  -> Roteamento
  -> Status da Task
  -> Status da Demanda

Detalhar task Consulta uma task específica pelo ID.

GET/api/demands/:id/tasks/:taskId

Use este endpoint para carregar os dados completos de uma task (payload, status e timestamps) quando você já conhece o taskId.

Exemplo cURL

curl -X GET "http://localhost:3000/api/demands/12846/tasks/501" \
  -H "X-TDemand-Api-Key: tdk_sua_chave"

Resposta (200)

{
  "message": "OK",
  "data": {
    "id": 501,
    "demand_id": 12846,
    "task_key": "contract-001",
    "status": "Recebida",
    "payload": {
      "amount": 1200
    },
    "error_message": null,
    "created_at": "2026-01-01T10:00:00.000Z",
    "updated_at": "2026-01-01T10:05:00.000Z",
    "processed_at": null
  }
 }

Atualizar task Atualiza status, task_key e payload de uma task existente.

PUT/api/demands/:id/tasks/:taskId

Use para atualizar uma task específica já criada na demanda. O payload é validado pelo schema da demanda (exceto modo Mágica).

{
  "task_key": "contract-001",
  "status": "Em analise",
  "payload": {
    "contractId": "C-001",
    "amount": 1450,
    "priority": "alta"
  }
}

Exemplo cURL

curl -X PUT "http://localhost:3000/api/demands/12846/tasks/501" \
  -H "Content-Type: application/json" \
  -H "X-TDemand-Api-Key: tdk_sua_chave" \
  -d '{
    "status": "Em analise",
    "payload": {
      "amount": 1450,
      "priority": "alta"
    }
  }'

Resposta (200)

{
  "message": "OK",
  "data": {
    "id": 501,
    "task_key": "contract-001",
    "status": "Em analise",
    "payload": {
      "contractId": "C-001",
      "amount": 1450,
      "priority": "alta"
    }
  }
}

Patch payload da task Atualiza partes do payload com set, merge e push em array.

PATCH/api/demands/:id/tasks/:taskId/payload

Use esse endpoint quando quiser alterar apenas partes do payload sem enviar o objeto inteiro novamente. O backend aplica as operações na ordem informada.

{
  "operations": [
    { "op": "set", "path": "cliente.email", "value": "novo@email.com" },
    { "op": "merge", "path": "cliente", "value": { "status": "revisado" } },
    { "op": "push", "path": "historico", "value": { "evento": "atualizado" } }
  ]
}

Exemplo cURL

curl -X PATCH "http://localhost:3000/api/demands/12846/tasks/501/payload" \
  -H "Content-Type: application/json" \
  -H "X-TDemand-Api-Key: tdk_sua_chave" \
  -d '{
    "operations": [
      { "op": "set", "path": "cliente.email", "value": "novo@email.com" },
      { "op": "push", "path": "tags", "value": "vip" }
    ]
  }'

Resposta (200)

{
  "message": "OK",
  "data": {
    "id": 501,
    "task_key": "contract-001",
    "status": "Em analise",
    "payload": {
      "cliente": {
        "email": "novo@email.com"
      },
      "tags": ["vip"]
    }
  }
}

Upsert task por match_key Atualiza uma task por chave lógica ou cria quando não existir.

POST/api/demands/:id/tasks/upsert

Combine match_key + match_value para localizar a task. Se não encontrar, cria uma nova task (quando create_if_missing não for false).

{
  "match_key": "payload.contractId",
  "match_value": "C-001",
  "merge_mode": "merge",
  "create_if_missing": true,
  "status": "Recebida",
  "payload": {
    "amount": 1800,
    "customerId": "ABC"
  }
}

Exemplo cURL

curl -X POST "http://localhost:3000/api/demands/12846/tasks/upsert" \
  -H "Content-Type: application/json" \
  -H "X-TDemand-Api-Key: tdk_sua_chave" \
  -d '{
    "match_key": "task_key",
    "match_value": "contract-001",
    "merge_mode": "replace",
    "payload": {
      "contractId": "C-001",
      "amount": 1800
    }
  }'

Resposta (201)

{
  "message": "OK",
  "data": {
    "action": "updated",
    "match_key": "task_key",
    "match_value": "contract-001",
    "data": {
      "id": 501,
      "task_key": "contract-001",
      "status": "Recebida",
      "payload": {
        "contractId": "C-001",
        "amount": 1800
      }
    }
  }
}

Sistema Health check e feature flags

Validação operacional de Postgres, Redis, worker e storage, além de controle fino de recursos por ambiente.

Status atual Última verificação: -

Aguardando

Rotinas do sistema Leitura somente. Essas rotinas são gerenciadas pelo sistema.

Cron	Nome	Descrição	Último sync	Ações	Status

Equipe Usuários permitidos a logar

Super Admin gerencia ambientes. Admin edita o ambiente atual. Operadores acessam apenas visualização.

Nome Email Role Ativo

Ambientes Gestão de espaços

Ambientes agrupados por client. Ambientes inativos deixam de aceitar uso operacional, chaves de API, login por domínio e execução de workers.

Experiência Aparência do painel

Escolha o modo visual mais confortável para seu fluxo de trabalho.

Tema da interface

Alterna entre white-mode e dark-mode.

Preferência visual

Integrações Chaves, documentação e importação

Crie chaves, abra a documentação técnica e importe os arquivos de configuração do Chat e da Voz.

Criar Chaves

Crie e gerencie chaves isoladas por ambiente para autenticar sistemas externos com escopos específicos.

Documentação

Abra a referência completa de endpoints, payloads, autenticação e exemplos em uma tela mais espaçosa.

Planos Catálogo de contratação

Selecione o plano ideal para este ambiente. Downgrade não é permitido por este fluxo.

Benefícios contratáveis Cortex

O comando Cortex pode ser usado no roteamento mesmo sem contratação, mas a execução será bloqueada até contratar.

Benefício	Preço	Mínimo	Contratado	Status	Ação

Cobrança por excedente (opcional) Expansão sob demanda quando o limite do plano é ultrapassado

Recurso	Cobrança	Contratado	Ação

Alertas de limite do plano Destinatários de notificação (90% e 100%)

Por padrão, todos os Admins ativos recebem os alertas. Remova no multiselect quem não deve receber.

Carregando destinatários...

Como estava

{}

Como ficou

{}

Visão Geral

Operação T-Demand

Entrada, processamento e conclusão

Tasks por status

Demandas x Status

Idade das tasks abertas

Saúde das APIs

Dashboard do Meu Ambiente

Distribuição por workspace (tasks, demandas, roteamentos e runs)

Top 5 demandas com mais Tasks importadas

Top 5 demandas com mais execuções de Task

Top 5 roteamentos com maior consumo

Últimos eventos do ambiente

Tasks da demanda

Editor de fluxo

Documentação API T-Demand

Logs do sistema