SurveyMonkey 添加 webhook

Question

我们的印象是，我们可以为使用收件人/批量添加的每个收件人添加一个 webhook/url。因此，如果我们的收件人如下所示，我们就可以将 webhook 数据添加到每个条目中。看了一会儿文档后，情况似乎并非如此。：

{
    "contacts" :[{
        "email":"email@here.com",
        "first_name": "John",
        "last_name": "Doe",
        "custom_fields": {
            "1": "2428156"
        }
    },
    {
        "email":"somebodyelse@here.com",
        "first_name": "Somebody",
        "last_name": "Else",
        "custom_fields": {
            "1": "2428143"
        }
    }]
}

有人知道这是否可能吗？如果没有，其他人如何批量发送收件人并让该列表中的每个人都转到正确的 webhook URL 以解析响应？

提前致谢， 哇哦

Answer 1

可用的 webhook 事件适用于 响应 而不是收件人。您可能想要做的是为您的所有回复提供one webhook，例如：

POST /v3/webhooks
{
    "name": "Test Webhook",
    "event_type": "response_completed",
    "object_type": "survey",
    "object_ids": ["<survey_id>"],
    "subscription_url": "http://example.com/mywebhook"
}

然后，对于指定调查的每条已完成消息，您都会收到一条通知，其中包含类似于您的订阅 URL 的正文：

{
    "respondent_id": "<response_id>",
    "recipient_id": "<recipient_id>",
    "survey_id": "<survey_id>",
    "user_id": "<user_id>",
    "collector_id": "<collector_id>"
}

recipient_id 将让您知道该特定响应是针对哪个收件人，您可以将其用于任何您的用例。如果您需要更多信息，您可以请求获取response details

GET /v3/surveys/<survey_id>/responses/<response_id>/details

或者，如果您不想要答案，请不要包含 /details，只想要该响应的元数据。

或者，如果您想具体了解该收件人的更多详细信息而不是回复，您可以获取 recipient details

GET /v3/collectors/<collector_id>/recipients/<recipient_id>

这为您提供了您可能存储在 extra_fields 或诸如此类的信息。