DoConure

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

CampoValore
URLhttps://api.doconure.com/api/v1/compose/documents/generate
MetodoPOST
Intestazione 1Authorization = Bearer YOUR_API_KEY (la parola Bearer, uno spazio, poi la chiave)
Intestazione 2Content-Type = application/json
Corpo (JSON grezzo)
{
  "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). 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)

  1. Aggiungete il modulo HTTP → Make a request.
  2. URL e metodo come sopra. In Headers aggiungete le due intestazioni. Body type: Raw, Content type: JSON (application/json).
  3. Incollate il corpo. Mettete dentro data i campi mappati di Make (per esempio il nome del cliente preso dal vostro Google Sheet).
  4. 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

  1. Aggiungete 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. Usate l'indirizzo di download o il campo base64 nel passaggio successivo.

n8n

  1. Aggiungete 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, incollate 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 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.