目录 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. 确认「发送内容」文案后，点击「立即发送」（或按定时设置发送）。

说明：取消选中仅影响本次发送，下次进入编辑页时标签仍会默认选中。已通过其他方式完成评价的人员会被过滤，不再出现在待发送列表中。此页面不提供「添加联系人」及「获取链接和二维码」入口。

三、查看发送状态

1. 发送后，点击「查看发送状态」进入状态页。

2. 可按全部、发送中、未作答、已作答、发送失败等筛选联系人列表，查看姓名、部门、ThirdUserId、邮箱、状态与发送时间。

3. 对发送失败的记录，可点击「重新发送」再次推送。

4. 评价者作答后，在「统计分析」→「查看下载答卷」中，「来源渠道」显示为「通讯录API」，并可查看来源渠道详情与评价关系。

配置选项详解

- 启用联系人：评价关系页开关。开启后才能在发送页看到「内部消息(API)」，并从联系人中选择被评者/评价者。

- 发送时间：支持立即发送或定时发送，与普通问卷 API 发送一致。

- 显示在待参与列表：开启后，邀请可出现在联系人的待参与列表中（适用于通讯录中的作者场景）。

- 匿名功能：开启后，填写者提交时隐藏通讯录姓名和部门信息。

常见问题

问：为什么发送页面看不到「内部消息(API)」？

答：请确认评价关系已开启「启用联系人」，且账号已使用通讯录功能。两项任一不满足时，入口不会显示。

问：点击「内部消息(API)」后提示需要对接开通，怎么办？

答：该能力需先完成通讯录 API 对接。请联系 SurveyMars 支持或客户成功团队开通后再使用。

问：能否同时使用邮件发送和 API 发送？

答：可以。电子邮件、密码登录与内部消息(API) 支持同时勾选，不再互斥。

问：编辑内部消息时取消了某位评价者，下次还会发给他吗？

答：取消选中仅对本次生效。下次再进入编辑页时，该评价者仍会默认选中（若尚未完成评价），可再次发送。

问：评价者已通过邮件作答，还会出现在 API 发送列表里吗？

答：不会。已完成评价的人员会被过滤，与邮件发送的过滤逻辑一致，避免重复邀请。