Integrationen

Integrations-Übersicht

Scorebase bietet verschiedene Integrationsmöglichkeiten, um die Plattform mit externen Diensten zu verbinden.

Verfügbare Integrationen

Integration	Beschreibung	Konfiguration
Google Kalender	Aufgaben und Events mit Google Kalender synchronisieren	OAuth-Verbindung
Outlook Kalender	Aufgaben und Events mit Outlook synchronisieren	OAuth-Verbindung
Google Contacts	CRM-Kontakte mit Google Kontakten abgleichen	OAuth-Verbindung
Slack	Benachrichtigungen in Slack-Channels senden	Webhook
Webhooks	Benutzerdefinierte HTTP-Callbacks bei Ereignissen	URL + Secret

Integration einrichten

Navigieren Sie zu Einstellungen > Integrationen
Wählen Sie die gewünschte Integration
Folgen Sie dem Einrichtungsassistenten
Testen Sie die Verbindung

OAuth-Verbindungen

Google verbinden

Klicken Sie auf Google verbinden
Sie werden zu Google weitergeleitet
Melden Sie sich mit Ihrem Google-Konto an
Erteilen Sie die angeforderten Berechtigungen
Sie werden zurück zu Scorebase geleitet
Die Verbindung wird bestätigt

Berechtigungen, die angefordert werden:

Kalender: Lesen und Schreiben von Kalendereinträgen
Kontakte: Lesen von Google-Kontakten (für CRM-Import)

Outlook/Microsoft 365 verbinden

Klicken Sie auf Microsoft verbinden
Sie werden zum Microsoft-Login weitergeleitet
Melden Sie sich mit Ihrem Microsoft-Konto an
Erteilen Sie die angeforderten Berechtigungen
Die Verbindung wird bestätigt

Hinweis: OAuth-Verbindungen sind pro Benutzer. Jeder Benutzer, der die Integration nutzen möchte, muss sie separat einrichten.

Verbindung trennen

Navigieren Sie zu Einstellungen > Integrationen
Klicken Sie bei der gewünschten Integration auf Trennen
Die Verbindung wird sofort getrennt
Daten, die bereits synchronisiert wurden, bleiben erhalten

Webhooks

Webhook erstellen

Webhooks ermöglichen es, externe Systeme bei Ereignissen in Scorebase zu benachrichtigen:

Navigieren Sie zu Einstellungen > Integrationen > Webhooks
Klicken Sie auf Neuer Webhook
Konfigurieren Sie:

Feld	Beschreibung
Name	Bezeichnung des Webhooks
URL	Ziel-URL, die aufgerufen wird
Secret	Geheimer Schlüssel für die Signatur-Verifizierung
Ereignisse	Welche Ereignisse den Webhook auslösen

Verfügbare Webhook-Ereignisse

Modul	Ereignis
CRM	Kontakt erstellt, Kontakt aktualisiert, Unternehmen erstellt
Aufgaben	Aufgabe erstellt, Status geändert, Aufgabe abgeschlossen
Kampagnen	Kampagne versendet, Bounce erkannt, Abmeldung
Events	Event erstellt, Personal zugewiesen, Event abgeschlossen
Finanzen	Rechnung erstellt, Zahlung eingegangen

Webhook-Payload

Jeder Webhook-Aufruf enthält:

{
  "event": "contact.created",
  "deliveredAt": "2026-04-04T10:30:00Z",
  "data": {
    "id": "contact_xyz",
    "firstName": "Max",
    "lastName": "Muster",
    "email": "max@beispiel.ch"
  }
}

Header und Signatur

Header	Inhalt
`X-Scorebase-Signature`	HMAC-SHA256 des Rumpfs mit dem Secret, hexadezimal
`X-Scorebase-Event`	Ereignis, z. B. `contact.created`
`X-Scorebase-Delivery`	Kennung der Zustellung – bei einer Wiederholung dieselbe
`X-Scorebase-Retry`	Nummer des Versuchs, nur bei Wiederholungen

Berechnen Sie die Signatur über den Rumpf genau so, wie er ankommt, und vergleichen Sie sie mit X-Scorebase-Signature, bevor Sie die Daten verarbeiten.

Übergangszeit bis 24. September 2027: Jeder Header wird zusätzlich unter seinem bisherigen Namen mit demselben Wert gesendet. Bestehende Empfänger laufen weiter – stellen Sie Ihre Prüfung bis dahin auf X-Scorebase-Signature um.

Webhook-Protokoll

Unter Webhooks > Protokoll sehen Sie alle ausgehenden Webhook-Aufrufe mit:

Zeitstempel und Ereignis
HTTP-Statuscode der Antwort
Antwortzeit
Möglichkeit zum erneuten Senden bei Fehlern

Tipp: Testen Sie Ihre Webhooks mit einem Service wie webhook.site, bevor Sie sie mit Ihrem Produktivsystem verbinden.