Setup-Guide — Boniforce für HubSpot

Installation der Boniforce-App in deinem HubSpot-Portal — Schritt für Schritt. Geschätzte Dauer: 5 Minuten.

Stand: 13.05.2026

Inhalt

  1. Voraussetzungen
  2. Installation
  3. Boniforce-API-Key hinterlegen
  4. Erste Nutzung
  5. Workflow-Aktionen
  6. Deinstallation
  7. Troubleshooting
  8. English version

1. Voraussetzungen

  • HubSpot-Portal mit Admin-Rechten (Super-Admin oder „App Marketplace verwalten“).
  • Bestehender Boniforce-Vertrag oder Sandbox-Zugang (kostenlos auf Anfrage über team@boniforce.de).
  • Persönlicher Boniforce-API-Key (im Boniforce-Dashboard erzeugen).

2. Installation

1

Install-Link öffnen

Klicke auf Boniforce in HubSpot installieren

2

Portal auswählen

HubSpot fragt, in welches Portal du installieren möchtest. Wähle dein Production-Portal (oder Sandbox).

3

Berechtigungen prüfen

HubSpot zeigt die angefragten Scopes an: crm.objects.companies.read/write, crm.schemas.companies.write, crm.lists.read, automation, settings.users.read, oauth. Klick „Connect App“.

4

Bestätigung

Du wirst auf eine Bestätigungsseite weitergeleitet. Die App ist jetzt installiert; alle boniforce_*-Eigenschaften wurden in deinem Company-Schema angelegt.

3. Boniforce-API-Key hinterlegen

Nach der Installation öffnest du eine beliebige Company in HubSpot. Im rechten Sidebar erscheint die Boniforce-Karte mit dem Hinweis, deinen API-Key einzutragen.

1

Settings öffnen

Klick auf „Einstellungen öffnen“ auf der Boniforce-Karte — du landest in den App-Settings.

2

API-Key eintragen

Füge deinen Boniforce-API-Key ein. Der Key wird sofort gegen api.boniforce.de validiert.

3

Speichern

Bei erfolgreicher Validierung wird der Key per AWS KMS in eu-central-1 envelope-verschlüsselt und gespeichert. Plaintext verlässt nie unsere Backend-Memory.

Wichtig. Boniforce-Berichte sind kostenpflichtig. Jeder Score-Abruf zählt gegen dein Boniforce-Kontingent — die App fügt keine zusätzlichen Kosten hinzu, sondern wird kostenlos installiert.

4. Erste Nutzung

1

Company öffnen

Geh zu einer deutschen Firma in HubSpot. Die Boniforce-Karte erscheint im rechten Sidebar unter „Score prüfen“.

2

„Boniscore abrufen“ klicken

Boniforce identifiziert die Firma über Name + Register-Daten und generiert einen Bericht. Dauer: typischerweise 30–90 Sekunden.

3

Ergebnis

Score (0–100), Risikoklasse, Berichtsdatum, Kreditlimit-Empfehlung erscheinen auf der Karte und werden in die boniforce_*-Eigenschaften geschrieben.

5. Workflow-Aktionen

Boniforce stellt drei Workflow-Aktionen bereit, die du in HubSpot-Workflows nutzen kannst:

AktionZweck
Enrich Company with BoniforceGeneriert einen neuen Boniscore und schreibt alle Eigenschaften zurück.
Get or refresh BoniscoreLiefert den letzten Score oder generiert nur dann neu, wenn älter als das Freshness-Fenster.
Lookup German CompanyResolves eine Firma zu Boniforce-Registerkennungen — ohne kostenpflichtigen Score.

6. Deinstallation

Geh in HubSpot zu „Einstellungen → Integrationen → Verbundene Apps“, such Boniforce, klick „Aktionen → Uninstall“. Die App entfernt sich aus dem Portal; die App-Datenbank markiert alle Datensätze für Housekeeping, der verschlüsselte API-Key wird sofort gelöscht.

7. Troubleshooting

ProblemLösung
Karte erscheint nicht nach InstallationHubSpot-Seite neu laden. Prüfe in Settings → Apps, ob Boniforce verbunden ist.
„API-Key ungültig“Im Boniforce-Dashboard prüfen, ob der Key aktiv ist. Eventuell rotieren.
Score-Abruf bleibt hängenFirmen-Name muss exakt mit dem Handelsregister übereinstimmen, oder Register-Nummer in HubSpot eintragen.
„Permission denied“App-Aktionen sind nach HubSpot-CRM-Rechten gegated. Frag deinen HubSpot-Admin.

Weitere Hilfe: Support kontaktieren.

English version

Step-by-step setup of the Boniforce HubSpot App. ~5 minutes.

  1. Prerequisites: HubSpot admin rights, Boniforce contract or sandbox key.
  2. Install: click the install link, pick your portal, approve scopes.
  3. API key: open any Company, click „Open settings“ on the Boniforce card, paste your Boniforce API key. It’s validated then envelope-encrypted via AWS KMS in eu-central-1.
  4. First use: open a German Company, click „Get Boniscore“. Result appears in 30–90s.
  5. Workflows: three actions available — Enrich Company, Get or refresh Boniscore, Lookup German Company.
  6. Uninstall: HubSpot Settings → Integrations → Connected Apps → Uninstall. Encrypted credential purged immediately.

Need help? Contact support · Privacy · DPA · Terms