Este endpoint executa captura em lote com retorno imediato do resultado e resumo de custo da chamada.

Endpoint

POST /api/v4/formFlow/batchAnalyzeDialogue

Parâmetros

input
string
required

UUID de conversa ou query SELECT que retorne coluna id.

formCatalogId
string (UUID)
required

UUID do catálogo FormFlow alvo da captura.

hostId
string (UUID)
required

UUID do host para validação de escopo.

instructions
string

Instruções extras para a captura; se omitido usa as do catálogo.

model
string

Modelo principal da captura.

lowCostModel
string

Modelo econômico para etapas auxiliares quando aplicável.

lowCostProvider
string

Provedor do modelo econômico.

Também são aceitos aliases como form_catalog_id e host_id.

Exemplo

curl -X POST "{{BASE_URL}}/api/v4/formFlow/batchAnalyzeDialogue" \
  -H "Authorization: Bearer {{TOKEN}}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "SELECT id FROM conversations WHERE host_id = '\''HOST_UUID'\'' LIMIT 5",
    "formCatalogId": "CATALOG_UUID",
    "hostId": "HOST_UUID"
  }'

Resposta

{
  "processedPairs": ["..."],
  "missingForms": [],
  "missingConversations": [],
  "errors": [],
  "timing": {
    "elapsedMs": 0
  },
  "costSummary": {
    "requestControlId": "uuid",
    "totalInputTokens": 0,
    "totalOutputTokens": 0,
    "estimatedCostUsd": 0
  }
}

Campos da Resposta

processedPairs
array

Pares conversa x formulário processados com sucesso.

missingForms
array

IDs de catálogos não encontrados.

missingConversations
array

IDs de conversas não encontradas.

errors
array

Erros de processamento por item ou por execução.

timing
object
costSummary
object

Erros

CódigoDescrição
400input, formCatalogId ou hostId inválidos
401Token inválido ou ausente
500Erro interno durante captura ou apuração de custo