> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Verifica dell'identità su Zapier: automazione KYC > Automatizza la verifica dell'identità con l'app Didit per Zapier: avvia verifiche e ricevi i risultati in 6,000+ app. Prezzi a consumo. Collega Didit a **6,000+ app** tramite Zapier, senza scrivere codice. Crea automaticamente sessioni di verifica, reagisci alle variazioni di stato e sincronizza i risultati con il tuo CRM, il database o gli strumenti di comunicazione. > [card] [Apri Didit su Zapier](https://zapier.com/apps/didit/integrations) > > Sfoglia trigger, azioni e modelli pronti all'uso nel marketplace di Zapier. [Integrazione di Didit con Zapier](https://www.youtube.com/embed/D7X4kNHxX0A?rel=0\&playsinline=1) *** ## Cosa ottieni > [card] Crea sessioni > > Avvia sessioni di verifica da invii di moduli, eventi del CRM o da qualsiasi app collegata a Zapier. > [card] Webhook in tempo reale > > Ricevi aggiornamenti di stato istantanei (Approvata, Rifiutata, In revisione, ecc.) come trigger di Zapier. > [card] Recupera i risultati > > Recupera su richiesta i dettagli completi della sessione: dati identificativi, punteggi di vitalità, riscontri AML. *** ## Prerequisiti | Requisito | Dove ottenerlo | | - | - | | **Account Didit** | Registrati su [business.didit.me](https://business.didit.me). Il piano KYC gratuito è sufficiente per fare test. | | **Chiave API** | Console → **API e Webhook** → copia la chiave di produzione. L'app Zapier autentica ogni azione con questa chiave. | | **ID del workflow** | Console → **Workflow** → scegli il workflow che vuoi avviare (oppure [creane uno](https://docs.didit.me/it/console/workflows.md)). | | **Account Zapier** | Gratuito o a pagamento: [zapier.com](https://zapier.com). Il piano gratuito gestisce 100 attività al mese, sufficienti per piccoli progetti pilota. | *** ## Come funziona **1. Collega Didit a Zapier** In Zapier, cerca **Didit** nella directory delle app (oppure apri direttamente la [scheda nel marketplace](https://zapier.com/apps/didit/integrations)) e collega il tuo account usando la **chiave API** presa da Console → **API e Webhook**. > [!TIP] > > La tua chiave API autentica tutte le azioni Didit in Zapier. Devi collegarla una sola volta: tutti i tuoi Zap condividono la stessa connessione. Se ruoti la chiave in Console, la connessione Zapier non funziona più finché non la ricolleghi. **2. Configura un trigger** Scegli cosa avvia il tuo Zap. Può essere un **trigger Didit** oppure un'altra app: | Origine del trigger | Esempio | | - | - | | **Webhook Didit** | Lo stato della sessione passa a "Approvata" | | **Google Forms** | Nuovo invio del modulo → crea una sessione di verifica | | **HubSpot** | Nuovo contatto creato → avvia il KYC | | **Stripe** | Nuovo cliente → verifica l'identità prima dell'erogazione | | **Typeform** | Modulo di onboarding completato → avvia la verifica | **3. Aggiungi un'azione Didit** Usa una delle azioni Didit disponibili (i nomi corrispondono alla [scheda nel marketplace di Zapier](https://zapier.com/apps/didit/integrations)): **Create Verification Session**: richiama `POST /v3/session/` * Indica l'**ID del workflow** del flusso di verifica da eseguire. * Facoltativamente, imposta un **URL di callback** per il reindirizzamento al termine della verifica. * Passa i **Dati del fornitore** (ad esempio l'email dell'utente o il tuo ID interno) per collegare la sessione ai tuoi record. * L'azione restituisce il nuovo `session_id`, l'`url` visibile all'utente e lo `status` iniziale. Usa l'`url` per inviare l'utente al flusso di verifica. **Retrieve Verification Session**: richiama `GET /v3/session/{sessionId}/decision/` * Passa un `session_id` per recuperare il risultato completo della verifica. * Accedi ai dati identificativi, ai punteggi di vitalità, ai risultati AML, allo `status` finale e agli URL dei contenuti multimediali caricati. **4. Reagisci ai risultati** Aggiungi azioni a valle in base all'esito della verifica: | Stato | Azione suggerita | | - | - | | `"Approved"` | Aggiorna il CRM, concedi l'accesso alla piattaforma, invia un'email di benvenuto | | `"Declined"` | Segnala nel database, avvisa la compliance, invia un'email di rifiuto | | `"In Review"` | Crea un'attività per il team di compliance, invia una notifica su Slack | | `"Abandoned"` | Invia un'email di promemoria con un nuovo link di verifica | ![Creazione di una sessione di verifica dell'identità Didit da un passaggio di azione Zapier](https://mintcdn.com/didit-0f962782/DSfxHq_ggIpqiQSG/images/zapier-create-session.png?fit=max\&auto=format\&n=DSfxHq_ggIpqiQSG\&q=85\&s=f847a30aa1e0b600543ae4dec6229cdd) Creazione di una sessione di verifica Didit da un'azione Zapier. *** ## Modelli Zap popolari > [card] Google Forms → Didit → Gmail > > L'utente compila il modulo di onboarding → viene creata la sessione di verifica → il risultato viene inviato via email all'utente e all'amministratore. > [card] HubSpot → Didit → HubSpot > > Nuovo contatto → avvia il KYC → aggiorna le proprietà del contatto con lo stato della verifica e i dati identificativi. > [card] Stripe → Didit → Slack > > Nuovo cliente → verifica l'identità → notifica il tuo team su Slack con il risultato. > [card] Webhook → Didit → Airtable > > Trigger personalizzato → verifica l'utente → registra i risultati delle sessioni in Airtable per i registri di compliance. *** ## Trigger e azioni disponibili I nomi qui sotto corrispondono all'app Didit attuale per Zapier nel [marketplace](https://zapier.com/apps/didit/integrations). Se in Zapier vedi un'etichetta leggermente diversa, fai riferimento all'interfaccia di Zapier: il comportamento sottostante è lo stesso. ### Trigger (avviano uno Zap) | Trigger | Evento sottostante | Descrizione | | - | - | - | | **Session Status Updated** | [webhook `status.updated`](https://docs.didit.me/it/integration/webhooks) | Si attiva ogni volta che una sessione di verifica cambia stato (`Approved`, `Declined`, `In Review`, `Resubmitted`, `Abandoned`, `Kyc Expired`, ecc.). | ### Azioni (eseguono un'operazione) | Azione | Endpoint sottostante | Descrizione | | - | - | - | | **Create Verification Session** | `POST /v3/session/` | Avvia una nuova sessione con il tuo workflow, un URL di callback facoltativo e `vendor_data`. Restituisce l'URL della sessione da condividere con l'utente. | | **Retrieve Verification Session** | `GET /v3/session/{sessionId}/decision/` | Recupera il payload completo della decisione (dati identificativi, vitalità, riscontri AML e stato finale) per un dato `session_id`. | *** ## Cose da sapere > [!WARNING] > > L'app Didit per Zapier è volutamente limitata all'**ambito di automazione di maggior valore**: avviare sessioni e reagire agli aggiornamenti di stato. Quanto segue **non** è attualmente disponibile tramite Zapier e richiede una chiamata API diretta: > > * Caricare un'immagine del documento, un video o un asset di prova di residenza da un passaggio di uno Zap. > * Sovrascrittura delle decisioni tramite [`PATCH /v3/session/{sessionId}/update-status/`](https://docs.didit.me/it/sessions-api/update-status). > * Endpoint specifici per KYB (registri, persone chiave). > * Tipi di evento webhook diversi dai cambiamenti di stato a livello di sessione (ad esempio `transaction.status.updated`, `user.status.updated`). > > Se ti serve una di queste funzionalità senza codice, passa all'[API delle sessioni](https://docs.didit.me/it/sessions-api/create-session.md) tramite un passaggio **Webhooks by Zapier** di Zapier, con la tua chiave API. *** ## Suggerimenti e buone pratiche > [accordion] Usa i dati del fornitore per collegare le sessioni > > Passa sempre un identificatore univoco (email, ID utente o UUID) nel campo **Dati del fornitore** quando crei le sessioni. Così puoi associare i risultati della verifica all'utente corretto nel tuo sistema. > [accordion] Gestisci tutti gli stati possibili > > Costruisci percorsi nello Zap (con la funzione Paths di Zapier) per gestire in modo diverso i vari stati: Approvata, Rifiutata, In revisione, Ripresentata, Abbandonata e Scaduta richiede ciascuno una risposta su misura. > [accordion] Usa i Filtri per ridurre il rumore > > Aggiungi Filtri di Zapier per attivare le azioni successive solo per stati specifici. Ad esempio, invia un'email di benvenuto solo quando lo stato è `"Approved"`. > [accordion] Testa prima di andare in produzione > > Usa la funzione di test di Zapier insieme al pulsante **Try Webhook** di Didit (in Console → API & Webhooks) per validare il tuo Zap dall'inizio alla fine prima di elaborare utenti reali. *** ## Prossimi passi > [card] [Guida rapida](https://docs.didit.me/it/getting-started/quick-start.md) > > Configura il tuo account Didit, crea un workflow e ottieni la tua chiave API. > [card] [Webhook](https://docs.didit.me/it/integration/webhooks.md) > > Scopri i payload dei webhook e la verifica della firma per le integrazioni lato server. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.