如何使用surveymonkey api v3添加批量电子邮件ID

Question

如果是 v2 版本的surveymonkey api，“https://api.surveymonkey.net/v2/batch/send_flow”的正文包含数组中的收件人列表，将简单地将所有收件人 emailID 添加到消息中。

但是在版本 v3 的情况下，是否有一种简单的方法可以批量添加所有收件人并为所有这些收件人发送电子邮件？以下发送消息的流程将只添加一个收件人 emailID，否则我们必须每次使用新的 emailID 执行几次“POST /collectors/{id}/messages/{id}/recipients”的 POST 调用。我们如何通过一个 api 调用将所有 emailID 添加到收件人列表中并将消息发送到该收件人列表？

POST /surveys/{id}/collectors -> POST /collectors/{id}/messages -> POST /collectors/{id}/messages/{id}/recipients -> POST /collectors/{ id}/messages/{id}/send

Answer 1

唯一的方法就是你现在在 V3 中建议的方法。我唯一要补充的是有一个bulk recipient endpoint。

你会的

POST /surveys/{id}/collectors
POST /collectors/{id}/messages
POST /collectors/{id}/messages/{id}/recipients/bulk
POST /collectors/{id}/messages/{id}/send

倾向于将这些拆分的部分原因是为了更好的事务管理。例如，如果您调用 send_flow 并创建了一个收集器和一条消息，然后由于任何原因尝试添加收件人时出错，您将留下挥之不去的收集器/消息。这样您就可以自己处理每个错误情况下发生的情况。

SurveyMonkey 正在考虑发布一些具有类似封装功能的 SDK，以及可能的批处理请求端点，但目前这是在 API 中发送消息的过程。

批量收件人端点的使用示例：

您可以像这样一次性将联系人列表添加到您的消息中：

POST /collectors/{id}/messages/{id}/recipients/bulk
{
    "contact_ids": ["1000", "10001"]
}

您可以像这样一次性添加联系人列表中的所有联系人：

POST /collectors/{id}/messages/{id}/recipients/bulk
{
    "contact_list_ids": ["2000", "20001"]
}

或者您可以像这样通过电子邮件手动添加任意数量的联系人：

POST /collectors/{id}/messages/{id}/recipients/bulk
{
    "contacts": [{
        "email": "user1@example.com",
        "first_name": "User 1",
        "last_name": "Testing" 
    },{
        "email": "user2@example.com",
        "first_name": "User 2",
        "last_name": "Testing" 
    }]
}

我相信您可以从一个请求中添加所有这三种方法。