{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Flusso di chiamate True Flow","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"flusso-di-chiamate-true-flow","__idx":0},"children":["Flusso di chiamate True Flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Questa guida descrive come creare un True Flow tramite la Public API. In sintesi hai ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tre possibilità"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creazione semplice"]}," — Una sola chiamata a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}," con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["template_token"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},". Il flusso parte con i valori di default del template; l'utente finale riceverà il link e compila il form dall'inizio alla fine."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creazione con dati precompilati e/o firmatari"]}," — Sempre ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]},", ma arricchito con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]}," (campi del form già valorizzati) e/o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign_data"]}," (elenco firmatari). Utile quando integri con i tuoi sistemi e vuoi precompilare dati anagrafici, riferimenti pratica o inviti alla firma."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Creazione con allegati"]}," — Il template prevede documenti da caricare. Prima ottieni un token e un URL di upload (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows-attachments"]},"), carichi il file con una ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},", poi crei il True Flow con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}," passando i token degli allegati in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]},". Le prime due operazioni vanno eseguite in sequenza per ogni file."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Puoi anche ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["combinare"]}," le opzioni: ad esempio dati prepopolati, firmatari e allegati nella stessa creazione (prima gli upload, poi una sola ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}," con tutto). Le sezioni seguenti entrano nel dettaglio di ogni caso."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"riferimento-rapido","__idx":1},"children":["Riferimento rapido"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scenario"},"children":["Scenario"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Chiamate principali"},"children":["Chiamate principali"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#1-creazione-true-flow-semplice"},"children":["Semplice"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST /true-flows"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#2-creazione-true-flow-con-dati-prepopolati"},"children":["Con prepopolazione"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST /true-flows con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#3-creazione-true-flow-con-allegati"},"children":["Con allegati"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST /true-flows-attachments → PUT upload_url → POST /true-flows con token in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#4-creazione-true-flow-con-firmatari"},"children":["Con firmatari"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST /true-flows con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign_data"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In tutti i casi le richieste devono includere l'",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#autenticazione"},"children":["autenticazione"]}," con API key. Per il contesto sui token usati nelle chiamate, vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#flow-template-token"},"children":["Flow template token"]},"; per combinare più opzioni in un'unica creazione, vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#combinazione-di-pi%C3%B9-opzioni"},"children":["Combinazione di più opzioni"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"true-flow-tramite-mcp","__idx":2},"children":["True Flow tramite MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le operazioni True Flow sono disponibili anche tramite MCP."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_list_templates"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_true_flow"]}," sono disponibili sia sul server MCP ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["remoto"]}," sia su quello ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["locale"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["L'upload di allegati per un True Flow è disponibile solo sul server MCP ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["locale"]}," tramite ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truescreen_create_true_flow_attachment"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vedi ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/it/mcp-integration"},"children":["Integrazione MCP"]}," per installazione e scelta del canale."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"flow-template-token","__idx":3},"children":["Flow template token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["flow template token"]}," è l'identificativo del modello di flusso che vuoi istanziare. È creato e gestito da TrueScreen: non lo generi tu, ma lo ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["usi"]}," nelle chiamate di creazione del True Flow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il token è ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["univoco per quel tipo di flusso"]}," e resta valido anche se il template evolve nel tempo: non è quindi necessario richiamare ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /templates"]}," a ogni creazione. I flow template sono un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["catalogo"]}," tra cui scegliere: una volta che conosci il ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["template_token"]}," (e, se serve, lo schema dei campi), puoi riusarlo per tutte le istanze che crei."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"come-ottenere-il-flow-template-token","__idx":4},"children":["Come ottenere il flow template token"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /templates"]}," — Chiama questo endpoint quando devi consultare il catalogo: restituisce l'elenco dei flow template disponibili per la tua API key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La risposta include, per ogni template, il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["template_token"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["La risposta include, quando previsto, lo ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["schema o l'elenco dei campi"]}," che puoi valorizzare in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sign_data"]}," (campi precompilabili del form e struttura firmatari). La forma esatta è definita nella specifica OpenAPI per ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /templates"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In sintesi: usi ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /templates"]}," quando ti serve scoprire o aggiornare il catalogo e i campi compilabili; per creare un True Flow usi sempre ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /true-flows"]}," con il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["template_token"]}," già in tuo possesso."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"casi-duso","__idx":5},"children":["Casi d'uso"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-creazione-true-flow-semplice","__idx":6},"children":["1. Creazione True Flow semplice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Si crea un True Flow passando solo il token del flow template. Il flusso viene creato con i valori di default definiti nel template; l'utente finale compilerà il form nel link restituito."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body minimo:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"template_token\": \"<token_ottenuto_da_GET_templates>\",\n  \"name\": \"Nome del flusso\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta:"]}," contiene il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token"]}," del True Flow e l'URL ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["trueLink"]}," (deeplink) da inviare all'utente."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-creazione-true-flow-con-dati-prepopolati","__idx":7},"children":["2. Creazione True Flow con dati prepopolati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vuoi precompilare alcuni campi del form (es. nome, email, riferimento pratica). I campi compilabili sono quelli restituiti nello schema del flow template (GET /templates)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"template_token\": \"<template_token>\",\n  \"name\": \"Flusso con dati prepopolati\",\n  \"flow_data\": {\n    \"nome\": \"Mario\",\n    \"cognome\": \"Rossi\",\n    \"email\": \"mario.rossi@example.com\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["flow_data"]}," è un oggetto chiave-valore: le chiavi sono i nomi dei campi definiti nel template; i valori devono rispettare tipo e vincoli dello schema."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I valori in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]}," diventano i ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["valori di default"]}," del form."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-creazione-true-flow-con-allegati","__idx":8},"children":["3. Creazione True Flow con allegati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per allegare file al flusso sono necessarie ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tre chiamate"]}," in sequenza."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passo-1--ottenere-token-e-url-di-upload","__idx":9},"children":["Passo 1 — Ottenere token e URL di upload"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows-attachments"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"file_name\": \"documento.pdf\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Risposta:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"token\": \"<attachment_token>\",\n  \"file_name\": \"documento.pdf\",\n  \"upload_url\": \"https://...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token:"]}," identificativo dell'allegato; lo userai in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["upload_url:"]}," URL firmato temporaneo (presigned URL) per caricare il file. Ha una scadenza di 120 secondi."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passo-2--caricare-il-file","__idx":10},"children":["Passo 2 — Caricare il file"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Esegui una richiesta ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUT"]}," sull'",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["upload_url"]}," restituito, con il corpo della richiesta uguale al contenuto binario del file (es. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/pdf"]}," per un PDF)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Il client HTTP deve usare esattamente l'URL restituito; non aggiungere header aggiuntivi non richiesti dalla signed URL (di solito solo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}," e il body)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passo-3--creare-il-true-flow-includendo-gli-allegati","__idx":11},"children":["Passo 3 — Creare il True Flow includendo gli allegati"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nel ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["flow_data"]},", inserisci i token degli allegati nei campi che il flow template riserva agli allegati (es. un campo tipo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documents"]}," che accetta un array di token)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body di esempio:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"template_token\": \"<template_token>\",\n  \"name\": \"Flusso con allegato\",\n  \"flow_data\": {\n    \"documents\": [\"<attachment_token_1>\", \"<attachment_token_2>\"]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I nomi dei campi per gli allegati (es. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documents"]},") dipendono dal flow template; puoi ricavarli dallo schema restituito da ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /templates"]}," (campi con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["format: \"attachment\""]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ogni elemento dell'array è il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["token"]}," restituito da ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /true-flows-attachments"]}," dopo aver completato l'upload con PUT."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Riassunto sequenza:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Per ogni file: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows-attachments"]}," → ottieni ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["upload_url"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Per ogni file: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT upload_url"]}," con il corpo = contenuto del file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}," con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_data"]}," contenente, nei campi allegati del template, gli array di token."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-creazione-true-flow-con-firmatari","__idx":12},"children":["4. Creazione True Flow con firmatari"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se il flow template prevede una sezione firmatari (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signData"]},"), puoi passare i dati dei firmatari nell'array ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sign_data"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /true-flows"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body di esempio:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"template_token\": \"<template_token>\",\n  \"name\": \"Flusso con firmatari\",\n  \"sign_data\": [\n    {\n      \"nome\": \"Mario\",\n      \"cognome\": \"Rossi\",\n      \"email\": \"mario.rossi@example.com\"\n    },\n    {\n      \"nome\": \"Luigi\",\n      \"cognome\": \"Verdi\",\n      \"email\": \"luigi.verdi@example.com\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sign_data"]}," è un array di oggetti; ogni oggetto corrisponde a un firmatario."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I campi ammessi (es. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nome"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cognome"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},") dipendono dallo schema ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["signData"]}," del flow template; puoi ricavarlo da ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET /templates"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I valori vengono inseriti nella sezione firmatari del flusso e utilizzati per l'invito alla firma."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"combinazione-di-più-opzioni","__idx":13},"children":["Combinazione di più opzioni"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Puoi combinare ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["flow_data"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sign_data"]}," e allegati nella stessa chiamata a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /true-flows"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"template_token\": \"<template_token>\",\n  \"name\": \"Flusso completo\",\n  \"flow_data\": {\n    \"riferimento\": \"PRAT-2024-001\",\n    \"documents\": [\"<attachment_token>\"]\n  },\n  \"sign_data\": [\n    {\n      \"nome\": \"Mario\",\n      \"cognome\": \"Rossi\",\n      \"email\": \"mario.rossi@example.com\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["L'ordine richiesto resta: prima eventuali ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /true-flows-attachments"]}," e ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUT"]}," di upload, poi ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["POST /true-flows"]}," con tutti i token e i dati desiderati."]}]},"headings":[{"value":"Flusso di chiamate True Flow","id":"flusso-di-chiamate-true-flow","depth":1},{"value":"Riferimento rapido","id":"riferimento-rapido","depth":2},{"value":"True Flow tramite MCP","id":"true-flow-tramite-mcp","depth":2},{"value":"Flow template token","id":"flow-template-token","depth":2},{"value":"Come ottenere il flow template token","id":"come-ottenere-il-flow-template-token","depth":3},{"value":"Casi d'uso","id":"casi-duso","depth":2},{"value":"1. Creazione True Flow semplice","id":"1-creazione-true-flow-semplice","depth":3},{"value":"2. Creazione True Flow con dati prepopolati","id":"2-creazione-true-flow-con-dati-prepopolati","depth":3},{"value":"3. Creazione True Flow con allegati","id":"3-creazione-true-flow-con-allegati","depth":3},{"value":"Passo 1 — Ottenere token e URL di upload","id":"passo-1--ottenere-token-e-url-di-upload","depth":4},{"value":"Passo 2 — Caricare il file","id":"passo-2--caricare-il-file","depth":4},{"value":"Passo 3 — Creare il True Flow includendo gli allegati","id":"passo-3--creare-il-true-flow-includendo-gli-allegati","depth":4},{"value":"4. Creazione True Flow con firmatari","id":"4-creazione-true-flow-con-firmatari","depth":3},{"value":"Combinazione di più opzioni","id":"combinazione-di-più-opzioni","depth":2}],"frontmatter":{"title":"Flusso di chiamate True Flow","description":"Guida ai casi d'uso per la creazione di un True Flow via API pubblica","seo":{"title":"Flusso di chiamate True Flow"}},"lastModified":"2026-04-20T15:13:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/true-flow-workflow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}