Liens d’ajout au calendrier

Lorsque vous faites la promotion d’un événement, d’une vente ou d’un rendez-vous, vous pouvez aider vos utilisateurs à enregistrer facilement l’événement dans leur calendrier en ajoutant un lien « ajouter au calendrier » dans vos e-mails.

Pour ce faire, rédigez votre e-mail et déterminez l’emplacement souhaité pour vos liens. Ajoutez ensuite deux options : une pour Google Calendar et une pour les autres calendriers (comme iCal ou Outlook). Par exemple, « Ajouter à Google Calendar » et « Ajouter à iCal ou Outlook ».

Format de l’URL

Ajoutez l’URL suivante à vos liens en remplaçant les marques substitutives. La seule différence entre ces deux URL est que Google Calendar nécessite un paramètre supplémentaire : &format=gcal.

• google calendar
• ical or outlook

1
https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION&format=gcal

1
https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION

Remplacez les éléments suivants :

• EVENT_SUBJECT : Titre de l’événement
• EVENT_LOCATION : Lieu de l’événement
• START_TIME : Heure de début de l’événement au format ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) en UTC
• END_TIME : Heure de fin de l’événement au format ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) en UTC
• EVENT_DESCRIPTION : Description de l’événement

Remplacez les espaces par le code d’échappement HTML %20. Par exemple, un sujet « Meet Braze » deviendrait « Meet%20Braze ».

Voici un exemple d’URL « Ajouter à Google Calendar » :

1
https://ics.agical.io/?subject=Meet%20Braze&location=114%20Sansome%20Street&dtstart=2021-06-24T15:00:00Z&dtend=2021-06-24T16:00:00Z&description=Braze%20Party&format=gcal

Paramètres supplémentaires

Les paramètres suivants sont facultatifs et permettent de définir des aspects supplémentaires d’un événement.

• Nom de l’organisateur : &organizer=name
• Joindre une URL liée à l’événement : &attach=http://www.example.com/
• Durée : duration=30M — comme alternative à l’heure de fin de l’événement (dtend), vous pouvez spécifier une durée comme 1H ou 30M
• Rappel en minutes : &reminder=15
• Événement sur toute la journée : &allday=1
• UID : paramètre facultatif permettant de coder en dur l’identifiant unique de l’événement, offrant à certaines applications de calendrier la possibilité de mettre à jour l’événement au fil du temps. La chaîne de caractères @ics.agical.io est automatiquement ajoutée à la valeur.

Vous pouvez également ajouter des paramètres supplémentaires pour les événements récurrents :

• Événements hebdomadaires : &recur=weekly
• Événements mensuels : &recur=monthly
• Fin de la récurrence : &recuruntil=END_DATE, où END_DATE est la date et l’heure de fin de la récurrence au format ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) en UTC

Comportement du lien

Lorsqu’un utilisateur clique sur le lien, les calendriers transforment automatiquement les horodatages UTC des URL pour refléter le fuseau horaire défini dans le calendrier de l’utilisateur.

Par exemple, si vous ouvrez l’exemple de lien « Ajouter à Google Calendar » et que votre calendrier est réglé sur CST, l’heure de l’événement sera pré-remplie en fonction de l’équivalent de 15 h UTC en CST (10 h).

Google Calendar

Au clic, Google Calendar s’ouvre dans un nouvel onglet ou une nouvelle fenêtre avec les détails de l’événement pré-remplis dans l’invitation, prêts à être enregistrés par l’utilisateur. Ce comportement est identique sur appareil mobile et ordinateur de bureau.

iCal ou Outlook

Sur ordinateur de bureau, un fichier ICS est téléchargé au clic. L’utilisateur doit ensuite ouvrir ce fichier ICS, ce qui lancera iCal ou Outlook et l’invitera à ajouter l’événement à son calendrier.

Sur appareil mobile, les utilisateurs doivent maintenir le lien appuyé, ce qui les invite à l’ajouter à leur calendrier.

Pour plus d’informations, consultez :

• Create events for Google Calendar
• Create an Add to calendar link in an email message