Phone Directory
- DarkLight
Phone Directory
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Overview
This API fetches the phone directory for the Agent.
Pre-requisite
The agent must be in the LoggedIn state.
Sequence Diagram
.jpg?sv=2022-11-02&spr=https&st=2025-12-27T15%3A23%3A31Z&se=2025-12-27T15%3A33%3A31Z&sr=c&sp=r&sig=dSkwTD7UpiMfQ1OUj5bt3YMzOVF07i0xihWVt8EBCCI%3D)
Message Structure
Request Parameters | Value |
|---|---|
channel | Cisco |
topic | Agent |
subtopic | GetPhoneDirectory |
source | «app-name-broadcasting-this-message» |
data | Not applicable |
Data Parameters
Parameter | Data Type | Description | Sample Value |
|---|---|---|---|
ReasonCodeId | String | The Not Ready Reason Code ID. | 28 |
Response Parameters
Response Parameters | Value |
|---|---|
channel | Cisco |
topic | Agent |
subtopic | SetPhoneDirectory |
message | «JSON Object» |
Response Data Parameters
Parameter | Data Type | Sample Value |
|---|---|---|
packet | String | phonebook |
data | JSON Object | NA |
name | String | TestAgent |
type | String | Global |
uri | String | finesse/api/PhoneBook/1 |
contacts | Array | NA |
firstName | String | Kathy |
lastName | String | Wong |
phoneNumber | String | 99381604019 |
description | String | Agent extension number. |
Sample Request
{
"channel": "Cisco",
"topic": "Agent",
"subtopic": "GetPhoneDirectory"
}Sample Response
{
"channel": "Cisco",
"topic": "Agent",
"subtopic": "SetPhoneDirectory",
"message":
{
"packet": "phoneBook",
"data":
[
{
"name": "TestShiva",
"type": "GLOBAL",
"uri": "/finesse/api/PhoneBook/1",
"contacts": [
{
"firstName": "kathy",
"lastName": "kathy",
"phoneNumber": "5054",
"description": "Kathy jabber extn",
"uri": "/finesse/api/PhoneBook/1/Contact/1"
},
{
"firstName": "joseph",
"lastName": "jabber",
"phoneNumber": "5055",
"description": "josephjabber extnsion number",
"uri": "/finesse/api/PhoneBook/1/Contact/2"
},
{
"firstName": "kk",
"lastName": "wrong",
"phoneNumber": "1234",
"description": "invalid",
"uri": "/finesse/api/PhoneBook/1/Contact/3"
},
{
"firstName": "mazi",
"lastName": "sk",
"phoneNumber": "99381604019",
"description": "ph.no",
"uri": "/finesse/api/PhoneBook/1/Contact/4"
},
{
"firstName": "test",
"lastName": "test1",
"phoneNumber": "18878473732843789g89876866657",
"description": "lenghty characters ",
"uri": "/finesse/api/PhoneBook/1/Contact/5"
}
]
}
]
}
}Was this article helpful?