Get a Specific Agent¶
To retrieve the details of a particular agent with the given stream Id and agent Id.
Method | GET |
---|---|
Endpoint | https://{{host}}/agentassist/api/v1/public/{{streamId}}/agents/{{agentId}} |
Content Type | application/json |
Authorization | auth: {{JWT}} See How to generate the JWT Token |
API Scope | SmartAssist Analytics |
Path Parameters¶
PARAMETER | DESCRIPTION | TYPE |
---|---|---|
host | Environment URL, for example, https://platform.kore.ai | string, required |
StreamId | BotId or StreamId. You can access it from the General Settings page of the bot. | string, required |
Sample Request¶
curl --location --request GET 'https://{{host}}/agentassist/api/v1/public/{{streamId}}/agents/{{agentId}}' \
--header 'auth: {jwt-code}' \
--header 'Content-Type: application/json' \
Query Parameter¶
PARAMETER | DESCRIPTION | TYPE |
---|---|---|
agentId | The Agent Id of the particular agent whose details are being retrieved. You can get this from agents GET API. | string, required |
Sample Response¶
{
"isAccountOwner": false,
"attachmentsEnabled": true,
"emojisEnabled": true,
"status": "ACTIVE",
"firstName": "agent",
"lastName": "1",
"phoneNumber": "1234567890",
"emailId": "agent_may15@mail.com",
"customId": "",
"profImage": "no-avatar",
"canSupportChat": true,
"maxChatSupport": 5,
"roleId": "6457f21044e2ab580af1e011",
"chatLanguageSupport": [
{
"isActive": true,
"language": "en",
"proficiency": "expert"
}
],
"canSupportVoice": false,
"voiceLanguageSupport": [
{
"isActive": false,
"language": "en",
"proficiency": "expert"
}
],
"desktopLayouts": [
{
"isDefault": true,
"id": "ly-a3b06d5-9c8c-476a-917b-0ab45d817021"
}
],
"fullName": "agent 1",
"lFullName": "agent 1",
"userId": "u-edc0304d-05b5-5350-98da-c9748edaxxxx",
"accountId": "6457f21044e2ab580af1xxxx",
"createdBy": "u-042a7093-8178-547a-ab50-364a239bxxxx",
"orgId": "o-0a4dcb56-5d8e-5bfa-86fc-1294e829xxxx",
"agentGroups": [
{
"groupId": "ag-aa690c9-1a2b-4926-aa7e-2511e5e4xxxx",
"role": "agent",
"name": "grp2"
}
],
"lastOnlineAt": "2023-05-19T09:01:26.268Z",
"createdAt": "2023-05-15T10:38:26.718Z",
"updatedAt": "2023-05-23T10:20:19.178Z",
"onlineStatus": "Offline",
"onlineStatusType": "OFFLINE",
"id": "a-953e380-2bc1-483a-a823-d9446806xxxx",
"nickName": "1",
"role": "Supervisor",
"skills": [],
"queues": [
{
"id": "qu-d1c05a4-99e5-4688-9156-897c959dxxxx",
"name": "queueuueue",
"description": "quieuueue",
"isPreferredAgent": true
}
]
}
Response Body Parameters¶
PARAMETER | DESCRIPTION | TYPE |
---|---|---|
isAccountOwner | Indicates whether the user is the account owner. | boolean |
attachmentsEnabled | Indicates whether attachments are enabled for the agent. | boolean |
emojisEnabled | Indicates whether emojis are enabled for the agent. | boolean |
status | The status of the agent. | string |
firstName | The first name of the agent. | string |
lastName | The last name of the agent. | string |
phoneNumber | The phone number of the agent. | string |
emailId | The email ID of the agent. | string |
customId | The custom ID associated with the agent. | string |
profImage | The profile image of the agent. | string |
canSupportChat | Indicates whether the agent can support chat. | boolean |
maxChatSupport | The maximum number of chat sessions the agent can support. | integer |
roleId | The ID of the role assigned to the agent. | string |
chatLanguageSupport | The chat languages supported by the agent. | array |
canSupportVoice | Indicates whether the agent can support voice calls. | boolean |
voiceLanguageSupport | The voice languages supported by the agent. | array |
desktopLayouts | The desktop layout details of the agent. | array |
fullName | The full name of the agent. | string |
lFullName | The localized full name of the agent. | string |
userId | The user ID of the agent. | string |
accountId | The ID of the account associated with the agent. | string |
createdBy | The ID of the user who created the agent. | string |
orgId | The ID of the organization associated with the agent. | string |
agentGroups | The agent group details associated with the agent. | array |
lastOnlineAt | The timestamp when the agent was last online. | string |
createdAt | The creation time of the interaction. | string |
updatedAt | The last updated time of the interaction. | string |
onlineStatus | The online status of the agent. | string |
onlineStatusType | The online status type of the agent. | string |
id | The ID of the agent. | string |
nickName | The nick name of the agent. | string |
role | The role of the agent. | string |
skills | The skills assigned to the agent. | array |
queues | The queues assigned to the agent. | array |