{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Webhook","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook","__idx":0},"children":["Webhook"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gestire i webhook per gli eventi delle pratiche, a livello di pratica e a livello di organizzazione."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Avviso di deprecazione"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gli endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook-subscription"]}," sono ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["deprecati e saranno rimossi il 31 ottobre 2026"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhook-subscription"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhook-subscription"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhook-subscription"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Migrare ai nuovi endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhooks"]}," descritti di seguito prima di tale data. Dopo la rimozione, le chiamate ai vecchi endpoint non andranno a buon fine. Vedere ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#migrazione-da-webhook-subscription"},"children":["Migrazione da webhook-subscription"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I webhook consentono alla propria applicazione di ricevere notifiche in tempo reale sugli eventi delle pratiche. Invece di interrogare ciclicamente l'API per gli aggiornamenti di stato, NSE invia un evento all'endpoint HTTPS indicato appena si verifica l'evento sottoscritto."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I webhook possono essere registrati a due livelli:"]},{"$$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":"Livello"},"children":["Livello"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Ambito"},"children":["Ambito"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Eventi supportati"},"children":["Eventi supportati"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pratica"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Una singola pratica"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tutti gli eventi (vedere ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#eventi-supportati"},"children":["Eventi supportati"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Organizzazione"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tutte le pratiche dell'organizzazione"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Solo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCompleted"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Per entrambi i livelli si registra un URL webhook e si seleziona l'evento che deve attivarlo (ad esempio ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCompleted"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientRejected"]},"). Ogni webhook ha un proprio ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]},", da utilizzare per leggerlo, aggiornarlo o eliminarlo."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook-della-pratica","__idx":1},"children":["Webhook della pratica"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"elencare-i-webhook-di-una-pratica","__idx":2},"children":["Elencare i webhook di una pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Restituisce tutti i webhook configurati per la pratica specificata."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso","__idx":3},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco della pratica"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creare-un-webhook-della-pratica","__idx":4},"children":["Creare un webhook della pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Crea un webhook per la pratica specificata."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-1","__idx":5},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco della pratica"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"corpo-della-richiesta","__idx":6},"children":["Corpo della richiesta"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Content-Type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$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":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'URL HTTPS su cui ricevere gli eventi webhook"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WebhookEventType"]}," (string)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'evento che attiva il webhook. Vedere ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#eventi-supportati"},"children":["Eventi supportati"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WebhookAuthenticationRequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Impostazioni di autenticazione per l'endpoint webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"eventi-supportati","__idx":7},"children":["Eventi supportati"]},{"$$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":"Evento"},"children":["Evento"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeSent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La pratica è stata inviata"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCompleted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La pratica è stata completata*"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCanceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La pratica è stata annullata"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeRestarted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La pratica è stata riavviata"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeDeleted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La pratica è stata eliminata"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientCompleted"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Un destinatario ha completato la propria azione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientRejected"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Un destinatario ha respinto la pratica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RecipientDelegated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Un destinatario ha delegato la propria azione"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["*Con la funzionalità ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["EnrichedWebhook"]}," abilitata, l'evento ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["EnvelopeCompleted"]}," restituisce dati aggiuntivi, ad esempio fasi, destinatari, artefatti e metadati della classe documentale."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"webhookauthenticationrequest","__idx":8},"children":["WebhookAuthenticationRequest"]},{"$$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":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Nullable"},"children":["Nullable"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["headers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object (map<string, string>)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header HTTP opzionali da includere nelle chiamate webhook, ad esempio un header ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientCertificate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificato client opzionale codificato in PEM per mTLS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Chiave privata opzionale codificata in PEM per mTLS"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"esempio-di-richiesta","__idx":9},"children":["Esempio di richiesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"url\": \"https://example.com/hooks/envelope\",\n  \"event\": \"EnvelopeCompleted\",\n  \"authentication\": {\n    \"headers\": {\n      \"Authorization\": \"Bearer token_123\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"esempio-di-payload---pratica-completata-senza-la-funzionalità-enrichedwebhook","__idx":10},"children":["Esempio di payload - pratica completata (senza la funzionalità EnrichedWebhook)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"EnvelopeCompleted\",\n  \"id\": \"cf02da82-1234-1234-1234-f07c9fafb1d0\",\n  \"occurredAt\": \"2026-11-17T08:12:17.767+00:00\",\n  \"organizationId\": \"afa1c381-1234-1234-1234-6e6796af7ff3\",\n  \"envelope\": {\n    \"id\": \"6af2128b-1234-1234-1234-881581c104c3\",\n    \"status\": \"Completed\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"esempio-di-payload---pratica-completata-con-la-funzionalità-enrichedwebhook","__idx":11},"children":["Esempio di payload - pratica completata (con la funzionalità EnrichedWebhook)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"EnvelopeCompleted\",\n  \"id\": \"7d84ac88-1234-1234-1234-faae948cfe07\",\n  \"occurredAt\": \"2026-11-17T08:16:44.947+00:00\",\n  \"organizationId\": \"afa1c381-1234-1234-1234-6e6796af7ff3\",\n  \"envelope\": {\n    \"id\": \"f2c3c35d-1234-1234-1234-2a882bca7e19\",\n    \"status\": \"Completed\",\n    \"name\": \"Contract for Mario Rossi\",\n    \"createdAt\": \"2026-11-17T08:15:49.637+00:00\",\n    \"sentAt\": \"2026-11-17T08:16:18.976+00:00\",\n    \"completedAt\": \"2026-11-17T08:16:42.701+00:00\",\n    \"stages\": [\n      {\n        \"id\": \"5d501c26-1234-1234-1234-cdcdc5918d52\",\n        \"name\": \"Stage3\",\n        \"sortOrder\": 1,\n        \"type\": \"Signer\",\n        \"requiredRecipientCompletions\": 1,\n        \"recipients\": [\n          {\n            \"id\": \"d92c57ca-1234-1234-1234-3931cc784a6e\",\n            \"givenName\": \"Mario\",\n            \"surname\": \"Rossi\",\n            \"email\": \"m.gierlinger@namirial.com\",\n            \"status\": \"Completed\",\n            \"completedAt\": \"2026-11-17T08:16:42.374+00:00\"\n          }\n        ]\n      },\n      {\n        \"id\": \"dc1ab1b6-1234-1234-1234-3ed51f23904e\",\n        \"name\": \"\",\n        \"sortOrder\": 2,\n        \"type\": \"CarbonCopy\",\n        \"requiredRecipientCompletions\": 0,\n        \"recipients\": [\n          {\n            \"id\": \"d0965a53-1234-1234-1234-c88fc3db7f86\",\n            \"givenName\": \"Mario\",\n            \"surname\": \"Rossi\",\n            \"email\": \"m.rossi@sample.com\",\n            \"status\": \"Completed\",\n            \"completedAt\": \"2026-11-17T08:16:42.701+00:00\"\n          }\n        ]\n      }\n    ],\n    \"artifacts\": [\n      {\n        \"id\": \"cfe314d5-1234-1234-1234-24c974923fe5\",\n        \"type\": \"CompletedFile\",\n        \"name\": \"A.pdf\",\n        \"fileId\": \"662806f3-1234-1234-1234-539c12ef097c\",\n        \"downloadLink\": {\n          \"url\": \"https://\"\n        }\n      },\n      {\n        \"id\": \"314676fd-1234-1234-1234-edfec12150ba\",\n        \"type\": \"AuditTrail\",\n        \"name\": \"Audit Trail.pdf\",\n        \"downloadLink\": {\n          \"url\": \"https://\"\n        }\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recuperare-un-webhook-della-pratica","__idx":12},"children":["Recuperare un webhook della pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks/{webhookId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Restituisce il webhook specificato."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-2","__idx":13},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco della pratica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco del webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"aggiornare-un-webhook-della-pratica","__idx":14},"children":["Aggiornare un webhook della pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks/{webhookId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aggiorna il webhook specificato. Il corpo della richiesta (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UpdateEnvelopeWebhookRequest"]},") ha la stessa struttura di ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#creare-un-webhook-della-pratica"},"children":["Creare un webhook della pratica"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," ed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]}," sono obbligatori, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication"]}," è facoltativo."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-3","__idx":15},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco della pratica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco del webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"esempio-di-richiesta-1","__idx":16},"children":["Esempio di richiesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"url\": \"https://example.com/hooks/envelope-new\",\n  \"event\": \"EnvelopeCompleted\",\n  \"authentication\": {\n    \"headers\": {\n      \"Authorization\": \"Bearer token_123\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"eliminare-un-webhook-della-pratica","__idx":17},"children":["Eliminare un webhook della pratica"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /api/v1/organizations/{organizationId}/envelopes/{envelopeId}/webhooks/{webhookId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Elimina il webhook specificato."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-4","__idx":18},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["envelopeId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco della pratica"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco del webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook-dellorganizzazione","__idx":19},"children":["Webhook dell'organizzazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I webhook dell'organizzazione vengono attivati per l'evento corrispondente su ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tutte le pratiche"]}," dell'organizzazione, quindi non è necessario registrare un webhook per ogni pratica."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Nota"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I webhook dell'organizzazione supportano solo l'evento ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCompleted"]},". I webhook della pratica supportano tutti gli eventi elencati in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#eventi-supportati"},"children":["Eventi supportati"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Le strutture di richiesta e di payload sono le stesse dei webhook della pratica. Vedere ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#webhookauthenticationrequest"},"children":["WebhookAuthenticationRequest"]}," e gli ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#esempio-di-payload---pratica-completata-senza-la-funzionalit%C3%A0-enrichedwebhook"},"children":["esempi di payload"]}," riportati sopra. La funzionalità ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["EnrichedWebhook"]}," si applica anche ai webhook dell'organizzazione."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"elencare-i-webhook-dellorganizzazione","__idx":20},"children":["Elencare i webhook dell'organizzazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/organizations/{organizationId}/webhooks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Restituisce tutti i webhook configurati per l'organizzazione specificata."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-5","__idx":21},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creare-un-webhook-dellorganizzazione","__idx":22},"children":["Creare un webhook dell'organizzazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/organizations/{organizationId}/webhooks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Crea un nuovo webhook per l'organizzazione specificata. È supportato solo l'evento ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCompleted"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-6","__idx":23},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"corpo-della-richiesta-1","__idx":24},"children":["Corpo della richiesta"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Content-Type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/json"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Corpo della richiesta (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CreateOrganizationWebhookRequest"]},") per la creazione di un webhook dell'organizzazione."]},{"$$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":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'URL HTTPS su cui ricevere gli eventi webhook"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WebhookEventType"]}," (string)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["L'evento che attiva il webhook. Per i webhook dell'organizzazione è supportato solo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EnvelopeCompleted"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WebhookAuthenticationRequest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Impostazioni di autenticazione per l'endpoint webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"esempio-di-richiesta-2","__idx":25},"children":["Esempio di richiesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"url\": \"https://example.com/hooks/organization\",\n  \"event\": \"EnvelopeCompleted\",\n  \"authentication\": {\n    \"headers\": {\n      \"Authorization\": \"Bearer token_123\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"recuperare-un-webhook-dellorganizzazione","__idx":26},"children":["Recuperare un webhook dell'organizzazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/organizations/{organizationId}/webhooks/{webhookId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Restituisce il webhook dell'organizzazione specificato."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-7","__idx":27},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco del webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"aggiornare-un-webhook-dellorganizzazione","__idx":28},"children":["Aggiornare un webhook dell'organizzazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /api/v1/organizations/{organizationId}/webhooks/{webhookId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aggiorna il webhook dell'organizzazione specificato. Il corpo della richiesta ha la stessa struttura di ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#creare-un-webhook-dellorganizzazione"},"children":["Creare un webhook dell'organizzazione"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]}," ed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]}," sono obbligatori, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication"]}," è facoltativo."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-8","__idx":29},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco del webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"esempio-di-richiesta-3","__idx":30},"children":["Esempio di richiesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"url\": \"https://example.com/hooks/organization-new\",\n  \"event\": \"EnvelopeCompleted\",\n  \"authentication\": {\n    \"headers\": {\n      \"Authorization\": \"Bearer token_123\"\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"eliminare-un-webhook-dellorganizzazione","__idx":31},"children":["Eliminare un webhook dell'organizzazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /api/v1/organizations/{organizationId}/webhooks/{webhookId}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Elimina il webhook dell'organizzazione specificato."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parametri-di-percorso-9","__idx":32},"children":["Parametri di percorso"]},{"$$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":"Nome"},"children":["Nome"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tipo"},"children":["Tipo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Obbligatorio"},"children":["Obbligatorio"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descrizione"},"children":["Descrizione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organizationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco dell'organizzazione"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sì"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificativo univoco del webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"migrazione-da-webhook-subscription","__idx":33},"children":["Migrazione da webhook-subscription"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["I precedenti endpoint ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook-subscription"]}," sono deprecati e saranno rimossi il ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["31 ottobre 2026"]},". Per eseguire la migrazione:"]},{"$$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":"Endpoint deprecato"},"children":["Endpoint deprecato"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Sostituzione"},"children":["Sostituzione"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST .../envelopes/{envelopeId}/webhook-subscription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST .../envelopes/{envelopeId}/webhooks"]}," (il campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]}," è ora obbligatorio)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET .../envelopes/{envelopeId}/webhook-subscription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET .../envelopes/{envelopeId}/webhooks"]}," oppure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET .../envelopes/{envelopeId}/webhooks/{webhookId}"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE .../envelopes/{envelopeId}/webhook-subscription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE .../envelopes/{envelopeId}/webhooks/{webhookId}"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Modifiche da tenere presenti:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Le richieste richiedono ora il campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I webhook sono identificati da un ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookId"]},", necessario per recuperare, aggiornare o eliminare un singolo webhook."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["I webhook possono ora essere aggiornati con ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},", senza doverli eliminare e ricreare."]}]}]},"headings":[{"value":"Webhook","id":"webhook","depth":2},{"value":"Webhook della pratica","id":"webhook-della-pratica","depth":2},{"value":"Elencare i webhook di una pratica","id":"elencare-i-webhook-di-una-pratica","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso","depth":4},{"value":"Creare un webhook della pratica","id":"creare-un-webhook-della-pratica","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-1","depth":4},{"value":"Corpo della richiesta","id":"corpo-della-richiesta","depth":4},{"value":"Eventi supportati","id":"eventi-supportati","depth":4},{"value":"WebhookAuthenticationRequest","id":"webhookauthenticationrequest","depth":4},{"value":"Esempio di richiesta","id":"esempio-di-richiesta","depth":4},{"value":"Esempio di payload - pratica completata (senza la funzionalità EnrichedWebhook)","id":"esempio-di-payload---pratica-completata-senza-la-funzionalità-enrichedwebhook","depth":4},{"value":"Esempio di payload - pratica completata (con la funzionalità EnrichedWebhook)","id":"esempio-di-payload---pratica-completata-con-la-funzionalità-enrichedwebhook","depth":4},{"value":"Recuperare un webhook della pratica","id":"recuperare-un-webhook-della-pratica","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-2","depth":4},{"value":"Aggiornare un webhook della pratica","id":"aggiornare-un-webhook-della-pratica","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-3","depth":4},{"value":"Esempio di richiesta","id":"esempio-di-richiesta-1","depth":4},{"value":"Eliminare un webhook della pratica","id":"eliminare-un-webhook-della-pratica","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-4","depth":4},{"value":"Webhook dell'organizzazione","id":"webhook-dellorganizzazione","depth":2},{"value":"Elencare i webhook dell'organizzazione","id":"elencare-i-webhook-dellorganizzazione","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-5","depth":4},{"value":"Creare un webhook dell'organizzazione","id":"creare-un-webhook-dellorganizzazione","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-6","depth":4},{"value":"Corpo della richiesta","id":"corpo-della-richiesta-1","depth":4},{"value":"Esempio di richiesta","id":"esempio-di-richiesta-2","depth":4},{"value":"Recuperare un webhook dell'organizzazione","id":"recuperare-un-webhook-dellorganizzazione","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-7","depth":4},{"value":"Aggiornare un webhook dell'organizzazione","id":"aggiornare-un-webhook-dellorganizzazione","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-8","depth":4},{"value":"Esempio di richiesta","id":"esempio-di-richiesta-3","depth":4},{"value":"Eliminare un webhook dell'organizzazione","id":"eliminare-un-webhook-dellorganizzazione","depth":3},{"value":"Parametri di percorso","id":"parametri-di-percorso-9","depth":4},{"value":"Migrazione da webhook-subscription","id":"migrazione-da-webhook-subscription","depth":3}],"frontmatter":{"seo":{"title":"Webhook"}},"lastModified":"2026-11-17T13:59:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/webhook-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}