Make, Zapier, n8n e gli altri strumenti senza codice
Qualsiasi strumento che sa inviare una richiesta HTTP può creare un documento. Non scrivete codice: compilate un
passaggio "HTTP" o "Webhook" con i valori qui sotto. La prima esecuzione usi "isTest": true, che è gratuita.
Nessuno strumento? Un documento Word che avete già scritto si può firmare dalla console: Flussi, Fate firmare un documento Word (come).
I cinque valori che ogni strumento chiede
| Campo | Valore |
|---|---|
| URL | https://api.doconure.com/api/v1/compose/documents/generate |
| Metodo | POST |
| Intestazione 1 | Authorization = Bearer YOUR_API_KEY (la parola Bearer, uno spazio, poi la chiave) |
| Intestazione 2 | Content-Type = application/json |
| Corpo (JSON grezzo) | |
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).
Aggiungete un passaggio "convertite base64 in file", oppure scaricate output.compose.downloadUrl con la stessa intestazione.
n8n può ricevere direttamente il file: impostate il formato della risposta del nodo su File e togliete
responseFormat.
Make (Integromat)
- Aggiungete il modulo HTTP → Make a request.
- URL e metodo come sopra. In Headers aggiungete le due intestazioni. Body type: Raw, Content type: JSON (application/json).
- Incollate il corpo. Mettete dentro
datai campi mappati di Make (per esempio il nome del cliente preso dal vostro Google Sheet). - Attivate Parse response. Il modulo successivo può leggere
output.compose.documentBase64; usate un passaggio di decodifica base64 o il campo file del modulo Google Drive o Email.
Zapier
- Aggiungete l'azione Webhooks by Zapier → Custom Request.
- Method:
POST. URL, Data (il corpo JSON) e Headers come sopra. - Zapier mostra la risposta come campi. Usate l'indirizzo di download o il campo base64 nel passaggio successivo.
n8n
- Aggiungete il nodo HTTP Request. Metodo
POST, l'URL qui sopra. - Authentication: Generic credential → Header Auth, nome
Authorization, valoreBearer YOUR_API_KEY. - Send body attivo, Body content type JSON, Specify body Using JSON, incollate il corpo senza
responseFormat. - 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 vostro 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 (controllate l'id del modello). Tutti i codici.
Lo stesso in codice: PHP, WordPress, React, Java, C#, Go, Ruby, JavaScript, cURL.