URLs de création d’événement
WhenToMeet permet de préremplir les formulaires de création d’événement via des paramètres d’URL. Cette fonctionnalité est pratique pour créer des liens rapides avec des réglages prédéfinis.
Utilisation de base
Vous pouvez créer des URLs qui remplissent automatiquement le formulaire de création avec des valeurs spécifiques. Particulièrement utile pour :
- Créer des liens rapides pour des événements récurrents
- Partager des modèles d’événements avec votre équipe
- Intégrer avec des applications calendrier
- Créer des invitations avec des horaires prédéfinis
Paramètres d’URL
Détails de base
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
title | string | Titre de l’événement | title=Team%20Meeting |
description | string | Description de l’événement | description=Weekly%20sync%20meeting |
Créneaux horaires
| Paramètre | Type | Description | Exemple |
|---|---|---|---|
slots | string[] | Créneaux au format ISO 8601 | slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z |
slotLength | number | Durée par défaut en minutes (15–1440) | slotLength=60 |
Exemples
Événement simple
/events/new?title=Team%20Meeting&description=Weekly%20sync
Événement avec créneaux
/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slotLength=60
Modèle d’événement complet
/events/new?title=Project%20Kickoff&description=Initial%20project%20meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:30:00Z&slots=2024-01-15T14:00:00Z,2024-01-15T15:30:00Z&slotLength=90
Format des créneaux
Les créneaux doivent être fournis au format ISO 8601 avec les exigences suivantes :
- Format :
YYYY-MM-DDTHH:mm:ssZ - Durée : 30 minutes minimum
- Dates futures : Tous les créneaux doivent être futurs
- Pas de chevauchement : Les créneaux ne doivent pas se chevaucher
Exemples valides
2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
2024-01-16T14:30:00Z,2024-01-16T16:00:00Z
Exemples invalides
2024-01-15T09:00:00Z,2024-01-15T09:15:00Z # Too short (15 minutes)
2024-01-15T10:00:00Z,2024-01-15T09:00:00Z # End before start
2023-01-15T09:00:00Z,2023-01-15T10:00:00Z # Past date
Créneaux multiples
Pour spécifier plusieurs créneaux, utilisez plusieurs paramètres slots :
/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slots=2024-01-17T16:00:00Z,2024-01-17T17:00:00Z
Encodage d’URL
Lors de la création manuelle d’URLs, pensez à encoder les caractères spéciaux :
| Caractère | Encodage |
|---|---|
| Espace | %20 |
| Virgule | %2C |
| Deux-points | %3A |
| Slash | %2F |
Example
Original: Team Meeting, Weekly Sync
Encoded: Team%20Meeting%2C%20Weekly%20Sync
Exemples d’intégration
Applications calendrier
Beaucoup d’applications calendrier supportent les paramètres d’URL. Vous pouvez utiliser les URLs WhenToMeet comme URL d’événement :
Calendar Event URL: https://whentomeet.io/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
Modèles d’e‑mail
Incluez des URLs WhenToMeet dans vos modèles d’e‑mail pour créer rapidement des événements :
<a
href="https://whentomeet.io/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z"
>
Create Team Meeting
</a>
Intégration Slack/Teams
Utilisez les URLs WhenToMeet dans vos outils de communication d’équipe :
https://whentomeet.io/events/new?title=Daily%20Standup&slots=2024-01-15T09:00:00Z,2024-01-15T09:15:00Z&slotLength=15
Bonnes pratiques
- Keep URLs short: Only include necessary parameters
- Use meaningful titles: Make the event purpose clear
- Provide multiple time slots: Give participants options
- Set appropriate duration: Consider the meeting type
- Test your URLs: Ensure they work as expected
Limitations
- Maximum slot duration: 24 hours
- Minimum slot duration: 30 minutes
- Maximum slots per event: No limit (but consider usability)
- All slots must be in the future
- Slots cannot overlap
Dépannage
Problèmes courants
- Invalid date format: Ensure dates are in ISO 8601 format
- Past dates: All slots must be in the future
- Overlapping slots: Slots cannot overlap
- Short duration: Slots must be at least 30 minutes
- URL encoding: Special characters must be properly encoded
Messages d’erreur
- "Invalid slot format": Check the date format
- "Slot duration must be at least 30 minutes": Increase slot duration
- "Time slots cannot overlap": Adjust slot times
- "All time slots must be in the future": Use future dates