技术指南 · 集成

将QR vCard Pro连接到任意CRM

一份分步指南：如何在不写代码的情况下，把QR vCard Pro的Webhook连接到Zapier，再把Zapier连接到您的CRM。

QR vCard Pro→ Zapier→ CRM / 6,000+ 应用

0前提条件

1在QR vCard Pro中创建Webhook

  1. 在WordPress后台，打开 QR vCard Pro → Webhooks。
  2. 点击 Add webhook。
  3. URL，把Zapier给您的地址粘贴到这里（第2步）。
  4. Events，选择 contact.received（或全部，*）。
  5. 保存。系统会生成一个用于为每次调用签名的 密钥。
ℹ️

三个事件：contact.received（来了一条线索，对CRM最关键）、card.created 和 scan.recorded。

2Zapier：捕获Webhook

  1. 在Zapier中，创建一个新的 Zap。
  2. 在 Trigger 处，选择 Webhooks by Zapier。
  3. 在 Event 处，选择 Catch Hook。
  4. 复制Zapier显示的 Custom Webhook URL。
  5. 把它粘贴到QR vCard Pro中的Webhook里并保存。
  6. 点击 Test（或进行一次真实交换），让Zapier学习字段。
✅

提示：先运行测试，Zapier便会“学习”字段（data.email…）并提供它们用于映射。

3连接到您的CRM

添加一个 Action 步骤并选择您的CRM。映射Webhook字段（前缀 data.）：

HubSpot

Action Create or Update Contact: data.email → Email, data.name → Name, data.phone → Phone, data.company → Company.

Pipedrive

Action Create Person: data.name → Name, data.email → Email, data.phone → Phone.

Salesforce

Action Create Lead: data.name → Last Name, data.email → Email, data.company → Company（必填）。

Google Sheets（最简单）

Action Create Spreadsheet Row：每条线索成为一行。

🔁

打开Zap（Publish）。从此，每一个新的 contact.received 都会实时自动流入您的CRM。

4Payload 参考

每个Webhook都是一个带JSON主体的HTTP POST。有用的数据在 data 字段中。

// contact.received { "event": "contact.received", "occurred_at": "2026-05-28T12:00:00+00:00", "plugin_version": "1.39.1", "data": { "contact_id": 42, "card_id": 1800, "name": "Marko Marković", "email": "marko.markovic@primer.rs", "phone": "+381 64 000 0000", "company": "Primer doo", "consent_given": true, "acquisition_method": "direct_form", "received_at": "2026-05-28T12:00:00+00:00" } }
事件关键字段 data
contact.receivedcontact_id, card_id, name, email, phone, company, message, consent_given, acquisition_method, received_at
card.createdcard_id, title, slug, landing_url, created_at, updated_at, meta
scan.recordedcard_id, action, scanned_at

HTTP 头

X-QRVP-Event事件名称
X-QRVP-Signaturesha256=<HMAC>
X-QRVP-Delivery唯一投递ID
X-QRVP-Attempt重试次数

5安全，HMAC 签名

每次调用都带有 X-QRVP-Signature，形如 sha256=<hash>，即用密钥签名的请求体的HMAC-SHA256。接收方由此可以确认调用来自您的网站。

ℹ️

Zapier的 Catch Hook 无需验证签名（URL是保密的）。验证对您自己的端点才重要：

$body = file_get_contents('php://input'); $expected = 'sha256=' . hash_hmac('sha256', $body, $secret); $received = $_SERVER['HTTP_X_QRVP_SIGNATURE'] ?? ''; if (! hash_equals($expected, $received)) { http_response_code(401); exit; }

6故障排查

症状原因与解决
Zapier没有捕获到测试URL粘贴错误，或Webhook未订阅。检查URL以及是否已选中 contact.received。
没有“Webhooks”页面级别低于Unlimited。Webhook从Unlimited套餐开始提供。
CRM字段为空映射使用了错误的路径，字段位于 data 之下（例如 data.email）。
调用有延迟投递是异步的（WP-Cron）。如需即时投递，请设置真正的系统cron。

准备好让您的线索自动化了吗？

Webhook从Unlimited级别起包含。

查看价格