Intégrations
Panels Discord
Panels (fondateurs) : publie dans un salon un message avec des boutons pour ouvrir un ticket sans passer par les MP. Embed personnalisable (titre, description, couleur, image), jusqu'à 25 boutons avec libellé, emoji, style et sujet, et un formulaire facultatif ouvert au clic. Modifier le panel met à jour le message ; le supprimer retire le message.
API publique
Activable par serveur (Paramètres → Fonctionnalités → API publique), avec des clés API (page Clés API) créées par les fondateurs : permissions au choix, date d'expiration facultative. Seule une empreinte de la clé est conservée.
| Méthode | Route | Permission |
|---|---|---|
GET | /api/v1/tickets?status=open|closed&page=1 | read_tickets |
GET | /api/v1/tickets/:id (ticket et messages) | read_tickets |
POST | /api/v1/tickets/:id/close | close_tickets |
GET | /api/v1/stats | read_stats |
La clé s'envoie dans l'en-tête Authorization: Bearer <clé>. La description OpenAPI 3 est publique sur /api/v1/openapi.json, et la page Documentation API du dashboard l'affiche avec un exemple curl et une réponse type pour chaque route. Les tickets confidentiels ne sont jamais accessibles par l'API.
Webhooks sortants
Paramètres → Intégrations : une adresse HTTPS prévenue à l'ouverture, à la fermeture et à la prise en charge d'un ticket (ticket_open, ticket_close, ticket_claim).
- En-tête
X-TicketBot-Event, et signatureX-TicketBot-Signature-256(HMAC-SHA256) si un secret est défini. - Adresses privées et internes refusées (protection anti-SSRF), délai de 5 secondes.
- Ticket confidentiel : seulement
{ ticketId, confidential: true }.
Notifications push
Chaque membre du staff peut recevoir les nouveaux messages et réponses en notification du navigateur (Profil → Notifications), seulement pour les tickets qu'il peut voir. Il faut les clés VAPID_* du .env, générées par setup.sh.
Accès invités
Accès invités (fondateurs) : un lien temporaire en lecture seule vers des tickets choisis, pour une personne extérieure sans compte Discord (modérateur d'un partenaire, conseil…). Durée d'une heure à 30 jours, notes internes incluses ou non, chaque consultation inscrite au journal, révocable à tout moment.
Sauvegarde de la configuration
Paramètres → Sauvegarde et transfert : export JSON de la configuration (paramètres, grades, tags, formulaires, panels, champs, FAQ, modèles, règles, procédures) et import sur ce serveur ou un autre. Les secrets ne sont jamais exportés.