Neurosis Prevention Mechanism

    ucclient-sdk
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.10 • Public • Published

    UCCLIENT - SDK

    UCCLIENT - SDK is a client side SDK to access the Mondago family of UC desktop products. The SDK allows a developer to control the users device through the UC client. This includes actions such as Makecall, Answer, Hangup etc. The API also provides the ability to get call events, which includes the callers phone number. This allows a developer to act on these events.

    For complete examples, see our client examples repository.

    Dependencies

    Download your software dependencies here

    Features

    • Monitor login: check for the start up and login of your desktop client, telling you when you can start using the api
    • Monitor calls: see your call events coming in, initial event and updates to your calls
    • Control handset: use the api to easily control your active calls and make new calls

    Installing

    Using npm:

    $ npm install ucclient-sdk
    

    Using our released zip (available here)

    <script src="./path/to/ucsdk.js"></script>

    Importing

    Using npm:

    import UCSession from "ucclient-sdk"

    Using released zip:

    const UCSession = window.ucsdk.default

    Example

    const ucSession = new UCSession()
    
    ucSession.connect()

    Events are communicated using event listeners. To receive an event add event listeners for "ucLogin" and "ucCall".

    The objects, shown later, are stored in the detail property of the event.

    Show data:

    window.addEventListener("ucLogin", (loginEvent) => console.log(loginEvent.detail))
    window.addEventListener("ucCall", (callEvent) => console.log(callEvent.detail))

    Methods

    ucSession.connect()

    ucSession.callController.makeCall(destination)

    ucSession.callController.hangupCall(id)

    ucSession.callController.holdCall(id)

    ucSession.callController.unHoldCall(id)

    ucSession.callController.answerCall(id)

    Examples

    ucSession.callController.makeCall("0800123456")
    ucSession.callController.holdCall("call_id_here:0123456789")

    Objects

    Shown below are the objects you may receive and handle.

    Call

    Call object, generated on any call event.

    {
        "Type": "Call",
    
        // `Id` is important, will be used to control this call using the methods shown above
        "Id": "037d274e-64cb-406e-9531-09f205caf5a2",
    
        // `Event` can be UPDATE | REMOVE
        "Event": "UPDATE",
    
        // `State` can be "DIALBACK" | "DIALING" | "RINGING" | "CONNECTED" | "ENDED" | "HELD" | "CONFERENCED" | "DISCONNECTED"
        "State": "DIALING",
    
        "HostId": "",
        "Start": "2019/03/21 10:32:45",
        "DurationTotal": "1",
        "DurationRing": "",
        "DurationHeld": "",
        "DurationConnected": "",
        "DurationOther": "",
        "Caller": {
            "Id": "",
            "Tel": "1234",
            "DisplayTel": "1234",
            "Name": "John Smith",
            "DisplayName": "John Smith",
            "ForeignId": "",
            "DirectoryId": "",
            "Department": "Development"
        },
        "Called": {
            "Id": "321",
            "Tel": "0800500005",
            "DisplayTel": "(0800) 500 005",
            "Name": "United Kingdom",
            "DisplayName": "Freephone",
            "ForeignId": "",
            "DirectoryId": "",
            "Department": ""
        },
        "Connections": "",
        "Trunk": "",
    
        // `Direction` can either be I | O for inbound or outbound
        "Direction": "O",
    
        "External": "",
        "Missed": "1",
        "Category": "",
        "Custom1": "",
        "Custom2": ""
    }

    Login

    Login event, generated on connection to the socket.

    {
       "Type":"Login",
    
       // The most important part of this object is the id, this may need to be sent in with some methods
       "Id":"#USERID",
    
       "ShortName":"#SHORTNAME",
       "Name":"#USERNAME",
       "PolicyId":"#POLICYID",
       "Devices":[],
       "Email":"",
       "RegisteredDevices":"",
       "CurrentTel":"",
       "Photo":"",
       "Department":"",
       "State":"",
       "DirectionState":"",
       "UserState":"",
       "AgentState":"",
       "ContactState":"",
       "DndState":"",
       "ForwardState":"",
       "MessageState":"",
       "Location":"",
       "AbsenceText":"",
       "UsePBXName":"",
       "ClassType":"",
       "EquipmentId":"",
       "Changes":"",
       "DDI":"",
       "AvailabilityUntil":"",
       "UserSrc":"LoginUser"
    }

    Install

    npm i ucclient-sdk

    DownloadsWeekly Downloads

    13

    Version

    1.0.10

    License

    MIT

    Unpacked Size

    269 kB

    Total Files

    12

    Last publish

    Collaborators

    • danielyates-mondago
    • ianrobinson
    • callumdouglas