Ajout de Snippets

docs/fr/7.communication/4.snippets.md

@@ -0,0 +1,130 @@
+---
+slug: /communication/snippets
+title: Snippets
+description: Enregistrez vos réponses types, retrouvez-les en un instant avec /snippet, et envoyez-les depuis votre propre compte plutôt que de les faire poster par un bot.
+navigation.icon: 'twemoji:speech-balloon'
+redactors: ['draftproducts']
+updatedAt: '2026-09-28'
+---
+
+## Des réponses prêtes, envoyées par vous
+
+Les mêmes questions reviennent chaque semaine sur un serveur, et les mêmes réponses avec. Les snippets sont une bibliothèque de réponses écrites une fois, rangées et partagées, que vous retrouvez avec la commande \</snippet> depuis n'importe quel salon et n'importe quel appareil.
+
+DraftBot n'envoie jamais ces réponses à votre place. La commande vous affiche le texte à vous seul, et vous le copiez pour l'envoyer depuis votre compte. C'est un choix de conception, pas une étape manquante. Le membre en face reçoit un message signé par une personne, avec son pseudo, son avatar et sa couleur de rôle, et vous gardez la main pour changer la mention, retirer le paragraphe hors sujet ou ajouter un mot qui n'appartient qu'à cette conversation.
+
+::hint{ type="info" }
+  Un snippet ne remplace pas la réponse, il remplace le fait de la retaper. Vous n'avez plus besoin d'un salon de notes, d'un fil dédié ou d'un serveur personnel pour garder vos formulations sous la main.
+::
+
+## Afficher une réponse
+
+La commande \</snippet> est ouverte à tous les membres du serveur. Tapez les premières lettres de ce que vous cherchez, le sélecteur affiche les réponses auxquelles vous avez accès.
+
+![Le sélecteur de la commande /snippet](./assets/snippets/bot_autocomplete.png)
+
+Trois préfixes distinguent les entrées :
+
+- 👤 une de vos réponses personnelles
+- 👥 une réponse du serveur, précédée du nom de sa catégorie entre crochets
+- `➕ Créer une réponse`, proposée en permanence, y compris quand la liste est vide
+
+La recherche porte sur le nom de la réponse et sur celui de sa catégorie. Dès que vous avez tapé 2 caractères, elle cherche aussi dans le contenu des réponses, de quoi retrouver un texte dont vous ne savez plus le titre. Vos 3 dernières réponses affichées remontent en tête de liste pendant 7 jours, serveur par serveur.
+
+La réponse s'affiche ensuite en message éphémère, visible de vous seul, dans un bloc de code. Copier ce bloc restitue le texte brut, avec les mentions de salon, de rôle et les émojis personnalisés intacts. Une copie du texte déjà affiché, elle, les casserait.
+
+### Les actions d'une réponse
+
+Le bouton `⋯` en haut à droite déplie une rangée d'actions. Elle s'ouvre d'elle-même quand le contenu comporte une mention, un émoji personnalisé ou un horodatage, les cas où le texte brut ne ressemble pas au résultat final.
+
+- **Aperçu** affiche le rendu du message tel qu'il apparaîtra une fois envoyé, dans un second message éphémère. C'est aussi le chemin de copie le plus confortable sur mobile.
+- **Ajouter au serveur** transforme une de vos réponses personnelles en réponse d'équipe. Le bouton n'apparaît que si vous pouvez écrire dans au moins une catégorie.
+- **Modifier** et **Supprimer** n'apparaissent que si vous avez le droit d'écrire dans la catégorie de la réponse. Vos réponses personnelles sont toujours modifiables par vous.
+
+## Réponses personnelles et réponses du serveur
+
+Une réponse personnelle n'appartient à aucun serveur. Vous seul y avez accès, et elle vous suit d'un serveur à l'autre, jusque dans vos messages privés. Retrouvez-les sur le panel dans [Mes snippets](/dashboard/user/snippets).
+
+Une réponse de serveur appartient à une catégorie, qui décide de qui peut la lire et la modifier. Elle reste sur le serveur et se partage avec toute l'équipe.
+
+Quand vous cliquez sur **Ajouter au serveur**, DraftBot ouvre la fenêtre de création préremplie avec le nom et le contenu de votre réponse personnelle, et vous laisse choisir sa catégorie. Si vous validez sans rien changer, votre copie personnelle est supprimée, puisque la réponse du serveur en est le double exact. Si vous modifiez le nom ou le texte au passage, elle est conservée.
+
+::hint{ type="info" }
+  Vous pouvez installer DraftBot sur votre compte pour utiliser \</snippet> même là où le bot n'est pas présent. Sur ces serveurs et en message privé, seules vos réponses personnelles s'affichent.
+::
+
+## Enregistrer un message existant
+
+Un message déjà écrit devient une réponse sans retaper une ligne. Faites un clic droit dessus (ou un appui long sur mobile), puis **Applications** ➜ **Enregistrer comme réponse**.
+
+Une fenêtre s'ouvre avec le texte du message déjà rempli. Vous choisissez son nom et sa destination, vos réponses personnelles ou l'une des catégories où vous pouvez écrire.
+
+::hint{ type="info" }
+  Les images du message sont reprises, jusqu'à 4 par message. DraftBot les réenvoie sur son propre stockage au moment où vous validez, parce que les liens d'origine de Discord expirent.
+::
+
+La même fenêtre s'ouvre depuis l'entrée ➕ **Créer une réponse** du sélecteur de \</snippet>, à ceci près que le contenu est vide. Ce que vous aviez tapé dans le champ de recherche sert de nom de départ.
+
+::hint{ type="warning" }
+  Un message qui ne contient ni texte ni image ne peut pas être enregistré.
+::
+
+## Catégories et accès
+
+Les catégories ne servent pas qu'à ranger. Ce sont elles qui portent les autorisations. Chaque catégorie a trois réglages.
+
+**Les rôles autorisés à lire.** Les membres qui portent l'un de ces rôles voient les réponses de la catégorie dans \</snippet>. Sans aucun rôle sélectionné, la catégorie est lisible par tous les membres du serveur.
+
+**Les rôles autorisés à ajouter des réponses.** Ces rôles peuvent créer, modifier et supprimer les réponses de la catégorie, et ils la lisent toujours, même s'ils ne figurent pas dans les rôles de lecture. Sans aucun rôle sélectionné, seuls les administrateurs peuvent y écrire.
+
+**L'accès des administrateurs.** Par défaut, un membre ayant la permission Administrateur lit toutes les catégories. Vous pouvez couper ce raccourci catégorie par catégorie pour qu'elle n'apparaisse plus qu'aux rôles autorisés. Le réglage ne concerne que l'affichage dans \</snippet>. La catégorie reste visible et modifiable sur le panel et dans \</config>.
+
+Une équipe peut donc avoir ses propres réponses sans que le reste du serveur les voie, et modifier les siennes sans toucher à celles des autres.
+
+::hint{ type="warning" }
+  Supprimer une catégorie supprime aussi toutes les réponses qu'elle contient. Une confirmation annonce leur nombre avant l'opération.
+::
+
+Les créations, modifications et suppressions de réponses et de catégories sont écrites dans le [module Logs](/docs/securite/logs).
+
+## Configurer les réponses du serveur
+
+::tabs
+  ::tab{ label="Depuis le panel" }
+
+    [⫸ Accéder au panel de **DraftBot**](/dashboard/first/snippets)
+
+    La page se divise en deux parties.
+
+    **Catégories** liste vos catégories avec leur nombre de réponses et leurs rôles autorisés. Les catégories lisibles par tout le serveur portent la mention "Catégorie publique", celles dont vous avez coupé l'accès administrateur la mention "Masquée aux administrateurs".
+
+    **Réponses** liste toutes les réponses, avec leur catégorie et leur nombre d'utilisations. La fenêtre de création propose un aperçu du rendu Discord pendant que vous écrivez.
+
+    Les deux listes ont leur champ de recherche, celui des réponses cherchant aussi par catégorie.
+  ::
+
+  ::tab{ label="Via la commande /config" }
+
+    Exécutez la commande \</config>, puis sélectionnez "💬 Snippets". La commande est réservée aux membres ayant la permission Administrateur.
+
+    L'écran affiche vos catégories et vos réponses, avec les compteurs de chacune. Une légende rappelle quelles catégories sont ouvertes à tout le serveur (🔓) et lesquelles sont masquées aux administrateurs (🔒).
+
+    Les boutons couvrent la création, la modification et la suppression des catégories comme des réponses. DraftBot vous guide ensuite question par question.
+  ::
+::
+
+Les membres qui portent un rôle autorisé à ajouter des réponses n'ont besoin ni du panel ni de \</config>. Ils créent et modifient depuis le clic droit sur un message ou depuis \</snippet>.
+
+## Limites
+
+| Limite | Gratuit | Premium |
+|---|---|---|
+| Catégories | 3 | 20 |
+| Réponses du serveur | 10 | 100 |
+| Réponses personnelles | 5 | 50 |
+
+::hint{ type="info" }
+  Les limites de catégories et de réponses du serveur dépendent du [premium](/premium) <:icon_premium:1096140508625125417> du serveur. Celle des réponses personnelles dépend du premium de votre compte, puisque ces réponses vous suivent partout.
+::
+
+Un nom de catégorie fait au plus 30 caractères, un nom de réponse 50, et le contenu d'une réponse 2000 caractères, la limite d'un message Discord. Deux réponses d'une même catégorie ne peuvent pas porter le même nom, mais deux catégories différentes peuvent chacune avoir leur "Bienvenue".