Aller au contenu principal

Deeplink - Concept et mise en place

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.

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.

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.
  • 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.

Le format général du deeplink est le suivant :

https://app.certificall.app?nie=VOTRE_NIE&reportId=ID_DU_RAPPORT&beneficiaire=INFO_BENEFICIAIRE&emetteur=INFO_EMETTEUR

Pour générer un deeplink :

  1. Rendez-vous sur la documentation Swagger de Certificall.
  2. Utilisez le générateur de deeplinks pour entrer vos paramètres.
  3. 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