Publier un événement

En tant qu’administrateur client et responsable d’équipe (selon vos attributions), vous accédez à une section dédiée à la configuration de vos événements.

Accès : "Rendez-vous > Evénements"

Au niveau de chaque événement, un bouton d’action vous propose plusieurs choix. Pour Publier un événement, il faudra sélectionner « Publier« .

Au clic, plusieurs options vous sont proposées :

• Informations
• Intégration
• Partage de créneaux
• Prendre un rendez-vous

Informations #

Vous avez accès à l’URL d’accès de l’événement.

Intégration #

3 choix vous sont proposés :

1. Intégrer un iframe
2. Intégrer un lien
3. Intégrer en pop-in

En fonction de ces choix des codes d’intégration différents vous seront proposés.

Code Iframe

Avec affichage du logo en option

<iframe width="100%" height="768" frameborder=0 src="https://app.apenday.com/meeting/support-apenday/rendez-vous-de-courtoisie?logo=true"></iframe>

Code lien

<a href="https://app.apenday.com/meeting/support-apenday/rendez-vous-de-courtoisie" target="_blank"> Prenez rendez-vous </a>

Code pop in

<img src="https://app.apenday.com/assets/images/scheduling_fr.gif" onclick="openCdScheduling('/meeting/support-apenday/rendez-vous-de-courtoisie')" alt="" style="cursor: pointer; border: 0"/> <script type="text/javascript">var scheduling = { server: 'app.apenday.com' };</script> <script type="text/javascript" src="https://app.apenday.com/assets/js/scheduling.js"></script>

Pré remplissage du formulaire #

Il est possible de préremplir le formulaire en passant des paramètres dans l’URL de l’iframe.

Pour ce faire, il vous faut utiliser les nom des champs renseignés dans la configuration de l’évènement.

L’option « Non modifiable par l’utilisateur » permet de bloquer la modification dans le cas ou le paramètre a déjà été prérempli via l’URL.

Ainsi pour préremplir le champs prénom sur un évènement on ajoutera a l’URL : ?prenom=john
Ce qui donnera :
https://app.apenday.com/meeting/support-apenday/rendez-vous-de-courtoisie?prenom=john

Il est possible de préremplir toutes les valeurs du formulaire en utilisant cette méthode.

Il est également possible d’empêcher la prise de rendez-vous sans ce préremplissage en utilisant l’option « Pré-remplissage du formulaire obligatoire » dans les section « Restrictions » de la configuration de l’évènement.

Aller plus loin sur le pré-remplissage #

Les paramètres peuvent être regroupés dans une seule chaîne encodée en Base64, ce qui évite les problèmes d’échappement lorsqu’une valeur contient un espace, un accent ou un caractère réservé. La marche à suivre, les noms de variables et les exemples d’URL sont détaillés sur la page Créer un accès personnalisé à un événement de prise de rendez-vous en ligne.

L’encodage en Base64 n’est pas un chiffrement, il se décode sans clé. Pour que les valeurs ne soient pas lisibles par le porteur du lien, voir Chiffrer les paramètres d’URL du parcours de prise de rendez-vous.

Vérifier la signature des paramètres d’URL #

Pour plus de sécurité, il est possible de valider la signature des paramètres d’URL. Celà permet d’être sur que les paramètres utilisés correspondent bien à ce qui ont été définis lors de l’intégration.

Pour exiger cette validation, il faut activer l’option « Valider la signature des paramètres d’URL »qui se trouve dans la section « Restrictions » de la configuration de l’évènement.

Dès lors que cette case est cochée la signature sera requise et il sera impossible de prendre un rendez-vous sur cet évènement si les paramètres ne correspondent pas à leur signature.

Pour générer cette signature vous aurez besoin de la clé secrete de votre espace client que vous pourrez récupérer au même endroit.

Exemple de construction de l’URL signée en PHP : #

<?php

$cleSecrete = 'MaCleSecrete';

$parametresUtilisateur = [
    'nom' => 'Doe',
    'prenom' => 'John',
    'email' => 'jdoe@mail.com'
];

$parametresUrl = http_build_query($parametresUtilisateur);
// A ce point on obtient la valeur :
// nom=Doe&prenom=John&email=jdoe%40mail.com

// Les paramètres peuvent également être encodés en base64
$parametresUrlBase64 = base64_encode($parametresUrl);
// A ce point on obtient la valeur :
// bm9tPURvZSZwcmVub209Sm9obiZlbWFpbD1qZG9lJTQwbWFpbC5jb20=

$signature = hash_hmac('sha256', $parametresUrlBase64, $cleSecrete);

$urlIframe = 'https://app.apenday.com/meeting/support-apenday/rendez-vous-de-courtoisie?' . $parametresUrlBase64.'&hash='.$signature;