Hilfe

Back to admin

Webhook-Details

Bringe Aufgaben aus anderen Tools in TwoDoo und sende erledigte Erfolge wieder nach außen.

TwoDoo unterstützt derzeit zwei Webhook-Richtungen: einen eingehenden Todo-Webhook zum Erstellen oder Aktualisieren von Wochen-Todos und einen ausgehenden Status-Webhook, der ein anderes Tool informiert, wenn ein Doo erledigt wurde.

Erzeuge die eingehende Webhook-URL in den Einstellungen, wenn Wochen-Todos aktiviert sind. Trage bis zu 3 ausgehende Status-Webhook-URLs in den erweiterten Einstellungen ein, wenn andere Systeme Abschluss-Updates erhalten sollen.

Eingehender Todo-Webhook

Nutze diesen Webhook, um Aufgaben aus Jira, Make, Zapier oder deinem eigenen System in TwoDoo zu schicken.

Endpunkt

Methode: POST. URL: dein eigener generierter /api/webhooks/todos/{token}-Endpunkt aus den Einstellungen. Das Token ist pro Nutzer eindeutig.

Verhalten

Wenn externalTaskId zu einem bestehenden aktiven Wochen-Todo passt, aktualisiert TwoDoo diesen Eintrag. Ohne externalTaskId erzeugt jede Anfrage ein neues Wochen-Todo. Doppelte Webhook-Aufrufe mit derselben externalTaskId werden für ungefähr 10 Sekunden ignoriert.

Limits und Voraussetzungen

Der Modus Wochen-Todos muss aktiviert sein. Der eingehende Webhook ist auf 30 Anfragen pro Minute und 200 pro Tag pro Nutzer begrenzt. Wiederholter Missbrauch kann ihn vorübergehend oder dauerhaft deaktivieren.

Akzeptierte Felder

title

Erforderlich. Der Todo-Titel. Maximal 140 Zeichen.

priority

Optional. Eines von: high, normal, low. Standard ist normal.

description

Optional. Reiner Text als Beschreibung. Maximal 1000 Zeichen.

descriptionUrlEncoded

Optional. URL-kodierter Beschreibungstext. Praktisch für Jira, wenn roher Beschreibungstext JSON kaputtmachen würde.

descriptionBase64

Optional. Base64-kodierter Beschreibungstext. Praktisch für Tools, die kodieren, aber nicht sicher JSON-escapen können.

plannedForDate

Optional. Geplantes Datum im Format YYYY-MM-DD.

externalTaskId

Optional, aber für Synchronisationen empfohlen. Externe Aufgaben-ID des sendenden Systems. Maximal 255 Zeichen.

Einfaches Beispiel

{
  "title": "Plan launch email",
  "priority": "high",
  "description": "Imported from Make.com",
  "plannedForDate": "2026-03-19",
  "externalTaskId": "make-12345"
}

Jira-freundliches Beispiel

Wenn rohe Jira-Beschreibungen JSON kaputtmachen, sende die Beschreibung als descriptionUrlEncoded statt als description.

{
  "title": "{{issue.summary.left(138)}}",
  "priority": "normal",
  "descriptionUrlEncoded": "{{issue.description.urlEncode()}}",
  "externalTaskId": "{{issue.id}}"
}

Ausgehender Todo-Status-Webhook

Dieser Webhook sendet einen JSON-Payload an deine URL, sobald ein Doo erledigt wird.

Wohin es geht

Trage in den erweiterten Einstellungen bis zu 3 gültige http- oder https-URLs ein. TwoDoo sendet den Abschluss-Payload an jede davon, nachdem ein Todo auf done, gratitude, scheduled, delegated oder eliminated gewechselt ist. Jedes Ziel kann zusätzlich ein optionales Secret und ein eigenes JSON-Body-Template haben.

Header

TwoDoo sendet den Header X-TwoDoo-Event: todo.status_changed zusammen mit einem JSON-Body. Wenn ein Webhook-Secret gesetzt ist, sendet TwoDoo für Tools wie Jira zusätzlich X-Automation-Webhook-Token.

Ausgehende Felder

event

Immer todo.status_changed.

userId

Die TwoDoo-Nutzer-ID.

userEmail

Die gespeicherte E-Mail-Adresse dieses Nutzers.

todoId

Die ID der erledigten Todo-Instanz.

sourceUserTodoId

Die ID des Wochen-Todos/Bibliothekseintrags, wenn dieses Doo aus der Wochenliste kam. Sonst null.

externalTaskId

Die am Wochen-Todo gespeicherte externalTaskId, falls vorhanden.

title

Der Titel des erledigten Todos.

description

Die auf diesem Todo gespeicherte Beschreibung, falls vorhanden.

status

Eines von: done, gratitude, scheduled, delegated, eliminated.

taskDate

Der TwoDoo-Tag, an dem der Abschluss passiert ist, im Format YYYY-MM-DD.

plannedForDate

Das optionale geplante Datum des Wochen-Todos.

completedAt

Zeitstempel des Abschlusses im ISO-8601-Format.

isDefault

True, wenn der erledigte Eintrag aus einem Default-/Simple-Task-Key kam.

Beispiel-Payload

{
  "event": "todo.status_changed",
  "userId": 12,
  "userEmail": "sam@example.com",
  "todoId": 481,
  "sourceUserTodoId": 93,
  "externalTaskId": "jira-12345",
  "title": "Plan launch email",
  "description": "Imported from Jira",
  "status": "done",
  "taskDate": "2026-03-22",
  "plannedForDate": "2026-03-23",
  "completedAt": "2026-03-22T15:18:04+00:00",
  "isDefault": false
}

Erstellt mit ❤️ von Sam Steiner