---
title: "Widget portail « Tickets à traiter »"
module: tickets
type: functional
status: active
updated: 2026-08-10
---

# Widget portail « Tickets à traiter »

Widget de portail (catalogue `Ticket - Tickets à traiter`, id **127**) qui affiche, sur la page
d'accueil, la **file de tickets qu'un gestionnaire doit traiter**.

Il vient **en complément** du widget « Mes demandes en cours » (id 83), qui liste au contraire les
tickets *déposés* par l'utilisateur. Les deux coexistent : aucun n'est remplacé.

## À qui il s'adresse

Aux comptes **prestataires** en priorité (un prestataire traite les tickets de ses clients, il n'en
dépose quasiment jamais), mais il est disponible pour n'importe quelle page/entité via le
gestionnaire de widgets.

Le widget est **poussé par défaut** en tête de la page d'accueil des comptes `presta` et
`prestamium`.

## Ce que vous voyez

Une ligne par ticket, **du plus récemment touché au plus ancien** :

| Élément | Détail |
|---------|--------|
| Pastille de couleur | Priorité du ticket (rouge = urgent, orange = important, vert = moyen, gris = faible / non renseignée) |
| Titre | `#numéro — libellé`, cliquable vers la fiche du ticket |
| Badge de statut | Ouvert / Affecté / En pause / Résolu |
| Entité | Structure cliente concernée |
| Demandeur | Personne à l'origine du ticket |
| Dernière activité | Depuis quand le ticket n'a pas bougé (`auj.`, `3 j`…). L'infobulle indique aussi depuis combien de temps il est ouvert |
| Affectation | Avatar de la personne affectée (vert si c'est vous), ou icône « non affecté » |

Un ticket **épinglé** remonte en tête de liste, avec une punaise.

La liste défile dans le widget (hauteur bornée) : la page d'accueil reste compacte même avec un
nombre d'éléments élevé.

## Les trois onglets

| Onglet | Contenu |
|--------|---------|
| **Tous** | Toute la file active de votre périmètre |
| **À affecter** | Les tickets ouverts, non affectés et non en pause |
| **Les miens** | Les tickets qui vous sont affectés |

Chaque onglet affiche son compteur. Le compteur « À affecter » passe en orange dès qu'il est non nul.

Le bouton **Voir tout** de l'en-tête ouvre l'écran complet *Tickets à traiter*.

## Règles d'accès

- Le widget n'apparaît que si le **module Tickets est activé** pour la structure.
- Il n'apparaît que pour les utilisateurs **gestionnaires d'au moins un système de tickets**. Un
  utilisateur qui ne gère aucun système ne le voit pas du tout.
- Le périmètre affiché est **exactement le même** que celui de l'écran *Tickets à traiter* : les
  systèmes que vous gérez, plus les tickets escaladés vers vous (niveaux 1 à 3). Les compteurs du
  widget et ceux de l'écran sont donc cohérents.

## Si la file est vide

Un message « Aucun ticket à traiter » s'affiche, adapté à l'onglet courant. Si l'option
**« Afficher même si vide »** est décochée dans le gestionnaire de widgets, le widget disparaît
simplement de la page tant qu'il n'y a rien à traiter.

## Paramétrage

Depuis le gestionnaire de widgets (administration) :

| Réglage | Effet |
|---------|-------|
| Titre | Titre affiché dans l'en-tête |
| Nombre max d'éléments | Nombre de tickets listés (1 à 20, 5 par défaut) |
| Largeur | Largeur de la colonne (12 = pleine largeur par défaut) |
| Afficher même si vide | Conserve le widget visible avec son message d'état vide |

## Voir aussi

- [Pilotage des tickets](pilotage-tickets.md)
- Doc technique : `.claude/technical-docs/tickets/tickets-todo-widget.md`