Deeplink - Concept et mise en place
Génération et Utilisation des Deeplinks Certificall
Introduction
L'utilisation de deeplinks Certificall simplifie l'accès à des fonctionnalités spécifiques de l'application mobile sur les appareils iOS et Android, en préconfigurant des paramètres essentiels pour une expérience utilisateur optimisée.
Générateur de Deeplinks via Swagger
La plateforme Certificall propose un générateur de deeplinks accessible via notre interface Swagger, facilitant la création de deeplinks personnalisés avec des paramètres adaptés à chaque besoin.
Paramètres du Deeplink
Les deeplinks Certificall peuvent inclure divers paramètres, tels que :
- NIE (obligatoire) : Le numéro identifiant l'entreprise, indispensable pour toute génération de deeplink.
- Report ID (reportId) : Pour spécifier un rapport en particulier.
- Frame ID (frameId) : Pour spécifier une trame à utiliser.
- Bénéficiaire (beneficiaire) et Émetteur (emetteur) : Pour préconfigurer les informations concernant le bénéficiaire et l'émetteur du rapport. Important : Les valeurs de ces paramètres doivent être encodées avec
encodeURIComponent
pour garantir que les URL générées sont valides et interprétables correctement par l'application.
Récupérer les ids de Trames (frameId)
Pour récupérer les identifiants de vos trames, vous devez vous rendre sur la page de configuration des trames de votre compte Certificall, https://admin.certificall.app/frames puis vous rendre sur la page de détails de la trame concernée et noter l'id qui est indiqué.
Format et Génération du Deeplink
Le format général du deeplink est le suivant :
https://app.certificall.app?nie=VOTRE_NIE&reportId=ID_DU_RAPPORT&frameId=1698&beneficiaire=INFO_BENEFICIAIRE&emetteur=INFO_EMETTEUR
Pour générer un deeplink :
- Rendez-vous sur la documentation Swagger de Certificall.
- Utilisez le générateur de deeplinks pour entrer vos paramètres.
- La plateforme générera automatiquement une URL deeplink que vous pourrez utiliser immédiatement.
Exemple Complet
Imaginons que vous souhaitez créer un deeplink pour l'entreprise avec le NIE ABC123
, un rapport 456Rapport
, un bénéficiaire nommé "Jean Dupont" résidant à "Paris" et un émetteur "Société XYZ".
Les valeurs pour le bénéficiaire et l'émetteur doivent d'abord être encodées :
- Bénéficiaire Encodé :
encodeURIComponent("Jean Dupont, Paris")
- Émetteur Encodé :
encodeURIComponent("Société XYZ")
Le deeplink final pourrait ressembler à cela :
https://app.certificall.app?nie=ABC123&reportId=456Rapport&beneficiaire=Jean%20Dupont%2C%20Paris&emetteur=Soci%C3%A9t%C3%A9%20XYZ
Ce lien, une fois cliqué, ouvrira l'application Certificall avec les informations du rapport, du bénéficiaire et de l'émetteur déjà configurées, permettant une expérience utilisateur fluide et directe.
Incidence sur le Certificat
Si le bénéficiaire est renseigné dans le deeplink, il apparaîtra dans la partie supérieur gauche du certificat.
Si l’émetteur est renseigné dans le deeplink, il apparaîtra dans le pied de page du certificat à la place du nom de la “société”
Pour le reportId, se référer à la page : https://doc.certificall.app/docs/admin/reportId