Documentation

Guide complet pour utiliser le système de gestion de tickets

Démarrage rapide

Bienvenue dans Ticket System ! Ce guide vous aidera à démarrer rapidement.

Astuce : Vous pouvez créer un ticket en moins de 2 minutes sans création de compte.

Installation

Aucune installation n'est nécessaire ! Accédez simplement à la plateforme via votre navigateur web.

Prérequis

  • Un navigateur web moderne (Chrome, Firefox, Safari, Edge)
  • Une adresse email valide pour recevoir les notifications

Créer un ticket

Créer un ticket est simple et rapide. Suivez ces étapes :

Étape 1 : Accéder au formulaire

Cliquez sur le bouton Créer un ticket depuis la page d'accueil ou directement via le widget intégré.

Étape 2 : Remplir le formulaire

  • Nom : Votre nom complet
  • Email : Votre adresse email (pour recevoir les notifications)
  • Type : Sélectionnez le type de ticket (Bug, Feature, Question, etc.)
  • Titre : Un titre court et descriptif
  • Description : Décrivez votre problème en détail (supporte le Markdown)
  • Captures d'écran : Ajoutez des images pour illustrer votre problème (optionnel)
# Exemple de description Markdown

## Problème rencontré
L'application plante quand je clique sur "Enregistrer".

## Étapes pour reproduire
1. Ouvrir la page de paramètres
2. Modifier un champ
3. Cliquer sur "Enregistrer"

**Résultat attendu :** Les modifications sont sauvegardées
**Résultat obtenu :** L'application plante

Étape 3 : Soumettre

Cliquez sur Créer le ticket. Vous recevrez immédiatement un email avec un lien unique pour suivre votre ticket.

Succès ! Conservez précieusement le lien reçu par email, c'est le seul moyen d'accéder à votre ticket.

Suivre un ticket

Une fois votre ticket créé, vous pouvez suivre son évolution en temps réel.

Accéder à votre ticket

Utilisez le lien unique reçu par email : https://votresite.com/ticket/HASH_UNIQUE

Statuts des tickets

  • Nouveau - Statut du ticket
  • Ouvert - Le ticket vient d'être créé et attend d'être traité
  • Vu - Ticket consulté par un membre de l'équipe
  • Encours - L'équipe travaille activement sur votre demande
  • Résolu - Le problème a été résolu avec succès
  • Annulé - Le ticket a été annulé (doublon, invalide, etc.)
Notifications : Vous recevez un email à chaque changement de statut ou nouveau message.

Messagerie

Communiquez directement avec l'équipe support via le chat intégré.

Envoyer un message

  1. Accédez à votre ticket via le lien unique
  2. Scrollez jusqu'à la section "Messages"
  3. Rédigez votre message dans le champ de texte
  4. Cliquez sur Envoyer

Fonctionnalités

  • Temps réel - Les messages apparaissent instantanément
  • Notifications email - Recevez un email pour chaque nouveau message
  • Markdown - Formatez vos messages avec Markdown
  • Indicateur de frappe - Voyez quand l'équipe répond
Important : Une fois le ticket résolu ou annulé, vous ne pouvez plus envoyer de messages.

Espace admin

L'espace administration permet de gérer tous les tickets et projets.

Accès administrateur

Accédez à l'interface admin : /admin

Fonctionnalités

  • Tableau de bord - Vue d'ensemble des tickets et statistiques
  • Gestion des projets - Créer et configurer des projets
  • Gestion des tickets - Modifier statuts, assigner, répondre
  • Types de tickets - Configurer les types disponibles
  • Équipes - Gérer les équipes et assignations
  • Intégration GitHub - Créer des issues GitHub depuis les tickets
Authentification : L'accès admin nécessite une authentification sécurisée par JWT.

Widget intégrable

Intégrez facilement le formulaire de création de tickets sur votre site web.

Obtenir le code du widget

  1. Connectez-vous à l'espace admin
  2. Accédez à la page du projet
  3. Copiez le code du widget (iframe)
<iframe
src="https://votresite.com/widget/TOKEN_UNIQUE"
width="100%"
height="800"
frameborder="0"
style="border: none; border-radius: 8px;"
></iframe>

Configuration

  • width : Largeur du widget (100% recommandé)
  • height : Hauteur en pixels (800px minimum)
  • TOKEN : Token unique par projet (génère automatiquement)

API REST

Intégrez le système de tickets dans vos applications via l'API REST.

Endpoints principaux

Créer un ticket

POST /api/tickets
Content-Type: application/json

{
"project_id": 1,
"type_id": 2,
"title": "Bug dans le formulaire",
"description": "Description du problème",
"client_name": "Jean Dupont",
"client_email": "jean@example.com"
}

Récupérer un ticket

GET /api/tickets/:hash

Ajouter un message

POST /api/messages
Content-Type: application/json

{
"ticket_id": 123,
"user_type": "client",
"user_identifier": "jean@example.com",
"message": "Message de suivi"
}
Authentification : Certains endpoints nécessitent un token JWT admin.

FAQ

Puis-je créer un ticket sans compte ?

Oui ! Aucun compte n'est nécessaire. Vous recevez un lien unique par email pour accéder à votre ticket.

Combien de temps mon ticket est-il accessible ?

Indéfiniment. Le lien unique reste valide tant que le ticket existe dans le système.

Puis-je ajouter des pièces jointes ?

Oui, vous pouvez ajouter des captures d'écran lors de la création du ticket (jusqu'à 5 images).

Puis-je modifier un ticket après création ?

Non, mais vous pouvez ajouter des messages pour préciser ou compléter votre demande.

Que se passe-t-il si je perds le lien ?

Le lien est envoyé par email. Vérifiez votre boîte mail et vos spams. Si vous ne le trouvez pas, contactez l'équipe support.

Le système est-il open source ?

Oui ! Le code source est disponible sur GitHub. Contributions bienvenues !