Doc Analyzer - batchAnalyzeDialogue
Enfileira análise de múltiplas conversas de forma assíncrona via input por UUID ou SELECT
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
UUID de conversa ou query SELECT que retorne coluna id.
UUID do host usado para validar escopo da execução.
JSON Schema de saída; use quando não enviar formCatalogId.
Catálogo FormFlow usado como base para extração estruturada.
Instruções complementares para a análise de cada conversa.
Modelo principal de análise usado pelos jobs.
Intervalo entre enfileiramentos para controlar ritmo de processamento.
Quando true, solicita persistência dos dados no FormFlow.
Instruções para etapa de filtro antes da análise principal.
Modelo usado na etapa de filtro, quando habilitada.
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
Resumo do enfileiramento dos jobs de análise.
Total de IDs resolvidos a partir do input.
Quantidade efetivamente enfileirada.
Lista de conversas aceitas para processamento assíncrono.
Mensagem de erro quando a validação ou o enfileiramento falha.
Erros
| Código | Descrição |
|---|---|
400 | Input inválido, schema ausente ou hostId ausente |
401 | Token inválido ou ausente |
500 | Erro interno ao resolver IDs ou enfileirar jobs |