# HubSpot Intercom Schnittstelle

*HubSpot → Intercom*

**Kurz gesagt:** Eine HubSpot-Intercom-Anbindung hält dieselbe Person und dasselbe Unternehmen in CRM und Messaging-Tool konsistent. Sie überträgt Kontakte, Unternehmen, Lifecycle-Phasen und Listenmitgliedschaften aus HubSpot nach Intercom - abgeglichen über eine stabile externe ID statt über eine fragile E-Mail - damit Support und Onboarding wissen, mit wem sie sprechen. Und sie spielt Intercom-Konversationen, Tags und Ticket-Ergebnisse zurück auf die HubSpot-Timeline, damit Vertrieb und Marketing die ganze Beziehung sehen. Richtig gemacht ist das kein einseitiger Kontaktabzug, sondern eine bidirektionale, idempotente Pipeline, die Rate Limits, Einwilligung und Update-Reihenfolge respektiert.

## Was eine HubSpot-Intercom-Anbindung wirklich leistet

In HubSpot lebt die kommerzielle Beziehung - wer der Kontakt ist, zu welchem Unternehmen er gehört, seine Lifecycle-Phase, auf welchen Marketinglisten er steht, der laufende Deal. In Intercom lebt die Konversation - die Onboarding-Nachricht, der Support-Thread, die Tags, die ein Agent gesetzt hat, das gestern gelöste Ticket. Beide Tools beschreiben dieselben Menschen, und beide liegen übereinander meist daneben.

Eine HubSpot-Intercom-Anbindung schließt diese Lücke, sodass kein Team mehr raten muss. Der Support öffnet eine Konversation und sieht sofort Tarif, Owner und Verlängerungsdatum aus HubSpot. Der Vertrieb öffnet einen HubSpot-Datensatz und sieht die letzte Intercom-Konversation, das offene Ticket und die Tags, die sagen, dass dieser Account unzufrieden ist. Niemand kopiert ein Feld zwischen zwei Browser-Tabs, und die beiden Systeme driften nicht mehr auseinander, kaum dass jemand sie zuletzt von Hand abgeglichen hat.

## Welche Daten fließen

| HubSpot-Objekt / -Ereignis | Wird in Intercom zu | Hinweis |
| --- | --- | --- |
| Kontakt | Kontakt (User oder Lead) | Abgeglichen über external_id (HubSpot-Datensatz-ID), E-Mail als Rückfall |
| Unternehmen | Company | Über die Zugehörigkeit mit dem Kontakt verknüpft |
| Lifecycle-Phase | Custom Data Attribute | Subscriber / Lead / MQL / SQL / Customer auf ein festes Attribut gemappt |
| Kontakt- & Unternehmens-Properties | Custom Data Attributes | Tarif, Owner, Verlängerungsdatum, MRR - Mapping einmalig abgestimmt |
| Mitgliedschaft in aktiver Liste | Tag- oder Segment-Signal | Steuert Intercom-Zielgruppen, ohne die Segmentlogik neu zu bauen |
| Marketing-Einwilligung / Abo | Abo-Status | Einwilligung wird respektiert, nie blind überschrieben |

Und in die Gegenrichtung, damit HubSpot abbildet, was in Intercom tatsächlich passiert ist:

| Vorgang in Intercom | Wird in HubSpot zu | Hinweis |
| --- | --- | --- |
| Konversation geöffnet / geschlossen | Timeline-Ereignis oder Engagement | Datum des letzten Kontakts und Konversationszähler bleiben aktuell |
| Gesetzte Tags | Kontakt- / Unternehmens-Property | z. B. "gefährdet", "Expansion", "Bug gemeldet" |
| Ticket gelöst | Property-Update oder Timeline-Eintrag | Support-Ergebnis für den Account-Owner sichtbar |

Das konkrete Mapping von Property auf Attribut und die Richtung jedes Feldes stimmen wir einmalig ab und hinterlegen sie in der Pipeline. Danach mappt niemand mehr etwas von Hand.

## Die Details, an denen einfache Syncs scheitern

Ein generischer Connector bringt Ihnen Kontakte-in-Intercom und hört vor den teuren Teilen auf:

- **Identitätszuordnung.** Intercom erzwingt keinen Kontakt je E-Mail - ein Lead und ein User können sich eine teilen, und Adressen ändern sich. Gleicht man nur über die E-Mail ab, entstehen Dubletten und verlorene Updates. Die HubSpot-Datensatz-ID gehört in die external_id von Intercom und muss der primäre Schlüssel sein.
- **Custom Data Attributes müssen zuerst existieren.** Intercom nimmt keinen Schreibvorgang auf ein Attribut an, das nicht angelegt wurde, und der Attributtyp ist danach fix. Eine HubSpot-Aufzählung, eine Mehrfachauswahl oder ein Datum (als Epoch gespeichert) muss auf den richtigen Intercom-Typ gemappt werden - Intercom-Zeitstempel sind Unix-Sekunden - und die Attribute müssen vor dem ersten Sync bereitstehen.
- **Rate Limits unterscheiden sich auf beiden Seiten.** HubSpot zählt Anfragen je App über ein gleitendes Fenster und erzwingt Tageslimits, Intercom zählt pro Minute. Ein voller Re-Sync, der das ignoriert, wird gedrosselt und bleibt auf halbem Weg stecken. Die Pipeline arbeitet in Batches, respektiert jedes Limit und bremst ab, statt zu scheitern.
- **Delta- gegen Vollsync.** Im Normalbetrieb laufen HubSpot-Property-Change-Webhooks und Intercom-Webhook-Themen; die Erstbefüllung und jede Wiederherstellung laufen als vollständiger Durchlauf über HubSpots Suche nach lastmodified und Intercoms Scroll-API. Beide müssen zum selben Ergebnis konvergieren.
- **Reihenfolge und Zuständigkeit.** Zwei Updates für denselben Kontakt können in falscher Reihenfolge eintreffen. Ohne Regel gewinnt das ältere und macht ein Feld still rückgängig. Wir vergleichen Update-Zeitstempel und legen vor allem je Feld fest, welches System es führt, damit es keinen uneindeutigen Konflikt gibt.
- **Einwilligung.** Abo-Status und Abmeldungen dürfen von einem blinden Sync nicht überschrieben werden. Die Einwilligung gilt als von einem System geführt und wird nur in die sichere Richtung bewegt.
- **Teilfehler.** In einem Batch von 100 darf ein fehlerhafter Datensatz nicht die anderen 99 mitreißen. Fehlgeschlagene Elemente werden isoliert, erneut versucht und sichtbar gemacht - nie still verworfen.

## Wie wir sie bauen und betreiben

Wir behandeln das als Pipeline, nicht als nächtliches Skript. Änderungen werden per Webhook abgeholt, wo die Plattformen es unterstützen, sonst per geplantem Delta-Durchlauf, validiert, in das abgestimmte Mapping überführt und idempotent geschrieben - ein erneuter Lauf erzeugt so nie einen doppelten Kontakt oder eine doppelt gezählte Konversation.

Sie läuft auf cloud-nativer, vollständig EU-gehosteter AWS-Infrastruktur, sodass Kontakt- und Konversationsdaten die EU nicht verlassen - das hält AVV und DSGVO sauber. Jeder Datensatz trägt durchgängig eine stabile Kennung, sodass die Pipeline immer weiß, was sie bereits übertragen hat.

Und dann halten wir sie am Laufen. Monitoring, Alerting, Incident Response und - entscheidend - das Beobachten von API-Änderungen bei HubSpot und Intercom, eingestellten Webhook-Themen und verschärften Rate Limits liegen vertraglich bei uns. Sie bekommen einen festen Ansprechpartner und ein SLA, keine Wartungslast.

## Wann sich diese Anbindung lohnt

Wenn Sie ein paar hundert Kontakte, eine Lifecycle-Definition und einen Support haben, der selten mehr als eine E-Mail-Adresse braucht, ist die native App oder ein manueller Export völlig in Ordnung - und wir sagen Ihnen das auch. Die Anbindung lohnt sich, wenn Kontaktzahl und Änderungsrate den manuellen Abgleich zur Pflichtübung machen, wenn Ihre Custom Properties und Ihre Lifecycle-Logik in Intercom korrekt abgebildet sein müssen, wenn der Vertrieb Intercom-Konversationen und Ticket-Signale auf der HubSpot-Timeline braucht, oder wenn ein wackeliger Connector ständig Updates verliert und jemand ihn jede Woche still von Hand nachzieht.

## Häufig gestellte Fragen

### Hat HubSpot nicht schon eine native Intercom-App?

Es gibt einen gelisteten Connector, und für ein kleines Team, das nur Kontakte in Intercom sehen will, kann er reichen. An den entscheidenden Stellen wird es dünn: verlässliche Identitätszuordnung, wenn dieselbe E-Mail als Lead und als User existiert, das Synchronisieren Ihrer konkreten Custom Properties und Ihrer Lifecycle-Logik, das Zurückspielen von Intercom-Konversationen auf die HubSpot-Timeline sowie jegliche Kontrolle über Rate Limits, Reihenfolge und Fehlerbehandlung. Eine betriebene Pipeline existiert genau für die Fälle, die die App liegen lässt.

### Wie verhindern Sie doppelte Kontakte in Intercom?

Die E-Mail allein ist kein sicherer Schlüssel - in Intercom können mehrere Kontakte dieselbe E-Mail teilen (etwa ein Lead und ein User), und Adressen ändern sich. Wir schreiben die HubSpot-Datensatz-ID in die external_id von Intercom und gleichen zuerst darüber ab, die E-Mail dient nur als Rückfallebene, wenn keine external_id vorhanden ist. So entsteht genau ein stabiler Intercom-Kontakt je HubSpot-Kontakt, und eine geänderte E-Mail aktualisiert den bestehenden Datensatz, statt einen zweiten anzulegen.

### Lassen sich auch eigene Properties synchronisieren, nicht nur Name und E-Mail?

Ja, und meist ist genau das der Kern des Projekts. Jede HubSpot-Property - Lifecycle-Phase, Tarif, zuständiger Owner, Verlängerungsdatum, MRR - lässt sich auf ein Intercom Custom Data Attribute abbilden, und Intercom-Konversationsdaten lassen sich zurück auf HubSpot-Properties oder Timeline-Ereignisse mappen. Wichtig: Custom Data Attributes müssen in Intercom vorab angelegt werden, bevor etwas hineingeschrieben werden kann, und ihr Typ ist danach fest. Deshalb stimmen wir das Attribut-Mapping vorab mit Ihnen ab und richten es einmalig ein.

### In welche Richtung fließen die Daten?

In der Regel in beide, und die Richtung wird je Feld festgelegt, damit sich die Systeme nicht gegenseitig überschreiben. HubSpot ist üblicherweise die führende Quelle für Identität, Unternehmen und Lifecycle-Daten Richtung Intercom, während Intercom die führende Quelle für Konversationszähler, Datum des letzten Kontakts, Tags und Ticket-Ergebnisse zurück nach HubSpot ist. Wir definieren die Zuständigkeit Feld für Feld, damit es nie einen uneindeutigen Konflikt darüber gibt, wer zuletzt schreibt.

### Wer betreibt die Schnittstelle nach dem Go-live?

Wir. Die Pipeline läuft auf cloud-nativer, vollständig EU-gehosteter Infrastruktur, die wir überwachen. Ändert HubSpot oder Intercom eine Schnittstelle, stellt ein Webhook-Thema ein oder verschärft ein Rate Limit, ist das vertraglich unser Problem - kein stiller Ausfall, den Ihr Team bemerkt, wenn plötzlich ein Segment nicht mehr aktualisiert wird. Sie bekommen einen festen Ansprechpartner, Alerting und ein SLA statt eines Skripts, an dessen Bau sich niemand mehr erinnert.

## Verwandte Integrationen

- [HubSpot ↔ Mailchimp](https://seamless.engineering/de/integrations/hubspot-mailchimp/): HubSpot Mailchimp Schnittstelle
- [HubSpot ↔ Pipedrive](https://seamless.engineering/de/integrations/hubspot-pipedrive/): HubSpot Pipedrive Schnittstelle
- [HubSpot ↔ Salesforce](https://seamless.engineering/de/integrations/hubspot-salesforce/): HubSpot Salesforce Schnittstelle
- [Business Central ↔ HubSpot](https://seamless.engineering/de/integrations/business-central-hubspot/): Business Central HubSpot Schnittstelle
- [HubSpot ↔ QuickBooks](https://seamless.engineering/de/integrations/hubspot-quickbooks/): HubSpot QuickBooks Schnittstelle
- [Intercom ↔ Salesforce](https://seamless.engineering/de/integrations/intercom-salesforce/): Intercom Salesforce Schnittstelle

## Nach System

- [Alle Schnittstellen für HubSpot](https://seamless.engineering/de/integrations/hubspot/)
- [HubSpot API-Changelog](https://seamless.engineering/de/api-changelog/hubspot/): 8 Breaking Changes und 2 Deprecations in den letzten 90 Tagen

## Scoping-Gespräch anfragen

Sie möchten diese Integration umsetzen und dauerhaft betreiben lassen? Sagen Sie uns, welche Systeme verbunden werden sollen und welche Daten fließen müssen. Festpreis-Angebot zur Aufwandsabschätzung innerhalb von 48 Stunden.

- E-Mail: hello@seamless.engineering
- Kontaktformular: https://seamless.engineering/de/#contact