Onboarding Gestion des absences Gestion du temps Présences & badgeages Notes de frais Performance & objectifs Documents & signatures App mobile Libre-service employé
L'entreprise Carrières Sécurité Contact
Entreprises moyennes Petites entreprises Grandes entreprises Partenaires SIRH Suisse SIRH France
Blog Centre d'aide Références clients Presse Panorama SIRH Notes de frais mondiales Absences mondiales Roadmap
Plans Connexion Essai 30 jours gratuit
Skip to content
Illizeo

Services RH de base

Administration du personnel

Dossiers, contrats et données centralisés.

People Analytics

Tableaux de bord RH temps réel.

Stockage & signature

Documents et signature électronique.

Documents de l’entreprise

Règlements, politiques et guides ciblés.

Affichage obligatoire

Les affichages légaux, en ligne.

Signature en masse

Campagnes de signature et documents des employés.

Gestion de projets

Suivi des projets RH transverses.

Modules

Demandes RH

Guichet, délais annoncés, suivi

Centre d’assistance

Tickets internes et externes, délais engagés.

Sondage

Enquêtes d’engagement, pulse, onboarding.

Lanceur d’alertes

Signalements confidentiels, conforme Sapin 2.

Recrutement

Requisition, ATS, pipeline, entretiens.

Cooptation

Recommandations, suivi et primes.

Notes de frais

Capture, validation et remboursement.

Avantages

Tickets resto, mobilité, bien-être

Budget & masse salariale

Budget, revue salariale, égalité.

CRM

Comptes, pipeline, devis, commissions.

 

BDESE

Base de données économiques et sociales.

Flex Office

Réservation de postes et présence hybride.

Planification

Plannings d’équipe, shifts et créneaux ouverts.

Gestion du temps

Absences, présences, badgeages.

Absences Présences Badgeuses ZKTeco Choisir son mode de pointage

Performance & objectifs

Évaluations continues et OKR alignés.

Formation & compétences

Compétences, plan, sessions, habilitations.

Onboarding & OffBoarding

Parcours d'arrivée et de départ automatisés.

Plateforme

Emails

Modèles, personnalisation, délivrabilité.

Libre-service employé

Espace personnel pour chaque salarié.

Flux & approbations

Workflows configurables sans code.

Alertes & notifications

Restez informés en temps réel.

Application mobile

iOS et Android, hors ligne.

Sécurité & conformité

ISO 27001, RGPD, SSO.

 

Permissions & rôles

Contrôle d'accès granulaire.

Gouvernance & Sécurité

Historisation, traçabilité, SoD, sécurité by design.

Lois & conventions

Conventions collectives intégrées, ajout sur demande.

Connecteurs

SSO, paie, agenda, signature : 22 outils.

API REST

Jetons à droits limités, OpenAPI.

Webhooks

Événements RH signés, relances auto.

Exports SFTP

Rapports planifiés déposés chez vous.

Salaires

Paie suisse

Calcul, impôt à la source, certificats.

Salaires préliminaires

Préparation et contrôle de paie.

Salaires externalisés

Paie déléguée à nos experts.

Paie mondiale consolidée

Multi-pays, multi-devises.

Consulting

Illizeo Premium Consulting

Accompagnement RH sur-mesure.

Nouveauté

Conformité réglementaire en 1 clic

Restez à jour automatiquement avec les évolutions légales locales et internationales.

Découvrir →
Intégrations

À propos

Notre mission, nos équipes.

Références

Plus de 100 clients nous font confiance.

Presse

Articles, prix, communiqués.

Carrières

Rejoignez l'aventure Illizeo.

Contact

Parlons de votre projet.

Par taille d'entreprise

Petites entreprises

Démarrez en moins de 30 jours.

Entreprises moyennes

Pilotez plusieurs sites en simultané.

Grandes entreprises

Conformité multi-pays et SSO.

Organisations & secteur public

Reporting réglementaire avancé.

Partenariats

Devenez intégrateur ou revendeur.

Par pays

SIRH Suisse

Impôt à la source, LPP, nLPD.

SIRH France

Conventions, congés, BDESE.

Blog

Insights RH et nouveautés produit.

Centre d'aide

Guides pas-à-pas et FAQ.

Roadmap

Ce qui arrive dans Illizeo.

Allocations familiales

Guide RH mondial - 147 pays.

Plans
Connexion Essayez gratuitement →

Prendre rendez-vous avec Illizeo

Choisissez un créneau dans l’agenda ci-dessous.

Addons

6
  • Avantages
    • Fournisseurs et contrôles de conformité
    • Mutuelle et prévoyance : affiliations, dispenses et contrôle avec la paie
    • Demandes, campagnes et adhésions côté RH
    • Construire le catalogue d’avantages
    • L’espace salarié : adhérer, ayants droit et bilan social
    • Démarrer avec le module Avantages

Services RH de base

25
  • People Analytics
    • Droits et confidentialité des données
    • Planifier l’envoi d’un rapport
    • Décrire son rapport à l’IA
    • Créer un rapport personnalisé
    • Catalogue des rapports système
    • Les rapports système
    • Le tableau de bord « Analyse des employés »
    • Démarrer avec People Analytics
  • Stockage & signature
    • Remplacer, dépublier ou supprimer un document
    • Publier un document de l’entreprise et choisir son public
    • Consulter et rechercher les documents de l’entreprise
    • Démarrer avec les documents de l’entreprise
  • Gestion de projets
    • Les paramètres et les finances d’un projet
    • Gérer l’équipe d’un projet
    • Planifier un projet et mesurer le temps passé
    • Organiser les tâches d’un projet
    • Suivre un projet depuis l’Aperçu
    • Démarrer avec la gestion de projets
  • Affichage obligatoire
    • Publier et retirer un document de l’affichage obligatoire
    • Démarrer avec l’affichage obligatoire
  • Accès RH
    • Poser une absence pour toute une population
    • Suivre une campagne de signature
    • Lancer une campagne de signature
    • Retrouver les documents de toute ta population
    • Démarrer avec l’Accès RH

Salaires

26
  • Pré-salaires
    • Les réglages de la paie
    • Saisir la rémunération d’un salarié
    • Importer des données de paie
    • Préparer la paie du mois
    • Démarrer avec le module Paie
  • Externalisation paie
    • Connecteur SwissSalary : les droits dans Business Central
  • Conformité & exports
    • Les types de rémunération et les rubriques de paie
    • Valider la paie et exporter les éléments
  • Paie suisse
    • Le cockpit Swissdec
    • Certificats de salaire, attestations annuelles et comptes de paie
    • Calculer et clôturer les décomptes mensuels
    • Compléter les données des collaborateurs
    • Paramétrer la Paie suisse
    • Démarrer avec la Paie suisse
  • Paie canadienne
    • Produire un relevé d’emploi
    • Préparer les T4 et le RL-1
    • Suivre les versements à l’ARC et à Revenu Québec
    • Calculer, clôturer et publier une paie canadienne
    • L’onglet Paie Canada du salarié : formulaires d’impôt et reprise
    • Déclarer un employeur canadien et régler la paie
    • Démarrer avec la Paie Canada
  • Paie marocaine
    • Les états du mois et les déclarations
    • Calculer, clôturer et publier la paie du mois
    • Préparer la fiche Paie Maroc d’un salarié
    • Paramétrer la Paie Maroc
    • Démarrer avec la Paie Maroc

Plateforme

57
  • Emails
    • Les e-mails automatiques : catalogue et activation
    • Modifier un modèle d’e-mail
    • Relancer un e-mail tant que l’action n’est pas faite
    • Suivre l’historique des envois
  • Libre-service employé
    • Se repérer dans Illizeo : menu, recherche, langue et paramètres personnels
    • Le tableau de bord : votre page d’accueil
    • Mon profil : consulter et mettre à jour mes informations
    • Le calendrier et la synchronisation de votre agenda
    • Paramétrer le tableau de bord de l’entreprise
  • Flux & approbations
    • Workflows : de la demande à la décision
    • Approuver, refuser ou déléguer une demande
    • Suivre l’activité des workflows : aperçu et métriques
    • Créer et modifier un workflow
    • Paramètres globaux, délais et actions automatiques
    • Les processus RH : documents, signatures et échéances
  • Alertes & notifications
    • Le centre de notifications (la cloche)
    • Choisir ses notifications
    • Régler les notifications de l’entreprise : défauts et verrous
    • Publier une annonce sur le tableau de bord
    • Rappels de rôle et rappels personnels
  • Application mobile
    • Régler l’application mobile
  • Sécurité & conformité
    • Mot de passe, durée de session et adresses IP
    • Double authentification et sessions ouvertes
    • Connexion unique (SSO)
    • Conformité par pays et déclarations de confidentialité (DPCS)
    • Les registres de protection des données
    • Sauvegardes des données
  • Permissions & rôles
    • Comprendre les rôles et les permissions
    • Créer et gérer les rôles
    • Régler les permissions dans la matrice
    • Définir la population cible d’un rôle
    • Attribuer un rôle aux employés
    • Créer des groupes d’employés
  • Gouvernance & Sécurité
    • Gouvernance et traçabilité : vue d’ensemble
    • Consulter les logs utilisateurs
    • Le journal d’audit RGPD
    • Conduire une revue des habilitations
    • La séparation des tâches (SoD)
    • Retrouver l’historique des modifications
  • API REST
    • Créer et gérer les jetons API
    • Suivre l’utilisation d’un jeton et le dépanner
    • API publique : le guide du développeur
    • L’API du Centre d’assistance
  • Webhooks
    • Créer et gérer un webhook
    • Suivre les livraisons et les relances
    • Recevoir et vérifier un webhook
    • Catalogue des événements webhook
    • Les webhooks du Centre d’assistance
  • Exports SFTP
    • Régler le serveur SFTP de l’entreprise
    • Les dépôts sur le serveur SFTP et leur suivi
  • Abonnement & paramétrage
    • Régler la génération des codes d’organisation
    • Se repérer dans les Paramètres
    • Installer les modules et choisir qui y accède
    • Souscrire et faire évoluer son abonnement
    • Factures, paiement, consommation et propriété de l’espace
    • Logos et paramètres globaux de l’espace
    • Ouvrir l’accès au support Illizeo

Consulting

3
  • La méthode Illizeo Pulse : comment nous conduisons votre déploiement
  • Accompagnement déploiement
    • La méthode Illizeo Pulse : comment nous conduisons votre déploiement
    • La méthode Illizeo Pulse : comment nous déployons votre SIRH

Présences & Badgeages

11
  • Remplir sa feuille de présence depuis l’agenda Outlook
  • Présences & badgeages : présentation du module
  • Pointer son arrivée et son départ
  • Remplir et soumettre sa feuille de présence
  • Valider les présences et suivre l’équipe
  • Créer et affecter les profils de présence
  • Règles de pointage, clôture et motifs de présence
  • Les compteurs d’heures
  • Indemnités et astreintes
  • Les badgeuses
  • Administrer le module Présences : droits, notifications, import-export et données personnelles

Gestion des Absences

8
  • Gestion des absences : présentation et vocabulaire
  • Poser, modifier et annuler une absence
  • Soldes et compteurs de congés
  • Approuver les demandes d’absence
  • Le calendrier des absences
  • Paramétrer les types d’absence et leurs politiques
  • Règles d’entreprise et jours fériés
  • Administrer le module Gestion des absences

Notes de frais

7
  • Notes de frais : présentation et cycle de vie d’une note
  • Saisir, soumettre et suivre une dépense
  • Déclarer des frais kilométriques et un per diem
  • Approuver les notes de frais
  • Rembourser, analyser et comptabiliser les notes de frais
  • Paramétrer le module Notes de frais
  • Administrer le module Notes de frais : droits, notifications, données personnelles et questions fréquentes

Performance & Objectifs

13
  • Performance : présentation et navigation
  • Fixer et suivre des objectifs (OKR)
  • Prime sur objectif : préparer et transmettre à la paie
  • Planifier et suivre les réunions 1:1
  • Concevoir les formulaires d’évaluation
  • Paramétrer un cycle et une campagne d’évaluation
  • Lancer, suivre et clôturer une campagne
  • Remplir et valider les évaluations
  • Le dossier de fin de cycle : valider et signer
  • Le feedback continu
  • La revue des talents (9-box)
  • Suivre les entretiens professionnels (France)
  • Administrer le module Performance

Sondages & Engagement

6
  • Les paramètres des sondages
  • Lire les résultats et générer un rapport
  • Suivre les réponses et relancer
  • Répondre à un sondage
  • Créer et lancer un sondage
  • Démarrer avec les Sondages

FlexOffice

18
  • Flex Office : présentation du module
  • Calendrier Flex Office
  • Flex Office : semaine type
  • Flex Office : parking
  • Flex Office : repas
  • Flex Office : visiteurs
  • Flex Office : salles de réunion
  • Flex Office : événements du site
  • Flex Office : approbations
  • Flex Office : relances de planning
  • Flex Office : tableau de bord
  • Flex Office : lieux et plans
  • Flex Office : profils de présence
  • Flex Office : réglages généraux
  • Paramètres Flex Office
  • Flex Office : imports
  • Flex Office : notifications
  • Flex Office : intégrations

Demandes RH

5
  • Administrer le module Demandes RH : traçabilité, données personnelles, langues et questions fréquentes
  • Paramétrer le module Demandes RH
  • Traiter les demandes RH (équipe RH)
  • Déposer et suivre une demande RH
  • Demandes RH : présentation et parcours d’une demande

Planification

7
  • Démarrer avec la Planification
  • Créer et publier un planning
  • Shifts ouverts et remplacements
  • Disponibilités et préférences
  • Pointage sur le shift et géorepérage
  • Les réglages de la Planification
  • API publique et webhooks de la Planification

Budget & masse salariale

10
  • Budget & masse salariale : présentation du module
  • Piloter la masse salariale face au budget
  • Conduire la revue salariale
  • Grilles salariales et positionnement des contrats
  • Analyser l’égalité salariale (LEg)
  • Simuler la masse salariale et planifier les effectifs
  • Exercices, financement et taux de couverture
  • Indicateurs, exports et journal du module Budget
  • Administrer le module Budget & masse salariale : réglages, circuits de validation et droits
  • Administrer le module Budget & masse salariale : notifications, traçabilité, données personnelles et glossaire

BDESE

9
  • Les consultations récurrentes du CSE
  • L’espace CSE : liste du personnel, mandats et experts
  • Calculer et publier l’index de l’égalité professionnelle
  • Les données de paie de la BDESE
  • Saisir, valider et publier les données
  • Les réglages de la BDESE
  • La vue groupe
  • Choisir la structure d’une BDESE et désigner les contributeurs
  • Déclarer et gérer les bases BDESE

Formation

12
  • Formation : présentation et navigation
  • Votre espace de formation : accueil, parcours, catalogue et attestations
  • Suivre un cours en ligne : leçons, quiz et devoirs
  • Demander une formation et la faire valider
  • Créer et publier une formation au catalogue
  • Programmer les sessions et tenir l’émargement
  • L’espace formateur : préparer, animer et déclarer ses heures
  • Piloter la formation : plan annuel, budget et analytics
  • Suivre les habilitations et les recyclages
  • Gérer les compétences : référentiel, matrice et écarts
  • Conventions, factures, attestations et dossiers réglementaires
  • Administrer le module Formation

Cooptation

5
  • Régler le programme de cooptation et les campagnes
  • Gérer les cooptations et valider la prime
  • Suivre tes cooptations, tes badges et le classement
  • Recommander un candidat ou partager ton lien
  • Démarrer avec la Cooptation

Whistleblowing

6
  • Rapports, export et confidentialité des données
  • Régler le dispositif
  • Traiter un dossier de signalement
  • Déposer et suivre un signalement
  • Configurer les canaux et désigner les référents
  • Démarrer avec les lanceurs d’alerte

CRM

26
  • Activer et administrer le module CRM
  • Gérer les comptes
  • Gérer les contacts
  • Repérer les doublons et fusionner des fiches
  • Les activités et « Mes activités »
  • Suivre les opportunités dans le pipeline
  • Le catalogue et les devis
  • Importer, exporter et utiliser l’API
  • Le tableau de bord et les objectifs commerciaux
  • Les réglages du CRM
  • Protéger les données des contacts (RGPD)
  • D’une affaire gagnée à un projet
  • Les webhooks du CRM
  • Relier le CRM à Power Automate
  • Relier le CRM à n8n
  • Microsoft 365 dans le CRM : e-mails, rendez-vous et Teams
  • L’adresse de transfert du CRM
  • L’intelligence artificielle dans le CRM
  • Faire valider les fiches et les envois
  • Les commissions des commerciaux
  • Le CRM et les RH : temps, frais, absences et départs
  • Le CRM dans l’application mobile
  • Liens entre organisations et projets à plusieurs organisations
  • Les pipelines de suivi : dossiers d’accompagnement et d’implantation
  • Adhésions et cotisations
  • Événements et inscriptions publiques

Centre d'assistance

20
  • Mettre en place le Centre d’assistance
  • Déposer et suivre une demande d’assistance
  • Traiter les tickets
  • Les engagements de service
  • Portail externe et e-mail entrant
  • La base de connaissances
  • Satisfaction et pilotage de l’assistance
  • Workflows et approbation des tickets
  • Le Centre d’assistance et le CRM : clients reliés et contrats
  • Les organisations clientes : portail partagé, référents et annuaire
  • Le widget d’aide sur le site de votre client
  • Le Centre d’assistance dans Microsoft Teams
  • Votre marque sur le portail et les e-mails
  • Fusion des doublons, liens entre tickets, observateurs et copies
  • Les automatisations : règles et macros
  • L’API du Centre d’assistance
  • Les webhooks du Centre d’assistance
  • Le catalogue de services : une demande, plusieurs équipes
  • Incidents majeurs et problèmes
  • Administrer le Centre d’assistance
Voir les catégories
  • Accueil
  • Centre d'aide
  • Plateforme
  • API REST
  • L’API du Centre d’assistance

L’API du Centre d’assistance

Wilfrid Paul Robert Dusseaux
Mis à jour le 20.11.2026

13 mins de lecture

0:00 / 14:21
  • View as Markdown Open this page as plain Markdown (opens in a new tab)
  • Open in ChatGPT Ask questions about this page (opens in a new tab)
  • Open in Claude Ask questions about this page (opens in a new tab)
  • Open in Google AI Studio Ask questions about this page (Google account required) (opens in a new tab)

Vos outils — supervision, site web, ERP, n8n, Power Automate — peuvent travailler directement dans le Centre d’assistance : déposer un ticket quand une alerte se déclenche, le retrouver, y répondre côté équipe ou au nom du demandeur, en changer le statut et la priorité, écrire une note interne et lire les articles publiés de la base de connaissances. Cet article décrit cette partie de l’API publique d’Illizeo. Il s’adresse aux développeurs qui construisent l’intégration et à l’administrateur du Centre qui l’autorise.

Avant de commencer #

  • Le module Centre d’assistance doit être installé, et votre abonnement doit comprendre l’accès à l’API.
  • L’administrateur du Centre ouvre à l’API le ou les services concernés (voir ci-dessous) : un jeton n’atteint jamais un service fermé.
  • Le jeton se crée dans Paramètres › Gérer Illizeo › Jetons API (voir Créer et gérer les jetons API). Il agit au nom de la personne qui le crée : celle-ci doit détenir, dans la matrice des rôles, Agent du Centre d’assistance ou Administrer le Centre d’assistance, au palier Accès pour lire et Exécuter pour écrire, et le module doit lui être ouvert.
  • L’adresse de l’API, l’authentification, l’enveloppe des réponses et les limites de débit sont communes à toute l’API : voir API publique : le guide du développeur.

Ouvrir un service à l’API #

Chaque service est fermé à l’API par défaut. L’ouvrir demande le droit Administrer le Centre d’assistance au palier Exécuter.

  1. Ouvrez Paramètres › Centre d’assistance › Services et cliquez sur le service.
  2. Dans la rubrique Identité, sous API publique, basculez l’interrupteur sur Ouvert à l’API.
  3. Cliquez sur Enregistrer.
Rubrique Identité d’un service : Ouvert aux, État, puis API publique avec l’interrupteur Ouvert à l’API, la phrase Les jetons de l’API et les webhooks n’atteignent que les services ouverts ici, et le bouton Enregistrer
Ouvrir un service à l’API

Comme le rappelle l’écran, les jetons de l’API et les webhooks n’atteignent que les services ouverts ici. Refermer un service vaut dès l’appel suivant : ses tickets et ses articles répondent alors 404, et il n’émet plus de webhook. L’ouverture et la fermeture s’inscrivent au journal d’activité.

Créer le jeton de l’intégration #

Dans Paramètres › Gérer Illizeo › Jetons API, cliquez sur Nouveau jeton. Choisissez le Nom avec soin : c’est lui qui signe ce que l’intégration écrit. Un jeton nommé « Supervision » répond sous la mention « via API · Supervision » dans la fiche du ticket, et l’e-mail reçu par le demandeur est signé « Supervision ». Cochez ensuite, dans le groupe Données, les droits du Centre dont l’intégration a besoin :

Droit (écran) Code Ce qu’il ouvre
Centre d’assistance — tickets (Lire) helpdesk_tickets:read Lister les services et les tickets ; lire un ticket, ses messages publics et sa chronologie publique.
Centre d’assistance — tickets (Écrire) helpdesk_tickets:write Déposer un ticket, répondre (côté équipe ou demandeur), changer le statut et la priorité.
Centre d’assistance — notes internes (Lire) helpdesk_notes:read Lire les notes internes, seules ou avec le ticket.
Centre d’assistance — notes internes (Écrire) helpdesk_notes:write Écrire une note interne.
Centre d’assistance — articles de la base de connaissances (Lire) helpdesk_articles:read Lister et lire les articles publiés.
Centre d’assistance — abonnements aux webhooks (Écrire) helpdesk_webhooks:write S’abonner aux webhooks du Centre et s’en désabonner (voir Les webhooks du Centre d’assistance).
Formulaire Nouveau jeton API, groupe Données : Centre d’assistance — tickets cochée en lecture et en écriture, notes internes non cochée, articles de la base de connaissances cochée en lecture, abonnements aux webhooks non cochée
Les droits du Centre d’assistance sur un jeton

L’écriture ne comprend pas la lecture : une intégration qui dépose puis suit ses tickets coche les deux. Sans un droit helpdesk_notes, aucune note interne ne sort ni n’entre par l’API. Ces droits n’apparaissent que si le module Centre d’assistance est actif.

Ce que le jeton atteint #

Le jeton atteint les services ouverts à l’API, et parmi eux ceux que son créateur atteint dans Illizeo :

  • créé par un agent : les services dont il est agent. Il y agit comme à l’écran : sur un ticket libre, sur les siens, et sur tous ceux d’un service dont il est responsable. Le ticket d’un collègue, il le lit, peut y ajouter une note ou y écrire au nom du demandeur ; y répondre côté équipe ou en changer le statut ou la priorité est refusé (422) ;
  • créé par l’administrateur du Centre (« Administrer le Centre d’assistance » au palier Exécuter) : tous les services ouverts à l’API, avec le droit d’agir sur chaque ticket.

Un ticket ou un article hors de cette portée répond 404, comme s’il n’existait pas. Si les droits du créateur changent, ceux du jeton suivent dès l’appel suivant.

Les opérations #

Toutes les adresses partent de https://api.illizeo.app, avec l’en-tête Authorization: Bearer illz_…. Dans les adresses, {ticket} est le numéro d’un ticket (AST-000812) ou son identifiant, et {article} le slug d’un article ou son identifiant.

Opération Droit Usage
GET /v1/helpdesk/services helpdesk_tickets:read Les services atteints, avec leurs types de demande et les champs de leur formulaire.
GET /v1/helpdesk/tickets helpdesk_tickets:read La liste des tickets, sans leurs messages.
GET /v1/helpdesk/tickets/{ticket} helpdesk_tickets:read Un ticket, ses messages et sa chronologie publique.
POST /v1/helpdesk/tickets helpdesk_tickets:write Déposer un ticket.
PATCH /v1/helpdesk/tickets/{ticket} helpdesk_tickets:write Changer le statut ou la priorité.
POST /v1/helpdesk/tickets/{ticket}/messages helpdesk_tickets:write Répondre, côté équipe ou côté demandeur.
GET /v1/helpdesk/tickets/{ticket}/notes helpdesk_notes:read Les notes internes du ticket.
POST /v1/helpdesk/tickets/{ticket}/notes helpdesk_notes:write Écrire une note interne.
GET /v1/helpdesk/articles helpdesk_articles:read Chercher parmi les articles publiés.
GET /v1/helpdesk/articles/{article} helpdesk_articles:read Lire un article publié.
POST /v1/helpdesk/webhooks, DELETE /v1/helpdesk/webhooks/{id} helpdesk_webhooks:write S’abonner aux webhooks du Centre, s’en désabonner.

Le bouton Documentation de la page des jetons décrit chaque opération dans la carte Centre d’assistance ; le bouton openapi.json y donne le contrat complet.

Documentation de l’API dans l’application, carte Centre d’assistance : sa présentation puis les douze opérations, chacune avec sa méthode, son adresse sous /v1/helpdesk, son résumé et son droit
Les opérations du Centre dans la documentation de l’API

Lire les tickets #

La liste accepte les filtres statut (un ou plusieurs codes séparés par des virgules), service_id, reference_externe et modified_since (une date ISO 8601 ; modifie_depuis est accepté aussi). Un ticket compte comme modifié quand sa fiche change ou qu’une activité visible par le jeton s’y ajoute : un message, un changement de statut. Les tickets viennent par identifiant croissant, 50 par page (limit, 200 au plus) ; la réponse porte items, next_cursor et has_more. Pour synchroniser un autre système, relancez la lecture avec cursor égal à next_cursor tant que has_more est vrai.

Un ticket porte notamment numero, objet, description, statut, priorite, service, type, canal, demandeur (salarie ou externe, avec nom et e-mail), agent, ses dates (depose_le, modifie_le, resolu_le, clos_le, en ISO 8601 UTC), ses echeances de première réponse et de résolution, les reponses_au_formulaire, la reference_externe, et les numéros du parent (la demande dont il est une tâche) et de l’incident majeur auquel il est rattaché, ou null. Les clés sont en français, comme dans l’application ; les valeurs sont des codes :

Champ Codes (libellé à l’écran)
statut new (Nouveau), taken (Pris en charge), waiting_requester (En attente du demandeur), waiting_third_party (En attente d’un tiers), resolved (Résolu), closed (Clos)
priorite low (Basse), normal (Normale), high (Haute), critical (Critique)
canal internal (Espace salarié), portal (Portail), email (E-mail), agent (Déposé par un agent), widget (Widget du site), teams (Microsoft Teams), api (API)

La lecture d’un ticket ajoute messages — chacun avec cote (equipe, demandeur ou note), auteur, via_api, le, corps en HTML et pieces (nom et taille ; les fichiers se téléchargent dans Illizeo) — puis chronologie, celle que voit le demandeur. Les notes internes n’y figurent qu’avec le droit helpdesk_notes:read.

Déposer un ticket #

Le corps de POST /v1/helpdesk/tickets porte service_id et objet (obligatoires), au besoin type_id, description, priorite, reponses_au_formulaire et reference_externe (votre propre identifiant, par exemple celui de l’alerte), et le demandeur : email (obligatoire), nom et langue.

POST /v1/helpdesk/tickets
Authorization: Bearer illz_…
Content-Type: application/json

{
  "service_id": 3,
  "objet": "Serveur de fichiers injoignable",
  "description": "FS-01 ne répond plus depuis 08:42.",
  "priorite": "high",
  "demandeur": { "email": "supervision@votre-entreprise.ch", "nom": "Supervision" },
  "reference_externe": "ALERTE-20261120-0042"
}

La réponse, en 201, rend le ticket et son fil ("numero": "AST-000812", "statut": "new", "canal": "api"…). Le ticket entre dans la file comme les autres : règles du Centre, engagements de service, accusé de réception au demandeur.

  • Le demandeur se donne par son adresse e-mail. Si le service est ouvert aux salariés et que l’adresse est celle d’un seul salarié actif qui peut déposer au Centre (droit « Demandes au Centre d’assistance » au palier Exécuter), c’est lui. Sinon, si le service est ouvert aux externes, c’est une personne extérieure, créée à sa première demande dans la langue donnée. Sinon, la réponse est 422. Une alerte peut donc porter l’adresse de l’outil qui l’émet.
  • Le type est facultatif. S’il est donné, il doit être actif et proposé à ce demandeur, et ses champs obligatoires doivent figurer dans reponses_au_formulaire, sous les clés que donne GET /v1/helpdesk/services.
  • La priorité, à défaut, est celle du type, sinon Normale ; elle remonte au minimum prévu par le contrat de l’organisation cliente, s’il y en a un.
  • Un service fermé à l’API, hors de la portée du jeton ou inactif est refusé (422 sur service_id).

Répondre #

POST /v1/helpdesk/tickets/{ticket}/messages prend un corps en HTML, nettoyé à l’arrivée, et un cote.

  • "cote": "equipe" : une réponse publique de l’équipe, marquée « via API · » suivi du nom du jeton, et envoyée au demandeur par un e-mail signé de ce nom. Elle compte comme première réponse pour les engagements de service, mais ne prend pas le ticket : il garde son agent, ou n’en a toujours pas. Un statut facultatif le change dans le même geste ; le demandeur ne reçoit alors qu’un e-mail. La réponse est refusée (422) sur un ticket clos, sur un ticket en attente d’approbation et sur le ticket d’un collègue. Sur une tâche d’une demande du catalogue, elle s’écrit sur la demande, comme à l’écran.
  • "cote": "demandeur" : la réponse est écrite au nom du demandeur du ticket, par exemple depuis votre portail client. Elle suit les règles d’une réponse du demandeur : un ticket en attente du demandeur repasse Pris en charge ; un ticket résolu depuis moins que le délai de réouverture est rouvert ; au-delà, ou sur un ticket clos, une suite est créée et reçoit le message. statut n’est pas accepté de ce côté, ni une réponse sur une tâche.
POST /v1/helpdesk/tickets/AST-000812/messages
{ "cote": "equipe", "corps": "<p>La sonde est revenue à la normale.</p>", "statut": "resolved" }

La réponse, en 201, porte message (le message écrit, avec "via_api": true) et ticket, le ticket qui l’a reçu : le même, sa suite, ou la demande d’une tâche.

Fiche du ticket AST-000071 côté agent : canal API, aucun agent, puis les échanges : réponse automatique, réponse de l’équipe marquée via API · Supervision, note interne d’une agente, réponse du demandeur écrite par l’API
Un ticket déposé et suivi par l’API, vu par l’agent

Dans la fiche du ticket, les agents voient le canal API et la mention via API · Supervision sur chaque message de l’intégration ; la chronologie la nomme aussi (« Supervision (API) a répondu »). Le demandeur voit la même mention dans sa demande.

Changer le statut ou la priorité #

PATCH /v1/helpdesk/tickets/{ticket} prend statut, priorite ou les deux, en tout ou rien. Les règles sont celles de l’écran :

  • un ticket clos ne change plus ; un ticket résolu ne peut que repasser Pris en charge ou se clore ; un ticket ne redevient Nouveau que depuis Pris en charge ;
  • un ticket en attente d’approbation ne change ni de statut ni de priorité ; le statut ne change pas sur un ticket rattaché à un incident majeur ouvert, et une demande du catalogue ne se résout ni ne se clôt tant qu’une de ses tâches est ouverte (422, avec le motif) ;
  • la priorité ne change plus sur un ticket résolu ou clos, et ne descend pas sous le minimum du contrat de l’organisation cliente ;
  • le ticket d’un collègue est refusé (422).

La réponse, en 200, rend le ticket sans son fil. Dans un même appel, la priorité est traitée avant le statut : pour rouvrir un ticket résolu et en changer la priorité, faites deux appels, le statut d’abord. Le geste est signé du nom du jeton dans la chronologie. "statut": "taken" ne donne le ticket à personne, et "statut": "new" le rend à la file, sans agent.

Les notes internes #

Avec helpdesk_notes:write, POST /v1/helpdesk/tickets/{ticket}/notes et un corps en HTML écrivent une note interne signée du nom du jeton, sur tout ticket atteint, même clos, en attente d’approbation ou tenu par un collègue. Elle ne change ni le statut ni l’agent, et n’est jamais montrée au demandeur. Avec helpdesk_notes:read, GET …/notes rend les notes seules, et la lecture d’un ticket les mêle à ses messages ("cote": "note").

Les articles de la base #

Avec helpdesk_articles:read, l’intégration lit les articles publiés des services atteints, dans leur version courante, par exemple pour proposer des réponses sur votre site. GET /v1/helpdesk/articles accepte q (la même recherche que l’aide de l’espace), service_id, public (interne ou externe ; internal et external sont acceptés aussi) et langue, et rend pour chaque article son titre, un extrait, la langue servie, sa visibilité et sa catégorie. GET /v1/helpdesk/articles/{article} rend l’article entier, corps en HTML ; repli vaut true quand la langue demandée manque et qu’une autre est servie. Un brouillon, un article archivé ou hors de portée répond 404, et un article rattaché à aucun service n’est pas servi. Voir La base de connaissances.

Les refus #

Réponse Cause
403, SCOPE_MANQUANT Le droit de l’opération n’est pas coché sur le jeton ; data.required_scope le nomme. Un jeton en lecture seule ne peut rien écrire.
403, MODULE_NOT_ACTIVE ou MODULE_DISABLED_FOR_EMPLOYEE (champ code) Le Centre d’assistance n’est pas actif dans l’espace, ou pas ouvert au créateur du jeton.
403 Le créateur du jeton n’a pas le droit de l’écran au bon palier : « Agent du Centre d’assistance » ou « Administrer le Centre d’assistance » (ce dernier, au palier Exécuter, pour les webhooks).
404, NOT_FOUND Ticket ou article hors de la portée du jeton, ou d’un service fermé à l’API.
422, VALIDATION_ERROR Un champ refusé, détaillé dans errors ; ou une règle de l’écran, dont le motif est dans message, dans la langue demandée par X-Locale ou Accept-Language, sinon dans celle du créateur du jeton.

À savoir #

  • Les gestes de l’API ne sont signés d’aucune personne : le nom du jeton les signe dans le fil et la chronologie. Ce nom est recopié sur chaque message : renommer le jeton ne change pas les messages déjà écrits. Au journal d’activité, les modifications sont inscrites au nom du créateur du jeton.
  • Une réponse de l’équipe écrite par l’API sur le ticket d’un agent ne lui envoie pas de notification.
  • Les pièces jointes ne s’envoient pas par l’API : les messages les nomment seulement.
  • Chaque appel compte une unité dans la consommation de la plateforme API, comme chaque webhook livré (voir Suivre l’utilisation d’un jeton et le dépanner).
  • Le canal API se retrouve dans le pilotage et dans la condition « Canal » des automatisations.
  • Pour être prévenu de ce qui arrive aux tickets plutôt que de les relire, abonnez-vous à leurs webhooks : voir Les webhooks du Centre d’assistance.

Similaire #

Mis à jour le 20.11.2026
API publique : le guide du développeur
Table des matières
  • Avant de commencer
  • Ouvrir un service à l’API
  • Créer le jeton de l’intégration
  • Ce que le jeton atteint
  • Les opérations
  • Lire les tickets
  • Déposer un ticket
  • Répondre
  • Changer le statut ou la priorité
  • Les notes internes
  • Les articles de la base
  • Les refus
  • À savoir
Onboarding✦Offboarding✦Crossboarding✦Reboarding✦Cooptation✦Matériel✦IA✦Signatures✦NPS✦Présences✦Badgeages✦Absences✦Performance✦Objectifs✦Sondages✦Enquêtes✦Temps✦Rôles✦Permissions✦Flux✦Approbations✦Salaires✦NDF✦FlexOffice✦Projets✦
Onboarding✦Offboarding✦Crossboarding✦Reboarding✦Cooptation✦Matériel✦IA✦Signatures✦NPS✦Présences✦Badgeages✦Absences✦Performance✦Objectifs✦Sondages✦Enquêtes✦Temps✦Rôles✦Permissions✦Flux✦Approbations✦Salaires✦NDF✦FlexOffice✦Projets✦
Plateforme RH internationale

Gérez vos
RH en minutes,
pas en journées.

Essayer gratuitement Prendre rendez-vous
illizeo

Onboarding, paie, absences, talents — un moteur unique pour vos équipes.

SWISS MADE
Fonctionnalités
  • Solutions
  • Plans
À Propos
  • Carrières
  • Presse
  • Références
  • Espace partenaires
  • Contact
Ressources
  • Blog
  • Allocations familiales mondiales
  • Comparatifs
  • Centre d’aide
  • FAQ
  • Sécurité
Contact
+41 78 669 05 65 contact@illizeo.com
Newsletter
1 email par mois. Que de l’utile.
Bientôt sur App Store Bientôt sur Google Play
All systems operational · Hébergement suisse · RGPD & nLPD
© 2026 Illizeo Cloud Solutions
FR/EN
Politique de confidentialité Mentions légales et CGU CGV Illizeo CGAI Paramètres des cookies Sous-traitants MTO Data Processing Addendum (DPA) CGV des services d’assistance
illizeo-logo-primary-white
Gérer le consentement

Afin de vous offrir la meilleure expérience possible, nous utilisons des technologies telles que les cookies pour stocker et/ou accéder aux informations relatives à votre appareil. En acceptant ces technologies, vous nous autorisez à traiter des données telles que votre comportement de navigation ou vos identifiants uniques sur ce site. Le refus ou le retrait de votre consentement peut avoir un impact négatif sur certaines fonctionnalités et fonctions.

Fonctionnel Toujours activé
Le stockage technique ou l'accès est strictement nécessaire à des fins légitimes afin de permettre l'utilisation d'un service spécifique explicitement demandé par l'abonné ou l'utilisateur, ou dans le seul but d'effectuer la transmission d'une communication sur un réseau de communications électroniques.
Preferences
The technical storage or access is necessary for the legitimate purpose of storing preferences that are not requested by the subscriber or user.
Statistiques
Le stockage technique ou l'accès utilisé exclusivement à des fins statistiques. The technical storage or access that is used exclusively for anonymous statistical purposes. Without a subpoena, voluntary compliance on the part of your Internet Service Provider, or additional records from a third party, information stored or retrieved for this purpose alone cannot usually be used to identify you.
Marketing
Le stockage technique ou l'accès est nécessaire pour créer des profils d'utilisateurs afin d'envoyer des publicités ou de suivre l'utilisateur sur un site web ou sur plusieurs sites web à des fins marketing similaires.
  • Gérer les options
  • Gérer les services
  • Gérer {vendor_count} fournisseurs
  • En savoir plus sur ces finalités
Afficher les préférences
  • {title}
  • {title}
  • {title}