Mit Zapier oder Make verbinden (über Webhooks)
Einträge und Pipelines aus eigenen Spaces an Zapier, Make oder ein eigenes System melden lassen und über die Schnittstelle zurückschreiben, mit Ereignissen, Aufbau der Meldung und Rechten des Schlüssels.
Worum es geht
Zapier und Make verbinden Dienste miteinander, ohne dass Sie programmieren. Scorebase meldet dazu über Webhooks, wenn in einem eigenen Space ein Eintrag angelegt oder geändert wird oder ein Durchlauf die Stufe wechselt. Daraus bauen Sie in Zapier oder Make zum Beispiel eine Nachricht in einen Kanal, eine Zeile in einer Tabelle oder einen Eintrag in einem anderen System.
Eine eigene Zapier-App gibt es nicht. Die Anbindung läuft über die Webhook-Bausteine der beiden Dienste, und das genügt für alles, was auf dieser Seite steht.
Voraussetzungen:
- Ihre Organisation hat das Modul Eigene Spaces.
- Sie sind Administratorin oder Administrator oder haben das Recht Eigene Spaces anlegen und verwalten. Ein Webhook gehört der Organisation und kennt keine einzelne Person. Darum dürfen nur Personen, die alle Spaces verwalten, diese Ereignisse wählen.
Die Ereignisse
| Ereignis | Wann es gemeldet wird |
|---|---|
entry.created |
Ein Eintrag wurde angelegt, von Hand, über ein Formular, die Schnittstelle, einen KI-Assistenten oder die Automatik |
entry.updated |
Feldwerte eines Eintrags haben sich geändert |
run.created |
Ein Eintrag hat einen Durchlauf in einer Pipeline begonnen |
run.stage_changed |
Ein Durchlauf ist in eine andere Stufe gewechselt |
run.won |
Ein Durchlauf wurde gewonnen. Gemeldet wird zusätzlich zu run.stage_changed |
run.lost |
Ein Durchlauf wurde verloren. Gemeldet wird zusätzlich zu run.stage_changed |
Es spielt keine Rolle, auf welchem Weg die Änderung entstanden ist: Oberfläche, KI-Assistent, Schnittstelle und Automatik melden gleich. Die Meldung sagt im Feld source, woher sie kam (user, mcp, api, automation oder form).
Ein Import meldet nichts. Sonst bekäme Ihr Ziel bei einer Datei mit tausend Zeilen tausend Aufrufe auf einmal.
Einen Webhook einrichten
- Legen Sie in Zapier einen Zap an. Als Auslöser wählen Sie Webhooks by Zapier mit dem Ereignis Catch Hook. In Make wählen Sie das Modul Webhooks mit Custom webhook. Beide Dienste zeigen Ihnen eine Adresse. Kopieren Sie sie.
- Öffnen Sie in Scorebase Entwicklerzugang und den Reiter Webhooks.
- Klicken Sie auf Neuer Webhook.
- Tragen Sie unter Adresse die kopierte Adresse ein. Sie muss mit
httpsbeginnen und aus dem Internet erreichbar sein. Adressen im internen Netz nimmt Scorebase nicht an. - Wählen Sie unter Ereignisse die gewünschten Ereignisse aus der Gruppe CRM.
- Klicken Sie auf Webhook anlegen. Scorebase zeigt das Geheimnis des Webhooks genau einmal. Speichern Sie es, wenn Sie die Signatur prüfen wollen, und schliessen Sie danach das Fenster.
- Lösen Sie das Ereignis einmal aus, zum Beispiel indem Sie einen Eintrag anlegen. Zapier oder Make zeigt Ihnen danach die ersten Daten, mit denen Sie weiterbauen.
Wichtig: Die Adresse von Zapier oder Make ist geheim. Wer sie kennt, kann Meldungen an Ihren Zap schicken. Behandeln Sie sie wie ein Passwort. Zapier und Make prüfen die Signatur der Meldung nicht von selbst; wenn Sie sie prüfen möchten, tun Sie das in einem eigenen System.
Aufbau einer Meldung
Jede Meldung ist ein JSON-Aufruf. Er ist signiert wie alle Webhooks von Scorebase, Aufbau und Kopfzeilen stehen in Integrationen, Kalender, Webhooks und API.
Ein neuer Eintrag:
{
"event": "entry.created",
"deliveredAt": "2026-11-13T10:30:00.000Z",
"data": {
"id": "…",
"spaceId": "…",
"spaceKey": "anfragen",
"spaceName": "Anfragen",
"title": "Muster AG",
"state": "open",
"ownerId": null,
"origin": "form",
"fields": { "name": "Muster AG", "betrag": 1200 },
"createdAt": "2026-11-13T10:30:00.000Z",
"updatedAt": "2026-11-13T10:30:00.000Z",
"source": "form"
}
}Bei entry.updated nennt das Feld changedFields, welche Felder sich geändert haben.
Ein Stufenwechsel:
{
"event": "run.stage_changed",
"deliveredAt": "2026-11-13T11:05:00.000Z",
"data": {
"id": "…",
"entryId": "…",
"spaceKey": "anfragen",
"pipelineName": "Verkauf",
"stageName": "Angebot",
"previousStageName": "Anfrage",
"daysInPreviousStage": 4,
"status": "open",
"source": "user"
}
}Mit entryId finden Sie den Eintrag zum Durchlauf. Bei run.lost steht lossReasonKey dabei.
Was nicht mitgeschickt wird
- Felder mit eingeschränkter Sichtbarkeit. Hat ein Feld unter Sichtbar für bestimmte Rollen, fehlt es in jeder Meldung samt Wert. Eine Organisation, die nichts übers Netz verlassen soll, schränkt das Feld also so ein.
- Beträge. Wert und Rhythmus eines Durchlaufs stehen nur in der Meldung, wenn die Pipeline Beträge führt und nicht auf bestimmte Rollen beschränkt ist. Hat die Pipeline unter Wer sieht die Beträge? den Schalter Werte nur für bestimmte Rollen zeigen eingeschaltet, fehlen die Beträge in jeder Meldung.
- Papierkorb und Systemspaces. Gelöschte Einträge und die Spaces Kontakte und Unternehmen melden hier nichts. Für Kontakte und Unternehmen gibt es die Ereignisse
contact.*undcompany.*.
Über die Schnittstelle zurückschreiben
Oft soll Zapier oder Make auch etwas in Scorebase ändern, zum Beispiel einen Eintrag anlegen oder einen Durchlauf weiterschieben. Dafür gibt es die Schnittstelle mit eigenen Bereichen je Ressource:
| Bereich | Erlaubt |
|---|---|
crm.spaces.read |
Eigene Spaces mit Feldern und Pipelines lesen |
crm.entries.read |
Einträge lesen |
crm.entries.write |
Einträge anlegen und Feldwerte ändern |
crm.runs.read |
Durchläufe lesen |
crm.runs.write |
Durchläufe beginnen und die Stufe wechseln |
So legen Sie den Schlüssel an: Entwicklerzugang → Schlüssel → Neuer Schlüssel. Wählen Sie nur die Bereiche, die Ihr Zap braucht. Zapier und Make senden den Schlüssel im Kopf jeder Anfrage als Authorization: Bearer …. Die Adressen und Felder stehen im Reiter Dokumentation.
Ein Schlüssel sieht nie mehr als die Person, die ihn angelegt hat. Er handelt in deren Namen, mit demselben Zugriff auf Spaces, denselben Feldrechten und, sobald es sie gibt, denselben Zeilenrechten. Ein Space, auf den diese Person keinen Zugriff hat, ist für den Schlüssel nicht vorhanden. Ein Beispiel:
- Wer einen Space nur ansehen darf, legt über den Schlüssel dort keine Einträge an. Die Schnittstelle antwortet mit
403. - Beträge liefert die Schnittstelle nur, wenn die Person sie sehen darf. Ohne dieses Recht fehlen die Felder, und ein Betrag lässt sich auch nicht schreiben.
- Verlässt die Person die Organisation, hört der Schlüssel auf zu funktionieren. Legen Sie ihn dann mit einer anderen Person neu an.
Einträge und Durchläufe, die über die Schnittstelle entstehen, melden ihrerseits die Ereignisse oben. Ein Zap, der auf entry.created hört und selbst Einträge anlegt, ruft sich also immer wieder selbst auf. Schliessen Sie das in Ihrem Zap mit einem Filter auf source aus.
Wenn etwas nicht ankommt
| Beobachtung | Ursache | Was Sie tun |
|---|---|---|
Unter Ereignisse fehlen entry.* und run.* |
Das Modul Eigene Spaces ist nicht freigeschaltet, oder Sie sind weder Administrator noch haben Sie das Recht, Spaces zu verwalten | Bitten Sie eine Administratorin um die Freigabe oder den Webhook |
| Nach einem Import kommt nichts | Ein Import meldet nichts | Das ist so gewollt |
| Der Webhook steht auf Pausiert oder Abgeschaltet | Das Ziel hat 15 Mal in Folge nicht geantwortet | Prüfen Sie den Zap und schalten Sie den Webhook wieder ein |
| Ein Feld oder ein Betrag fehlt in der Meldung | Das Feld ist auf Rollen beschränkt, oder die Pipeline zeigt Beträge nur bestimmten Rollen | Das ist Absicht, siehe oben |
Die Schnittstelle antwortet mit 404 |
Der Space oder Eintrag existiert nicht oder ist für die Person hinter dem Schlüssel nicht sichtbar | Prüfen Sie den Zugriff dieser Person auf den Space |