Messagerie

Discord

Envoyer les notifications de Dokos dans un canal Discord à l'aide d'un webhook créé sur votre serveur Discord.

Pour envoyer vos notifications dans un canal Discord, créez un webhook sur votre serveur Discord. Ensuite, créez une URL de webhook entrant dans Dokos et utilisez-la dans une notification.

1. Créer le webhook dans Discord

Pour plus de détails, consultez le guide officiel de Discord.

  1. Ouvrez Discord sur ordinateur (application de bureau ou application web).
  2. Ouvrez les paramètres du serveur qui recevra les notifications.
  3. Cliquez sur Intégrations, puis sur Créer un webhook.
  4. Définissez un nom, une image de profil et le canal qui recevra les notifications.
  5. Cliquez sur Copier l'URL du webhook. Vous la collerez dans Dokos.

Dokos remplace le nom et l'image du webhook. Les messages portent le nom de l'application et son logo, définis dans les Paramètres du Site web. Sans logo, Dokos utilise le logo Dokos.

Discord limite un message à 2000 caractères. Au-delà, Dokos coupe le message et enregistre une entrée dans le Journal des Erreurs.

2. Créer l'URL de webhook entrant dans Dokos

Seul le rôle System Manager peut créer une URL de webhook entrant.

  1. Ouvrez la liste URL de webhook entrant (/desk/incoming-webhook-url). Vous pouvez aussi la chercher avec Ctrl+K.

  1. Cliquez sur Créer.
  2. Saisissez le Nom (obligatoire). Ce nom identifie l'URL dans les notifications.
  3. Dans le champ Service, sélectionnez Discord.
  4. Dans le champ URL du webhook, collez l'URL copiée dans Discord. L'URL doit commencer par http:// ou https://.
  5. La case Ajouter un lien vers le document est cochée par défaut. Dokos ajoute un encadré Lien vers le document sous le message.
  6. Cliquez sur Enregistrer.

Pour vérifier l'URL, cliquez sur Envoyer dans le formulaire enregistré. Saisissez un Message (« Test » par défaut), puis cliquez sur Envoyer. Le message doit apparaître dans Discord. Si Discord refuse le message, Dokos affiche le code d'erreur reçu.

3. Créer la notification

La notification indique quel événement envoie un message dans Discord.

  1. Ouvrez la liste Notification (/desk/notification). Vous pouvez aussi la chercher avec Ctrl+K.

  1. Cliquez sur Créer, puis saisissez le Nom de la notification.
  2. La case Activé est cochée par défaut. Décochez-la pour suspendre la notification.
  3. Dans la section Canal d'envoi, sélectionnez le Canal Outil de collaboration externe. Le canal par défaut est « Email ».
  4. Dans le champ URL de webhook entrant de l'outil de collaboration (obligatoire), sélectionnez l'URL créée à l'étape précédente.
  5. Cochez Envoyer une notification système si la notification doit aussi apparaître dans le panneau des notifications de Dokos.

Avec ce canal, la section Destinataires n'apparaît pas. Le message va dans le canal Discord lié au webhook.

Événement déclencheur

  1. Type de document : sélectionnez le type de document surveillé.
  2. Envoyer une alerte lors de l'événement : choisissez l'événement, par exemple « Nouveau·elle », « Enregistrer », « Valider », « Annuler », « Jours suivants », « Jours précedents » ou « Modification de valeur ».
  3. Type de condition : choisissez « Python » (par défaut) ou « Filtres ».
  4. Conditions : saisissez une condition facultative. La notification part seulement si la condition est vraie.

Exemples de conditions Python, une par notification :

doc.status == "Open"
doc.due_date == nowdate()
doc.grand_total > 40000

Message

  1. Sujet (obligatoire) : saisissez un sujet. Vous pouvez utiliser Jinja, par exemple {{ doc.name }}. Dokos n'envoie pas le sujet dans Discord. Seul le Message est envoyé.
  2. Editeur : « Markdown » par défaut. Dokos envoie le texte tel quel, après le rendu Jinja. Discord interprète ensuite la mise en forme.
  3. Message : saisissez le texte. Utilisez les champs du document avec Jinja, par exemple {{ doc.customer }}.

Le champ Modèle d'email n'apparaît que pour le canal « Email ».

Modifier une propriété après la notification

Cette section est la dernière du formulaire. Elle peut changer un champ du document après l'envoi. Choisissez le champ, puis saisissez la Valeur à définir.

Tester la notification

  1. Enregistrez la notification.
  2. Cliquez sur Aperçu pour voir le sujet et le message rendus pour un document. L'aperçu indique aussi si le document remplit les conditions.
  3. Cliquez sur Actions > Tester cette notification.
  4. Sélectionnez un document, puis cliquez sur Envoyer une notification.

Le test ne vérifie pas les conditions. Il applique aussi la section « Modifier une propriété après la notification », si elle est remplie.

Si l'envoi échoue, Dokos enregistre l'erreur « Failed to send Notification » dans le Journal des Erreurs (/desk/error-log).

Exemple fictif

La boutique en ligne Atelier Lumière veut prévenir son équipe dans Discord à chaque commande du panier d'achat.

  1. Elle crée l'URL de webhook entrant « Discord », service « Discord ».
  2. Elle crée une notification :
    • Canal : « Outil de collaboration externe » ;
    • URL de webhook entrant de l'outil de collaboration : « Discord » ;
    • Type de document : « Commande client » ;
    • Envoyer une alerte lors de l'événement : « Nouveau·elle » ;
    • Conditions : doc.order_type == "Shopping Cart" ;
    • Sujet : Nouvelle commande.
  3. Elle saisit ce Message :
Nouvelle commande **{{ doc.name }}** :
- Client : {{ doc.customer }}
- Montant : {{ doc.grand_total }}

Quand le client « Boulangerie Martin » valide son panier, le message apparaît dans le canal Discord, avec le lien vers la commande.