Integrationen, Kalender, Webhooks und API
Externe Dienste über den Integrationsbereich verbinden, Google- und Outlook-Kalender koppeln, Webhooks einrichten und API-Schlüssel für eigene Anbindungen erstellen.
Worum es geht
Scorebase lässt sich auf mehreren Wegen mit anderen Systemen verbinden. Welcher Weg der richtige ist, hängt davon ab, was Sie erreichen möchten:
| Sie möchten … | Weg | Wo |
|---|---|---|
| einen fertigen Dienst anbinden, zum Beispiel eine Buchhaltung oder ein HR-System | Integrationen | Navigation des Dashboards → Integrationen |
| Aufgaben in Ihrem Google- oder Outlook-Kalender sehen | Kalender | Einstellungen → Integrationen |
| ein anderes System sofort informieren, wenn in Scorebase etwas passiert | Webhooks | Entwicklerzugang und der Reiter Webhooks |
| aus einem eigenen Programm auf Scorebase-Daten zugreifen | API-Keys | Entwicklerzugang und der Reiter Schlüssel |
| einen KI-Assistenten mit Scorebase arbeiten lassen | MCP-Service | siehe Funktionen |
Anbindungen einzelner Apps – etwa Zahlungsanbieter im Ticketshop oder WhatsApp in Kampagnen – richten Sie in der jeweiligen App ein. Die Anleitungen stehen in deren Kategorien, zum Beispiel CRM-Integrationen.
Integrationen verbinden
Hinweis: Der Integrationsbereich ist nicht in jeder Organisation freigeschaltet. Sie brauchen ausserdem das Recht «Integrationen anzeigen»; zum Anlegen und Ändern von Verbindungen die Rechte «Verbindungen erstellen», «… bearbeiten» und «… löschen».
Öffnen Sie Integrationen in der Navigation des Dashboards. Die Seite hat diese Reiter:
| Reiter | Inhalt |
|---|---|
| Verfügbar | Alle Integrationen, die Ihnen zur Verfügung stehen. Suchfeld «Integration suchen...» und Filter nach Kategorie: CRM, E-Mail, Kalender, Buchhaltung, Zahlung, HR, Speicher, Sonstige. |
| Meine Integrationen | Ihre bestehenden Verbindungen mit Status und letzter Synchronisation |
| Analytics | Auswertung der Synchronisationen: Aktivität, Dauer und Fehler |
| Builder | Eigene Integrationen zu beliebigen Schnittstellen bauen – nur Administratoren |
Welche Integrationen unter Verfügbar erscheinen, pflegt das Scorebase-Team. Eine Karte zeigt Verfügbar, Verbunden oder Von Admin geteilt.
Eine Integration verbinden:
- Klicken Sie auf der Karte auf Verbinden. Ein Assistent führt Sie durch fünf Schritte.
- Authentifizierung – Zugangsdaten eingeben und testen. Je nach Dienst werden Sie zur Anmeldung beim Anbieter weitergeleitet, oder Sie geben einen API-Schlüssel bzw. Benutzername und Passwort ein.
- Konfiguration – Namen der Verbindung, Sync-Richtung (Import, Export oder Bidirektional) und Häufigkeit (Manuell, Stündlich, Täglich, Wöchentlich) festlegen.
- Field-Mapping – die Felder des Dienstes den Feldern in Scorebase zuordnen, per Ziehen oder automatisch.
- Duplikate – festlegen, wie doppelte Datensätze erkannt werden.
- Finalisierung – testen und die Verbindung erstellen.
Nach erfolgreicher Anmeldung beim Anbieter meldet Scorebase «Integration erfolgreich verbunden.». Schlägt sie fehl, steht dort «Verbindung nicht hergestellt» – es wurde nichts gespeichert, und Sie können es jederzeit erneut versuchen.
Bestehende Verbindungen pflegen: Unter Meine Integrationen können Sie je Verbindung Bearbeiten, Sync jetzt starten, die Sync-Logs ansehen, sie Deaktivieren bzw. Aktivieren oder Löschen. Beim Löschen gehen auch Feldzuordnungen und Einstellungen der Verbindung verloren.
Eine fehlende Integration anfragen: Administratoren sehen oben Integration anfragen. Geben Sie den Namen des Dienstes, die Website, eine Kategorie, eine Beschreibung und die Dringlichkeit (Niedrig, Mittel, Hoch) an und klicken Sie auf Anfrage senden. Die Anfrage geht an das Scorebase-Team.
Kalender verbinden
Unter Einstellungen → Integrationen verbinden Sie Ihren persönlichen Kalender. Die Verbindung gilt nur für Sie, nicht für die ganze Organisation.
| Kalender | Was synchronisiert wird |
|---|---|
| Google Calendar | Aufgaben mit Fälligkeitsdatum erscheinen als Termine in Ihrem Google-Kalender. Scorebase darf Kalendereinträge lesen und erstellen, aber keine anderen Google-Daten. |
| Outlook Calendar | Aufgaben mit Fälligkeitsdatum erscheinen als Termine in Ihrem Outlook- bzw. Microsoft-365-Standardkalender. |
- Klicken Sie auf Mit Google Calendar verbinden bzw. Mit Outlook Calendar verbinden.
- Melden Sie sich beim Anbieter an und erlauben Sie den Zugriff.
- Zurück in Scorebase steht Verbunden und Verbunden seit.
Steht Token abgelaufen, klicken Sie auf Erneut verbinden. Mit Verbindung trennen heben Sie die Verbindung auf; Scorebase widerruft dabei den Zugriff auf Ihren Kalender beim Anbieter. Sie können die Verbindung jederzeit neu herstellen.
Hinweis: Dieser Bereich liegt in den Einstellungen der Organisation und ist heute nur für Administratoren und Mitglieder mit dem Recht «Einstellungen verwalten» erreichbar.
Webhooks
Ein Webhook ruft bei einem Ereignis in Scorebase automatisch eine Adresse Ihres Systems auf – zum Beispiel, wenn ein Kontakt angelegt oder eine Rechnung bezahlt wird.
Webhook anlegen:
- Öffnen Sie Entwicklerzugang und den Reiter Webhooks und klicken Sie auf Neuer Webhook.
- Tragen Sie unter Adresse die Adresse Ihres Systems ein. Sie muss mit
httpsbeginnen und aus dem Internet erreichbar sein. Adressen im internen Netz sind nicht möglich. - Wählen Sie unter Ereignisse die Ereignisse aus. Mit Ereignisse suchen grenzen Sie die Liste ein.
- Klicken Sie auf Webhook anlegen.
- Scorebase zeigt das Geheimnis des Webhooks. Kopieren Sie es sofort – es wird kein zweites Mal angezeigt. Bestätigen Sie, dass Sie es sicher gespeichert haben, und schliessen Sie das Fenster.
Verfügbare Ereignisse:
| App | Ereignisse |
|---|---|
| CRM | contact.created, contact.updated, contact.deleted, company.created, company.updated, company.deleted |
| Aufgaben | task.created, task.updated, task.completed, task.deleted, time_entry.created, material_entry.created, report.finalized |
| Finanzen | invoice.created, invoice.updated, invoice.sent, invoice.paid, invoice.deleted |
| Eventmanager | event.created, event.updated, event.deleted |
| CRM, eigene Spaces | entry.created, entry.updated, run.created, run.stage_changed, run.won, run.lost. Nur mit dem Modul Eigene Spaces und für Administratoren oder Personen mit dem Recht, Spaces zu verwalten. Anleitung: Mit Zapier oder Make verbinden |
Aufbau eines Aufrufs (Zieltyp JSON):
{
"event": "contact.created",
"deliveredAt": "2026-09-29T10:30:00.000Z",
"data": { "…": "die Daten des Eintrags" }
}| Header | Inhalt |
|---|---|
X-Scorebase-Signature |
HMAC-SHA256 des Rumpfs mit dem Secret, hexadezimal |
X-Scorebase-Event |
Ereignis, zum Beispiel 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-Signatureum.
Zustellung und Fehler:
- Scorebase wartet höchstens 10 Sekunden auf eine Antwort.
- Schlägt eine Zustellung fehl, versucht Scorebase es erneut – insgesamt bis zu fünfmal, mit wachsendem Abstand.
- Nach 15 fehlgeschlagenen Zustellungen in Folge schaltet Scorebase den Webhook ab und benachrichtigt die Administratoren.
Die Liste zeigt je Webhook die Adresse, die Zahl der Ereignisse, den Zustand (Aktiv, Pausiert, Fehler in Folge mit Anzahl oder Abgeschaltet) und, wann zuletzt zugestellt wurde (Zuletzt zugestellt am … oder Noch nie zugestellt). Über die Aktionen der Zeile erreichen Sie Testereignis senden, Zustellungen (die Zustellungen der letzten 30 Tage mit Erneut senden), Bearbeiten, Pausieren bzw. Aktivieren, Geheimnis erneuern und Löschen. Beim Löschen können Sie den Webhook stattdessen pausieren; ein pausierter Webhook behält seine Einstellungen.
Tipp: Testen Sie einen neuen Webhook zuerst mit Testereignis senden gegen eine Testadresse, bevor Sie Ihr produktives System anbinden.
API-Keys und API-Docs
Hinweis: Der API-Zugang ist nicht in jeder Organisation freigeschaltet. Fehlt er, steht dort «API-Zugang nicht aktiviert».
Mit einem API-Key greifen eigene Programme auf die Daten Ihrer Organisation zu, zum Beispiel auf Kontakte, Firmen, Aufgaben, Projekte, Zeiteinträge, Rechnungen und Events.
- Öffnen Sie Entwicklerzugang und den Reiter Schlüssel und klicken Sie auf Neuer Schlüssel.
- Geben Sie einen Namen ein, zum Beispiel den des Programms, das ihn nutzt, und wählen Sie unter Ablauf, ob er nicht abläuft oder nach einer Anzahl Tagen.
- Wählen Sie unter Bereiche, was der Schlüssel nutzen darf, zum Beispiel Kontakte oder Rechnungen. Wählen Sie nur, was nötig ist; Voller Zugriff auf alle Bereiche der Organisation brauchen die wenigsten Programme.
- Klicken Sie auf Schlüssel anlegen und kopieren Sie den Schlüssel sofort. Er wird nur ein einziges Mal angezeigt.
Die Liste zeigt den Anfang jedes Schlüssels, seine Bereiche, wann er Läuft ab, wann er Angelegt wurde und den Zustand (Aktiv, Gesperrt oder Abgelaufen). Mit Sperren sperren Sie einen Schlüssel nach einer Rückfrage sofort – Aufrufe damit schlagen danach fehl, und ein gesperrter Schlüssel lässt sich nicht wieder öffnen.
Der Reiter Dokumentation beschreibt alle Endpunkte mit Methode und Pfad, zeigt die Basis-Adresse Ihrer Organisation und die vollständige Beschreibung im OpenAPI-Format. Programme melden sich mit dem Header Authorization: Bearer <Ihr Key> an.
Die Schnittstellen für Website-Inhalte sind separat dokumentiert: Delivery API und Management API.
Wenn etwas nicht klappt
| Symptom | Ursache | Lösung |
|---|---|---|
| Integrationen fehlt in der Navigation | Nicht freigeschaltet oder Recht «Integrationen anzeigen» fehlt | Ihre Administration oder den Support fragen. |
| «Kein Zugriff» auf der Integrationsseite | Das Recht fehlt | Ihre Administration kann es unter Rollen und Rechte vergeben. |
| Kalender zeigt Token abgelaufen | Die Freigabe beim Anbieter ist abgelaufen oder wurde widerrufen | Erneut verbinden. |
| Webhook steht auf inaktiv | 15 Fehlschläge in Folge | Empfänger prüfen, Webhook löschen und neu anlegen. |
| Ihr System lehnt Webhooks als ungültig ab | Signatur falsch berechnet | Signatur über den unveränderten Rumpf mit dem Secret berechnen; Header X-Scorebase-Signature verwenden. |
| API meldet «Ungültiger oder fehlender API-Key» | Schlüssel gesperrt, falsch kopiert oder Header fehlt | Header Authorization: Bearer <Key> prüfen, bei Bedarf neuen Schlüssel erstellen. |
| API meldet «API-Key fehlt der Scope: …» | Dem Schlüssel fehlt die Berechtigung für diesen Endpunkt | Neuen Schlüssel mit dem genannten Scope erstellen. |