curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/validate" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"flow_config": {
"initial_node_id": "node-greet",
"nodes": [
{ "id": "node-greet", "type": "say", "content": "Hi!", "next": "node-end" },
{ "id": "node-end", "type": "end" }
]
}
}'
{
"success": true,
"message": "Flow is valid"
}
Fluxo de Conversação
Validar Fluxo do Agente
Validação em modo de teste de uma configuração de fluxo
POST
/
api
/
v1
/
agents
/
{agent_id}
/
flow
/
validate
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/validate" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"flow_config": {
"initial_node_id": "node-greet",
"nodes": [
{ "id": "node-greet", "type": "say", "content": "Hi!", "next": "node-end" },
{ "id": "node-end", "type": "end" }
]
}
}'
{
"success": true,
"message": "Flow is valid"
}
Validar Fluxo do Agente
Executa a validação em uma configuração de fluxo candidata sem persistir alterações. Retorna os mesmos erros que Atualizar Fluxo do Agente retornaria.Endpoint
POST /api/v1/agents/{agent_id}/flow/validate
Parâmetros de caminho
string
obrigatório
UUID do agente. Usado para delimitar a validação (ex: para verificar se IDs de ações referenciados existem).
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_herestring
obrigatório
Deve ser definido como
application/jsonCorpo da requisição
object
obrigatório
Mesmo formato de Atualizar Fluxo do Agente.
Exemplos
curl -X POST "https://app.talkover.ai/api/v1/agents/agent-uuid/flow/validate" \
-H "Authorization: Bearer talq_your_environment_token_here" \
-H "Content-Type: application/json" \
-d '{
"flow_config": {
"initial_node_id": "node-greet",
"nodes": [
{ "id": "node-greet", "type": "say", "content": "Hi!", "next": "node-end" },
{ "id": "node-end", "type": "end" }
]
}
}'
Resposta
Válido
{
"success": true,
"message": "Flow is valid"
}
Inválido
{
"success": false,
"errors": [
"Duplicate node id: 'node-greet'",
"Node 'node-end' is unreachable"
]
}
Observações
- Use este endpoint a partir do seu editor antes de submeter uma atualização — expõe problemas cedo, sem modificar o estado do agente.
- As regras de validação cobrem: IDs de nó únicos, alcançabilidade, alvos válidos de
next/branchese campos obrigatórios portypede nó.
Esta página foi útil?