ステップごとのガイドです。QR vCard ProのWebhookをZapierに、ZapierをあなたのCRMに、コードを書かずに接続する方法です。
contact.received を選びます（またはすべて、*）。3つのイベント：contact.received（リードが入った、CRMで最も重要）、card.created、scan.recorded。
ヒント：まずテストを実行すると、Zapierがフィールド（data.email…）を「学習」し、マッピング用に提示します。
Action ステップを追加し、CRMを選びます。Webhookのフィールド（接頭辞 data.）をマッピングします。
Action Create or Update Contact: data.email → Email, data.name → Name, data.phone → Phone, data.company → Company.
Action Create Person: data.name → Name, data.email → Email, data.phone → Phone.
Action Create Lead: data.name → Last Name, data.email → Email, data.company → Company（必須）。
Action Create Spreadsheet Row：各リードが1行になります。
Zapをオンにします（Publish）。それ以降、新しい contact.received はすべて、リアルタイムで自動的にあなたのCRMに流れ込みます。
すべてのWebhookは、JSONボディを持つHTTPの POST です。有用なデータは data フィールドにあります。
| イベント | 主なフィールド data |
|---|---|
contact.received | contact_id, card_id, name, email, phone, company, message, consent_given, acquisition_method, received_at |
card.created | card_id, title, slug, landing_url, created_at, updated_at, meta |
scan.recorded | card_id, action, scanned_at |
X-QRVP-Event | イベント名 |
X-QRVP-Signature | sha256=<HMAC> |
X-QRVP-Delivery | 一意の配信ID |
X-QRVP-Attempt | 再試行の回数 |
すべての呼び出しは X-QRVP-Signature を sha256=<hash> として運びます。これはボディのHMAC-SHA256で、秘密鍵で署名されています。これにより受信側は、呼び出しがあなたのサイトから来たことを確認できます。
Zapierの Catch Hook は署名を検証する必要はありません（URLが秘密だからです）。検証が重要になるのは、あなた自身のエンドポイントです。
| 症状 | 原因と対処 |
|---|---|
| Zapierがテストを受け取らない | URLの貼り付けが間違っているか、Webhookが購読されていません。URLと、contact.received が選択されていることを確認してください。 |
| 「Webhooks」ページがない | ティアがUnlimited未満です。WebhookはUnlimitedプランから始まります。 |
| CRMのフィールドが空 | マッピングのパスが間違っています。フィールドは data の下にあります（例：data.email）。 |
| 呼び出しが遅れる | 配信は非同期です（WP-Cron）。即時配信には、本物のシステムcronを設定します。 |