Schnittstellen
Teil von Marketing-Schnittstellen
Formularfelder auf Kontaktdatensätze abbilden
Legen Sie für Formularfelder Zielattribute, erlaubte Werte und Änderungsregeln fest und prüfen Sie das Ergebnis am Kontaktdatensatz.
Jedes Formularfeld braucht ein Zielattribut, einen passenden Wert und eine Regel für spätere Änderungen. Die sichtbare Beschriftung allein legt nicht fest, welches CRM-Feld befüllt wird oder was bei erneuter Übermittlung geschieht.
Eine Feldliste anlegen
Erfassen Sie Beschriftung, internen Feldnamen, Zielattribut, Datentyp und erlaubte Werte. Trennen Sie Angaben zum Kontakt von Angaben, die nur diese eine Übermittlung beschreiben.
| Formularangabe | Mögliches Ziel | Offene Entscheidung |
|---|---|---|
| E-Mail-Adresse | Kontaktattribut und möglicher Suchwert | Wie wird ein vorhandener Kontakt erkannt? |
| Vorname | Kontaktattribut | Darf eine leere Eingabe einen Namen löschen? |
| Produktinteresse | Definierte CRM-Auswahl | Welche internen Werte entsprechen den Formularoptionen? |
| Anlass der Anfrage | Ereignis zur Übermittlung | Soll ein dauerhafter Kontaktwert geändert werden? |
Ein Anfragetext gehört nicht automatisch in ein dauerhaftes Feld „letztes Interesse“. Eine neue Übermittlung kann sonst frühere Angaben überschreiben, obwohl beide Vorgänge relevant bleiben.
Werte und Formate prüfen
Vergleichen Sie die internen Werte beider Systeme. Eine Option mit der sichtbaren Bezeichnung „Beratung“ kann im CRM eine andere Kennung haben. Für HubSpot-Kontakt-APIs müssen Werte von Auswahleigenschaften zu den definierten Optionen passen; ungültige Werte führen zu einem Fehler.
Bei der HubSpot-Formularübermittlungs-API können Datumswerte im Format YYYY-MM-DD oder als UTC-mitternachtsausgerichtete Unix-Millisekunden übermittelt werden. Datums- und Uhrzeitwerte können das Format YYYY-MM-DDThh:mm:ss.sTZD oder Unix-Millisekunden verwenden. Für bestehende Formulare kann das bisher verwendete Format weiterhin akzeptiert werden.
Legen Sie für unbekannte Auswahlwerte einen sichtbaren Fehlerfall fest. Eine willkürliche Standardoption würde den Datensatz befüllen, aber seine Bedeutung verfälschen.
Datumsformate in HubSpot-Formular-API
- Akzeptiertes Format 1
- YYYY-MM-DD
- Akzeptiertes Format 2
- UTC-mitternachtsausgerichtete Unix-Millisekunden
- Weitere Optionen
- YYYY-MM-DDThh:mm:ss.sTZD oder Unix-Millisekunden
Kontakt und Änderungsregel bestimmen
Wenn die Quelle eine verlässliche CRM-ID besitzt, kann die Zuordnung darauf aufbauen. Andernfalls ist eine Such- oder Anlegeregel nötig. Eine E-Mail-Adresse allein klärt geänderte oder gemeinsam genutzte Adressen nicht; legen Sie fest, wie solche Treffer geprüft werden.
Entscheiden Sie pro Feld, ob ein leerer Wert einen vorhandenen Wert löscht, unverändert lässt oder eine Prüfung auslöst. Bei der nativen HubSpot-Salesforce-Integration hängt das Verhalten von der gewählten Synchronisationsregel ab.
Das Ergebnis abnehmen
Legen Sie erwartete Zielwerte für einen neuen Kontakt, einen vorhandenen Kontakt, eine leere Angabe, einen unbekannten Auswahlwert und eine wiederholte Übermittlung fest. Kontrollieren Sie anschließend den Kontakt und den Datensatz der Übermittlung.
Bei einer Übergabe über die HubSpot-Formular-API prüfen Sie zusätzlich die Formulardefinition: Für nicht aufgeführte CRM-Felder gelten je nach Authentifizierung und bisheriger Nutzung unterschiedliche Regeln.
