Plenum mit HubSpot verbinden
Diese Anleitung erklärt Ihnen Schritt für Schritt, wie Sie Ihr HubSpot-Portal mit Plenum verbinden, welche Berechtigungen dabei erteilt werden und wie Sie die Verbindung jederzeit wieder aufheben können.
Zuletzt aktualisiert: 2026-06-28
Übersicht
Plenum ist nativ für HubSpot entwickelt: Die Anwendung läuft direkt auf Ihrem HubSpot-Portal und liest sowie schreibt ausschliesslich Ihre eigenen HubSpot-Daten. Plenum greift dabei nur auf jene Bereiche zu, für die Sie ausdrücklich Ihre Zustimmung erteilt haben. Ihre Daten verlassen HubSpot nicht und werden von by Nu weder gespeichert noch für eigene Zwecke verwendet. Der Betrieb erfolgt auf Servern von Infomaniak in der Schweiz.
Voraussetzungen
- Ein aktives HubSpot-Konto (jeder Plan genügt; Marketing Events ist auf allen HubSpot-Plänen enthalten).
- Ein HubSpot-Benutzer mit Administratorrechten oder der Berechtigung, Apps zu installieren bzw. Integrationen zu verwalten.
- Ein aktiver Plenum-Plan.
HubSpot verbinden (OAuth)
Die Verbindung wird über das sichere HubSpot-OAuth-Verfahren hergestellt. Folgen Sie diesen Schritten:
- Rufen Sie app.bynu.ch/signup auf und wählen Sie einen Plenum-Plan.
- Klicken Sie auf "HubSpot verbinden" ("Connect HubSpot").
- Sie werden auf den HubSpot-Zustimmungsbildschirm weitergeleitet. Prüfen Sie dort die angeforderten Berechtigungen sorgfältig.
- Klicken Sie auf "Verbinden" bzw. "Zugriff erteilen", um die Berechtigungen zu bestätigen.
- Sie werden zurück zu Plenum geleitet. Ihr Portal ist jetzt verknüpft.
Angeforderte Berechtigungen und ihr Zweck
| Berechtigung (Scope) | Was Plenum damit tut | Warum benötigt |
|---|---|---|
| oauth | Stellt die sichere OAuth-Verbindung zu Ihrem Portal her. | Ohne diesen Scope ist keine Verbindung möglich. |
| crm.objects.contacts.read | Liest Ihre Kontakte. | Personen können als Teilnehmende importiert und bestehende Kontakte abgeglichen werden. |
| crm.objects.contacts.write | Aktualisiert Kontakte. | Plenum schreibt den Anmelde- und Check-in-Status zurück sowie die von Plenum benötigten Kontakteigenschaften (z. B. QR-Code- und Absage-Links). |
| crm.objects.companies.read | Liest Unternehmen. | Teilnehmende können nach Unternehmen gruppiert und VIP-Handhabung kann aktiviert werden. |
| crm.objects.companies.write | Aktualisiert Unternehmen. | Ermöglicht optionale Unternehmensfelder, die Plenum benötigt. |
| crm.lists.read | Liest Ihre Listen. | Teilnehmende können aus einer bestehenden HubSpot-Liste importiert werden. |
| crm.lists.write | Verwaltet Listen. | Plenum führt pro Teilnahmestatus eine statische Liste in HubSpot. |
| crm.schemas.contacts.read | Liest das Kontakteigenschafts-Schema. | Plenum erkennt, welche Eigenschaften in Ihrem Portal vorhanden sind. |
| crm.schemas.contacts.write | Erstellt Kontakteigenschaften. | Beim ersten Verbinden legt Plenum die benötigten Eigenschaften in Ihrem Portal an. |
| crm.objects.marketing_events.read | Liest Marketing Events. | Plenum kann bestehende Events und Teilnahmedaten auslesen. |
| crm.objects.marketing_events.write | Schreibt Marketing Events. | Plenum erstellt und synchronisiert den Event in HubSpot und schreibt den Teilnahmestatus (registriert, teilgenommen, abgesagt). |
Was Plenum beim ersten Verbinden einrichtet
Beim erstmaligen Verbinden prüft Plenum, welche der benötigten Kontakteigenschaften in Ihrem HubSpot-Portal noch nicht vorhanden sind, und legt diese automatisch an. Ausserdem kann Plenum einen Marketing Event in HubSpot erstellen. Es werden keine bestehenden Daten verändert oder gelöscht.
Verbindung prüfen
Nach dem Verbinden sehen Sie in den Plenum-Einstellungen Ihre HubSpot-Portal-ID sowie einen grünen Status, der eine erfolgreiche Verbindung anzeigt. Wir empfehlen folgende Prüfschritte:
- Erstellen Sie einen Testevent in Plenum und prüfen Sie, ob er in HubSpot unter Marketing Events erscheint.
- Fügen Sie einen Testkontakt hinzu und bestätigen Sie, dass Anmeldestatus und Kontakteigenschaften in HubSpot korrekt gesetzt werden.
Verbindung trennen / Plenum deinstallieren
Sie können die Verbindung jederzeit trennen, entweder in den Plenum-Einstellungen oder direkt in HubSpot unter Einstellungen > Integrationen > Verbundene Apps, indem Sie Plenum entfernen.
Weitere Details zur Datenaufbewahrung entnehmen Sie bitte unserer Datenschutzerklärung.
Fehlerbehebung
- Fehlende Berechtigungen: Verbinden Sie Plenum erneut und melden Sie sich mit einem HubSpot-Benutzerkonto an, das über Administrator- oder App-Installationsrechte verfügt.
- Eine Berechtigung wurde abgelehnt: Die zugehörige Funktion steht nicht zur Verfügung. Trennen Sie die Verbindung, verbinden Sie erneut und erteilen Sie alle angeforderten Berechtigungen.
- Portal erscheint als "getrennt": Trennen Sie die Verbindung manuell und stellen Sie sie neu her.
- Problem besteht weiterhin: Wenden Sie sich an unseren Support unter /support.
Hilfe und Kontakt
Bei Fragen oder Problemen steht Ihnen unser Support-Team unter bynu.ch/support zur Verfügung. Informationen zum Datenschutz finden Sie in unserer Datenschutzerklärung.