# Scegli il tuo flusso. Scopri come integrarlo.

> Scegli KYC, NFC, verifica di presenza, indirizzo e colloqui. Genera la tua guida con la corretta sequenza API ed esempi di codice.

URL canonico: https://legichain.com/it/integration-guide
Lingua: it
Altre lingue (tr): https://legichain.com/integration-guide
Altre lingue (en): https://legichain.com/en/integration-guide
Altre lingue (de): https://legichain.com/de/integration-guide
Altre lingue (es): https://legichain.com/es/integration-guide

Scegli i controlli, ordina i passaggi consentiti e seleziona la tecnologia. Scopri passo dopo passo dove inviare ogni richiesta e quale token usare.

- [Crea la mia guida](https://legichain.com/it/integration-guide#builder)
- [Riferimento API](https://legichain.com/it/developers#api-reference)

## Configura la tua integrazione.

Le scelte aggiornano la guida. Non modificano le regole dell’account e non creano sessioni reali.

Le scelte aggiornano la guida. Non modificano le regole dell’account e non creano sessioni reali.

Trascina o usa le frecce. NFC resta dopo la lettura del documento. Dopo l’approvazione KYC puoi riordinare il monitoraggio AML e i passaggi indirizzo; il colloquio segue tutti i controlli. Questo ordine riguarda l’integrazione API; l’ordine delle domande viene dal flusso del pannello.

Il colloquio usa un persona_id esistente e un KYC approvato e conservato della stessa persona. Non raccoglie nuovamente documento, selfie, NFC o prova di presenza. Per una nuova verifica scegli «Nuovo KYC».

Il flusso attivo pubblicato nel pannello definisce domande, ordine, tipi di risposta e voci. Questa pagina non li modifica: mostra come eseguirli tramite API. Ogni sessione fissa la versione del flusso.

Conserva la chiave API nel backend. Non inserirla nel codice mobile o del browser; al dispositivo fornisci solo un token di sessione.

Ottieni compute_url e compute_token solo dalla risposta claim. Carica i byte su quell’origine, senza passare dall’API principale o usare multipart.

Nei colloqui IA invia solo i nuovi frammenti di una registrazione, non l’intero video per ogni domanda. Procedi con intervalli di risposta, capture-state e condizioni di chiusura.

Con il passaggio automatico attivo, un esito IA non verificato idoneo entra nella coda manuale dopo l’archiviazione delle prove. Un operatore pronto prende la chiamata; altrimenti l’utente attende. L’app segue lo stato manuale e si collega a LiveKit solo quando è presente media. Non serve approvazione del revisore; non aggira un rifiuto esplicito o un KYC fallito. Consulta prima GET /v3/onboardings/{id} con session_token. Leggi /manual solo con sessione aperta, state=manual_waiting e interview_mode=manual; prima della transizione regionale /manual può ancora restituire 404.

Combina le funzioni HTTP con gli esempi, compila i segnaposto dalle risposte e integra gli adattatori fotocamera/NFC. Non è un SDK compilato né un’app pronta all’uso; la pagina non invia richieste API.

[Crea la mia guida](https://legichain.com/it/integration-guide#builder)

## Due connessioni, responsabilità chiare.

- **Il tuo backend → API regionale** — Qui associ le persona, crei sessioni e segui i risultati. La chiave API resta sul tuo backend. Usa l’endpoint regionale TR o EU assegnato al tuo account.
- **La tua app → compute assegnato** — Invia documenti, selfie e risposte IA registrate direttamente a compute_url. Il compute_token temporaneo è limitato alla sessione. La piattaforma sceglie capacità dedicata o condivisa e assegna l’host.
- **Colloquio manuale → LiveKit** — Segui richiesta e coda manuale. Connettiti a LiveKit con i dati partecipante solo quando /manual contiene media: chiamata attiva e registrazione pronta. La sola assegnazione operatore non basta.

---
Legichain — tecnologia per l'identità digitale, AI Video KYC e la valutazione del rischio. Contatto: contact@legichain.com
