Jump to: navigation, search

IM Session Resource

The imSessions resource includes properties that describe the current state of the session, the session participants, and the resource capabilities. Instant message sessions are returned from GET requests to /api/v2/me/im-sessions?fields=*.

Sample Data

{
    "imSessions": [
        {
            "capabilities": [
                "SendMessage",
                "AttachUserData",
                "Complete"
            ],
            "id": "007MDF3D0KAHL93L807GK2LAES000001",
            "participants": [
                {
                    "digits": "3002",
                    "e164Number": "3002",
                    "formattedPhoneNumber": "3002",
                    "phoneNumber": "3002"
                }
            ],
            "path": "/im-sessions/007MDF3D0KAHL93L807GK2LAES000001",
            "state": "Talking",
            "uri": "http://hpe-voicevm-64.genesyslab.com:8090/api/v2/im-sessions/007MDF3D0KAHL93L807GK2LAES000001"
        }
    ],
    "statusCode": 0
}

Resource Details

Field Description
id The unique ID for the imSessions. This should be the associated SIP server call UUID.
state The state of the imSessions interaction. Possible values are "Initiating" (EventDialing), "Talking" (EventEstablished), "Alerting" (EventRinging), "Completed" (EventReleased)
userData The user data attached to the imSessions.
path The path to the imSessions (in the format: /im-sessions/{id})
participants An array of participants in the same format as the "call" resource.
capabilities The list of operations that may be performed for the given session. This list should correspond to the asynchronous operations that are valid for imSessions: SendMessage, AttachUserData, UpdateUserData, DeleteUserData, Complete.

Feedback

Comment on this article:

blog comments powered by Disqus
This page was last modified on March 25, 2016, at 10:22.