---
title: "Die Ereignisse eines Kreises oder Projekts an Ihre eigene Webhook-URL senden"
description: "Die Governance-Ereignisse eines Kreises oder die Aufgaben eines Projekts als JSON an eine eigene URL senden: die Karte verbinden, die Nutzlast jedes Ereignisses und die Ereignisse, die nicht gesendet werden"
category: integrations
section: native-integrations
type: Reference
lastUpdated: 2026-09-30
locale: de
canonical: https://support.talkspirit.com/de/integrations/send-circle-or-project-events-to-your-own-webhook
---

# Die Ereignisse eines Kreises oder Projekts an Ihre eigene Webhook-URL senden


> **Kurz gefasst:** Öffnen Sie den Kreis, gehen Sie zu den Reiter **Integrationen** in den Einstellungen des Kreises, wählen Sie auf der Karte **Webhook** die Option **Aktivieren**, fügen Sie Ihre URL ein und wählen Sie **Bestätigen**. Jedes Governance-Ereignis des Kreises wird dann als JSON-`POST` an diese URL gesendet, im Format, das die frühere Plattform verwendete. 25 Ereignisarten werden gesendet, und ein Projekt kann seine Aufgaben auf dieselbe Weise senden. 12 werden nie gesendet, und diese Seite listet sie auf.

Diese Anleitung behandelt die Karte **Webhook** eines Kreises. Sie ist nicht [Webhooks: neue Ereignisse](/integrations/partner-api), wo die für die Partner-API geplanten Webhooks für Entwickler beschrieben sind. Was eine Kreis-Integration sendet, Familie für Familie, steht in [Kreis-Integrationen](/integrations/circle-and-project-integrations-overview).

Anders als bei Slack oder Microsoft Teams ist das Ziel ein Dienst, den Sie betreiben, keine Unterhaltung. Niemand liest das Ergebnis: Ein Programm tut es.

## Bevor Sie beginnen

- Sie sind Administrator der Organisation oder Administrator des Kreises.
- Sie haben einen aus dem Internet erreichbaren Endpunkt, der einen `POST` mit JSON-Inhalt annimmt.
- Er antwortet innerhalb von 10 Sekunden mit einem Status unter `400`. Weiterleitungen werden nicht verfolgt.

## Den Kreis verbinden

1. Öffnen Sie die Einstellungen des Kreises, dann den Reiter **Integrationen**.
2. Wählen Sie auf der Karte **Webhook** die Option **Aktivieren**. Ein Feld **Webhook-URL** öffnet sich. Es gibt keine Anmeldung und keinen Zustimmungsdialog.
3. Fügen Sie die URL ein und wählen Sie **Bestätigen**.

Die Karte zeigt nun **Verbunden**: „Die Webhook-URL ist gespeichert. Die Ereignisse werden als JSON dorthin gesendet.“

Die URL wird geprüft, wenn Sie **Bestätigen** wählen, nicht beim ersten Ereignis. Eine fehlerhafte Adresse oder eine, die auf ein internes Netzwerk zeigt, wird dort abgelehnt. Der Grund erscheint unter dem Feld, und nichts wird gespeichert.

> **Wichtig:** Die Anfrage trägt keine Signatur. Wer die URL kennt, kann Ihrem Endpunkt einen Inhalt senden, der wie unserer aussieht. Verwenden Sie eine lange URL, die sich nicht erraten lässt, und behandeln Sie sie wie ein Passwort.

## Prüfen, ob es funktioniert

Beim Wählen von **Bestätigen** wird nichts gesendet. Wählen Sie auf der Karte **Testen**: Ihr Endpunkt erhält diesen Inhalt, und die Karte hält das Ergebnis fest.

```json
{
  "object": "connection_test",
  "text": "Talkspirit is connected to this channel. Governance changes in this circle will be posted here."
}
```

Wenn Ihre Automatisierung nach `object` filtert, ignorieren Sie `connection_test`.

## Die URL ändern oder entfernen

- **Webhook-URL ändern** richtet den Kreis auf eine neue URL aus. Dabei wird auch der Fehlerzähler zurückgesetzt, das ist die Reparatur, wenn der Endpunkt umgezogen ist.
- **Deaktivieren** entfernt die URL und die Ereigniseinstellungen. Danach wird nichts mehr gesendet.

## Was Ihr Endpunkt empfängt

Jedes Ereignis ist ein `POST` mit JSON-Inhalt und dem Header `User-Agent` `Holaspirit Client`. Zwei Schlüssel sind immer vorhanden:

- `object`, worum es im Ereignis geht, zum Beispiel `role` oder `tension`.
- `text`, das Ereignis als Satz, zum Beispiel `New role Facilitator`.

Die übrigen Schlüssel hängen von `object` ab. `activity` gibt es nur bei den Objekten, die es tragen.

| `object` | Gesendet für | Weitere Schlüssel |
| --- | --- | --- |
| `role` | Eine Rolle oder ein Kreis angelegt oder geändert, eine Rolle in einen Kreis umgewandelt, ein Kreis in eine Rolle umgewandelt | `id`, `circle`, `purpose`, `url` |
| `role` | Eine Rolle oder ein Kreis gelöscht | `circle` und `url`, die auf den übergeordneten Kreis verweist |
| `policy` | Eine Richtlinie veröffentlicht oder geändert | `id`, `circle`, `description`, `domain`, `url` |
| `policy` | Eine Richtlinie gelöscht | `circle`, `url` |
| `tension` | Ein Vorschlag angenommen (`activity: accept`) oder abgelehnt (`activity: refuse`) | `activity`, `id`, `name`, `body`, `circle`, `member` |
| `assignation` | Ein Mitglied einer Rolle zugewiesen | `assignation`, `circle`, `circle_id`, `role`, `role_id`, `focus`, `member`, `member_id`, `url` |
| `circleAssignation` | Ein Mitglied einem Kreis zugewiesen | `assignation`, `circle`, `circle_id`, `member`, `member_id`, `url` |
| `unassignation` | Ein Mitglied aus einer Rolle oder einem Kreis entfernt | `unassignation`, `circle`, `circle_id`, `member`, `member_id`, `url`, sowie `role`, `role_id` bei einer Rolle |
| `objective` | Ein Ziel angelegt (`activity: create`), aktualisiert (`activity: update`) oder gelöscht (`activity: delete`) | `activity`, `id`, `title`, `description`, `circle`, `members`, `role`, `status`, `url` |
| `checklist`, `metric` | Eine Checkliste oder eine Kennzahl angelegt oder aktualisiert | `id`, `title`, `body`, `circle`, `members`, `recurrence`, und `role`, wenn es eine gibt |
| `project` | Eine Aufgabe auf einem Projekt angelegt (`activity: create`), aktualisiert (`activity: update`) oder gelöscht (`activity: delete`) | `activity`, `id`, `title`, `body`, `url`, `board`, `board_id` |

Ein Kreis wird als `object: role` gesendet, wie bei die frühere Plattform. Das Objekt eines Vorschlags heißt `tension` und nennt seinen Gegenstand `name` statt `title`: Beides sind die Namen von die frühere Plattform, unverändert übernommen.

Zum Beispiel ein Mitglied, das einer Rolle zugewiesen wird:

```json
{
  "object": "assignation",
  "text": "Assignation for role: Facilitator",
  "assignation": "Ada Lovelace was assigned to the role: Facilitator",
  "circle": "Commercial",
  "circle_id": "11111111-2222-3333-4444-555555555555",
  "role": "Facilitator",
  "role_id": "r-1",
  "focus": "EMEA",
  "member": "Ada Lovelace",
  "member_id": "u-1",
  "url": "https://…"
}
```

## Ereignisse, die nicht gesendet werden

Von den 37 Ereignisarten, die eine Integration kennt, werden 12 nie an einen Webhook gesendet. Jedes wird abgelehnt, bevor etwas Talkspirit verlässt. Ein abgelehntes Ereignis zählt nicht als fehlgeschlagene Zustellung: Die anderen Ereignisse werden weiter gesendet.

**die frühere Plattform hat sie nie gesendet**: `unsupported_event_kind`, 12 Ereignisse. Sie werden nicht hinzugefügt: Es gibt kein die frühere Plattform-Format, das sich nachbilden ließe.

| Ereignisse | Warum |
| --- | --- |
| Ein Vorschlag eingereicht oder zurückgezogen | die frühere Plattform sendete nur das Ergebnis: angenommen oder abgelehnt. |
| Eine Spannung eröffnet oder geschlossen | die frühere Plattform hatte keine Entsprechung für dieses Objekt. |
| Eine Rolle oder ein Kreis verschoben | die frühere Plattform hat nie eine Verschiebung gemeldet. |
| Ein beendetes Meeting, ein Meeting, das gleich beginnt, ein veröffentlichtes Meeting-Protokoll | die frühere Plattform sendete keine Meeting-Ereignisse an einen Webhook. |
| Ein Projekt angelegt, geändert oder gelöscht | die frühere Plattform hatte kein Projekt-Objekt. |

## Wenn Sie von die frühere Plattform kommen

**Für jedes Ereignis, das sie sendet, verwendet diese Integration das Format von die frühere Plattform.** Dieselben `object`-Namen, dieselben Schlüssel, derselbe `text`-Satz und derselbe `User-Agent`. Ein für den Webhook von die frühere Plattform geschriebener Endpunkt liest sie ohne jede Änderung.

Einige Werte sind noch nicht befüllt, und ein Endpunkt, der sie liest, bemerkt den Unterschied:

- `body` bei `tension`, `checklist` und `metric`, `description` und `members` bei `objective` sowie `members` und `recurrence` bei `checklist` und `metric` sind `null`.
- Bei `policy` ist `description` leer, und `domain` enthält immer den Text für eine Richtlinie ohne Domäne: `All functions and activities within the Kreis`.
- Bei `checklist` und `metric` ist `last_checked` nie vorhanden.
- Bei `policy` verweist `url` auf die Seite der Richtlinie selbst, wo die frühere Plattform auf ihren Kreis verwies.

Aufgaben kommen vom Webhook eines Projekts als `object: project`, mit `board` und `board_id`. Die Schlüssel, die die frühere Plattform einer Aufgabe hinzufügte, `context`, `circle`, `members`, `role` und `status`, fehlen, statt `null` zu sein.

## Auf einem Projekt

Ein Projekt verbindet den Webhook über sein die Einstellungen des Projekts, Reiter **Benachrichtigungen**, mit derselben Karte. Sie müssen Eigentümer oder Bearbeiter des Projekts sein.

- Ein Projekt hat genau ein Webhook-Ziel. Eine neu eingefügte URL ersetzt die vorherige.
- Ein Projekt sendet seine Aufgaben: eine angelegte oder gelöschte Aufgabe und eine Aufgabe, deren Status, Priorität oder Fälligkeitsdatum sich ändert. Unteraufgaben, private Aufgaben und Aufgaben, die auf einem privaten oder geheimen Projekt angelegt wurden, werden nicht gesendet.

Zum Beispiel eine auf einem Projekt angelegte Aufgabe:

```json
{
  "object": "project",
  "activity": "create",
  "id": "t-1",
  "text": "New project Ship v2",
  "title": "Ship v2",
  "body": null,
  "url": "https://…",
  "board": "Roadmap",
  "board_id": "66666666-7777-8888-9999-aaaaaaaaaaaa"
}
```

## Mehrere Ziele für einen Kreis

Ein Kreis kann mehr als ein Webhook-Ziel haben, wie bei die frühere Plattform. Jedes Ereignis wird dann an jedes Ziel gesendet.

Die Karte verwaltet jedoch genau eines. Bei einem Kreis mit mehreren zeigt sie **Dieser Kreis hat mehr als ein Ziel** und bietet nichts an: kein **Aktivieren**, kein **Webhook-URL ändern**, kein **Deaktivieren**, keine Schalter und kein **Testen**. Die Zustellung an jedes Ziel läuft weiter. Um sie zu ändern, wenden Sie sich an den Talkspirit-Support.

## Wenn der Versand aufhört

Die URL ist die einzige Zugangsinformation, daher ist das Einfügen einer funktionierenden URL die Reparatur. Es gibt keine Schaltfläche **Neu verbinden**.

| Was die Karte sagt | Was es bedeutet | Was zu tun ist |
| --- | --- | --- |
| **Das Senden wurde unterbrochen** | Fünf Zustellungen in Folge sind fehlgeschlagen: Ihr Endpunkt hat sie abgelehnt oder nicht rechtzeitig geantwortet. | Beheben Sie die Ursache, dann wählen Sie **Testen** oder **Webhook-URL ändern**. Der erste Erfolg setzt den Zähler zurück. |
| **Verbunden, aber es wurde nie etwas zugestellt** | Die URL wurde gespeichert, und jeder Versuch seitdem ist fehlgeschlagen. | Prüfen Sie, ob Ihr Endpunkt einen `POST` aus dem Internet annimmt und mit einem Status unter `400` antwortet. |
| **Die letzten Benachrichtigungen wurden nicht zugestellt** | Die Zustellung hat zuvor funktioniert und schlägt jetzt fehl. | Prüfen Sie die Protokolle Ihres Endpunkts. |
| **Benachrichtigungen sind auf unserer Seite unterbrochen** | Ein Fehler bei Talkspirit, nicht in Ihrer Konfiguration. | Nichts. Unser Team wird automatisch alarmiert, Ihre Einstellungen bleiben unberührt. |

Eine Antwort `429` Ihres Endpunkts zählt nicht als Fehlschlag: Talkspirit versteht sie als Bitte, langsamer zu senden.

## Wie geht es weiter?

- [Kreis-Integrationen](/integrations/circle-and-project-integrations-overview), was gesendet wird, die Ereignisfamilien und das Lesen der Karte
- [Einen Kreis mit einem Slack-Kanal verbinden](/integrations/connect-a-circle-or-a-project-to-slack)
- [Einen Kreis mit einem Microsoft-Teams-Kanal verbinden](/integrations/connect-a-circle-or-a-project-to-microsoft-teams)