> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.
# HubSpot
> Verbinde HubSpot mit telli, um Kontakte mit deinem Workspace zu synchronisieren und HubSpot-Eigenschaften auf telli-Kontakteigenschaften zuzuordnen.
## Überblick
Mit der HubSpot-Integration von telli kannst du CRM-Daten in telli übernehmen, ohne eine eigene Synchronisation aufzubauen.
Die aktuelle Version konzentriert sich auf die eingehende Synchronisation von HubSpot nach telli:
* HubSpot per OAuth direkt in der telli App verbinden
* HubSpot-`Contact`-Datensätze nach telli synchronisieren
* HubSpot-Kontakteigenschaften auf telli-Kontakteigenschaften abbilden
* Filtern, welche HubSpot-Kontakte synchronisiert werden sollen
* Agenten während Anrufen mit aktuellem CRM-Kontext versorgen
Die HubSpot-CRM-Integration befindet sich aktuell in der Beta-Phase. Nutze Workflows, um Daten abgeschlossener Anrufe zurück nach HubSpot zu schreiben, zum Beispiel indem HubSpot-Datensätze nach Anrufen erstellt oder aktualisiert werden. Das ist von der eingehenden Kontaktsynchronisation getrennt.
HubSpot Meetings ist eine separate Kalender-Integration. Nutze [HubSpot Meetings](./hubspot-meetings), wenn Agenten während Anrufen Termine über HubSpot-Meeting-Links buchen sollen.
## Voraussetzungen
* Zugriff auf die telli App
* Zugriff auf das HubSpot-Portal, das du verbinden möchtest
* Ein HubSpot-Benutzer, der die telli App mit Kontakt- und Kontakt-Schema-Berechtigungen autorisieren kann
* Eine klare Vorstellung davon, welche telli-Kontakteigenschaften HubSpot-Daten erhalten sollen
## HubSpot in telli einrichten
Gehe in telli zu **Einstellungen** -> **Integrationen** -> **HubSpot** und wähle **Konfigurieren**, um die Einrichtungsseite zu öffnen.
Wähle **HubSpot verbinden** und schließe den HubSpot-OAuth-Flow für das Portal ab, das du verbinden möchtest.
Wähle **Contact** als Objekt für die Synchronisation aus. Die aktuelle HubSpot-CRM-Integration unterstützt nur HubSpot-Kontakte.
Ordne HubSpot-Kontakteigenschaften den telli-Kontakteigenschaften zu, die dein Team verwendet.
Begrenze die Kontakte, die synchronisiert werden sollen, wenn nur ein Teil deiner HubSpot-Kontakte in telli landen soll.
Speichere deine Konfiguration und bestätige, dass der Integrationsstatus verbunden und aktiv ist.
## So funktioniert die Synchronisation
Nachdem OAuth abgeschlossen ist, liest telli die HubSpot-Contact-Metadaten ein, damit du Zuordnungen direkt in der App konfigurieren kannst.
Wenn du diese Zuordnungen speicherst, bereitet telli die HubSpot-Contact-Sync-Konfiguration vor und hält die HubSpot-Journal-Subscription mit deiner aktivierten Konfiguration synchron. Erstellungen, Aktualisierungen, Wiederherstellungen und Löschungen von HubSpot-Kontakten werden anhand deiner Mapping- und Filterkonfiguration verarbeitet.
## Feldzuordnungen
Mit Feldzuordnungen legst du fest, wie HubSpot-Daten telli-Kontakte befüllen sollen.
* Ordne HubSpot-Kontakteigenschaften den telli-Eigenschaften zu, die deine Workflows bereits verwenden
* Konfiguriere Zuordnungen für HubSpot-`Contact`-Datensätze
* Die HubSpot-Kontakt-URL wird automatisch synchronisiert
So erhalten deine Agenten aktuellen CRM-Kontext vor und während Anrufen, ohne dass dein Team Daten manuell zwischen Systemen kopieren muss.
## Sync-Filter
Du kannst zusätzliche Bedingungen definieren, um zu steuern, welche HubSpot-Kontakte mit telli synchronisiert werden.
Standardmäßig müssen HubSpot-Kontakte einen Vornamen, Nachnamen und eine Telefonnummer haben, um nach telli synchronisiert zu werden. Danach kannst du in den Integrationseinstellungen weitere Filter hinzufügen, um die passenden Kontakte weiter einzugrenzen.
## Daten per Workflow nach HubSpot zurückschreiben
Die eingehende Kontaktsynchronisation bringt HubSpot-Kontaktdaten nach telli. Um Daten abgeschlossener Anrufe zurück nach HubSpot zu senden, nutze [Workflows](../platform/workflows) mit HubSpot-Aktionen zum Erstellen oder Aktualisieren von Datensätzen.
Workflow-Write-back kann HubSpot-Datensätze anhand von Anrufergebnissen, gesammelten Daten oder anderen Workflow-Bedingungen erstellen oder aktualisieren. Diese Funktion wird getrennt von den Contact-Sync-Zuordnungen auf dieser Seite konfiguriert.
## Verbindung verwalten
Auf der HubSpot-Integrationsseite in telli kannst du:
* ein bestehendes HubSpot-Portal erneut verbinden
* die OAuth-Verbindung trennen und Zuordnungen für eine spätere Wiederverbindung behalten
* die Integration vollständig entfernen
* die Sync-Konfiguration erneut deployen, wenn der Status **Nicht bereitgestellt** angezeigt wird
## Fehlerbehebung
* **Autorisierung abgelaufen oder Token widerrufen**: Verbinde die Integration auf der HubSpot-Seite in telli erneut.
* **Fehlende Berechtigungen**: Verbinde HubSpot erneut, um die neuesten telli-Berechtigungen zu genehmigen, wenn telli meldet, dass erforderliche Berechtigungen fehlen.
* **Datensätze werden nicht synchronisiert**: Bestätige, dass die Integration verbunden und aktiv ist, und prüfe dann die Contact-Zuordnungen und Sync-Filter.
* **Kontakt wird übersprungen**: Stelle sicher, dass der HubSpot-Kontakt einen Vornamen, Nachnamen und eine Telefonnummer hat und zu deinen zusätzlichen Filtern passt.
* **Falscher Integrationstyp**: Nutze [HubSpot Meetings](./hubspot-meetings) für Terminbuchungen. Die HubSpot-CRM-Integration ist für CRM-Sync und Workflow-Write-back gedacht.