HubSpot
HubSpot unter Fertige Integrationen mit dem Token einer Private App und sechs Scopes einschalten. Legt den Kontakt per E-Mail an oder aktualisiert ihn, erfasst Kauf und Verlängerung als gewonnenen Deal ohne Duplikate, setzt den Abo-Status und nimmt Formulareinsendungen an, ohne Kontakte zu überschreiben.
HubSpot erhält Mitglieder als Kontakte und Verkäufe als gewonnene Deals: „Legt den Kontakt in HubSpot an oder aktualisiert ihn und erfasst Käufe und Verlängerungen als gewonnene Deals.“
Rolle: Eigentümer und Administrator. Wie man jede App einschaltet, testet, ausschaltet und entfernt, steht unter Fertige Integrationen.
1. Lege die Private App in HubSpot an
Du musst Super-Admin des HubSpot-Kontos sein.
- Öffne in HubSpot Einstellungen › Integrationen › Private Apps und klicke auf Private App erstellen.
- Gib einen Namen ein (Memberfy).
- Markiere im Tab Scopes alle sechs:
| Scope | Wofür |
|---|---|
crm.objects.contacts.read | Den Kontakt per E-Mail finden |
crm.objects.contacts.write | Den Kontakt anlegen und aktualisieren |
crm.objects.deals.read | Den Deal eines schon erfassten Ereignisses finden |
crm.objects.deals.write | Den Deal anlegen und mit dem Kontakt verknüpfen |
crm.schemas.contacts.write | Die Eigenschaft für den Abo-Status am Kontakt anlegen |
crm.schemas.deals.write | Die Eigenschaft anlegen, die doppelte Deals verhindert |
- Klicke auf App erstellen und kopiere das Zugriffstoken. Es beginnt mit
pat-.
Der Memberfy-Bildschirm listet die Scopes auch unter Benötigte Scopes.
2. Schalte es in Memberfy ein
- Klicke unter Einstellungen › Integrationen und APIs › Integrationen auf HubSpot.
- Füge es unter Private-App-Token ein.
- Wähle die Ereignisse und markiere Diese App empfängt: ….
- Klicke auf Einschalten und dann auf Test senden. Der Test prüft nur das Token: Er legt keinen Kontakt an.
Was ankommt
Der Kontakt wird über die E-Mail erkannt.
| Ereignis | In HubSpot |
|---|---|
| Ein Mitglied ist der Community beigetreten | Legt den Kontakt an (Vorname, Nachname, E-Mail und Telefonnummer) oder aktualisiert Namen und Telefonnummer des bestehenden |
| Ein Kauf wurde abgeschlossen | Ein gewonnener Deal Kauf: {Produkt} mit dem gezahlten Betrag, in der Standard-Pipeline, mit dem Kontakt verknüpft; der Abo-Status des Kontakts wird active |
| Ein Abo wurde verlängert | Ein gewonnener Deal Verlängerung: {Produkt}, ebenso |
| Ein Abo wurde gekündigt | Der Abo-Status des Kontakts wird canceled |
| Ein Formular wurde gesendet | Legt den Kontakt mit Name, E-Mail, Telefon, Unternehmen und Position aus dem Formular an und erfasst, wenn die Person zugestimmt hat, die Einwilligung. Bei einem bestehenden Kontakt siehe unten |
- Ohne Duplikate: Jeder Deal speichert das Ereignis, das ihn erzeugt hat (die Eigenschaft Memberfy event id). Ein neuer Versuch oder ein Erneut senden findet den schon angelegten Deal und legt keinen weiteren an.
- Beide Eigenschaften, Memberfy subscription status (am Kontakt) und Memberfy event id (am Deal), werden beim ersten Mal automatisch angelegt.
- Telefonnummer: geht im internationalen Format (
+5541999998888) mit, wenn das Mitglied eine hinterlegt hat. Bei den anderen Ereignissen kommt sie nur in einen Kontakt, der dabei neu angelegt wird; was HubSpot schon hat, wird nicht überschrieben. - Der Deal-Name kommt in der Sprache der Community.
- Bittet HubSpot ums Warten (Ratenlimit), wartet die Zustellung und versucht es erneut, ohne dass es als Fehler zählt.
Formulareinsendungen
- Ein Besucher ändert nie einen bestehenden Kontakt. Jede Person kann in einem offenen Formular die E-Mail einer anderen eingeben. Deshalb wird die Einsendung eines Besuchers (oder eines Mitglieds mit einer anderen E-Mail) an einen bestehenden Kontakt nur zu einer Notiz am Kontakt, mit dem, was gesendet wurde.
- Die Einsendung eines angemeldeten Mitglieds mit der E-Mail aus dem eigenen Profil füllt die leeren Eigenschaften des Kontakts (Name, Telefon, Unternehmen, Position) und erfasst die Einwilligung. Mit Formulare aktualisieren bestehende Kontakte eingeschaltet aktualisiert sie auch die schon ausgefüllten.
- HubSpot schon früher eingeschaltet? Die Installation bekommt das Ereignis nicht von selbst: Öffne HubSpot unter Integrationen, markiere Ein Formular wurde gesendet und speichere. Eine neue Installation hat es schon.
Häufige Probleme
- „Der Anbieter hat die Zugangsdaten abgelehnt.“ Das Token wurde geändert oder die Private App gelöscht. Füge das neue Token ein und speichere.
- Zustellungen scheitern mit 403. Einer der sechs Scopes fehlt. Bearbeite die Private App in HubSpot, markiere den fehlenden und teste erneut.
- Die App ist Fehlerhaft. Siehe Wegen Fehlern ausgeschaltet.