Visão geral, esquema do banco e fluxo de dados em Tolky Features.

Endpoint

POST /api/v4/tolkyFeatures/create

Parâmetros

title
string
required

Nome curto da feature. Único dentro do módulo quando module for informado.

description
string

Resumo em uma linha do que a feature faz.

longDescription
string

Descrição completa da feature.

module
string

Agrupamento lógico da feature (ex.: "insights", "agents", "leads").

Exemplo

curl -X POST {{BASE_URL}}/api/v4/tolkyFeatures/create \
  -H "Authorization: Bearer {{TOKEN}}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Smart Feedback",
    "description": "Automatically classifies and routes user feedback.",
    "longDescription": "Smart Feedback analyzes incoming messages and classifies them into predefined categories using LLM-based intent detection, then routes them to the appropriate follow-up flow.",
    "module": "insights"
  }'

Resposta

{
  "id": "3f8a1c2d-4e5b-6f7a-8b9c-0d1e2f3a4b5c",
  "title": "Smart Feedback",
  "description": "Automatically classifies and routes user feedback.",
  "long_description": "Smart Feedback analyzes incoming messages and classifies them into predefined categories using LLM-based intent detection, then routes them to the appropriate follow-up flow.",
  "module": "insights",
  "is_active": true,
  "created_at": "2026-03-30T14:22:00.000Z",
  "updated_at": "2026-03-30T14:22:00.000Z"
}

Campos da Resposta

id
string

UUID da feature gerado automaticamente.

title
string

Nome curto da feature.

description
string

Resumo em uma linha. Pode ser null.

long_description
string

Descrição completa. Pode ser null.

module
string

Agrupamento lógico. Pode ser null.

is_active
boolean

true por padrão.

created_at
string

Data e hora de criação em ISO 8601.

updated_at
string

Data e hora da última atualização em ISO 8601.

Erros

CódigoDescrição
400title ausente ou já existe uma feature com o mesmo title no mesmo module
401Token inválido ou ausente
403Token não pertence a um admin global
500Erro interno do servidor