通訊錄 API 傳送

SurveyMars 360 度評估支援透過「內部訊息(API)」向通訊錄當中的評價者傳送測評邀請。評價者可於企業通訊錄/待參與清單收到內部訊息並完成填答，適合已完成通訊錄 API 對接的企業客戶，無須仰賴電子郵件即可聯繫評價者。

功能概述

在 360 度評估的「發送問卷」階段，除電子郵件、密碼登入外，還可使用「內部訊息(API)」發送。此方式仰賴評價關係內的聯絡人資訊，將測評邀請推送至已開通的通訊錄管道。填答紀錄於統計分析頁面的來源管道會顯示為「通訊錄API」。

使用前提

使用前請確認以下條件皆已滿足，否則發送頁可能不會顯示「內部訊息(API)」入口，或是無法順利完成發送：

1. 帳號已開通並啟用通訊錄功能。

2. 已聯繫 SurveyMars 完成 API 對接開通；尚未開通時點擊入口會提示需聯繫進行對接設定。

3. 在評價關係清單中已開啟「啟用聯絡人」，並從聯絡人名單設定被評者與評價者。

說明：未啟用聯絡人時，發送頁面不會出現「內部訊息(API)」入口。

使用步驟

一、選擇內部訊息(API) 發送方式

1. 開啟目標 360 度評估問卷，進入「發送問卷」。

2. 在左側「發送方式」中勾選「內部訊息(API)」。

3. 勾選之後，右側評價者清單不再顯示電子郵件欄位；頁面上方引導文字會提示您可「編輯內部訊息」或「檢視發送狀態」（若先前已發送過邀請）。

說明：電子郵件、密碼登入與內部訊息(API) 可同時勾選，功能互不排斥，可依場景彈性搭配使用。

二、編輯並發送內部訊息

1. 點擊上方引導區的「編輯內部訊息」，進入內部訊息編輯頁。

2. 在「發送給」區塊，系統以標籤形式顯示待發送評價者姓名，預設全部選取。可點擊標籤取消本次發送；也可使用「取消全選」或右上角反選功能快速調整收件人名單。

3. 依需求設定發送時間（立即發送 / 定時發送），以及聯絡人相關選項（如「顯示於待參與清單」「匿名功能」等）。

4. 確認「發送內容」文案無誤後，點擊「立即發送」（或是依照定時設定送出）。

說明：取消選取僅影響本次發送，下次進入編輯頁時標籤仍會預設勾選。已經透過其他管道完成評價的人員將自動過濾，不會出現於待發送清單。此頁面不提供「新增聯絡人」及「取得連結與QR Code」入口。

三、檢視發送狀態

1. 發送完成後，點擊「檢視發送狀態」進入狀態頁。

2. 可依全部、發送中、尚未填答、已填答、發送失敗等條件篩選聯絡人清單，檢視姓名、部門、ThirdUserId、電子信箱、狀態與發送時間。

3. 針對發送失敗的紀錄，可點擊「重新發送」再次推送邀請。

4. 評價者完成填答之後，於「統計分析」→「檢視下載填答」頁面，「來源管道」會顯示為「通訊錄API」，並可檢視來源管道詳細資訊與評價關係。

設定選項詳解

- 啟用聯絡人：評價關係頁面的開關。開啟之後才能在發送頁看見「內部訊息(API)」，並從聯絡人名單挑選被評者/評價者。

- 發送時間：支援立即發送或定時發送，規則與一般問卷 API 發送相同。

- 顯示於待參與清單：開啟後，邀請訊息將出現在聯絡人的待參與清單（適用於通訊錄內使用者場景）。

- 匿名功能：開啟之後，填寫者送出資料時將隱藏通訊錄姓名和部門資訊。

常見問題

問：為什麼發送頁面看不到「內部訊息(API)」？

答：請確認評價關係已開啟「啟用聯絡人」，且帳號已啟用通訊錄功能。兩項任一條件未達成時，入口就不會顯示。

問：點擊「內部訊息(API)」後提示需要對接開通，該怎麼辦？

答：此項功能必須先完成通訊錄 API 對接。請聯繫 SurveyMars 支援或是客戶成功團隊開通後再使用。

問：能否同時使用電子郵件發送和 API 發送？

答：可以。電子郵件、密碼登入與內部訊息(API) 支援同時勾選，功能互不排斥。

問：編輯內部訊息時取消了某位評價者，下次還會發給他嗎？

答：取消選取僅對本次發送生效。下次再進入編輯頁時，該評價者仍會預設勾選（若尚未完成評價），可再次發送邀請。

問：評價者已透過電子郵件完成填答，還會出現在 API 發送清單裡嗎？

答：不會。已完成評價的人員將會被過濾，與電子郵件發送的過濾邏輯一致，避免重複寄送邀請。