Slack
Pour envoyer vos notifications dans un canal Slack, créez un webhook dans Slack. Ensuite, créez une URL de webhook entrant dans Dokos et utilisez-la dans une notification.
1. Créer le webhook dans Slack
Pour générer des URL de webhook, vous devez créer une nouvelle application Slack :
- Accédez à https://api.slack.com/
- Cliquez sur Créer une application Slack

- Sélectionnez la rubrique De zéro pour créer votre application

- Donnez un nom à votre application et choisissez le bon espace de travail.

- Une fois votre application créée, accédez à la section Webhooks entrants.

- Une fois dans la section des webhooks entrants, cliquez sur Activer les Webhooks entrants

- Allez à la section en bas de page URL de webhook pour votre espace de travail, puis cliquez sur Ajouter un nouveau webhook à l'espace de travail.
- Choisissez le canal Slack qui recevra les notifications. Ce canal doit déjà exister.

- Copiez l'URL du webhook. Vous la collerez dans Dokos.

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 Slack.
- Dans le champ URL du webhook, collez l'URL copiée dans Slack. L'URL doit commencer par
http://ouhttps://. - La case Ajouter un lien vers le document est cochée par défaut. Dokos ajoute un bouton Voir le document sous le 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 Slack. Si Slack 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 Slack.
- 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 Slack 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 Slack. Seul le Message est envoyé. - Editeur : « Markdown » par défaut. Dokos envoie le texte tel quel, après le rendu Jinja. Slack interprète ensuite la mise en forme.
- Message : saisissez le texte. Utilisez les champs du document avec Jinja, par exemple
{{ doc.customer }}.
Slack utilise sa propre syntaxe : *texte* met le texte en gras.
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 Slack à chaque nouveau ticket.
- Elle crée l'URL de webhook entrant « Support Slack », service « Slack », 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 Slack » ;
- 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.