Annonces
Publiez des annonces avec des boutons de traduction, gratuitement sur tous les serveurs.
Une annonce est un message accompagné de cinq boutons de traduction au maximum. Un membre qui clique sur l'un d'eux voit l'annonce traduite dans cette langue, dans une réponse que lui seul voit.
Fonctionnement
Les boutons se configurent une seule fois pour tout le serveur : une langue, un libellé, un emoji ou les deux, et une couleur (blurple, gris, vert ou rouge).
Jusqu'à {max} boutons, affichés dans cet ordre sous chaque annonce. Chacun traduit l'annonce dans sa langue. Deux boutons ne peuvent pas avoir la même langue.
Un clic traduit le texte et les embeds de l'annonce. Les pièces jointes ne sont jamais traduites.
En mode réponse, un clic traduit toujours le texte actuel du message d'origine, même s'il a été modifié.
Les annonces sont gratuites sur tous les serveurs, jusqu'à 3 par jour.
Quatre façons de publier une annonce
L'onglet Rédaction du tableau de bord : écrivez le message, vérifiez l'aperçu, envoyez-le.
Un webhook externe : une URL utilisable par tout outil capable de publier via un webhook Discord.
La commande contextuelle sur un message existant.
Un salon d'annonces : chaque message qui y est publié devient une annonce.
Rédaction
L'onglet Rédaction du tableau de bord : écrivez le message, vérifiez l'aperçu, envoyez-le.
Passez le format sur Conteneur pour publier une carte Components V2 : des textes, des séparateurs, des sections (des textes avec un bouton de lien ou une image à droite), des galeries de médias et des boutons de lien, avec une couleur d’accent facultative. Une image peut être un lien ou l’une des pièces jointes ; les pièces jointes que la carte n’utilise pas s’affichent sous la carte.
Dans les deux formats, une annonce peut porter jusqu’à 5 boutons de lien qui lui sont propres. Ils s’affichent sur leur propre ligne, au-dessus des boutons de traduction.
Webhooks externes
Une URL de webhook permet à un autre outil ou service de publier des annonces dans un salon, avec les boutons.
L'URL accepte les mêmes requêtes qu'un webhook Discord : tout outil capable de publier via un webhook Discord peut publier des annonces. Collez l'URL là où l'outil demande une URL de webhook Discord.
Envoyer un message :
curl -X POST "$WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"content": "Hello everyone!"}'Envoyer un message avec un fichier :
curl -X POST "$WEBHOOK_URL" \
-F 'payload_json={"content": "New screenshots"}' \
-F 'files[0][email protected]'Envoyer un message Components V2 :
curl -X POST "$WEBHOOK_URL" \
-H "Content-Type: application/json" \
-d '{"flags": 32768, "components": [{"type": 17, "components": [{"type": 10, "content": "## Patch notes"}, {"type": 14}, {"type": 9, "components": [{"type": 10, "content": "..."}], "accessory": {"type": 2, "style": 5, "label": "Changelog", "url": "https://example.com"}}]}]}'Les messages Components V2 sont acceptés : mettez flags à 32768 et envoyez des conteneurs composés de textes, de séparateurs, de sections, de galeries de médias et de lignes de boutons de lien. Une image peut désigner un fichier envoyé avec attachment:// suivi de son nom. 5 boutons de lien au maximum par message ; les autres boutons et les menus de sélection sont refusés, car le bot ajoute ses propres boutons de traduction sur une dernière ligne.
Un username ou un avatar_url envoyé dans une requête remplace le nom et l’avatar enregistrés du webhook, pour ce message uniquement.
Convertir en annonce
Faites un clic droit sur un message (appui long sur mobile), ouvrez Applications, puis choisissez Convertir en annonce. Seuls les membres qui peuvent gérer les messages la voient. Un message qui est déjà une annonce est refusé.
Salons d'annonces
Chaque message publié par un membre dans ces salons devient automatiquement une annonce. Une fois la limite quotidienne atteinte, les messages restent tels quels.
Modes
La commande contextuelle et les salons d'annonces transforment un message existant en annonce selon l'un des trois modes. Le défaut du serveur s'applique partout, et chaque salon d'annonces peut le remplacer.
| Option | Description |
|---|---|
| Automatique | Le bot republie le message sous le nom et l'avatar de son auteur avec les boutons, puis supprime l'original. Si le message ne peut pas être republié (une réponse, un sticker, un sondage, des fichiers trop volumineux…), le bot y répond avec les boutons à la place. |
| Réponse uniquement | Le message reste intact : le bot y répond avec les boutons. Supprimer le message supprime aussi la réponse. |
| Republication uniquement | Le message est toujours republié. Si c'est impossible, il n'est pas converti et une erreur s'affiche. |
Les clics sur les boutons sont traduits avec le moteur premium de ce serveur au lieu du moteur gratuit. Chaque langue n'est payée qu'une fois par annonce et conservée 90 jours : les clics suivants ne coûtent rien. Quand il ne reste plus de caractères, le moteur gratuit prend le relais.
Si une annonce est modifiée, sa traduction est refaite une fois. Si la traduction Premium échoue, le moteur gratuit répond à la place.
Limite quotidienne
Chaque serveur peut publier 3 annonces par jour, quelle que soit leur provenance. Le compteur est remis à zéro à minuit UTC.
Rédaction et webhooks externes : l'annonce est refusée avec une erreur.
Commande contextuelle : une erreur vous indique quand la limite sera réinitialisée.
Salon d'annonces : le message reste intact, sans notification.
Commandes
Tout peut aussi se configurer depuis Discord. Ces commandes sont réservées aux modérateurs.
| Option | Description |
|---|---|
/annonces bouton définir | Ajouter ou remplacer un bouton de traduction. |
/annonces bouton retirer | Supprimer un bouton de traduction. |
/annonces salon ajouter | Transformer chaque message d'un salon en annonce. |
/annonces salon retirer | Ne plus transformer chaque message d'un salon en annonce. |
/annonces mode | Choisir comment les boutons de traduction sont ajoutés par défaut. |
/annonces traduction_premium | Traduire les clics avec votre moteur premium au lieu du moteur gratuit. |
/annonces texte_réponse | Définir un texte affiché au-dessus des boutons quand ils sont ajoutés en réponse. |
/annonces afficher | Afficher les paramètres d'annonces de ce serveur. |
Commandes slash
/annonces bouton définir
/annonces bouton retirer
/annonces salon ajouter
/annonces salon retirer
/annonces mode
/annonces traduction_premium
/annonces texte_réponse
/annonces afficher