Quire-Webhooks einrichten: eine Schritt-für-Schritt-Anleitung

Zuletzt aktualisiert: 24. Juli 2026

Hast du dir schon einmal gewünscht, deine Apps könnten automatisch miteinander kommunizieren? Genau das leisten Webhooks! Stell sie dir wie Boten vor, die deinen Server in dem Moment benachrichtigen, in dem in deinen Quire-Projekten etwas passiert – sei es eine neu erstellte Aufgabe, die Aktualisierung einer Zuweisung oder das Abschließen einer Aufgabe.

In dieser Anleitung zeigen wir dir, wie du Webhooks einrichtest, damit deine Anwendungen mit Quire synchron bleiben, ohne dass du einen Finger rühren musst.

Wie startest du mit Quire-Webhooks?

Schritt 1: Erstelle deine Quire-App

Zuallererst brauchst du eine Quire-App. Falls du noch keine eingerichtet hast, schau dir unsere Anleitung Eine Quire-App mit der Quire API erstellen an – wir führen dich Schritt für Schritt durch.

Schritt 2: Sag Quire, wohin es Updates senden soll

Jetzt ist es an der Zeit, deinen Webhook-Endpunkt im Quire Developer Apps-Portal einzurichten. Das ist einfach die Webadresse, an die Quire Benachrichtigungen senden soll, etwa so etwas wie http://myserver/hookhandler.

Stell es dir vor, als würdest du Quire deine Postanschrift geben, damit es weiß, wohin die Neuigkeiten zugestellt werden sollen.

Schritt 3: Updates abonnieren

Der letzte Einrichtungsschritt besteht darin, Quire mitzuteilen, welchen Projekten oder Aufgaben du folgen möchtest. Dazu fügst du deine App über die Quire API als „Follower" hinzu:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

Wichtiger Hinweis: Stelle sicher, dass du deine Webhook-URL bereits vor diesem Schritt konfiguriert hast. Ohne sie funktioniert das Hinzufügen deiner App als Follower nicht.

Wenn du keine Updates mehr benötigst, entferne deine App einfach wieder aus der Follower-Liste. So einfach ist das!

Weitere Details findest du unter Update a project by OID in unserer API-Referenz.

Wie funktionieren Webhooks im Hintergrund?

Was du erhältst

Sobald alles eingerichtet ist, beginnt Quire, dir Benachrichtigungen zu senden, sobald in deinen verfolgten Projekten etwas passiert. Diese kommen als POST-Anfragen mit allen wichtigen Details in einem übersichtlichen JSON-Paket:

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

Sicherheit zuerst: Überprüfe die Quelle

Jeder Webhook enthält den geheimen Schlüssel deiner App. Damit kannst du bestätigen, dass die Nachricht wirklich von Quire stammt und nicht von jemandem, der sich als wir ausgibt. Prüfe das immer, bevor du irgendwelche Daten verarbeitest!

Auf unterschiedliche Ereignisse reagieren

In deinen Projekten passieren unterschiedliche Dinge, und du wirst sie unterschiedlich behandeln wollen. Hier ein einfaches Beispiel, wie du je nach Ereignis reagieren kannst:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

Welche Ereignistypen sendet Quire?

Quire kann dich über alle möglichen Aktivitäten benachrichtigen. Hier sind einige der häufigsten:

Du möchtest die vollständige Liste? In unserer Dokumentation zu Aktivitätstypen findest du alles, was Quire dir mitteilen kann.

Quire mitteilen, dass die Nachricht angekommen ist

Wenn dein Webhook eine Benachrichtigung empfängt, sende einfach einen Erfolgs-Statuscode zurück (irgendetwas zwischen 200 und 299). Das signalisiert Quire: „Angekommen, danke!"

Wenn etwas schiefläuft und du einen anderen Statuscode zurücksendest, kein Problem – Quire versucht es erneut, nach 15 Minuten, dann nach 1 Stunde und schließlich nach 1 Tag.

Weitere Details findest du unter „Responding and Retries" in unserer API-Dokumentation.

Wie verwaltest du Webhooks über mehrere Projekte hinweg?

Arbeitest du mit mehreren Quire-Projekten auf demselben Server? Wir haben zwei flexible Ansätze für dich:

Option 1: Benutzerdefinierte Labels verwenden

Du kannst beim Abonnieren von Projekt-Updates ein benutzerdefiniertes Label hinzufügen:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

Quire fügt dieses Label jeder Webhook-Benachrichtigung hinzu, sodass du leicht erkennen kannst, welches Projekt sie gesendet hat:

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

In deinem Code kannst du Benachrichtigungen dann entsprechend weiterleiten:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

Option 2: Verschiedene Pfade verwenden

Möchtest du die Dinge lieber getrennt halten? Richte für jedes Projekt einen eigenen Pfad ein:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

So sendet Quire Benachrichtigungen an verschiedene Unterpfade deines Haupt-Endpunkts (wie http://myserver/hookhandler/projectAUpdate), und du kannst jedes Projekt mit einem eigenen dedizierten Handler behandeln.

Was ist der schnellste Weg zu deinem ersten Webhook?

Das war's! Jetzt weißt du, wie man Webhooks einrichtet und seine Anwendungen perfekt mit Quire synchron hält. Die vollständige technische Dokumentation findest du im Webhook-Abschnitt unserer API-Referenz.

Entwickelst du für einen KI-Assistenten statt für einen eigenen Server? Dann wirf einen Blick auf Quire MCP Setup in 5 Minuten, um Claude, ChatGPT oder jeden anderen KI-Client direkt zu verbinden.

Viel Erfolg beim Entwickeln!

Häufig gestellte Fragen

Was ist ein Quire-Webhook?

Eine automatisierte HTTP-Benachrichtigung, die Quire in dem Moment, in dem in einem verfolgten Projekt etwas passiert, an eine von dir festgelegte URL sendet – so bleibt deine App synchron, ohne abfragen zu müssen.

Wie richte ich einen Webhook in Quire ein?

Erstelle eine Quire-App, registriere deine Endpunkt-URL im Developer-Apps-Portal und füge deine App dann über die API als Projekt-Follower hinzu. Konfiguriere die URL, bevor du das Abonnement einrichtest, sonst schlägt der Aufruf fehl.

Wie kann ich überprüfen, ob eine Webhook-Anfrage wirklich von Quire stammt?

Jede Payload enthält im Feld secret den geheimen Schlüssel deiner App – vergleiche ihn mit deinem gespeicherten Secret und lehne jede nicht übereinstimmende Anfrage ab.

Was passiert, wenn mein Server offline ist, während ein Webhook ausgelöst wird?

Quire versucht es dreimal erneut – nach 15 Minuten, 1 Stunde und 1 Tag. Sende einen 2xx-Status, sobald du die Payload empfängst, um weitere Wiederholungsversuche zu stoppen.

Wie handhabe ich Webhooks für mehrere Quire-Projekte auf einem Server?

Hänge entweder beim Abonnieren ein benutzerdefiniertes Label an (zum Beispiel app|handleProjectA) und leite anhand des team-Felds weiter, oder gib jedem Projekt einen eigenen Unterpfad deiner Webhook-URL.