URL de webhook entrant
Un webhook entrant est une adresse web fournie par un outil de discussion. Dokos envoie un message à cette adresse quand une notification se déclenche. Par exemple, Dokos peut prévenir une équipe qu'un ticket client est arrivé.
Dans Dokos, chaque adresse est enregistrée dans une URL de webhook entrant. Une notification avec le canal Outil de collaboration externe utilise cette URL.
Créer une URL de webhook entrant
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).
- Dans le champ Service (obligatoire), sélectionnez l'outil : Google Chat, Mattermost, Rocket.Chat, Slack, Discord, Ntfy ou Raven.
- Dans le champ URL du webhook (obligatoire), collez l'URL copiée dans l'outil. L'URL doit commencer par
http://ouhttps://. - La case Ajouter un lien vers le document est cochée par défaut. Elle ajoute au message un lien vers le document concerné.
- Cliquez sur Enregistrer.

Envoyer un message de test
- Dans le formulaire enregistré, cliquez sur Envoyer.
- Saisissez un Message (« Test » par défaut).
- Gardez ou changez le Type de document de référence et le Nom de la référence. Ils servent au lien vers le document.
- Cliquez sur Envoyer.
Si l'outil refuse le message, Dokos affiche le code d'erreur reçu. Pour Slack, Dokos traduit les codes 400, 403, 404, 410 et 500, par exemple « 404: Channel not found ».
Format du message selon le service
| Service | Message envoyé | Lien vers le document |
|---|---|---|
| Slack | Texte du message | Bouton Voir le document |
| Mattermost, Google Chat | Texte du message | Ligne Lien vers le document à la fin du texte |
| Rocket.Chat | Texte du message | Pièce jointe Lien vers le document |
| Discord, Raven | Texte limité à 2000 caractères, avec le nom et le logo de l'application | Encadré Lien vers le document |
| Ntfy | Texte brut | Clic sur la notification Ntfy |
Guides par outil
Exemple fictif
L'association Jardins Partagés utilise Ntfy sur les téléphones de ses bénévoles. Elle crée l'URL de webhook entrant « Alertes bénévoles », service « Ntfy », URL https://ntfy.example.org/jardins. Elle clique sur Envoyer avec le message « Test ». Les bénévoles reçoivent « Test » sur leur téléphone. Elle peut ensuite choisir cette URL dans une notification.