如何获取 RingCentral 软电话中显示的用户状态？

Question

RingCentral 软件电话应用程序将显示用户状态，如下所示。我怎样才能通过 API?

得到这个

可用
忙
请勿打扰
隐形
通话中
暂停

我正在查看 "Get User Status API"，其中 presenceStatus 属性具有以下值 Offline、Busy、Available ，但我如何才能在网络电话上显示完整的状态列表？

https://developer.ringcentral.com/api-reference#Presence-getPresenceStatus

这是一个示例屏幕截图：

Answer 1

用户存在是找到此信息的正确位置，这可以通过 REST API 和使用订阅 API 的推送通知的 real-time 更新静态完成。

软电话中显示的状态是用户存在时几个不同值的组合，可以如下所示。

以下知识库文章说明了如何确定状态：

状态 - 通过收藏夹查看状态 | RingCentral Phone

https://support.ringcentral.com/s/article/7252?language=en_US

The status of their phone will be displayed as Available, Do Not Disturb, and Busy. Contacts on Invisible or Offline will be seen as Invisible.

“Get User Status API”（又名 Presence API）将 return 一个 object 如下所示：

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

据此，可以使用以下伪代码构建用户状态：

user_status = 
  !user.allowSeeMyPresence                ? "Invisible" :
  user.presenceStatus == "Offline"        ? "Invisible" :
  user.dndStatus == "DoNotAcceptAnyCalls" ? "Do Not Disturb" :
  user.telephonyStatus == "CallConnected" ? "On a Call" :
  user.telephonyStatus == "OnHold"        ? "On Hold" :
  user.presenceStatus == "Busy"           ? "Busy" : "Available"

一旦页面显示此信息，您还可以通过为您希望为其接收更新的用户创建状态端点订阅来实时更新它。

如何获取 RingCentral 软电话中显示的用户状态？

How can I get a user's status as shown in the RingCentral softphone?

status

user-presence

ringcentral