Ajouter un événement au calendrier
create_calendar_eventDescription
Crée dans le calendrier Oxygenius un événement (rendez-vous, bureau, congé…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, pour une ou plusieurs personnes (get_agenda_lists avec kind calendar donne les types et les calendriers accessibles). Un événement de type privé n'est visible que de ses personnes et de son auteur. Lié à un dossier, il a lieu par défaut à l'adresse de son chantier et, comme dans l'application, un premier rendez-vous fait avancer les étapes du dossier (prise de contact). Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.
Accès requis
- Au moins une de ces permissions :
calendar.list.viewoucalendar-hybrid.list.view - Société ouverte aux outils d'écriture (Paramètres → Intégration IA).
- Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
subject | string | obligatoire | Objet de l'événement (ex. Visite chez le client). |
date | string (date) | obligatoire | Premier jour (AAAA-MM-JJ). |
startTime | string | obligatoire | Heure de début, heure locale belge (HH:mm, ex. 14:00). |
endTime | string | obligatoire | Heure de fin, le même jour (HH:mm). |
resourceIds | integer[] | obligatoire | Personnes concernées (champ id de resources dans get_agenda_lists), 20 au plus. |
endDate | string (date) | facultatif | Dernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus). |
typeId | integer | facultatif | Type d'événement (id de types) ; par défaut, le type marqué isDefault. |
dossierId | integer | facultatif | Dossier lié (champ id de search_dossiers). |
location | string | facultatif | Lieu ; par défaut, l'adresse du chantier du dossier lié. |
description | string | facultatif | Description, en texte simple. |
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
description | string | peut être null | Description de l'événement (masquée pour un événement privé d'autrui). |
dossierSiteAddress | string | peut être null | Adresse du chantier du dossier lié. |
dossierClient | string | peut être null | Client (tiers propriétaire) du dossier lié. |
estimates | object[] | Devis liés à l'événement (vide sans accès aux devis). | |
estimates[].estimateId | integer | Identifiant du devis (à passer à get_estimate). | |
estimates[].reference | string | peut être null | Référence du devis. |
id | integer | Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event). | |
kind | string | planning ou calendar : écran d'origine de l'événement. | |
subject | string | peut être null | Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur. |
start | string (date-time) | Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00). | |
end | string (date-time) | Fin, en heure locale belge avec son décalage UTC. | |
type | string | peut être null | Type d'événement (chantier, rendez-vous, congé, intervention…). |
siteState | string | peut être null | État de chantier (planifié, validé…), pour le planning. |
location | string | peut être null | Lieu saisi sur l'événement (masqué pour un événement privé d'autrui). |
isPrivate | boolean | Vrai pour un événement privé. | |
dossierId | integer | peut être null | Identifiant du dossier lié (à passer à get_dossier). |
dossierReference | string | peut être null | Référence du dossier lié. |
dossierIndication | string | peut être null | Intitulé court du dossier lié. |
assignees | string[] | Personnes affectées à cette occurrence. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Ajouter un événement au calendrier | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | non | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"name": "create_calendar_event",
"title": "Ajouter un événement au calendrier",
"description": "Crée dans le calendrier Oxygenius un événement (rendez-vous, bureau, congé…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, pour une ou plusieurs personnes (get_agenda_lists avec kind calendar donne les types et les calendriers accessibles). Un événement de type privé n'est visible que de ses personnes et de son auteur. Lié à un dossier, il a lieu par défaut à l'adresse de son chantier et, comme dans l'application, un premier rendez-vous fait avancer les étapes du dossier (prise de contact). Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.",
"inputSchema": {
"type": "object",
"properties": {
"subject": {
"description": "Objet de l'événement (ex. Visite chez le client).",
"type": "string"
},
"date": {
"description": "Premier jour (AAAA-MM-JJ).",
"type": "string",
"format": "date"
},
"startTime": {
"description": "Heure de début, heure locale belge (HH:mm, ex. 14:00).",
"type": "string"
},
"endTime": {
"description": "Heure de fin, le même jour (HH:mm).",
"type": "string"
},
"resourceIds": {
"description": "Personnes concernées (champ id de resources dans get_agenda_lists), 20 au plus.",
"type": "array",
"items": {
"type": "integer"
}
},
"endDate": {
"description": "Dernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus).",
"type": [
"string",
"null"
],
"format": "date",
"default": null
},
"typeId": {
"description": "Type d'événement (id de types) ; par défaut, le type marqué isDefault.",
"type": [
"integer",
"null"
],
"default": null
},
"dossierId": {
"description": "Dossier lié (champ id de search_dossiers).",
"type": [
"integer",
"null"
],
"default": null
},
"location": {
"description": "Lieu ; par défaut, l'adresse du chantier du dossier lié.",
"type": [
"string",
"null"
],
"default": null
},
"description": {
"description": "Description, en texte simple.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"subject",
"date",
"startTime",
"endTime",
"resourceIds"
]
},
"outputSchema": {
"type": "object",
"properties": {
"description": {
"description": "Description de l'événement (masquée pour un événement privé d'autrui).",
"type": [
"string",
"null"
]
},
"dossierSiteAddress": {
"description": "Adresse du chantier du dossier lié.",
"type": [
"string",
"null"
]
},
"dossierClient": {
"description": "Client (tiers propriétaire) du dossier lié.",
"type": [
"string",
"null"
]
},
"estimates": {
"description": "Devis liés à l'événement (vide sans accès aux devis).",
"type": "array",
"items": {
"type": "object",
"properties": {
"estimateId": {
"description": "Identifiant du devis (à passer à get_estimate).",
"type": "integer"
},
"reference": {
"description": "Référence du devis.",
"type": [
"string",
"null"
]
}
},
"required": [
"estimateId"
]
}
},
"id": {
"description": "Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event).",
"type": "integer"
},
"kind": {
"description": "planning ou calendar : écran d'origine de l'événement.",
"type": "string"
},
"subject": {
"description": "Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.",
"type": [
"string",
"null"
]
},
"start": {
"description": "Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).",
"type": "string",
"format": "date-time"
},
"end": {
"description": "Fin, en heure locale belge avec son décalage UTC.",
"type": "string",
"format": "date-time"
},
"type": {
"description": "Type d'événement (chantier, rendez-vous, congé, intervention…).",
"type": [
"string",
"null"
]
},
"siteState": {
"description": "État de chantier (planifié, validé…), pour le planning.",
"type": [
"string",
"null"
]
},
"location": {
"description": "Lieu saisi sur l'événement (masqué pour un événement privé d'autrui).",
"type": [
"string",
"null"
]
},
"isPrivate": {
"description": "Vrai pour un événement privé.",
"type": "boolean"
},
"dossierId": {
"description": "Identifiant du dossier lié (à passer à get_dossier).",
"type": [
"integer",
"null"
]
},
"dossierReference": {
"description": "Référence du dossier lié.",
"type": [
"string",
"null"
]
},
"dossierIndication": {
"description": "Intitulé court du dossier lié.",
"type": [
"string",
"null"
]
},
"assignees": {
"description": "Personnes affectées à cette occurrence.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"start",
"end",
"isPrivate"
]
},
"annotations": {
"title": "Ajouter un événement au calendrier",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}