Make, Zapier, n8n e gli altri strumenti senza codice

Qualsiasi strumento che sa inviare una richiesta HTTP può creare un documento. Non scrivi codice: compili un passaggio "HTTP" o "Webhook" con i valori qui sotto. La prima esecuzione usi "isTest": true, che è gratuita.

Nessuno strumento? Un documento Word che hai già scritto si può firmare dalla console: Flussi, Fai firmare un documento Word (come).

I cinque valori che ogni strumento chiede

{
  "data": { "customer": { "name": "Acme Srl" } },
  "settings": {
    "templateId": "YOUR_TEMPLATE_ID",
    "isTest": true,
    "responseFormat": "json"
  }
}

Perché responseFormat: "json": la maggior parte degli strumenti senza codice non sa passare i byte di un PDF da un passaggio all'altro. Con questa opzione la risposta è testo, e il PDF è in output.compose.documentBase64 (base64). Aggiungi un passaggio "converti base64 in file", oppure scarica output.compose.downloadUrl con la stessa intestazione. n8n può ricevere direttamente il file: imposta il formato della risposta del nodo su File e togli responseFormat.

Make (Integromat)

1. Aggiungi il modulo HTTP → Make a request.
2. URL e metodo come sopra. In Headers aggiungi le due intestazioni. Body type: Raw, Content type: JSON (application/json).
3. Incolla il corpo. Metti dentro data i campi mappati di Make (per esempio il nome del cliente preso dal tuo Google Sheet).
4. Attiva Parse response. Il modulo successivo può leggere output.compose.documentBase64; usa un passaggio di decodifica base64 o il campo file del modulo Google Drive o Email.

Zapier

1. Aggiungi l'azione Webhooks by Zapier → Custom Request.
2. Method: POST. URL, Data (il corpo JSON) e Headers come sopra.
3. Zapier mostra la risposta come campi. Usa l'indirizzo di download o il campo base64 nel passaggio successivo.

n8n

1. Aggiungi il nodo HTTP Request. Metodo POST, l'URL qui sopra.
2. Authentication: Generic credential → Header Auth, nome Authorization, valore Bearer YOUR_API_KEY.
3. Send body attivo, Body content type JSON, Specify body Using JSON, incolla il corpo senza responseFormat.
4. Options → Response → Response format: File. Il nodo successivo riceve il PDF come dati binari.

Sapere quando una firma è completata

Per un documento mandato in firma, dai alla chiamata un indirizzo di callback. In Make, Zapier o n8n crea un trigger Custom webhook, copia il suo indirizzo nella chiamata e ogni evento della busta avvia il tuo scenario (ambienti dei callback).

Quando non funziona

La risposta ha sempre un code e un message. I più frequenti: MISSING_CREDENTIALS (manca l'intestazione Authorization), INVALID_API_KEY (la chiave è stata copiata con uno spazio, o senza Bearer ), INVALID_JSON (il corpo non è un JSON valido: un apice dritto diventato curvo, o una virgola finale), TEMPLATE_NOT_FOUND (controlla l'id del modello). Tutti i codici.

Lo stesso in codice: PHP, WordPress, React, Java, C#, Go, Ruby, JavaScript, cURL.