跳转到主要内容
文档: 集成与 webhook

连接

集成与 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 助手。

更新于

没有找到需要的内容?

查看常见问题,或给我们写信,我们会帮助你。

常见问题