question

colin-calvert2238 avatar image
colin-calvert2238 asked Anirban answered

When is "presenceStatus" ever "offline"?

For the purpose of explaining this I've got two extensions setup. Extension 101, with the id 378712345, is using a Polycom VVX-410 and extension 103, with the id 378712345, is just logged in with the softphone on OS X. If I unplug the Polycom phone and close the softphone (essentially making both extensions "offline") the API presence endpoint still responds with the following:

{
                 
  "uri": "https://platform.ringcentral.com/restapi/v1.0/account/378712345/extension/378712345";,
    "id": 378712345,
    "extensionNumber": "101"
  },
  "presenceStatus": "Available",
  "telephonyStatus": "NoCall",
  "userStatus": "Available",
  "dndStatus": "TakeAllCalls",
  "allowSeeMyPresence": true,
  "ringOnMonitoredCall": false,
  "pickUpCallsOnHold": false
}


{
                 
  "uri": "https://platform.ringcentral.com/restapi/v1.0/account/378712345/extension/378712345";,
    "id": 378712345,
    "extensionNumber": "103"
  },
  "presenceStatus": "Available",
  "telephonyStatus": "NoCall",
  "userStatus": "Available",
  "dndStatus": "TakeAllCalls",
  "allowSeeMyPresence": true,
  "ringOnMonitoredCall": false,
  "pickUpCallsOnHold": false
}


Additionally, on the Polycom phone, if I press the DND button the status reflects the change on the phone, however, the API results are the same as above.


What I'm expecting, based off the API docs, is that the "presenceStatus" should return "Offline" when either the softphone is closed or the Polycom phone has no network connection. Additionally, when the DND button is pressed on the Polycom phone, I would expect the "dndStatus" to return "DoNotAcceptAnyCalls".


My question is, what am I missing? Is there something specific that needs to be configured in the web interface (I do have "Allow other users to see my Presence status" set to on for both extensions)? How can we achieve the expected results outlined above?

hardware
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

benjamin-dean avatar image
benjamin-dean answered
Hey Colin, thanks for providing such good information about the issue you are experiencing. I think there are a few different things which could be causing what you are seeing, but I'd like to be certain.

I'm communicating with our engineering team to be certain the answer you receive is 100% accurate.

Either myself or another member of our team will respond here as soon as we have the "gospel truth" for you.
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

benjamin-dean avatar image
benjamin-dean answered
Hey Colin,

Thanks for your patience.

So I have the answer for you sir.

Physical Device Status:

Currently, there is no way to monitor the state of a physical device's connectivity or availability via the API. This feature is being actively developed and is on-track to be shipped in an upcoming release cycle.

Soft Phone Status:

You can monitor (using a subscription) the status which the user defines within the softphone for their settings (Busy, Available, Offline), but the Presence data does not display when the soft phone application is closed as "offline" unless the user has first set the soft phone into "Offline" mode (or by not accepting calls).

I put together this video for you to show you what I mean (it is in the final stages of processing by YouTube):  https://www.youtube.com/watch?v=sUU8XuMkNH4
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

colin-calvert2238 avatar image
colin-calvert2238 answered
Thanks for the detailed response and video. I'm not sure I agree with the methodology behind the software is closed but "a computer is still authorized"  so the "presenceStatus" is online. If the software is closed then the software can't ring. In my opinion, that is the definition of offline.
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

benjamin-dean avatar image
benjamin-dean answered
I do see the value in what you have suggested and will share with our Product Management for consideration.

There currently is no feature (of which I am aware) on the desktop soft phones which "ping the mothership" or vice-versa to determine if a particular soft phone is still executing in memory on the host machine. I think this would be the type of feature needed to achieve the results you are seeking.

We expect the operating agent to modify their settings, and then for the IVR, call-routing, or voicemail to kick-in (in events where nobody answers on a particular leg).
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

gyorgy-orban7607 avatar image
gyorgy-orban7607 answered
Is there any update on this feature? We have just checked, the API endpoint still doesn't seem to return the connectivity status of users. It would be a very useful feature to monitor remote users with softphone-only access. Other SIP providers have this service too.
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

kalen-white1743 avatar image
kalen-white1743 answered Anirban commented

Hi! Do we have an update on the ability to monitor the physical phone status via API as mentioned above?

1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Anirban avatar image
Anirban answered

@kalen-white I still don't think presence status is available in normal physical phone because that is impossible. However there are certain presence capable deskphone is available like Cisco 508G, Cisco SPA 525G2, Polycom IP650 etc which are capable to show their presence.

check here : https://www.ringcentral.com/office/features/presence/overview.html

1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys