Skip to main content

聯絡人

個人資訊​

For Mobile:
顯示下列資訊：

  1. 個人頭像
  2. 當前團隊名稱
  3. 個人顯示名稱
  4. 可快捷顯示個人商務號QRCode的按鈕

For Desktop:

列表​

列表中區分以下數個分組，各分組可展開或收合

  • 我的最愛
  • 訂閱服務號
  • 社團
  • 夥伴
  • 客戶
  • 封鎖
  • 手機聯絡人
  • 應用

我的最愛​

列出已被添加為最愛的夥伴

數據來源​

  1. base/sync/label API返回數據中 readOnly 欄位為 true 的Tag，是我的最愛數據
  2. 我的最愛Tag的 userIds 欄位對應到的夥伴數據即為此分組應顯示的對象

API調用時機​

  1. 同步全部數據
  2. 同步聊天列表數據
  3. 同步聯絡人列表數據
  4. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表 時)

數據刷新時機​

  1. 使用者頭像更新時，Notice Code：Ce.Notice.UpdateUserAvatar
  2. 使用者資訊更新時，Notice Code：Ce.Notice.UpdateProfile
  3. 添加為好友時，Notice Code：Ce.Notice.AddAddressBook
  4. 解除好友時(此項前端應已沒有解除好友功能，理論上不會觸發)，Notice Code：Ce.Notice.DeleteAddressBook
  5. 同步員工數據完成時(調用 base/sync/employee API後)
  6. 同步標籤數據完成時(調用 base/sync/label API後)
  7. 夥伴主頁修改夥伴備註名稱後(調用 addressbook/customfriendinfo API後)
  8. 夥伴主頁變更最愛狀態時(調用 label/member/add 及 label/member/delete API後)

For Mobile:

  • 分組標題為『我的最愛 n』，n為被添加為最愛的夥伴數量
  • 若尚未添加任何夥伴為最愛，則列表不顯示此分組
  • 夥伴主頁變更最愛狀態時，iOS未直接通知列表更新，而是依賴頁面返回後的數據刷新機制

For Desktop:

訂閱服務號​

列出當前使用者訂閱的服務號，目前系統預設訂閱所有內部服務號

數據來源​

從 base/sync/subscribe/servicenumber API取得的服務號數據

API調用時機​

  1. 同步全部數據
  2. 同步聊天列表數據
  3. 同步聯絡人列表數據
  4. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表 時)

數據刷新時機​

  1. 服務號訂閱事件通知時，Notice Code：Ce.Notice.ServiceNumberSubscribe
  2. 服務號取消訂閱事件通知時，Notice Code：Ce.Notice.ServiceNumberUnSubscribe
  3. 同步聊天室資料完成時，(調用 base/sync/room/servicenumber API後)
  4. 收到API回應服務號禁用，Error Code為 Ce.ServiceNumber.Disable 時
  5. 點擊服務號或其頭像檢查服務號是否為啟用狀態，調用 servicenumber/item API取得服務號資訊且服務號 status 欄位為 Disable 時

For Mobile:

  • 分組標題為『訂閱服務號 n』，n為訂閱服務號的數量
  • 列表數據過濾條件：
    • isSubscribe 欄位為 true
    • status 欄位不為 false
    • serviceNumberType 欄位不為 Boss
    • serviceNumberOpenType 欄位不包含 C(諮詢)

For Desktop:

社團​

列出當前使用者有加入的社團聊天室

數據來源​

從 base/sync/room/normal API取得的聊天室數據中 type 欄位為 group 者，即為此分組應顯示的對象

API調用時機​

  1. 同步全部數據
  2. 同步聊天列表數據
  3. 同步聯絡人列表數據
  4. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表 時)

數據刷新時機​

  1. 同步聊天室資料完成時，(調用 base/sync/room/normal API後)
  2. API回應非聊天室成員，Error Code為 Ce.ChatMember.Invalid 時
  3. API回應聊天室不存在，Error Code為 Ce.ChatRoom.NotExist 時

For Mobile:

  • 列表第一列固定為建立社團
  • 分組標題：
    • 尚無任何社團時：『社團』
    • 有一個以上社團時：『社團 n』，n為社團數量(不含第一列的建立社團)
  • 過濾條件：
    • deleted 欄位為 false
    • memberdeleted 欄位為 false

For Desktop:

夥伴​

列出當前團隊中的夥伴(員工)

數據來源​

從 base/sync/employee API取得的夥伴(員工)數據

API調用時機​

  1. 同步全部數據
  2. 同步聊天列表數據
  3. 同步聯絡人列表數據
  4. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表 時)

數據刷新時機​

  1. 使用者頭像更新時，Notice Code：Ce.Notice.UpdateUserAvatar
  2. 使用者資訊更新時，Notice Code：Ce.Notice.UpdateProfile
  3. 添加為好友時，Notice Code：Ce.Notice.AddAddressBook
  4. 解除好友時(此項前端應已沒有解除好友功能，理論上不會觸發)\，Notice Code：Ce.Notice.DeleteAddressBook
  5. 夥伴主頁修改夥伴備註名稱後(調用 addressbook/customfriendinfo API後)
  6. 夥伴主頁變更最愛狀態時(調用 label/member/add 及 label/member/delete API後)
  7. 夥伴主頁變更封鎖狀態時(調用 user/block API後)

For Mobile:

  • 分組標題為『夥伴 n』，n為過濾後夥伴的數量
  • 過濾條件：
    • 不是當前登入的使用者
    • userType 欄位為 employee
    • status 欄位為 enable
    • isBlock 欄位為 false
  • 備註：
    • 夥伴主頁變更最愛狀態時，iOS未直接通知列表更新，而是依賴頁面返回後的數據刷新機制
    • 夥伴主頁變更封鎖狀態時，iOS未直接通知列表更新，而是依賴頁面返回後的數據刷新機制

For Desktop:

客戶​

列出當前使用者的商務號客戶

數據來源​

從 base/sync/contact API取得的使用者數據中， serviceNumberIds 欄位包含當前使用者的商務號ID者，即為此分組應顯示的對象

API調用時機​

  1. 同步全部數據
  2. 同步聊天列表數據
  3. 同步聯絡人列表數據
  4. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表 時)

數據刷新時機​

  1. 更新客戶資料時，Notice Code: Ce.Notice.UpdateCustomerProfile
  2. 同步客戶資料完成時，(調用 base/sync/contact API後)

For Mobile:

  • 分組標題為『客戶 n』，n為過濾後客戶的數量
  • 從本地資料庫User表取出數據的過濾條件：
    • userType 欄位為 contact
    • serviceNumberIds 欄位包含當前使用者的商務號ID
    • status 欄位不為 disable
  • 若過濾後無客戶，則不顯示此分組

For Desktop:

封鎖​

列出當前使用者封鎖的夥伴

數據來源​

從 base/sync/employee API取得的夥伴(員工)數據

API調用時機​

  1. 同步全部數據
  2. 同步聊天列表數據
  3. 同步聯絡人列表數據
  4. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表 時)

數據刷新時機​

  1. 使用者頭像更新時，Notice Code：Ce.Notice.UpdateUserAvatar
  2. 使用者資訊更新時，Notice Code：Ce.Notice.UpdateProfile
  3. 添加為好友時，Notice Code：Ce.Notice.AddAddressBook
  4. 解除好友時(此項前端應已沒有解除好友功能，理論上不會觸發)\，Notice Code：Ce.Notice.DeleteAddressBook
  5. 夥伴主頁修改夥伴備註名稱後(調用 addressbook/customfriendinfo API後)
  6. 夥伴主頁變更最愛狀態時(調用 label/member/add 及 label/member/delete API後)
  7. 夥伴主頁變更封鎖狀態時(調用 user/block API後)

For Mobile:

  • 分組標題為『封鎖 n』，n為被封鎖的夥伴(員工)數量
  • 過濾條件：
    • 不是當前登入的使用者
    • userType 欄位為 employee
    • status 欄位為 enable
    • isBlock 欄位為 true
  • 若無符合條件的夥伴，則不顯示此分組
  • 備註：
    • 夥伴主頁變更最愛狀態時，iOS未直接通知列表更新，而是依賴頁面返回後的數據刷新機制
    • 夥伴主頁變更封鎖狀態時，iOS未直接通知列表更新，而是依賴頁面返回後的數據刷新機制

For Desktop:

手機聯絡人​

列出已上傳至伺服器的手機作業系統聯絡人資料

數據來源​

手機作業系統的聯絡人資料，上傳後伺服器返回數據 items 欄位中的數據，即為此分組應顯示的對象

API調用時機​

  1. 點擊『將手機通訊錄匯入』時，調用 phone/addressbook/sync API

數據刷新時機​

  1. 點擊『將手機通訊錄匯入』時

For Mobile:

  • 第一列固定為『將手機通訊錄匯入』
  • 分組標題
    • 當伺服器返回的手機聯絡人數據為零時，顯示為『手機聯絡人』
    • 當伺服器返回的手機聯絡人數據不為零時，顯示為『手機聯絡人 n』，n為手機聯絡人數量(不包含第一列的『將手機通訊錄匯入』)

For Desktop:

應用​

列出當前使用者可使用的AIFF應用

數據來源​

從 aiff/list API取得的AIFF數據

API調用時機​

  1. 聯絡人頁面顯示時(每次切換Tab到聯絡人列表 或 每次從次頁返回列表時)
  2. 每次列表數據刷新時

數據刷新時機​

  1. 每次調用 token/apply API後
  2. 每次調用 aiff/list API後

For Mobile:

  • 過濾條件：
    • embedLocation 欄位為 ApplicationList
  • 若無符合條件的AIFF數據，則不顯示此分組

For Desktop:

互動​

聯絡人列表中有點擊、左滑(Trailing Swipe)等事件，不同點擊位置或不同分組會有不同的處理結果，以下依然區分「個人資訊」及「列表」兩個章節來說明

個人資訊之互動​

個人資訊僅有點擊事件，以下三個位置的點擊事件處理分別為：

點擊位置事件處理備註
個人頭像進入個人主頁
個人顯示名稱進入個人聊天室
QRCode按鈕進入商務號QRCode/官方服務號QRCode頁面

列表之互動​

列表有點擊以及左滑(Trailing Swipe)等事件，以下區分 點擊事件 以及 左滑(Trailing Swipe) 兩個部分說明

列表的點擊事件​

列表點擊事件再區分兩個點擊位置，並依照列表數據分組的不同而有不同的處理方式

點擊頭像​
數據分組事件處理備註
我的最愛進入夥伴主頁
訂閱服務號進入服務號主頁
社團進入社團主頁
夥伴進入夥伴主頁
客戶當團隊有設置客戶主頁AIFF時顯示AIFF，反之顯示APP的客戶主頁
封鎖無
手機聯絡人無
應用無
點擊頭像以外區域​
數據分組事件處理備註
我的最愛進入與該夥伴的單人聊天室
訂閱服務號進入進線該服務號的聊天室
社團 - 建立社團進入建立社團頁面
社團進入社團聊天室
夥伴進入與該夥伴的單人聊天室
客戶進入該客戶進線商務號的聊天室
封鎖進入與該夥伴的單人聊天室
手機聯絡人 - 將手機通訊錄匯入讀取手機通訊錄數據並上傳伺服器
手機聯絡人進入與該聯絡人的單人聊天室
應用開啟AIFF網頁

列表的左滑(Trailing Swipe)事件​

聯絡人列表中僅部分分組有設置左滑(Trailing Swipe)功能項，詳細如下：

數據分組支援左滑功能名稱處理方式備註
我的最愛V主頁進入夥伴主頁
訂閱服務號X
社團V主頁進入社團主頁
夥伴V主頁進入夥伴主頁
客戶X
封鎖X
手機聯絡人X
應用X