只有当客户证言能自动流向你业务中的其他环节——CRM、Slack、邮件营销平台、表格——它的价值才能被真正释放。SocialProof.Reviews 在每次收到新证言时都会触发一个 Webhook,为你提供一个可路由到任何地方的实时触发点。
Webhook 是一种 HTTP POST 请求:每当有新证言提交时,你的工作区就会将其发送到你指定的 URL。请求载荷包含了本次提交的所有信息——评论者的姓名、邮箱、评分、评论内容、图片和元数据。你的接收系统可以对它做任何事:记录日志、通知团队、更新 CRM 记录,或触发培育邮件序列。
登录 SocialProof.Reviews,打开你的工作区,在管理后台中进入 Embed & Integrations(嵌入与集成)板块,找到 Webhooks 标签。
粘贴用于接收 POST 请求的 URL。它可以是:
点击 Save(保存),然后点 Send test event(发送测试事件)向你的端点发送一条示例载荷。在上线前先确认它能正确送达。
每次提交证言时发送的 JSON 载荷结构如下:
{
"event": "testimonial.submitted",
"workspaceId": "abc123",
"testimonialId": "t_xyz789",
"submittedAt": "2026-03-17T10:30:00Z",
"reviewer": {
"name": "Jane Smith",
"email": "[email protected]",
"jobTitle": "Head of Marketing",
"company": "Acme Corp",
"photoUrl": "https://..."
},
"rating": 5,
"review": "This tool completely changed how we collect and display customer feedback.",
"photos": ["https://...", "https://..."],
"videoUrl": null,
"approved": false,
"source": "collect-form"
}
Zapier 让你无需写代码就能把 SocialProof.Reviews 连到 6000+ 个应用上。
登录 zapier.com,点击 Create Zap。
https://hooks.zapier.com/hooks/catch/123456/abcdef/ 的专属 Webhook URL⚠️ **重要:**Zapier 只有在主动等待触发时才会接收测试载荷。如果它没在监听,你会收到 401 错误。
现在可以连接任何你想要的动作。一些示例:
在 Slack 中通知你的团队:
New ⭐⭐⭐⭐⭐ review from {{reviewer__name}} at {{reviewer__company}}: "{{review}}"#testimonials把评论者加入邮件列表(Mailchimp):
{{reviewer__email}}{{reviewer__name}}testimonial-submitted写入 Google 表格:
在 HubSpot 中创建联系人:
{{reviewer__email}}点击 Publish(发布),此后每一条新证言都会自动触发你的工作流。
Make 是一个更可视化、对开发者更友好的自动化平台。如果你需要多步流程、条件逻辑或数据转换,它是理想选择。
登录 make.com,点击 Create a new scenario。
https://hook.eu1.make.com/abc123xyz 的 URL——把它复制下来⚠️ **重要:**Make 只有在主动监听时才会接受 Webhook。如果不在监听模式,你会收到 401 错误。
收到测试载荷后,Make 会列出自动化中可用的每一个字段。你会看到:
几个典型的 Make 自动化示例:
按评分过滤再通知:
rating >= 4 时继续#wins 频道自动审核通过高评分证言:
approved 置为 true带条件逻辑地写入 CRM:
reviewer.company 非空 → 更新 Salesforce 中的公司记录reviewer.company 为空 → 添加到 Mailchimp 消费者列表在 Notion 数据库中创建条目:
点击场景编辑器左下角的电源开关启用场景。此后 Make 将处理每一条进来的证言 Webhook。
SocialProof.Reviews 从一组固定的 IP 地址发送 Webhook,并附带一个签名头(X-SPR-Signature),你可以用它来验证请求的真实性。验证方法:
HMAC-SHA256X-SPR-Signature 中的值对比这样可以防止重放攻击,也能确保没人能伪造虚假证言混入你的自动化流程。
| 使用场景 | 平台 | 触发器 | 动作 |
|---|---|---|---|
| 实时 Slack 提醒 | Zapier | testimonial.submitted | Slack 消息 |
| 自动打标签到邮件列表 | Make | testimonial.submitted(rating ≥ 4) | 为订阅者打标签 |
| 记录所有评论 | Zapier | testimonial.submitted | Google 表格新增一行 |
| 推送到 CRM | Make | testimonial.submitted | HubSpot / Salesforce 联系人 |
| 自动审核通过 5 星 | Make | testimonial.submitted(rating = 5) | API PATCH approved=true |
| 触发培育序列 | Zapier | testimonial.submitted | Mailchimp 自动化 |
在你责怪 Make、Zapier 或自己的服务器之前,先确认 SocialProof.Reviews 确实把请求发出去了:
你应该在应用中看到 ✓ Sent! Payload delivered to your endpoint.,同时一两秒内 webhook.site 会出现一条新请求。点开它就能查看完整的 JSON 载荷。
如果 webhook.site 收到了,说明 SocialProof.Reviews 的 Webhook 功能正常——问题出在你的 Make/Zapier 配置,而不是在平台。继续看第 2 步。
如果 webhook.site 没有收到,仔细检查是否在粘贴 URL 后点过 Save changes,以及 Enable webhooks(启用 Webhook)开关是否打开。
Make 返回 401 意味着 Webhook 令牌无效或未注册——Make 不认识这个 URL。常见原因是场景在 Webhook 创建后没正确保存,或者 Webhook 被删除了。仅仅点击 "Run once" 无法修复 401,你需要完全重建 Webhook 模块。
Make 会捕获载荷并展示所有可用字段。点击 OK 确认数据结构,然后继续搭建你的场景。
✗ HTTP 401 — Make/Zapier 拒绝了请求。 最常见的原因是你点发送测试时 Make 或 Zapier 并未主动监听,或 Webhook 令牌无效(Make 请参见上面的第 2 步)。解决办法:
✗ HTTP 404 — 找不到 Webhook URL。 URL 被删除了,或者场景/Zap 被禁用了。回到 Make 或 Zapier,确认 Webhook 模块是否还存在,并复制一个新的 URL。
✗ 无法连接 / HTTP 0。
URL 不可达,或你还没保存它。确保你在粘贴 URL 后点过 Save changes,并且 URL 以 https:// 开头。
测试能送达,但真实提交过不来。 检查两件事:(1)Enable webhooks 开关已打开并保存;(2)你想要的事件已在 Events to send(要发送的事件)下勾选。只有在 Webhook 启用状态下,真实提交才会触发。
我的端点没收到 Webhook。 检查你的 URL 是否公网可达——localhost URL 会被拒绝。用 webhook.site 确认载荷确实在发送(见上面的第 1 步)。
我收到了重复事件。
在接收端以 testimonialId 作为去重键实现幂等处理。