Skip to main content
Retrieves a specific AI agent by its ID. Returns the complete agent configuration including name, status, actions, and settings. 
GET https://services.leadconnectorhq.com/conversation-ai/agents/{agentId}

​
Autorización

​
Authorization
string
required
Bearer token generado desde el portal Leadway. Ver Autenticación.
​
Version
string
default:"2021-07-28"
required
Versión de la API.

​
Path parameters

​
agentId
string
default:"EmployeeId123"
required
Conversations AI agent id

​
Respuestas

​
id
string
default:"emp_123"
required
Unique identifier for the agent.
​
name
string
default:"John Doe"
required
Name of the agent.
​
businessName
string
default:"Tech Corp"
Name of the business the agent represents.
​
mode
string
default:"auto-pilot"
required
Current operating mode of the agent. Posibles valores: ‘off’, ‘suggestive’, ‘auto-pilot’
​
channels
string[]
required
Communication channels the agent operates on.
​
waitTime
number
default:"30"
required
Wait time before agent responds.
​
waitTimeUnit
string
default:"seconds"
required
Unit for wait time. Posibles valores: ‘minutes’, ‘seconds’
​
sleepEnabled
boolean
default:"False"
required
Indicates if sleep functionality is enabled.
​
sleepTime
number
default:"2"
Duration of sleep period.
​
sleepTimeUnit
string
default:"hours"
Unit of sleep time. Posibles valores: ‘hours’, ‘minutes’, ‘seconds’
​
actions
object[]
required
List of actions associated with this agent.
​
isPrimary
boolean
default:"False"
required
Indicates if this agent is a primary agent.
​
autoPilotMaxMessages
number
default:"25"
required
Maximum number of messages in auto-pilot mode before requiring human intervention.
​
goal
string
default:"Assist customers with inquiries"
The goal of the agent.
​
personality
string
default:"Friendly and helpful"
Personality traits of the agent.
​
instructions
string
default:"Provide excellent customer service"
Instructions for the agent.
​
knowledgeBaseIds
string[]
Array of knowledge base IDs associated with this agent.
​
sleepOnManualMessage
boolean
default:"False"
Whether the bot sleeps on manual outbound messages.
​
sleepOnWorkflowMessage
boolean
default:"False"
Whether the bot sleeps on workflow outbound messages.
{
  "id": "emp_123",
  "name": "John Doe",
  "businessName": "Tech Corp",
  "mode": "auto-pilot",
  "channels": [
    "SMS",
    "Live_Chat"
  ],
  "waitTime": 30,
  "waitTimeUnit": "seconds",
  "sleepEnabled": false,
  "sleepTime": 2,
  "sleepTimeUnit": "hours",
  "actions": [
    {
      "id": "actionId123",
      "type": "triggerWorkflow"
    }
  ],
  "isPrimary": false,
  "autoPilotMaxMessages": 25,
  "goal": "Assist customers with inquiries",
  "personality": "Friendly and helpful",
  "instructions": "Provide excellent customer service",
  "knowledgeBaseIds": [
    "kb_123",
    "kb_456"
  ],
  "sleepOnManualMessage": false,
  "sleepOnWorkflowMessage": false
}

{}

{}

{}

​
Ejemplo

curl -X GET 'https://services.leadconnectorhq.com/conversation-ai/agents/YOUR_agentId' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Version: 2021-07-28'

const response = await fetch('https://services.leadconnectorhq.com/conversation-ai/agents/YOUR_agentId', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.LEADWAY_TOKEN}`,
    Version: '2021-07-28',
  },
});
const data = await response.json();

import os, requests
response = requests.request(
    'GET',
    'https://services.leadconnectorhq.com/conversation-ai/agents/YOUR_agentId',
    headers={
        'Authorization': f"Bearer {os.environ['LEADWAY_TOKEN']}",
        'Version': '2021-07-28',
    },
)
data = response.json()

<?php
$ch = curl_init('https://services.leadconnectorhq.com/conversation-ai/agents/YOUR_agentId');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('LEADWAY_TOKEN'),
        'Version: 2021-07-28',
    ],
]);
$data = json_decode(curl_exec($ch), true);