Technischer Leitfaden · Integrationen

Verbinden Sie QR vCard Pro mit jedem CRM

Eine Schritt-für-Schritt-Anleitung: wie Sie einen QR vCard Pro-Webhook mit Zapier verbinden und Zapier mit Ihrem CRM, ohne Code zu schreiben.

QR vCard Pro→ Zapier→ CRM / 6.000+ Apps

0Voraussetzungen

1Den Webhook in QR vCard Pro erstellen

  1. Öffnen Sie im WordPress-Adminbereich QR vCard Pro → Webhooks.
  2. Klicken Sie auf Add webhook.
  3. URL, fügen Sie hier die Adresse ein, die Zapier Ihnen gibt (Schritt 2).
  4. Events, wählen Sie contact.received (oder alle, *).
  5. Speichern. Das System erzeugt einen geheimen Schlüssel, mit dem jeder Aufruf signiert wird.
ℹ️

Drei Events: contact.received (ein Lead ist eingegangen, der wichtigste fürs CRM), card.created und scan.recorded.

2Zapier: den Webhook abfangen

  1. Erstellen Sie in Zapier einen neuen Zap.
  2. Wählen Sie als Trigger Webhooks by Zapier.
  3. Wählen Sie als Event Catch Hook.
  4. Kopieren Sie die Custom Webhook URL, die Zapier anzeigt.
  5. Fügen Sie sie in Ihren Webhook in QR vCard Pro ein und speichern Sie.
  6. Klicken Sie auf Test (oder führen Sie einen echten Austausch durch), damit Zapier die Felder lernt.
✅

Tipp: Führen Sie zuerst den Test aus, Zapier „lernt" dann die Felder (data.email…) und bietet sie zum Zuordnen an.

3Mit Ihrem CRM verbinden

Fügen Sie einen Action-Schritt hinzu und wählen Sie Ihr CRM. Ordnen Sie die Webhook-Felder zu (mit Präfix 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 (erforderlich).

Google Sheets (am einfachsten)

Action Create Spreadsheet Row: Jeder Lead wird zu einer Zeile.

🔁

Schalten Sie den Zap ein (Publish). Von da an fließt jedes neue contact.received automatisch und in Echtzeit in Ihr CRM.

4Payload-Referenz

Jeder Webhook ist ein HTTP-POST mit einem JSON-Body. Die nützlichen Daten stehen im Feld 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" } }
EventSchlüsselfelder in 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-Header

X-QRVP-Eventder Event-Name
X-QRVP-Signaturesha256=<HMAC>
X-QRVP-Deliveryeindeutige Zustellungs-ID
X-QRVP-AttemptNummer des Wiederholungsversuchs

5Sicherheit, HMAC-Signatur

Jeder Aufruf trägt X-QRVP-Signature als sha256=<hash>, den HMAC-SHA256 des Bodys, signiert mit dem Secret. So kann der Empfänger bestätigen, dass der Aufruf von Ihrer Website kommt.

ℹ️

Zapiers Catch Hook muss die Signatur nicht prüfen (die URL ist geheim). Die Prüfung ist für Ihren eigenen Endpoint wichtig:

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

6Fehlerbehebung

SymptomUrsache & Lösung
Zapier fängt den Test nicht abURL falsch eingefügt, oder der Webhook ist nicht abonniert. Prüfen Sie die URL und dass contact.received ausgewählt ist.
Keine Seite „Webhooks"Der Tarif liegt unter Unlimited. Webhooks beginnen beim Unlimited-Tarif.
CRM-Felder leerDas Mapping nutzt den falschen Pfad, die Felder liegen unter data (z. B. data.email).
Aufrufe sind verzögertDie Zustellung ist asynchron (WP-Cron). Für sofortige Zustellung richten Sie einen echten System-Cron ein.

Bereit, Ihre Leads zu automatisieren?

Webhooks sind ab dem Unlimited-Tarif aufwärts enthalten.

Preise ansehen