---
title: "Utilisation"
weight: 30
description: "Utilisation quotidienne du module TipsForTickets : qualification des tickets, envoi automatique et manuel des demandes de contribution."
---

# Utilisation

## Champs ajoutés à la fiche ticket

Le module ajoute trois champs personnalisés (extrafields) sur chaque ticket :

| Champ | Type | Description |
|-------|------|-------------|
| Éligible à la demande de contribution | Case à cocher | Indique si ce ticket doit déclencher une demande de contribution à la clôture. |
| Temps passé (minutes) | Nombre entier | Temps estimé passé sur le ticket par le technicien. Cette valeur est incluse dans l'email envoyé au client. |
| Date d'envoi de la demande de contribution | Date/heure (lecture seule) | Renseignée automatiquement lors de l'envoi de l'email. Non modifiable manuellement. |

## Qualifier un ticket

Lorsque vous ajoutez un message sur un ticket, deux champs supplémentaires apparaissent dans le formulaire de réponse :

![Champs TipsForTickets dans le formulaire de message d'un ticket](screenshots/champs-formulaire-message.webp)

1. Cochez **Éligible à la demande de contribution** si vous souhaitez qu'un email soit envoyé au client à la clôture du ticket
2. Renseignez le **temps passé** en minutes si vous souhaitez que cette information figure dans l'email

Ces valeurs sont sauvegardées à chaque envoi de message. Vous pouvez les modifier à tout moment en envoyant un nouveau message.

> **Raccourci clavier** : Appuyez sur Ctrl+Entrée dans la zone de texte du message pour envoyer directement le formulaire.

## Envoi automatique à la clôture

Si l'envoi automatique est activé dans la [configuration](/tipsfortickets/configuration), le processus est le suivant :

1. Le technicien qualifie le ticket comme éligible (case cochée)
2. Le ticket est clôturé (passage au statut "Fermé")
3. Le module vérifie les conditions : ticket éligible, URL de boutique configurée, email non déjà envoyé
4. L'email est envoyé au client dans sa langue
5. La date d'envoi est enregistrée sur le ticket
6. L'événement est tracé dans l'agenda Dolibarr

Le module ne renvoie jamais l'email automatiquement si une demande a déjà été envoyée pour ce ticket.

### Conditions requises pour l'envoi automatique

L'email est envoyé uniquement si toutes ces conditions sont réunies :

- L'envoi automatique est activé dans la configuration
- L'URL de la boutique de contribution est renseignée
- Le ticket est marqué comme éligible
- Aucun email de contribution n'a déjà été envoyé pour ce ticket
- Une adresse email client est disponible (email d'origine du ticket, email du tiers ou email du contact)

Si l'une de ces conditions n'est pas remplie, l'envoi est ignoré et un message est enregistré dans les logs Dolibarr.

## Envoi manuel

Un bouton d'action est disponible sur la fiche de chaque ticket pour envoyer ou renvoyer la demande manuellement.

![Bouton d'envoi de la demande de contribution sur la fiche ticket](screenshots/bouton-envoi-manuel.webp)

### Envoyer une première demande

Si aucun email n'a encore été envoyé pour ce ticket, le bouton **Envoyer demande de contribution** apparaît dans la barre d'actions de la fiche ticket. Un clic envoie immédiatement l'email.

### Renvoyer une demande

Si un email a déjà été envoyé, le bouton change de libellé pour **Renvoyer demande de contribution**. Cette action force un nouvel envoi, même si la date d'envoi est déjà renseignée.

> **Condition d'affichage** : Le bouton n'apparaît que si l'URL de la boutique de contribution est configurée et qu'une adresse email client est disponible sur le ticket.

## Résolution de l'adresse email du client

Le module recherche l'adresse email du client dans l'ordre suivant :

1. **Email d'origine du ticket** -- L'adresse renseignée lors de la création du ticket (champ `origin_email`)
2. **Email du tiers** -- L'adresse email du tiers (société) associé au ticket
3. **Email du contact** -- L'adresse email du contact associé au ticket

La première adresse trouvée est utilisée.

## Traçabilité

Chaque envoi d'email est enregistré dans l'agenda Dolibarr (module Événements) :

- **Type** : Email (AC_EMAIL)
- **Libellé** : "Demande de contribution envoyée pour le ticket [référence]"
- **Note** : Adresse email du destinataire et sujet de l'email
- **Lien** : Associé au ticket et au tiers concernés

Vous retrouvez ces événements dans l'onglet **Événements** de la fiche ticket ou dans l'agenda global de Dolibarr.

## Contenu de l'email

L'email envoyé au client est mis en page avec un template HTML responsive :

- En-tête avec le logo de votre société (intégré en pièce jointe inline)
- Corps du message personnalisable via les modèles d'emails
- Lien vers la page de contribution
- Pied de page avec le nom de la société et l'année en cours

Si le logo de la société n'est pas configuré dans Dolibarr, le nom de la société est affiché en texte dans l'en-tête.