# Creare un'app o collegare dei webhook

Crea un'applicazione OAuth che altri utenti Drime collegano al proprio account, ricevi webhook e gli eventi di Drime Sign sul tuo server.

Aggiornato: 2026-10-19  
Fonte: https://drime.cloud/it/support/integrations-and-api/build-an-integration

Per usare l'API Drime sul tuo account basta un token personale: consulta [Creare un token API](https://drime.cloud/it/support/integrations-and-api/api-tokens). Per creare un'app che altri utenti Drime collegano ai propri account, crea un'applicazione OAuth: i tuoi utenti la approvano su Drime e l'app non vede mai la loro password.

## Creare un'applicazione OAuth

Qualsiasi utente che ha effettuato l'accesso può creare applicazioni dal portale sviluppatori, da **Le mie applicazioni**, poi **Crea applicazione**.

![Il modulo Crea applicazione del portale sviluppatori con i tre tipi di applicazione](https://drime.cloud/media/01M5AT6DMNDAVYH6SJW5CDQYFB/8439d64a4ecd-web-developers-create-application.png)

Per prima cosa scegli cosa stai creando:

| Scelta | Per |
| --- | --- |
| **Un sito web o un server** | Ricevi una chiave segreta da tenere sul tuo server. |
| **Un’app desktop o mobile** | Installata sui dispositivi dei tuoi utenti, quindi niente chiave segreta. |
| **Uno script, solo per me** | Un piccolo strumento che esegui tu. |

Poi scegli di cosa ha bisogno l'applicazione: **Una cartella dedicata** (vede sempre e solo una cartella, creata nel Drive) oppure **Tutto il Drive**.

Buono a sapersi:

- Puoi creare fino a 25 applicazioni.
- Una nuova applicazione funziona per un massimo di 25 utenti. Per aprirla a più persone, usa **Aprirla a tutti**, poi **Invia per la revisione**: Drime risponde entro 24 ore.
- I token di accesso durano 1 ora e i token di aggiornamento 90 giorni.
- Le applicazioni di terze parti non possono mai accedere a un Vault.

Le applicazioni di tipo **Un sito web o un server** possono anche ricevere webhook quando vengono creati o eliminati file in un account collegato. Ogni notifica è firmata nell'header `X-Drime-Signature`.

## Webhook di Drime Sign

In **Impostazioni** \> **Sviluppatori** \> **Webhook** (**Notifiche HTTP per gli eventi di Drime Sign.**), fai clic su **Aggiungi un webhook** per far avvisare il tuo server quando, ad esempio:

- un documento viene inviato, completato o rifiutato;
- un firmatario visualizza, firma o rifiuta;
- viene creato un modello.

![La sezione Webhook delle impostazioni Sviluppatori con Aggiungi un webhook](https://drime.cloud/media/01M5AKQ8TWF4KP6TWB0GPD9RK7/f4d9572805b0-web-sign-webhooks.png)

Ogni notifica è firmata con un secret (`X-Drime-Signature`, HMAC SHA-256). Una notifica non riuscita viene ritentata fino a 10 volte nell'arco di circa 34 ore. Puoi usare **Invia un test** e **Cambia il segreto**, e controllare le **Consegne**.

## Incorporare un modulo di firma nel tuo sito web

In **Impostazioni** \> **Sviluppatori** \> **Incorporamento** puoi permettere ai visitatori di firmare documenti senza lasciare il tuo sito web, con il widget `<drime-sign-form>`. Aggiungi i tuoi domini in **Domini consentiti**: senza alcun dominio, l'incorporamento è disattivato.

## Passi successivi

- [Creare un token API](https://drime.cloud/it/support/integrations-and-api/api-tokens)
- [Rclone, Drime CLI e WebDAV](https://drime.cloud/it/support/integrations-and-api/rclone-cli-and-webdav)