Messagerie

Google Chat

Envoyer les notifications de Dokos dans un espace Google Chat à l'aide d'une URL de webhook entrant.

Google Chat est la messagerie d'équipe de Google Workspace. Pour y envoyer vos notifications, créez un webhook dans un espace Google Chat. Ensuite, créez une URL de webhook entrant dans Dokos et utilisez-la dans une notification.

1. Créer le webhook dans Google Chat

Il faut un compte Google Workspace.

Les webhooks se configurent depuis un navigateur, pas depuis l'application mobile Chat.

  1. Ouvrez Google Chat (ou Chat dans Gmail).
  2. Si l'espace n'existe pas encore, cliquez sur Nouveau chat, puis sur Créer un espace. Saisissez son nom, puis cliquez sur Créer.
  3. Dans l'espace, cliquez sur la flèche à côté de son nom, puis sur Applications et intégrations.
  4. Cliquez sur Ajouter des webhooks. Si le bouton est grisé, l'administrateur de votre organisation n'autorise pas les webhooks.
  5. Saisissez un Nom (par exemple « Dokos »), puis cliquez sur Enregistrer.
  6. Cliquez sur Plus, puis sur Copier le lien pour copier l'URL du webhook. Vous la collerez dans Dokos.
Ne partagez pas l'URL du webhook : toute personne qui la connaît peut publier dans l'espace.

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 Google Chat.
  4. Dans le champ URL du webhook, collez l'URL copiée dans Google Chat. 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 une ligne Lien vers le document à la fin du 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 Google Chat. Si Google 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 Google Chat.

  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 Google Chat 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 Google Chat. Seul le Message est envoyé.
  2. Editeur : « Markdown » par défaut. Dokos envoie le texte tel quel, après le rendu Jinja. Google Chat interprète ensuite la mise en forme.
  3. Message : saisissez le texte. Utilisez les champs du document avec Jinja, par exemple {{ doc.customer }}.

Google Chat 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

  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 société Atelier Lumière veut prévenir son équipe support dans Google Chat à chaque nouveau ticket.

  1. Elle crée l'URL de webhook entrant « Support Google Chat », service « Google Chat », pour le canal Support.
  2. Elle crée la notification « Nouveau ticket » :
    • Canal : « Outil de collaboration externe » ;
    • URL de webhook entrant de l'outil de collaboration : « Support Google Chat » ;
    • Type de document : « Ticket » ;
    • Envoyer une alerte lors de l'événement : « Nouveau·elle » ;
    • Sujet : Nouveau ticket {{ doc.name }}.
  3. 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.