如何使用 surveymonkey api v3 添加批量電子郵件 ID

Question

在SurveyMonKey API版本V2的情况下接收者eleminID简单地发送给消息。

但是，对于V3版本，是否有一种简单的方法可以将所有收件人添加到批量上并为所有这些收件人发送电子邮件？下面发送消息的流程将仅添加一个收件人电子邮件ID，否则我们必须使用新的EmailID进行几个" Post/Collectors/{ID}/Message/{ID}/收件人"的帖子。我们如何使用一个API调用并将消息发送到该收件人列表中？

post/surveys/{id}/collectors-> post/collectors/{id}/messages-> post/collectors/{id}/message/{id}/{id}/cocketers-> post/collectors/{id}/messages/{id}/send

Answer 1

唯一的方法是您现在在V3中建议的方式。我唯一要添加的是有一个批量的收件人端点。

所以你会

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": "[e-mail]",
        "first_name": "User 1",
        "last_name": "Testing" 
    },{
        "email": "[e-mail]",
        "first_name": "User 2",
        "last_name": "Testing" 
    }]
}

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