Phone Directory
    • Dark
      Light

    Phone Directory

    • Dark
      Light

    Article summary

    Overview

    This API fetches the phone directory for the Agent.

    Pre-requisite

    The agent must be in the LoggedIn state.

    Sequence Diagram

    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?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.