Verifica dell'identità Salesforce: app KYC e KYB

Aggiungi la verifica dell’identità di Didit a Salesforce Sales Cloud / Service Cloud con il nostro pacchetto gestito. Il componente si inserisce nelle pagine dei record Contact e Lead, crea sessioni nella tua org tramite Apex (la tua chiave API Didit resta all’interno di Salesforce) e scrive i risultati nei campi standard del record, così che Flow e Report possano agire su di essi. Un’Invocable Action integrata permette a Flow Builder di avviare automaticamente le verifiche, ad esempio quando viene creato un nuovo lead.

​

Prerequisiti

• Un’org Salesforce (edizione Enterprise o superiore; Developer Edition per i test)
• Un account della Didit Console con un workflow configurato
• Autorizzazione a installare pacchetti gestiti e creare Sites in Setup

---

​

Passaggio 1: installa l’app

Il link qui sotto installa il pacchetto rilasciato DiditVerifyManaged 1.0.0.2. L’installazione del pacchetto è separata dall’approvazione della pubblicazione nel marketplace.

1. Apri il link di installazione: https://login.salesforce.com/packaging/installPackage.apexp?p0=04td10000004M0LAAU
2. Seleziona Install for Admins Only mentre configuri e testi l’integrazione. Concedi l’accesso agli utenti previsti solo dopo aver validato la configurazione.

3. Fai clic su Install

---

​

Passaggio 2: ottieni le tue credenziali Didit

​

Ottieni la tua chiave API (per la modalità API)

1. Accedi alla Didit Business Console
2. Vai a API e Webhook nella barra laterale sinistra
3. Copia la tua chiave API

​

Ottieni il tuo ID del workflow

1. Nella Didit Business Console, vai su Workflow
2. Seleziona il workflow che vuoi usare (oppure creane uno nuovo)
3. Copia l’ID del workflow (un UUID come xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)

---

​

Passaggio 3: configura le impostazioni di Didit

1. Fai clic su App Launcher (icona a griglia, in alto a sinistra) e cerca “Didit”

2. Apri l’app Didit: si aprirà la scheda Didit Settings
3. Compila le credenziali e le preferenze:

4. Fai clic su Save Settings

​

Passaggio 4: aggiungi il componente alle pagine dei record

1. Vai a un record Contact o Lead

2. Fai clic sull’icona a ingranaggio → Edit Page (oppure Setup → Object Manager → Contact/Lead → Lightning Record Pages)

3. In Lightning App Builder, trascina Didit Identity Verification dal pannello Components

4. Fai clic su Salva e Attiva la pagina, seleziona “Assign as Org Default” durante l’attivazione, guarda il video:

5. L’esempio sopra usa una pagina del record Contact; i passaggi sono identici per le pagine dei record Lead.

​

Come funziona

​

Modalità API (consigliata)

1. L’utente clicca su Verify Identity in un record Contact/Lead
2. Apex crea una sessione tramite l’API di Didit (la chiave API resta lato server)
3. L’SDK di Didit apre il flusso di verifica, come overlay modale o come vista incorporata nella pagina, a seconda dell’impostazione Display Mode
4. Al termine, il record viene aggiornato automaticamente:
   • Verification Status → il risultato della sessione (Approved, Declined, In Review, ecc.)
   • Identity Verified → true per Approved; false per Declined
   • Verified At (timestamp) e Didit Session ID
   • Verified Document Type, Document Expiry Date, AML Check Status (popolati tramite webhook, vedi sotto)
5. Il componente mostra in linea lo stato di verifica, il tipo di documento, la data di scadenza e il risultato AML, senza bisogno di configurare il layout della pagina

​

Modalità UniLink

1. L’utente clicca su Verify Identity
2. Un URL UniLink fisso si apre in una finestra modale o in un iframe (non è necessaria alcuna chiamata API)
3. Al termine, il risultato viene salvato nel record

​

Aggiornamenti automatici della verifica (webhook)

Quando una sessione di verifica si completa (che l’operatore stia guardando la pagina o no), Didit invia un webhook alla tua org Salesforce per aggiornare automaticamente il record Contact/Lead. Questo richiede una configurazione una tantum di un Salesforce Site.

​

Perché serve?

Salesforce non accetta richieste HTTP in entrata da servizi esterni senza un endpoint pubblico. Un Salesforce Site crea questo endpoint, così Didit può inviare i risultati della verifica direttamente alla tua org in tempo reale.

​

Passaggio 1: vai a Setup > Sites

In Salesforce, clicca sull’icona a forma di ingranaggio > Setup. Nella casella Quick Find digita Sites e clicca su di esso in Sites and Domains. Se è la prima volta, seleziona “I have read and accepted the Salesforce Site Terms of Use” e clicca su Register My Salesforce Site Domain.

​

Passaggio 2: crea un nuovo Site

Clicca sul pulsante Nuovo nell’elenco Sites. Compila:

• Site Label: DiditWebhook
• Site Name: si compila automaticamente come DiditWebhook
• Default Web Address: didit
• Attivo: selezionato
• Active Site Home Page: InMaintenance

Lascia invariati tutti gli altri campi e clicca su Salva.

​

Passaggio 3: verifica che il Site sia stato creato

Dopo il salvataggio, vedrai la pagina di dettaglio del Site. Annota il Site URL: avrà un formato simile a https://your-org.develop.my.salesforce-sites.com/didit. Ti servirà più avanti.

​

Passaggio 4: concedi al Guest User l’accesso alla classe del webhook

Nella pagina di dettaglio del Site, clicca su Public Access Settings. Si apre il profilo Guest User. Scorri fino a Enabled Apex Class Access e clicca su Modifica. Seleziona DiditWebhookReceiver dall’elenco Available e clicca su Aggiungi per spostarlo nell’elenco Enabled. Clicca su Salva.

​

Passaggio 5: configura il webhook nella Didit Console

1. Vai su business.didit.me > API e Webhook
2. Imposta il tuo Webhook URL su: https://your-org.develop.my.salesforce-sites.com/didit/services/apexrest/didit/webhook/

Nota: il formato esatto del dominio dipende dal tipo di org. Le org Developer Edition includono .develop nell’URL. Le org di produzione usano https://your-org.my.salesforce-sites.com/didit/services/apexrest/didit/webhook/. Copia sempre l’URL dalla pagina di dettaglio del Site (Passaggio 3) per essere sicuro.

3. Copia la Webhook Secret Key
4. In Salesforce, vai su Didit Settings e incolla il segreto nel campo Webhook Secret
5. Clicca su Save Settings

Tutto qui. Da ora in poi, ogni risultato di verifica aggiornerà automaticamente il record Contact/Lead, anche se nessuno ha la pagina di Salesforce aperta.

​

Cosa salva il webhook

Quando Didit invia un webhook, il Contact o il Lead viene aggiornato automaticamente. Sempre aggiornati, indipendentemente dal tipo di workflow: Aggiornati solo quando la funzionalità fa parte del tuo workflow: Se una funzionalità non è attiva nel tuo workflow di Didit, i campi corrispondenti restano semplicemente vuoti: non si rompe nulla. Per ogni sessione viene inoltre creato un record figlio Didit Verification (Didit_Verification__c), che ti offre un registro di audit completo con dettagli aggiuntivi (numero del documento, paese di emissione, nome sul documento, data di nascita, punteggio di confronto facciale, punteggio di rilevamento della vitalità, numero di riscontri AML). Anche in questo caso, i dettagli compaiono solo per le funzionalità incluse nel workflow. Puoi aggiungere la lista correlata Didit Verifications al layout di pagina di Contact/Lead per consultarne la cronologia.

​

Automazione dei flow (azione invocabile)

Il plugin include un’azione Apex invocabile che i Flow di Salesforce possono chiamare per avviare la verifica automaticamente:

1. In Flow Builder, aggiungi un elemento Azione
2. Cerca “Create Didit Verification Session”
3. Passa l’ID di un record Contact o Lead
4. L’azione restituisce url, sessionId, success ed error
5. Usa l’URL in un’azione Send Email o Send Notification per inviarlo al cliente

Esempi di casi d’uso:

• Alla creazione di un Lead: invia automaticamente un link di verifica a ogni nuovo lead
• Monitoraggio della scadenza dei documenti: crea uno Scheduled Flow che viene eseguito ogni giorno, trova tutti i Contact in cui Document Expiry Date ≤ TODAY + 90 days e invia un link di nuova verifica. Funziona subito, usando il campo Document Expiry Date popolato dal webhook.

​

Risoluzione dei problemi

​

Il pulsante non fa nulla al clic

• Assicurati di aver salvato la tua chiave API e il Workflow ID nelle Impostazioni di Didit
• Verifica che il Workflow ID appartenga alla stessa applicazione della tua chiave API
• Attiva il Debug Logging nelle Impostazioni di Didit e controlla la console del browser per individuare eventuali errori

​

”Received a non-JSON response from the Didit API”

• Verifica che la Remote Site Setting per https://verification.didit.me sia attiva: Setup → Remote Site Settings
• Controlla che la tua chiave API sia valida e non sia scaduta nella Didit Business Console

​

Il webhook restituisce 401 — “Webhook secret not configured”

• Vai alle Impostazioni di Didit, incolla la tua Webhook Secret Key (copiata da Didit Console → API & Webhooks) nel campo Webhook Secret, quindi fai clic su Save Settings

​

Il webhook restituisce 401 — “Invalid signature” o “Request timestamp is stale”

• Firma non valida: assicurati che la Webhook Secret nelle Impostazioni di Didit corrisponda esattamente a quella presente nella Didit Console, senza spazi o caratteri in più
• Timestamp obsoleto: i webhook devono arrivare entro 5 minuti dall’invio. Se l’orologio della tua organizzazione Salesforce non è sincronizzato, questo può generare falsi positivi, ma è un caso molto raro

​

La finestra di verifica non si apre (errore CSP nella console del browser)

• Il CSP Trusted Site per https://verify.didit.me è incluso nel pacchetto gestito (managed package) e viene distribuito automaticamente. Se effettui il deployment dal codice sorgente, assicurati che cspTrustedSites/Didit_Verify_Frontend.cspTrustedSite-meta.xml sia incluso nel tuo deployment

​

Supporto (24/7)

Il nostro team è disponibile per aiutarti a iniziare.