Doc Analyzer - analyzeDialogue
Analisa um diálogo e retorna JSON estruturado conforme schema ou catálogo
Analise uma conversa individual com saída estruturada para integrar em fluxo operacional, BI ou automação.
Endpoint
POST /api/externalAPIs/public/docAnalyzer/analyzeDialogue
Parâmetros
Instruções que orientam o que deve ser extraído do diálogo.
JSON Schema de saída; use quando não for enviar formCatalogId.
UUID do catálogo FormFlow usado como fonte de schema e instruções.
Texto único ou lista de mensagens { role, content }.
UUID de uma conversa quando os dados já estão no banco.
Modelo principal da análise estruturada.
Provedor do modelo, como openai ou google.
Quando true, grava os dados extraídos no FormFlow.
Identificador do lead para gravação no escopo correto.
Identificador do avatar quando necessário para persistência.
Também são aceitos aliases em snake_case, como form_catalog_id, record_form_data, lead_id e avatar_id.
Exemplo
curl -X POST "{{BASE_URL}}/api/externalAPIs/public/docAnalyzer/analyzeDialogue" \
-H "Authorization: Bearer {{TOKEN}}" \
-H "Content-Type: application/json" \
-d '{
"instructions": "Extraia nome e intencao do cliente.",
"schema": {
"type": "object",
"additionalProperties": false,
"properties": {
"nome": { "type": "string" },
"intencao": { "type": "string" }
},
"required": ["nome"]
},
"dialogue": [
{ "role": "user", "content": "Sou a Ana e quero um orcamento." }
]
}'
Resposta
{
"data": {
"nome": "Ana",
"intencao": "orcamento"
},
"error": null,
"rawResult": {},
"metrics": {
"elapsedMs": 320
},
"formDataRecorded": null
}
Campos da Resposta
JSON estruturado gerado a partir do schema.
Mensagem de erro quando a análise falha.
Payload bruto retornado pelo provedor do modelo.
Contadores de inserção, atualização e skip quando recordFormData estiver ativo.
Erros
| Código | Descrição |
|---|---|
400 | Falha de validação ou combinação mínima de parâmetros inválida |
401 | Token inválido ou ausente |
500 | Erro interno do servidor |