调查Webhooks：发布或从外部数据库获取调查数据

Webhooks允许您通过HTTP帖子或HTTP获取标准与外部网页进行通信。您可以使用Webhook操作将数据拉到调查响应和/或向外部数据库发送调查响应数据。

如果您希望使用Webhooks发送帐户级更新（例如调查创建，调查更新，调查发布和/或调查收到的通知作为回复通知）访问我们的由于人的文件．

设置

Webhook操作可以添加到调查的任何页面，除了第一页．要添加Webhook，请单击行动链接到你的调查页面并选择Webhook．

1. 选择你的方法，邮寄或领取。
   • 默认方法是通过HTTP POST，因为它支持要传输的更大量数据。
   • 如果API或网页需要通过此方法获取数据，也可以使用HTTP GET方法。
2. 指定您的URL.和协议。
   • 可以通过正常发送连接http或者通过一个安全的https.URL。
   • 使用选择合并代码链接将合并代码插入URL字段。如果需要，这将允许您使用从调查中拉入的信息进行动态更新请求URL。
3. 下字段通过你可以选择发布当前响应数据（整个响应）或发布自定义字段(从调查中选择的问题/领域)。
   
   
   • 发布当前响应数据将发送包含在内的信息调查响应子对象．默认情况下，此信息将作为post变量发送，如果您希望更改此设置以JSON格式发送响应数据，请选择此选项。
     
     注意:使用发布当前调查响应数据选项，响应数据将在“响应”键下可用。看例子．
     
   • 发布自定义字段将允许您指定您希望发送的问题/字段作为post变量。要设置此设置，请指定以下内容:
     • 要发送的问题- 从调查中选择一个字段，以发送下拉菜单并单击添加字段．
     • 变量名- 指定变量名称（必需的）
     • 默认值(可选)—如果问卷调查字段没有值，请指定默认值。
       
4. 使用自定义标题章节定义将随请求一起传递的自定义HTTP头。
   • 和上面一样通过田地，你可以引用一个要发送的问题并提供一个变量名为您的自定义标题。一个可选的默认值字段也可用。
   • 您还可以选择发送一个静态值,如果必要的。
     
5. 表明什么时候运行此操作．
   • 默认情况下，WebHook在显示页面时运行。
   • 它可以在提交页面时触发(包括单击Back、Next和Submit按钮时)。
     • 此选项仅与帖子兼容，无法在调查中显示或预先填充问题。
     • 如果您已经将您的Webhook行动在您的调查的感谢页面(或其他终端页面），不要使用此选项。相反，在显示页面时设置要运行的操作。
6. 异步连接-这将异步处理连接;这是一个连接队列。当此选项切换为Yes时，如果操作失败，将重试该操作，这将防止调查表加载缓慢。此选项仅与帖子兼容，无法在调查中显示或预先填充问题。

   1. 异步网络钩子最多可以重试10次。每次尝试重发的时间间隔是(以秒为单位的重发次数)^2。

7. 表明您希望使用从URL返回的数据/内容进行操作。
   • 此选项仅与GET相关。
   • 默认情况下，没有将显示，但是，您可以选择显示它作为基本的HTML页面，或使用它预先配置的问题你指定的，在下一节讨论。
8. 如果您需要在每个调查页面之间执行WebHook，请导航到逻辑按下并检查在每个页面之间运行操作设置。
   

用HTTP获取结果预先填充问题

此方法要求网页直接显示查询字符串作为网页的输出。用户id = 12345帧=鲍勃．

请注意显示的查询字符串不是以？在网页输出中。

这是通过炼金术器解释的，可用于通过选择字段，点击添加字段，并指定变量名(在字段名称列)，定义在网页的显示输出。

逻辑

如果你需要在每个调查页面之后执行你的webhook，导航到逻辑按下并检查在每个页面之间运行操作设置。

在这里，你也可以申请逻辑根据以前问题的答案触发您的Webhook行动。

测试您的Webhook.

有许多可用于测试Webhook的第三方工具，包括Webhook Tester.和麦克风．我们在下面使用Webhook测试仪突出显示。

1. 转到以下链接：https://webhook.site/#/．
2. 输入网站时，将自动为您生成唯一的URL。单击右上角的“复制”按钮将您的唯一测试URL复制到剪贴板。注意：请勿使用图像中的链接，它是为我们特定实例创建的唯一链接，它将无法为您工作。
   
3. 返回调查，并创建或编辑Webhook行动。
4. 在Webhook操作中粘贴您唯一的Webhook测试仪URL。
5. 保存您的行动并记录调查响应。
6. 要查看发布的结果，请返回Webhook测试仪。每次提交新响应时，它将在左侧菜单的请求列表中显示。单击它查看请求详细信息。
   

HTTP Post结果导出

默认情况下，导出中包含HTTP Post结果。这将包含每个响应的操作结果。

Webhook局限性

• 管道字段不能被传递。
• post自定义字段post选项有200个字段的上限。如果你想要增加你的帽子联络支持．或者，您可以使用发布当前响应数据，它将作为发布变量或JSON发布整个响应。使用get方法可以提取多少字段并没有真正的限制!
• Webhooks不能添加到调查的第一页。
• Webhooks只会每10秒运行一次。如果您的受访者在10秒内再次点击并在10秒内快速重新提交Webhook。

常见问题解答

我可以使用自定义端口吗？

不可以。我们使用用于HTTP的HTTP和端口443的端口80。请不要使用自定义端口，因为它会导致操作变得无法运行。

用于发布数据的内容类型是什么?

Webhook通过Content-Type: application/x-www-form-urlencoded传递数据。

我可以看到帖子当前响应数据选项的示例吗？

以下是JSON响应数据的示例：

[response] =>{"is_test_data": false， "session_id": "1487806491_58ae201be29097.19130318"， "language": "English"， "date_started": "2017-02-22 18:35:02 EST"， "link_id": "123456"， "url_variables": {"name": "jane"}， "ip_address": "10.142.0.130"， "referer": "http://survey.alchemer.com/s3/1234567/Webhook-Survey"， "user_agent": "Mozilla/5.0 (Macintosh;Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/ 560.2924.87 Safari/537.36"， "response_time": 0， "data_quality": []， "survey_data": {"5": {"id": 5， "type": "RADIO"， "question": "Gender"， "section_id": 1， "answer": "male"， "answer_id": 10001， "shown": true}}}