Visão Geral

​

Rotas disponíveis

​

Conversas

• Criar Conversa — Gera um identificador único para iniciar uma nova conversa
• Obter Informações da Conversa — Retorna resumo, análise de sentimento e metadados de uma conversa
• Investigar Mensagem — Detalha uma mensagem por ID com custos de IA, chamadas externas e métricas de performance
• Investigate V2 — Explica por que a IA respondeu de determinada forma a partir de instruções do gestor
• Smart Feedback — Registra feedback positivo ou negativo sobre uma resposta do avatar

​

Avatares

• Listar Avatares — Retorna todos os avatares e datasets associados a um host
• Obter Avatar — Retorna dados completos de um avatar específico
• Criar Avatar — Cria um novo avatar vinculado a um host
• Editar Avatar — Atualiza as configurações de um avatar existente
• Deletar Avatar — Remove um avatar do sistema (soft delete)

​

Hosts

• Criar Host — Registra um novo host no sistema Tolky

​

Datasets

• Listar Datasets — Retorna os datasets de um host, com filtro por avatar
• Criar Dataset — Cria um novo dataset de conhecimento
• Editar Dataset — Atualiza as configurações de um dataset existente
• Deletar Dataset — Remove um dataset do sistema
• Vincular Dataset ao Avatar — Associa um dataset a um avatar

​

Blocos de Conteúdo

• Ler Bloco — Lista os blocos de conteúdo de um dataset
• Criar Bloco — Adiciona um novo bloco de conteúdo a um dataset
• Editar Bloco — Atualiza o conteúdo de um bloco existente
• Deletar Bloco — Remove um bloco de conteúdo

​

Fluxos de Automação

• Listar Fluxos — Retorna os fluxos de automação configurados em um host
• Salvar Fluxo — Cria ou atualiza um fluxo de automação
• Deletar Fluxo — Remove um fluxo de automação
• Templates de Fluxo Padrão — Retorna templates predefinidos de fluxos para usar como base
• Listar Modelos — Retorna os modelos de LLM disponíveis para uso nos fluxos
• Listar Agentes — Retorna os agentes configuráveis disponíveis para fluxos
• Gerar Payload de Agente — Gera a estrutura de configuração de um agente específico

​

Relatórios

• Estatísticas Conversacionais — Retorna métricas de volume e qualidade de conversas por período
• Custos por Host — Retorna o consumo de créditos de IA agrupado por host
• Estatísticas Financeiras — Retorna dados financeiros consolidados por período

​

MCP

• Listar Configurações MCP — Retorna os servidores MCP configurados para um host
• Salvar Configuração MCP — Cria ou atualiza uma configuração de servidor MCP
• Deletar Configuração MCP — Remove uma configuração de servidor MCP

​

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/callReasoning

​

Parâmetros

​

Exemplo

curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/callReasoning \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "hostId": "454960a8-7c78-4ee9-88cc-91b7beddf303",
    "conversationId": "63f75d81-b8fb-41f8-8a9c-39748c6f68f4",
    "question": "Olá, preciso de ajuda",
    "userData": {
      "userName": "João Silva",
      "email": "joao@exemplo.com"
    }
  }'

​

Resposta

{
  "code": 200,
  "message": "OK",
  "data": {
    "assistantResponse": {
      "string": "Olá! Como posso ajudar?",
      "wppParsed": [
        { "type": "text", "content": "Olá! Como posso ajudar?" }
      ],
      "isAudio": false,
      "mediaDescriptionArray": []
    },
    "responseStatus": {
      "ok": true,
      "message": null
    },
    "tokensControl": [
      { "model": "gpt-4o", "tokens": 250 }
    ],
    "sessionId": "uuid-da-sessao",
    "conversationId": "63f75d81-b8fb-41f8-8a9c-39748c6f68f4",
    "hostId": "454960a8-7c78-4ee9-88cc-91b7beddf303",
    "userId": null,
    "leadId": "uuid-do-lead",
    "askHumanHelp": false,
    "createdMessageIds": ["uuid-msg-1", "uuid-msg-2"],
    "requestControlId": "rc_uuid",
    "globalData": null
  }
}

​

Campos da Resposta

​

wppParsed — tipos suportados

​

Erros