curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": {
"conversation_mode": "flow_driven",
"flow_config": {
"initial_node_id": "node-greet",
"meta": {
"name": "Sales Qualification Flow",
"version": "1.2.0"
},
"nodes": [
{
"id": "node-greet",
"type": "say",
"content": "Hi! Are you the right person to talk about scheduling?",
"next": "node-qualify"
},
{
"id": "node-qualify",
"type": "decision",
"branches": [
{ "match": "yes", "next": "node-book" },
{ "match": "no", "next": "node-transfer" }
]
}
],
"global_functions": [
{ "name": "end_conversation", "description": "Ends the call gracefully" }
]
}
}
}
Fluxo de Conversação
Obter Fluxo do Agente
Recuperar a configuração do fluxo de conversação de um agente
GET
/
api
/
v1
/
agents
/
{agent_id}
/
flow
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
-H "Authorization: Bearer talq_your_environment_token_here"
{
"success": true,
"data": {
"conversation_mode": "flow_driven",
"flow_config": {
"initial_node_id": "node-greet",
"meta": {
"name": "Sales Qualification Flow",
"version": "1.2.0"
},
"nodes": [
{
"id": "node-greet",
"type": "say",
"content": "Hi! Are you the right person to talk about scheduling?",
"next": "node-qualify"
},
{
"id": "node-qualify",
"type": "decision",
"branches": [
{ "match": "yes", "next": "node-book" },
{ "match": "no", "next": "node-transfer" }
]
}
],
"global_functions": [
{ "name": "end_conversation", "description": "Ends the call gracefully" }
]
}
}
}
Obter Fluxo do Agente
Recupera o modo de conversação atual e a configuração do Fluxo de Conversação do agente. Os agentes podem operar em dois modos:llm_driven (padrão — o LLM conduz a conversa livremente, com conhecimento/ações) ou flow_driven (um grafo baseado em nós dita o fluxo da conversa).
Endpoint
GET /api/v1/agents/{agent_id}/flow
Parâmetros de caminho
string
obrigatório
UUID do agente.
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereExemplos
curl "https://app.talkover.ai/api/v1/agents/agent-uuid/flow" \
-H "Authorization: Bearer talq_your_environment_token_here"
Resposta
{
"success": true,
"data": {
"conversation_mode": "flow_driven",
"flow_config": {
"initial_node_id": "node-greet",
"meta": {
"name": "Sales Qualification Flow",
"version": "1.2.0"
},
"nodes": [
{
"id": "node-greet",
"type": "say",
"content": "Hi! Are you the right person to talk about scheduling?",
"next": "node-qualify"
},
{
"id": "node-qualify",
"type": "decision",
"branches": [
{ "match": "yes", "next": "node-book" },
{ "match": "no", "next": "node-transfer" }
]
}
],
"global_functions": [
{ "name": "end_conversation", "description": "Ends the call gracefully" }
]
}
}
}
Modos de Conversação
llm_driven— o comportamento do agente é regido por conhecimento, voz e ações.flow_configénull.flow_driven— um grafo de nós dita cada turno. Use este modo para conversas altamente estruturadas (qualificação, intake, abordagem com script).
Observações
- O esquema do fluxo é detalhado — veja Atualizar Fluxo do Agente para a referência completa de campos.
- A validação pode ser executada de forma independente com Validar Fluxo do Agente antes de salvar.
Esta página foi útil?