Pular para o conteúdo principal
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

​
agent_id
string
obrigatório
UUID do agente.

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

​
Exemplos

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