连接
集成与 webhook
把 Repliq 与你的工具连接:Google 商家资料、来自网店或预约的自动邀请,以及用于通知你系统的签名 webhook。
Google 商家资料
这是主要连接:Repliq 通过 Google 官方授权(OAuth)读取评价并发布回复。你可以随时在“门店”中断开,或在 Google 账户中撤销访问权限。
自动邀请(入站 webhook)
在集成中为你的工具(Shopify、WooCommerce、Stripe、Square、Calendly、HubSpot、Zapier、Make、n8n 或自定义)创建一个私密链接,并在该工具中将其设为 webhook。当有订单送达、付款或预约时,Repliq 会读取客户的姓名以及邮箱或电话,并向其发送评价邀请,同时遵守退订、重复和方案限额。
出站 webhook
发生以下事件时,Repliq 可以向一个公开的 https 地址发送 JSON POST,通知你的系统(或 Zapier、Make、n8n):
| 事件 | 时机 |
|---|---|
review.created | 收到一条新评价。 |
review.negative | 收到一条 1 星或 2 星评价。 |
review.published | 一条回复已发布到 Google。 |
每次发送都带有 X-Repliq-Event、X-Repliq-Delivery(唯一标识,可避免重复处理)和 X-Repliq-Signature 请求头,后者格式为 t=<时间戳>,v1=<签名>。签名是用创建 webhook 时显示的密钥,对 <时间戳>.<请求体> 计算的 HMAC-SHA256。
javascript
import crypto from 'node:crypto';
// rawBody:收到的原始请求体(字符串),不要重新序列化。
export function verifyRepliqSignature(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
const expected = crypto.createHmac('sha256', secret)
.update(`${parts.t}.${rawBody}`)
.digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && parts.v1?.length === expected.length
&& crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected));
}- 返回 2xx 状态码以确认送达。
- 如果失败,Repliq 会以递增的间隔重试(1、2、4…分钟,最长 6 小时),最多 8 次。
- 连续失败 25 次后 webhook 会被停用;在你的系统准备好后,请在“集成”中重新创建。
- 出于安全考虑,不接受私有地址以及 443 以外的端口。
AI 助手
Claude、ChatGPT 和任何 MCP 客户端都通过 Repliq 的 MCP 服务器连接。参见AI 助手。
更新于
没有找到需要的内容?
查看常见问题,或给我们写信,我们会帮助你。
常见问题