Calendrier et Planification

Le module Calendrier d'Oquira vous permet de gérer les plannings de votre équipe, de définir les disponibilités des opérateurs et de planifier des événements récurrents.

Types d'Événements

Impact sur la Disponibilité des Opérateurs

Les événements de type break, closure et unavailability affectent la disponibilité des opérateurs en temps réel. Lorsqu'un opérateur est listé dans les attendees d'un tel événement (ou si l'événement n'a pas de participants, le rendant applicable à toute l'organisation), il est considéré comme indisponible pendant la durée de l'événement. Cela impacte :

• L'assignation des files et l'appel des tickets
• Les indicateurs de disponibilité des opérateurs sur le tableau de bord
• La sélection automatique d'opérateur pour les tickets VIP/hors-ligne

Restrictions pour les Opérateurs

Les opérateurs ont des permissions de calendrier limitées :

• Événements propres : Les opérateurs peuvent créer, modifier et supprimer les événements qu'ils ont eux-mêmes créés (événements de disponibilité/indisponibilité).
• Autres événements : Les événements créés par les managers ou propriétaires sont en lecture seule pour les opérateurs. Ils peuvent voir les détails mais ne peuvent ni les modifier ni les supprimer.
• Événements actifs : Une fois qu'un événement a commencé, les opérateurs ne peuvent modifier que le titre et la description — les champs d'heure, de service et de participants sont verrouillés.

Récupérer les Événements

Obtenez tous les événements du calendrier pour une organisation dans une plage de dates.

GET /v1/business/calendar
X-API-Key: votre_cle_api

Créer un Événement

Ajoutez un nouvel événement au calendrier de l'organisation.

POST /v1/calendar/organization/{organizationId}
X-API-Key: votre_cle_api
Content-Type: application/json

{
  "title": "Shift Jean-Pierre",
  "description": "Guichet VIP",
  "startDate": "2024-03-18T09:00:00Z",
  "endDate": "2024-03-18T18:00:00Z",
  "eventType": "shift",
  "serviceId": "ser_xyz...",
  "attendees": ["usr_abc123"],
  "color": "#2196F3"
}

Créer une Disponibilité (Opérateur)

Les opérateurs peuvent déclarer leurs propres disponibilités.

POST /v1/calendar/organization/{organizationId}/availability
X-API-Key: votre_cle_api
Content-Type: application/json

{
  "title": "Disponible matin",
  "startDate": "2024-03-20T08:00:00Z",
  "endDate": "2024-03-20T12:00:00Z"
}

Note : Cette route utilise la permission CALENDAR_CREATE_OWN_AVAILABILITY qui permet aux opérateurs de gérer uniquement leurs propres événements de disponibilité.

Mettre à Jour un Événement

PATCH /v1/calendar/{eventId}
X-API-Key: votre_cle_api
Content-Type: application/json

{
  "title": "Shift Jean-Pierre (modifié)",
  "endDate": "2024-03-18T17:00:00Z"
}

Supprimer un Événement

DELETE /v1/calendar/{eventId}
X-API-Key: votre_cle_api

Événements Récurrents

Les événements récurrents sont automatiquement étendus aux occurrences individuelles lors de la récupération. Par exemple, un shift quotidien créera une occurrence pour chaque jour dans la plage demandée.

Patterns de Récurrence Supportés

POST /v1/calendar/organization/{organizationId}
X-API-Key: votre_cle_api
Content-Type: application/json

{
  "title": "Pause déjeuner",
  "startDate": "2024-03-01T12:00:00Z",
  "endDate": "2024-03-01T14:00:00Z",
  "eventType": "break",
  "recurrencePattern": "daily"
}