Rocket.Chat
Pour envoyer vos notifications dans un canal Rocket.Chat, créez un webhook entrant dans Rocket.Chat. Ensuite, créez une URL de webhook entrant dans Dokos et utilisez-la dans une notification.
1. Créer le webhook dans Rocket.Chat
Il faut un compte administrateur sur votre serveur Rocket.Chat. Vous pouvez aussi démarrer sur https://rocket.chat/get-started.
- Dans Rocket.Chat, ouvrez Manage > Workspace > Integrations.
- Cliquez sur New, puis sur l'onglet Incoming.
- Activez l'intégration et saisissez son Name.
- Dans Post to Channel, saisissez le canal qui recevra les messages (par exemple
#ventes). - Dans Post as, saisissez l'utilisateur qui publiera les messages.
- Cliquez sur Save, puis copiez l'URL du webhook. Vous la collerez dans Dokos.
Dokos envoie un champ text et, si le lien est activé, une pièce jointe (attachments). Ce format suit le schéma « Post Message » des webhooks entrants de Rocket.Chat : aucun script n'est nécessaire, laissez Script Enabled désactivé. Activez un script seulement si vous voulez transformer le message.
2. Créer l'URL de webhook entrant dans Dokos
Seul le rôle System Manager peut créer une URL de webhook entrant.
- Ouvrez la liste URL de webhook entrant (
/desk/incoming-webhook-url). Vous pouvez aussi la chercher avec Ctrl+K.

- Cliquez sur Créer.
- Saisissez le Nom (obligatoire). Ce nom identifie l'URL dans les notifications.
- Dans le champ Service, sélectionnez Rocket.Chat.
- Dans le champ URL du webhook, collez l'URL copiée dans Rocket.Chat. L'URL doit commencer par
http://ouhttps://. - La case Ajouter un lien vers le document est cochée par défaut. Dokos ajoute une pièce jointe Lien vers le document au message.
- 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 Rocket.Chat. Si Rocket.Chat 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 Rocket.Chat.
- Ouvrez la liste Notification (
/desk/notification). Vous pouvez aussi la chercher avec Ctrl+K.

- Cliquez sur Créer, puis saisissez le Nom de la notification.
- La case Activé est cochée par défaut. Décochez-la pour suspendre la notification.
- Dans la section Canal d'envoi, sélectionnez le Canal Outil de collaboration externe. Le canal par défaut est « Email ».
- Dans le champ URL de webhook entrant de l'outil de collaboration (obligatoire), sélectionnez l'URL créée à l'étape précédente.
- 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 Rocket.Chat lié au webhook.

Événement déclencheur
- Type de document : sélectionnez le type de document surveillé.
- 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 ».
- Type de condition : choisissez « Python » (par défaut) ou « Filtres ».
- 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
- Sujet (obligatoire) : saisissez un sujet. Vous pouvez utiliser Jinja, par exemple
{{ doc.name }}. Dokos n'envoie pas le sujet dans Rocket.Chat. Seul le Message est envoyé. - Editeur : « Markdown » par défaut. Dokos envoie le texte tel quel, après le rendu Jinja. Rocket.Chat interprète ensuite la mise en forme.
- 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
- Enregistrez la notification.
- 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.
- Cliquez sur Actions > Tester cette notification.
- 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 société Atelier Lumière veut prévenir son équipe support dans Rocket.Chat à chaque nouveau ticket.
- Elle crée l'URL de webhook entrant « Support Rocket.Chat », service « Rocket.Chat », pour le canal
#support. - Elle crée la notification « Nouveau ticket » :
- Canal : « Outil de collaboration externe » ;
- URL de webhook entrant de l'outil de collaboration : « Support Rocket.Chat » ;
- Type de document : « Ticket » ;
- Envoyer une alerte lors de l'événement : « Nouveau·elle » ;
- Sujet :
Nouveau ticket {{ doc.name }}.
- Elle saisit ce Message :
**Nouveau ticket {{ doc.name }}**
- Client : {{ doc.customer }}
- Sujet : {{ doc.subject }}
Quand le client « Boulangerie Martin » ouvre un ticket, le message apparaît dans #support, avec le lien vers le ticket.