Endpoint
Metodo: POST. URL: il tuo endpoint generato /api/webhooks/todos/{token} nelle impostazioni. Il token è univoco per ogni utente.
Aiuto
Back to adminDettagli webhook
Porta attività in TwoDoo da altri strumenti e invia fuori le vittorie completate.
Al momento TwoDoo supporta due direzioni di webhook: un webhook in ingresso per creare o aggiornare i todos settimanali e un webhook di stato in uscita che avvisa un altro strumento quando un Doo viene completato.
Genera l’URL del webhook in ingresso nelle impostazioni quando la modalità Todos settimanali è attiva. Aggiungi fino a 3 URL del webhook di stato in uscita nelle impostazioni avanzate se altri sistemi devono ricevere gli aggiornamenti di completamento.
Webhook in ingresso dei todo
Usa questo webhook per inviare attività da Jira, Make, Zapier o dal tuo sistema a TwoDoo.
Comportamento
Se externalTaskId corrisponde a un todo settimanale attivo esistente, TwoDoo aggiorna quell’elemento. Senza externalTaskId, ogni richiesta crea un nuovo todo settimanale. Le chiamate duplicate con lo stesso externalTaskId vengono ignorate per circa 10 secondi.
Limiti e requisiti
La modalità Todos settimanali deve essere attiva. Il webhook in ingresso è limitato a 30 richieste al minuto e 200 al giorno per utente. Abusi ripetuti possono disattivarlo temporaneamente o definitivamente.
Campi accettati
title
Obbligatorio. Il titolo del todo. Massimo 140 caratteri.
priority
Opzionale. Uno tra: high, normal, low. Il valore predefinito è normal.
description
Opzionale. Descrizione in testo semplice. Massimo 1000 caratteri.
descriptionUrlEncoded
Opzionale. Testo della descrizione codificato in URL. Utile per Jira quando la descrizione grezza romperebbe il JSON.
descriptionBase64
Opzionale. Testo della descrizione codificato in Base64. Utile per strumenti che sanno codificare ma non fare l’escape JSON in modo sicuro.
plannedForDate
Opzionale. Data pianificata nel formato YYYY-MM-DD.
externalTaskId
Opzionale ma consigliato per le sincronizzazioni. ID attività esterno del sistema mittente. Massimo 255 caratteri.
Esempio base
{
"title": "Plan launch email",
"priority": "high",
"description": "Imported from Make.com",
"plannedForDate": "2026-03-19",
"externalTaskId": "make-12345"
}Esempio per Jira
Se le descrizioni grezze di Jira rompono il JSON, invia la descrizione come descriptionUrlEncoded invece di description.
{
"title": "{{issue.summary.left(138)}}",
"priority": "normal",
"descriptionUrlEncoded": "{{issue.description.urlEncode()}}",
"externalTaskId": "{{issue.id}}"
}Webhook di stato del todo in uscita
Questo webhook invia un payload JSON al tuo URL ogni volta che un Doo viene completato.
Destinazione
Imposta fino a 3 URL http o https validi nelle impostazioni avanzate. TwoDoo invierà il payload di completamento a ciascuno dopo che un todo passa a done, gratitude, scheduled, delegated o eliminated. Ogni destinazione può anche avere un secret opzionale e un template JSON personalizzato.
Header
TwoDoo invia l’header X-TwoDoo-Event: todo.status_changed insieme a un corpo JSON. Se imposti un secret del webhook, TwoDoo invia anche X-Automation-Webhook-Token per strumenti come Jira.
Campi in uscita
event
Sempre todo.status_changed.
userId
L’ID utente di TwoDoo.
userEmail
L’indirizzo e-mail salvato di quell’utente.
todoId
L’ID dell’istanza di todo completata.
sourceUserTodoId
L’ID del todo settimanale / elemento libreria se questo Doo proveniva dalla lista settimanale. Altrimenti null.
externalTaskId
La externalTaskId salvata sul todo settimanale, se presente.
title
Il titolo del todo completato.
description
La descrizione salvata su quel todo, se presente.
status
Uno tra: done, gratitude, scheduled, delegated, eliminated.
taskDate
Il giorno TwoDoo in cui il completamento è avvenuto, nel formato YYYY-MM-DD.
plannedForDate
La data pianificata opzionale del todo settimanale.
completedAt
Timestamp di completamento in formato ISO 8601.
isDefault
True quando l’elemento completato proveniva da una chiave attività predefinita / semplice.
Esempio di 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
}Creato con ❤️ da Sam Steiner