如何獲得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"

頁面顯示此信息后，您還可以通過為要接收其更新的用戶創建狀態端點的訂閱來實時更新它。