Use este endpoint para processar alto volume sem manter a conexão HTTP aberta até o fim da análise.

Endpoint

POST /api/externalAPIs/public/docAnalyzer/batchAnalyzeDialogue

Parâmetros

input
string
required

UUID de conversa ou query SELECT que retorne coluna id.

hostId
string (UUID)
required

UUID do host usado para validar escopo da execução.

schema
object

JSON Schema de saída; use quando não enviar formCatalogId.

formCatalogId
string (UUID)

Catálogo FormFlow usado como base para extração estruturada.

instructions
string

Instruções complementares para a análise de cada conversa.

model
string

Modelo principal de análise usado pelos jobs.

intervalMs
number
default: "200"

Intervalo entre enfileiramentos para controlar ritmo de processamento.

recordFormData
boolean
default: "false"

Quando true, solicita persistência dos dados no FormFlow.

filterInstructions
string

Instruções para etapa de filtro antes da análise principal.

filterModel
string

Modelo usado na etapa de filtro, quando habilitada.

filterProvider
string

Provedor da etapa de filtro, quando habilitada.

Também são aceitos aliases em snake_case, como form_catalog_id, host_id, record_form_data, filter_instructions, filter_model e filter_provider.

Exemplo

curl -X POST "{{BASE_URL}}/api/externalAPIs/public/docAnalyzer/batchAnalyzeDialogue" \
  -H "Authorization: Bearer {{TOKEN}}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "CONVERSATION_UUID",
    "formCatalogId": "CATALOG_UUID",
    "hostId": "HOST_UUID",
    "instructions": "Extraia os campos do catalogo a partir do dialogo."
  }'

Resposta

{
  "data": {
    "total": 1,
    "enqueued": 1,
    "conversationIds": ["CONVERSATION_UUID"]
  },
  "error": null
}

Campos da Resposta

data
object | null

Resumo do enfileiramento dos jobs de análise.

data.total
number

Total de IDs resolvidos a partir do input.

data.enqueued
number

Quantidade efetivamente enfileirada.

data.conversationIds
array

Lista de conversas aceitas para processamento assíncrono.

error
string | null

Mensagem de erro quando a validação ou o enfileiramento falha.

Erros

CódigoDescrição
400Input inválido, schema ausente ou hostId ausente
401Token inválido ou ausente
500Erro interno ao resolver IDs ou enfileirar jobs