Webhook 是一个轻量的事件处理应用，在指定事件发生时立即调用。系统每个收集器都支持 Webhook，当指定事件触发时调用预先配置的地址，并传出参数。

Webhook 触发事件

Webhook 配置区域有 3 个输入框，用于填写以下 3 种事件触发时的回调地址：

• 回复完成：被访者完成问卷并提交结果时触发。
• 回复不合格：被访者被甄别时触发。
• 回复超过了设定的配额：被访者完成甄别题目开始进入问卷正式题目内容时，系统会判断被访者对应的配额是否还有空余配额，当还有配额时被访者可以继续问卷，否则触发该事件。

Webhook 调用方式

Webhook 支持 4 种不同的调用方式：

• BACKEND

事件发生后会在后台调用这个接口，后台调用默认以POST方式调用。

• GET

事件发生后会在前端以GET方式调用这个接口，后面可以附加参数，请求参数将会拼接到 URL 的后面。

• POST

事件发生后会在前端以POST方式调用这个接口，请求时参数会放到 HttpRequest 的 body 中。

• 跳转

事件发生情况后会直接跳转到该网址页面。

可以在每个事件的调用方式下拉菜单种设置，随后在输入框种填入调用地址即可。

在网址中注入变量

网络地址中还可以通过{{varName}}的方式注入问卷编辑器中的变量，而且只能注入显式变量和系统变量。

例如：

问卷链接中带入了员工姓名参数，问卷内容中要求输入员工工号，在 Webhook 里，希望能把员工工号和姓名传出去。

假设员工姓名叫lucy，通过问卷链接最后添加key1参数的形式注入，参考形式为：[问卷链接]?key1="lucy"，Webhook 的目标地址为：https://www.choiceform.com。

这时，需要注入 2 个变量：var1和key1：

• var1： 这是一个显式变量，显式变量注入时需要确保在问卷编辑器中已经创建了一个名叫var1的变量，这里可以对应到问卷里面一道提示输入员工工号的题目；

• key1： key1是问卷编辑器中内置的URL 参数变量，被访者打开问卷页面时，会解析出这些变量的值。

根据以上各项，最终的 Webhook 地址应为：https://www.choiceform.com?number={{var1}}&name={{key1}}。

被访者 lucy回复问卷时，key1解析到的值是lucy，如果她输入了员工工号0001，那么var1解析到的值是0001。最后跳转的真实地址会是：https://www.choiceform.com?number=0001&name=lucy。