Envoyer la personne sur le parcours

Créer la session

POST /v1/sessions
Content-Type: application/json

{"case_id": "case_…", "locale": "fr", "lifetime_minutes": 30}

Champ	Obligatoire	Description
case_id	oui	Le dossier ouvert avec POST /v1/cases.
locale	non	La langue du parcours : fr ou en. Par défaut, celle du parcours (fr).
lifetime_minutes	non	La durée de validité du lien, de 1 à 60 minutes.
return_url	non	Où revient la personne à la fin, pour cette session : une page HTTPS de votre site, sans ? ni #. Remplace l’adresse de fin du parcours.

La réponse contient url : le lien du parcours. Il n’est rendu qu’une fois. Ne le stockez pas plus longtemps que nécessaire pour l’envoyer.

Transmettre le lien

• SMS ou courriel : la personne ouvre le lien sur son téléphone.
• Redirection : depuis votre application mobile ou votre site, ouvrez le lien dans le navigateur.

Le jeton est dans la partie après # du lien : les navigateurs ne l’envoient à aucun serveur, et il n’apparaît dans aucun journal. Le parcours l’efface de la barre d’adresse dès l’ouverture.

Le parcours de la personne

1. Consentement : ce qui est vérifié, par qui, et combien de temps les données sont gardées.
2. Choix du pays et de la pièce.
3. Photo de chaque face de la pièce, guidée et contrôlée en direct (netteté, reflets, cadrage).
4. Selfie, avec une vérification de présence.
5. Envoi, puis retour vers votre adresse de fin si le parcours en a une.

Si la caméra est refusée ou absente, le parcours explique comment l’autoriser et, si votre parcours le permet, propose d’envoyer une photo déjà prise de la pièce (jamais du selfie).

Langues et textes

Le parcours existe en français et en anglais : tous les écrans, les noms des pièces et des pays. Choisissez la langue à la création de la session (locale).

Chaque phrase du parcours peut être réécrite pour votre parcours, dans chaque langue : dans la console, page du parcours, panneau Textes du parcours. La réécriture entre dans une nouvelle version du parcours et vaut à son activation ; un dossier garde les textes de la version qui l’a ouvert. Deux emplacements sont remplis par Tano : {client} (le nom de votre organisation) et {retention_days} (la durée de conservation du selfie).

Si la personne s’interrompt

Le même lien la ramène où elle en était tant qu’il n’a pas expiré. Au-delà, créez une nouvelle session pour le même dossier.

Un dossier n’a qu’un lien vivant : créer une session remplace la précédente, qui cesse aussitôt de valoir. C’est ce qu’il faut faire quand la personne a perdu son lien ; le parcours repart alors du début.