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

Question

RingCentral软电话应用程序将显示以下用户状态。 如何通过API获取此信息？

• 可得到
• 忙
• 请勿打扰
• 无形
• 通话中
• 等候接听

我看其中有一个“获取用户状态API” presenceStatus使用下面的值属性Offline ， Busy ， Available ，但是我如何才能在软电话显示完整的状态列表？

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

这是一个示例屏幕截图：

Answer 1

用户状态是找到此信息的正确位置，可以通过REST API和使用Subscription API的Push Notifications进行实时更新来静态完成此操作。

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

以下知识库文章指示如何确定状态：

在线状态-通过收藏夹查看在线状态| RingCentral电话

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

他们的电话状态将显示为“可用”，“请勿打扰”和“忙碌”。 不可见或离线上的联系人将被视为不可见。

“ 获取用户状态API ”（又名Presence API）将返回如下对象：

{
  "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"

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