n8n + Clinch: workflow per i contratti, self-hosted o cloud

Tre ricette

• Quando viene inviato un modulo, invia un contratto

  Form Trigger di n8n (o Typeform, Tally) → HTTP Request POST /api/v1/documents con il modello web-design-contract e il cliente come firmatario.

• Quando un contratto è firmato, fattura la prima milestone

  Webhook su contract.signed → HTTP Request POST /api/v1/invoices per la prima milestone, con un link di pagamento.

• Quando una proposta è accettata, apri il progetto

  Webhook su proposal.accepted → crea un progetto Linear o Jira e una cartella condivisa su Google Drive.

Configuralo

1. In Clinch, apri Impostazioni → Chiavi API e crea una chiave. In n8n, salvala come credenziale Header Auth: nome Authorization, valore Bearer <la tua chiave>.
2. Per inviare contratti: aggiungi un HTTP Request node, POST https://clinch.lumnika.com/api/v1/documents, con quella credenziale e un body JSON (title, template o text, signers).
3. Per reagire agli eventi: aggiungi un Webhook node impostato su POST, copia il suo URL di produzione e incollalo in Clinch in Impostazioni → Integrazioni.
4. Facoltativo: aggiungi un Code node che verifica l'header X-Clinch-Signature con il tuo segreto di firma, poi attiva il workflow.

Esempio

POST https://clinch.lumnika.com/api/v1/documents
Authorization: Bearer clk_your_key
Content-Type: application/json

{
  "title": "Website redesign – Acme Bakery",
  "template": "web-design-contract",
  "signers": [{ "name": "Jane Doe", "email": "jane@acme.com" }],
  "deposit_cents": 72000
}

Domande