Guide technique · Intégrations

Connectez QR vCard Pro à n'importe quel CRM

Un guide étape par étape : comment connecter un webhook QR vCard Pro à Zapier, et Zapier à votre CRM, sans écrire de code.

QR vCard Pro→ Zapier→ CRM / 6 000+ applications

0Prérequis

1Créer le webhook dans QR vCard Pro

  1. Dans l'administration WordPress, ouvrez QR vCard Pro → Webhooks.
  2. Cliquez sur Add webhook.
  3. URL, collez ici l'adresse que Zapier vous donne (étape 2).
  4. Events, choisissez contact.received (ou tous, *).
  5. Enregistrez. Le système génère une clé secrète utilisée pour signer chaque appel.
ℹ️

Trois events : contact.received (un lead est arrivé, le principal pour le CRM), card.created et scan.recorded.

2Zapier : capter le webhook

  1. Dans Zapier, créez un nouveau Zap.
  2. Pour le Trigger, choisissez Webhooks by Zapier.
  3. Pour l'Event, choisissez Catch Hook.
  4. Copiez la Custom Webhook URL que Zapier affiche.
  5. Collez-la dans votre webhook dans QR vCard Pro et enregistrez.
  6. Cliquez sur Test (ou faites un véritable échange) pour que Zapier apprenne les champs.
✅

Astuce : lancez d'abord le test, Zapier « apprend » alors les champs (data.email…) et les propose pour le mappage.

3Connecter à votre CRM

Ajoutez une étape Action et choisissez votre CRM. Mappez les champs du webhook (préfixés 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 (requis).

Google Sheets (le plus simple)

Action Create Spreadsheet Row : chaque lead devient une ligne.

🔁

Activez le Zap (Publish). À partir de là, chaque nouveau contact.received arrive automatiquement dans votre CRM, en temps réel.

4Référence du payload

Chaque webhook est un POST HTTP avec un corps JSON. Les données utiles se trouvent dans le champ 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" } }
ÉvénementChamps clés dans 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

En-têtes HTTP

X-QRVP-Eventle nom de l'événement
X-QRVP-Signaturesha256=<HMAC>
X-QRVP-DeliveryID de livraison unique
X-QRVP-Attemptnuméro de tentative de nouvel envoi

5Sécurité, signature HMAC

Chaque appel porte X-QRVP-Signature sous la forme sha256=<hash>, le HMAC-SHA256 du corps, signé avec le secret. Le destinataire peut ainsi confirmer que l'appel vient de votre site.

ℹ️

Le Catch Hook de Zapier n'a pas besoin de vérifier la signature (l'URL est secrète). La vérification compte pour votre propre endpoint :

$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; }

6Dépannage

SymptômeCause et solution
Zapier ne capte pas le testURL mal collée, ou le webhook n'est pas abonné. Vérifiez l'URL et que contact.received est sélectionné.
Pas de page « Webhooks »Le forfait est inférieur à Unlimited. Les webhooks commencent au forfait Unlimited.
Champs CRM videsLe mappage utilise le mauvais chemin, les champs sont sous data (par ex. data.email).
Les appels sont retardésLa livraison est asynchrone (WP-Cron). Pour une livraison instantanée, configurez un vrai cron système.

Prêt à automatiser vos leads ?

Les webhooks sont inclus à partir du forfait Unlimited.

Voir les tarifs