WhatsApp Business API Integration in Ihr CRM (funktionierendes Setup)

Hier ist eine frustrierende Realität: Sie bringen WhatsApp-Gespräche zum Laufen, Reps antworten, Leads zeigen Interesse, und dann tauchen 40 % dieser Kontakte nie in Ihrem CRM auf. Nicht wegen einer technischen Einschränkung, sondern weil die Integration fehlerhaft konfiguriert wurde und lautlos versagt.

Ein RevOps Manager bei einem B2B SaaS-Unternehmen entdeckte das, als sie einen WhatsApp-Report zog und ihn mit HubSpot verglich. Die Lücke war real und hatte sich zwei Monate lang aufgebaut. Die Behebung dauerte einen Nachmittag, sobald sie herausfand, welchen Pfad sie nutzte und was falsch konfiguriert war.

Dieser Leitfaden führt Sie durch die drei wichtigsten Integrations-Setups: ManyChat zu HubSpot, Respond.io zu HubSpot und Webhook zu einem beliebigen CRM, mit dem jeweiligen Field Mapping, der Deduplizierungslogik und den UTM-Attributionsschritten.

Ihren Integrationspfad wählen

Wählen Sie Ihren Pfad, bevor Sie irgendwelche Einstellungen anfassen. Die Entscheidung hängt von Ihrem bestehenden Tech-Stack und CRM ab. Laut der offiziellen Dokumentation der WhatsApp Business Platform von Meta unterstützt die Business API drei Authentifizierungsstufen mit unterschiedlichen Messaging-Funktionen. Ihr Integrationspfad bestimmt, welche Stufe für Ihren Anwendungsfall gilt. Wenn Sie noch entscheiden, welche Chat-Plattform zu Ihrem Workflow passt, listet der Vergleich Respond.io vs. ManyChat für B2B Sales die Kompromisse übersichtlich auf.

Wenn Sie HubSpot nutzen und aktiv Flows in ManyChat aufbauen, wählen Sie Pfad A. Wenn Sie alle Chat-Operationen über Respond.io abwickeln, bietet Pfad B eine tiefere Synchronisierung. Wenn Ihr CRM nicht HubSpot ist, ist Pfad C Ihre Option.

Pfad A: ManyChat zu HubSpot

Integration aktivieren

Gehen Sie in ManyChat zu Einstellungen, dann Integrationen, dann HubSpot. Sie benötigen:

• Ein HubSpot-Konto mit Kontaktzugriff
• Eine ManyChat-Adminrolle
• HubSpot API Key oder OAuth-Verbindung (OAuth wird bevorzugt)

Klicken Sie auf Verbinden, autorisieren Sie die HubSpot-Verbindung und bestätigen Sie das verknüpfte Portal.

Erforderliche HubSpot-Berechtigungen

Der verbindende HubSpot-Nutzer benötigt mindestens: Kontakte (anzeigen und bearbeiten), Properties (anzeigen) und Workflows (anzeigen). Wenn Sie HubSpot-Workflows verwenden, die durch ManyChat-Daten ausgelöst werden, fügen Sie Workflows (bearbeiten) hinzu.

Kontaktfelder zuordnen

ManyChat-Subscriber-Daten werden auf HubSpot-Kontakt-Properties gemappt. Hier ist das Standard-Mapping und was Sie anpassen möchten:

Um ein Custom Attribute zu mappen, gehen Sie zu ManyChat, dann Integrationen, dann HubSpot, dann Field Mapping, und fügen Sie eine neue Zeile hinzu. Die HubSpot-Property muss vorhanden sein, bevor Sie mappen können. Erstellen Sie sie zuerst in HubSpot unter Kontakte, dann Properties.

Kontakteigentümer-Zuweisung

ManyChat kann einen HubSpot-Kontakteigentümer per Round-Robin oder festen Eigentümer zuweisen. Richten Sie das unter den HubSpot-Integrationseinstellungen und Standard-Eigentümer ein. Für Teams mit gebietsbasiertem Routing müssen Sie einen HubSpot-Workflow verwenden, der bei Kontakterstellung ausgelöst wird, um auf Basis von Unternehmen oder Region neu zuzuweisen.

Was synchronisiert wird und was nicht

ManyChat synchronisiert Kontakt-Properties und sendet optional eine Notiz mit einer Gesprächszusammenfassung. Vollständige Gesprächsprotokolle werden nicht nativ in HubSpot synchronisiert. Für den Gesprächsverlauf benötigen Sie Pfad B oder ein Webhook-Workaround.

Die Integration sendet auch keine Kontaktaktualisierungen in Echtzeit bei jeder Nachricht. Sie löst bei spezifischen Ereignissen in Ihrem Flow aus, typischerweise beim opt-in oder wenn ein Flow-Schritt die HubSpot-Aktion auslöst.

Pfad B: Respond.io zu HubSpot

Verbindung über das native HubSpot-Modul von Respond.io herstellen

Gehen Sie in Respond.io zu Einstellungen, dann Integrationen, dann HubSpot. Sie authentifizieren sich per OAuth. Respond.io erfordert ein HubSpot-Admin-Konto für die erstmalige Verbindung.

Nach der Verbindung erstellt Respond.io eine bidirektionale Synchronisierung: In Respond.io erstellte Kontakte erscheinen in HubSpot, und bestehende HubSpot-Kontakte können in Respond.io-Gespräche gezogen werden.

Lifecycle Stage Mapping

Respond.io kann HubSpot Lifecycle Stages auf Basis von Gesprächsereignissen aktualisieren. Konfigurieren Sie das unter den HubSpot-Integrationseinstellungen:

• Neuer Kontakt aus WhatsApp: Lead
• Qualifizierungsfragen abgeschlossen: Marketing Qualified Lead
• Meeting gebucht: Sales Qualified Lead

Stellen Sie diese Mappings so ein, dass sie automatisch auslösen, wenn der relevante Flow-Schritt abgeschlossen ist.

Kontakt-Deduplizierung per Telefonnummer

Respond.io verwendet die Telefonnummer als primären Deduplizierungsschlüssel bei der Synchronisierung mit HubSpot. Wenn ein Kontakt mit der gleichen E.164-formatierten Telefonnummer bereits in HubSpot existiert, aktualisiert Respond.io den bestehenden Datensatz, anstatt ein Duplikat zu erstellen.

Der Haken: Das Telefonnummernformat muss exakt übereinstimmen. Wenn HubSpot „+1 (555) 000-0000" hat und Respond.io „+15550000000" sendet, wird keine Deduplizierung stattfinden. Standardisieren Sie alle Telefonnummern auf das E.164-Format in beiden Systemen. In HubSpot können Sie einen Workflow mit der Aktion „Telefonnummer formatieren" verwenden, um bestehende Datensätze zu normalisieren.

Optionen zur Synchronisierung des Gesprächsverlaufs

Respond.io kann den Gesprächsverlauf als Notiz im HubSpot-Kontaktdatensatz ablegen. Aktivieren Sie das unter HubSpot-Integration, dann Synchronisierungsoptionen, dann Gespräche protokollieren. Jedes Gespräch wird als zeitgestempelte Notiz mit dem vollständigen Austausch gespeichert.

Das ist der größte Vorteil von Pfad B gegenüber Pfad A für Teams, die möchten, dass Reps vor dem Anruf eines chat-generierten Leads den Kontext einsehen können.

Pfad C: Webhook zu beliebigem CRM

Respond.io Webhook-Payload strukturieren

Respond.io unterstützt ausgehende Webhooks, die durch Gesprächsereignisse ausgelöst werden (neuer Kontakt, Nachricht empfangen, Flow-Schritt abgeschlossen). Konfigurieren Sie diese unter Einstellungen, dann Entwickler, dann Webhooks.

Eine Beispiel-Payload, wenn ein Kontakt einen Qualifizierungs-Flow-Schritt abschließt:

{
  "event": "contact.updated",
  "contact": {
    "id": "abc123",
    "phone": "+15550001234",
    "firstName": "Jane",
    "lastName": "Chen",
    "customAttributes": {
      "company_size": "50-200",
      "use_case": "sales_automation",
      "timeline": "Q2_2026",
      "source_ad_id": "23849572894"
    },
    "createdAt": "2026-04-18T09:32:00Z",
    "optInTimestamp": "2026-04-18T09:31:47Z"
  },
  "conversation": {
    "id": "conv_xyz789",
    "channel": "whatsapp"
  }
}

Den Zapier- oder Make-Zap aufbauen

In Zapier:

1. Trigger: Webhooks by Zapier, dann Catch Hook
2. Kopieren Sie die Webhook-URL in Respond.io
3. Senden Sie einen Test-Kontakt durch den Flow, um Beispieldaten zu befüllen
4. Aktion: Kontakt in Ihrem CRM erstellen oder aktualisieren
5. Felder aus der Webhook-Payload auf CRM-Felder mappen
6. Filterschritt hinzufügen: nur fortfahren, wenn phone nicht leer ist

In Make (früher Integromat) verwenden Sie das Webhooks-Modul als Trigger und leiten dann zum Modul „Kontakt erstellen/aktualisieren" Ihres CRM weiter.

Das Telefonnummern-Format-Problem lösen

WhatsApp sendet Telefonnummern immer im E.164-Format. Die meisten CRMs akzeptieren E.164, aber einige (insbesondere Salesforce) haben lokale Formatanforderungen. Fügen Sie in Zapier/Make einen Textformatierschritt hinzu, um die Ländervorwahl zu entfernen oder das Format anzupassen, bevor die CRM-Aktion ausgelöst wird.

UTM und Quellzuordnung

Wenn ein Kontakt Ihren WhatsApp Funnel über eine Meta-Anzeige betritt, werden die Anzeigenquell-Daten mitgeführt, aber nur wenn Sie die Übergabe korrekt verdrahtet haben. Das vollständige Anzeigen-Setup für diese Attributions-Pipeline finden Sie im Leitfaden zu Click-to-WhatsApp-Werbekampagnen.

Meta übergibt einen ad_id- und campaign_id-Parameter, wenn das Gespräch aus einer Click-to-WhatsApp-Anzeige initiiert wird. Respond.io erfasst diese automatisch in den Gesprächsmetadaten. ManyChat erfasst sie als User-Input-Variablen, wenn Sie den Meta-Anzeigenquellen-Schritt Ihrem Flow hinzugefügt haben.

So erhalten Sie kampagnenebene Attribution in Ihrem CRM:

1. ad_id, ad_set_id und campaign_id als Custom Attributes in Ihrer Chat-Plattform speichern
2. Diese ins Field Mapping oder den Webhook-Payload zum CRM einbeziehen
3. Eine benutzerdefinierte HubSpot-Property „WhatsApp Campaign Source" erstellen, die auf campaign_id gemappt wird
4. Einen HubSpot-Report gefiltert nach „WhatsApp Campaign Source" aufbauen, um Pipeline nach Kampagne zu sehen

Das liefert Ihnen eine einfache Kampagnen-zu-Pipeline-Ansicht ohne ein zusätzliches Attributionstool.

Deduplizierungsregeln

Wenn dieselbe Telefonnummer mehrfach in Ihren Funnel eintritt (häufig bei Retargeting-Kampagnen), benötigt Ihre Integration eine klare Regel. Das ist besonders relevant, wenn Lead-Capture-Automatisierung Kontakte gleichzeitig aus mehreren Kanälen einzieht.

Die Prioritätsreihenfolge:

1. Zuerst auf Telefonnummer abgleichen (E.164 normalisiert)
2. Bei Übereinstimmung: bestehenden Datensatz aktualisieren, keinen neuen anlegen
3. Bei keiner Übereinstimmung: neuen Kontakt anlegen, als neuen Lead kennzeichnen
4. Wenn Telefonnummer übereinstimmt, aber E-Mail abweicht: E-Mail nur aktualisieren, wenn der bestehende Datensatz keine E-Mail hat

In HubSpot erfolgt die native Deduplizierung standardmäßig nur auf Basis der E-Mail-Adresse. Für telefonnummernbasierte Deduplizierung verwenden Sie einen HubSpot-Workflow: bei Kontakterstellung auslösen, nach bestehendem Kontakt per Telefonnummer suchen und bei Übereinstimmung die Datensätze mit einem Custom-Code-Schritt oder einer Drittanbieter-Deduplizierungs-App wie Dedupely zusammenführen.

In Salesforce verwenden Sie Duplikatregeln unter Einrichtung, dann Duplikatverwaltung, mit einer Abgleichregel für das Telefonnummernfeld. Eine Gartner-Studie zur CRM-Datenqualität ergab, dass schlechte Datenqualität Unternehmen durchschnittlich 12,9 Millionen US-Dollar pro Jahr kostet. Telefonnummern-Deduplizierung ist eine der kosteneffizientesten Abhilfemaßnahmen.

Integration testen

Führen Sie diese 6-Schritt-Sequenz durch, bevor Sie live gehen:

1. Senden Sie sich selbst mit einer Test-Telefonnummer durch den vollständigen WhatsApp-Flow
2. Überprüfen Sie in Ihrer Chat-Plattform (ManyChat/Respond.io), ob der Kontakt mit allen befüllten Custom Attributes erstellt wurde
3. Warten Sie 2 bis 3 Minuten, dann prüfen Sie in Ihrem CRM, ob ein neuer Kontakt mit der übereinstimmenden Telefonnummer vorhanden ist
4. Verifizieren Sie, dass jedes gemappte Feld mit dem korrekten Wert angekommen ist, insbesondere Custom Attributes
5. Prüfen Sie, ob der Kontakteigentümer korrekt zugewiesen wurde
6. Senden Sie einen zweiten Test mit derselben Telefonnummer, um Deduplizierung zu überprüfen (Aktualisierung, nicht Duplikat)

Wenn Schritt 3 fehlschlägt: Prüfen Sie zuerst Ihren Integrationsstatus, dann schauen Sie im Ereignisprotokoll Ihrer Chat-Plattform nach Sync-Fehlern.

Wenn Schritt 4 mit fehlenden Custom Attributes fehlschlägt: Bestätigen Sie, dass das Attribut während des Flows befüllt wurde (prüfen Sie den Kontaktdatensatz in ManyChat/Respond.io) und dass das Field Mapping korrekt konfiguriert ist.

Häufige Fehler

Telefonnummern-Format-Diskrepanz. Der mit Abstand häufigste Fehler. Normalisieren Sie auf E.164 überall, bevor Sie irgendein Mapping aufbauen. GDPR-konforme Chat Funnels für EU-Käufer behandelt zusätzliche Anforderungen für die Speicherung von Telefonnummern, wenn sich Ihre Kontakte in der EU befinden.

Fehlender opt-in Zeitstempel. GDPR und WhatsApp Business Policy verlangen beide, dass Sie festhalten, wann ein Nutzer sich angemeldet hat. Speichern Sie den opt-in Zeitstempel von Anfang an als CRM-Feld, nicht als Nachgedanke.

CRM blockiert Datensätze ohne E-Mail-Adresse. HubSpot und Salesforce können so konfiguriert werden, dass bei der Kontakterstellung eine E-Mail erforderlich ist. WhatsApp-Kontakte haben oft keine erfasste E-Mail. Entfernen Sie entweder die E-Mail-Anforderung für chat-generierte Kontakte oder erfassen Sie die E-Mail als Flow-Schritt.

HubSpot Property-Typ-Konflikte. Wenn Sie ein ManyChat-Textattribut auf eine HubSpot-Number-Property mappen, schlägt die Synchronisierung lautlos fehl. Stimmen Sie Property-Typen exakt ab: Text zu Text, Zahl zu Zahl, Dropdown zu Dropdown.

Nächste Schritte

Sobald Ihre Integration bestätigt funktioniert, erstellen Sie eine CRM-Ansicht, gefiltert nach „WhatsApp Campaign Source ist nicht leer". Kombinieren Sie diese Ansicht mit einem soliden CRM-Datenmodell-Design, damit Ihre benutzerdefinierten Chat-Properties von Anfang an in einem konsistenten Schema sitzen. Das wird Ihre laufende Ansicht für die Verfolgung chat-generierter Pipeline. Prüfen Sie diese wöchentlich im Vergleich zu Ihren anderen Lead-Quellen, um den Beitrag des Kanals zu sehen.

Verbinden Sie von dort aus die Attribution mit dem Umsatz. Wenn ein chat-generierter Lead abschließt, kennzeichnen Sie den Deal mit der ursprünglichen Kampagnenquelle. Nach 60 Tagen haben Sie genug Daten, um das Werbebudget auf die Kampagnen zu optimieren, die nicht nur Gespräche, sondern abgeschlossene Deals liefern.

Mehr erfahren

• Meta Ads zu WhatsApp Chat Funnel von Anfang bis Ende einrichten
• Lead-Routing-Automatisierung für chat-generierte Leads
• Wie das Ende des Kontaktformulars die Lead-Erfassung verändert
• CRM-Workflow-Automatisierung für Ops-Teams
• Chat Funnel Performance messen: die Metriken, die zählen
• Respond.io mit HubSpot von Anfang bis Ende einrichten