Dépannage des webhooks

Un webhook ne reçoit rien ? Le problème vient le plus souvent de l’URL, des permissions du salon ou de la configuration des événements. Suivez ces vérifications dans l’ordre avant de recréer le webhook.

1. Vérifier l’URL

• L’URL doit commencer par https://discord.com/api/webhooks/.
• Elle ne doit pas contenir d’espace ni de guillemet.
• Copiez-la à nouveau depuis Discord : une URL partielle est la cause la plus fréquente.
• Si le webhook a été supprimé dans Discord, recréez-le.

2. Vérifier le salon

• Le webhook pointe vers un salon existant.
• Le salon n’est pas archivé ou supprimé.
• Les permissions Voir le salon et Envoyer des messages sont accordées au webhook.
• Un salon en lecture seule peut bloquer l’envoi.

3. Vérifier les événements

• L’événement correspondant est coché : vote, like, commentaire ou palier.
• Le message personnalisé n’est pas vide si l’interface l’exige.
• La configuration a bien été enregistrée après modification.

4. Tester proprement

Un vote sur votre propre fiche peut être refusé ou ne pas déclencher les mêmes effets. Demandez à un autre utilisateur de voter, ou utilisez un compte de test autorisé. Vérifiez ensuite le salon.

5. Cas particuliers

• Webhook Discord supprimé : recréez-le et remplacez l’URL.
• Rate limit : Discord peut temporairement limiter les envois. Attendez quelques minutes.
• Bot absent du serveur : les récompenses de rôle et certaines annonces nécessitent Botillon dans le serveur.
• Palier : le palier doit être atteint et actif.

6. Contacter le support

Si le webhook fonctionne dans Discord mais pas depuis Botillon, ouvrez un ticket avec :

• l’URL de la fiche ;
• l’heure de l’événement ;
• le type d’événement ;
• une capture du salon et de la configuration (sans l’URL complète du webhook).

Voir aussi

• Webhooks de votes et likes
• Guide : Notifications et webhooks
• Configurer les salons de notification
• Contacter le support