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.

Encrypter les paramètres en base 64 #

Pour ne pas afficher de manière lisible les paramètres dans l’URL il est possible de les encoder en base 64.
Ainsi l’url précédente deviendra :
https://app.apenday.com/meeting/support-apenday/rendez-vous-de-courtoisie?cHJlbm9tPWpvaG4

Exemple de construction de l’URL en PHP : #

<?php
$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@mail.com

$parametresUrlBase64 = base64_encode($parametresUrl);
// A ce point on obtient la valeur :
// bm9tPkRvZSZwcmVub20lMjBKb2huJTIwJTIwZW1haWxAY29t

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

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@mail.com

// Il est possible également de chiffrer les paramètres de l'URL encodés en base64
$parametresUrlBase64 = base64_encode($parametresUrl);
// A ce point on obtient la valeur :
// bm9tPkRvZSZwcmVub20lMjBKb2huJTIwJTIwZW1haWxAY29t

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

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