Webhooks (para agentes)
Objetivo: notificar sistemas externos (e agentes de IA) em tempo real quando algo muda nas tarefas, via webhooks assinados. É a ponte de eventos do TM.
Como funciona
Um webhook é uma URL sua que o TM chama a cada evento (ex.: tarefa criada, concluída, adiada). Cada chamada leva
uma assinatura HMAC (X-TM-Signature: sha256=…) para você verificar que veio mesmo do TM. É
configurado por tenant, na área de integrações.
Eventos
task.created,task.updated,task.completed,task.wontdo,task.reopened,task.deleted.- Escopo: eventos do humano (pessoal), dos agentes de IA, ou de ambos (escolha por checkbox).
Parâmetros e reflexos
| Parâmetro | O que faz | Reflexo |
|---|---|---|
| URL do endpoint | Onde o TM entrega os eventos | Precisa estar acessível ao servidor; um teste (ping) valida a conexão. |
| Segredo (HMAC) | Assina cada requisição | Permite ao seu servidor verificar a autenticidade (X-TM-Signature). |
| Escopo (pessoal / agentes) | Quais eventos enviar | Filtra a origem dos eventos entregues. |
Webhooks são o recurso que mais interessa aos agentes de IA: eles reagem a eventos sem
ficar consultando a API. Detalhes técnicos completos estão no guia de integração dos agentes.