Integração · 3 de junho de 2026 · 6 min de leitura
Renders automáticos com gatilhos de evento
Ligue um evento a um template e os documentos passam a aparecer sozinhos — com idempotência e sem loops, por desenho.
Nem tudo merece uma integração: recibos mensais, cartas de boas-vindas, confirmações. Para esses, os gatilhos de render transformam eventos em documentos sem uma linha de código no fluxo.
Criar um gatilho
curl -X POST https://api.doptizer.pavulla.com/v1/render-triggers \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"event_type": "FormSubmissionFinal",
"template_id": "7bc1…",
"format": "pdf"
}'A partir daqui, sempre que um formulário multi-parte conclui (FormSubmissionFinal), o worker gera o documento com os dados do evento. O documento aparece no repositório com origem “via gatilho” na linhagem.
As garantias por trás
- Outbox transacional: o evento grava-se na mesma transação do facto que o originou — nunca se perde, nunca dispara sem o facto ter acontecido.
- Idempotência por gatilho+evento: reprocessamentos do worker não duplicam documentos.
- Allowlist de eventos: DocumentRendered está excluído por desenho — impossível criar loops de geração.
- Quota normal: renders por gatilho contam como qualquer outro.
Os gatilhos geríveis também na consola: API & integrações → Gatilhos de render, com os eventos suportados listados.