[{"data":1,"prerenderedAt":647},["ShallowReactive",2],{"\u002Fv5\u002Fintegrations\u002Fcommunication\u002Fmattermost":3,"section:\u002Fv5\u002Fintegrations\u002Fcommunication\u002Fmattermost":646},{"id":4,"title":5,"body":6,"description":630,"extension":577,"meta":631,"navigation":632,"path":642,"seo":643,"stem":644,"__hash__":645},"docs\u002F1.v5\u002F4.integrations\u002F11.communication\u002Fmattermost.md","Mattermost",{"type":7,"value":8,"toc":619},"minimark",[9,18,23,45,52,69,75,94,100,114,120,134,140,146,152,156,163,176,182,235,241,255,259,262,272,278,322,329,335,340,366,369,396,402,405,434,441,447,451,457,463,467,493,496,502,512,518,522,525,573,609,615],[10,11,12,13,17],"p",{},"Pour envoyer vos notifications dans un canal Mattermost, créez un webhook entrant dans Mattermost. Ensuite, créez une ",[14,15,16],"strong",{},"URL de webhook entrant"," dans Dokos et utilisez-la dans une notification.",[19,20,22],"h2",{"id":21},"_1-créer-le-webhook-dans-mattermost","1. Créer le webhook dans Mattermost",[24,25,26,42],"ol",{},[27,28,29,30,41],"li",{},"Connectez-vous à votre espace Mattermost. Vous pouvez aussi créer un compte sur ",[14,31,32,37],{},[33,34],"a",{"href":35,"target":36},"https:\u002F\u002Fmattermost.com\u002F","_blank",[33,38,35],{"href":35,"rel":39},[40],"nofollow",".",[27,43,44],{},"Allez sur les canaux de chat",[10,46,47],{},[48,49],"img",{"alt":50,"src":51},"liste_canaux.png","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fliste-canaux.png",[24,53,55],{"start":54},3,[27,56,57,58,61,62,65,66,41],{},"Ajoutez un ",[14,59,60],{},"nouveau canal",", en cliquant en haut sur le ",[14,63,64],{},"+",", puis sur ",[14,67,68],{},"Créer un nouveau canal",[10,70,71],{},[48,72],{"alt":73,"src":74},"ajouter_un_espace.png","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fajouter-un-espace.png",[24,76,78,84],{"start":77},4,[27,79,80,81],{},"Indiquez le ",[14,82,83],{},"nom du canal",[27,85,86,87,90,91],{},"Allez sur gestion des intégrations en cliquant sur le ",[14,88,89],{},"menu en haut à gauche"," et sélectionnez ",[14,92,93],{},"Intégrations",[10,95,96],{},[48,97],{"alt":98,"src":99},"retour_aux_intégrations.png","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fretour-aux-integrations.png",[24,101,103,109],{"start":102},6,[27,104,105,106,41],{},"Cliquez sur ",[14,107,108],{},"Webhooks entrants",[27,110,57,111],{},[14,112,113],{},"nouveau Webhook entrant",[10,115,116],{},[48,117],{"alt":118,"src":119},"ajouter_url.png","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fajouter-url.png",[24,121,123],{"start":122},8,[27,124,125,126,129,130,133],{},"Donnez un ",[14,127,128],{},"nom"," à votre nouveau Webhook entrant et ",[14,131,132],{},"sélectionnez le canal"," qui recevra le webhook.",[10,135,136],{},[48,137],{"alt":138,"src":139},"validation_url.png","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fvalidation-url.png",[24,141,143],{"start":142},9,[27,144,145],{},"Copiez l'URL du webhook. Vous la collerez dans Dokos.",[10,147,148],{},[48,149],{"alt":150,"src":151},"copier_url.png","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fcopier-url.png",[19,153,155],{"id":154},"_2-créer-lurl-de-webhook-entrant-dans-dokos","2. Créer l'URL de webhook entrant dans Dokos",[10,157,158,159,162],{},"Seul le rôle ",[14,160,161],{},"System Manager"," peut créer une URL de webhook entrant.",[24,164,165],{},[27,166,167,168,170,171,175],{},"Ouvrez la liste ",[14,169,16],{}," (",[172,173,174],"code",{},"\u002Fdesk\u002Fincoming-webhook-url","). Vous pouvez aussi la chercher avec Ctrl+K.",[10,177,178],{},[48,179],{"alt":180,"src":181},"Liste « URL de webhook entrant », vide, avec le bouton « Créer ».","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fliste-webhook.png",[24,183,185,190,197,206,219,230],{"start":184},2,[27,186,105,187,41],{},[14,188,189],{},"Créer",[27,191,192,193,196],{},"Saisissez le ",[14,194,195],{},"Nom"," (obligatoire). Ce nom identifie l'URL dans les notifications.",[27,198,199,200,203,204,41],{},"Dans le champ ",[14,201,202],{},"Service",", sélectionnez ",[14,205,5],{},[27,207,199,208,211,212,215,216,41],{},[14,209,210],{},"URL du webhook",", collez l'URL copiée dans Mattermost. L'URL doit commencer par ",[172,213,214],{},"http:\u002F\u002F"," ou ",[172,217,218],{},"https:\u002F\u002F",[27,220,221,222,225,226,229],{},"La case ",[14,223,224],{},"Ajouter un lien vers le document"," est cochée par défaut. Dokos ajoute une ligne ",[14,227,228],{},"Lien vers le document"," à la fin du message.",[27,231,105,232,41],{},[14,233,234],{},"Enregistrer",[10,236,237],{},[48,238],{"alt":239,"src":240},"Formulaire « URL de webhook entrant » : Nom, Service Mattermost, URL du webhook et case « Ajouter un lien vers le document ».","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fcreation-url-entrant.png",[10,242,243,244,247,248,251,252,254],{},"Pour vérifier l'URL, cliquez sur ",[14,245,246],{},"Envoyer"," dans le formulaire enregistré. Saisissez un ",[14,249,250],{},"Message"," (« Test » par défaut), puis cliquez sur ",[14,253,246],{},". Le message doit apparaître dans Mattermost. Si Mattermost refuse le message, Dokos affiche le code d'erreur reçu.",[19,256,258],{"id":257},"_3-créer-la-notification","3. Créer la notification",[10,260,261],{},"La notification indique quel événement envoie un message dans Mattermost.",[24,263,264],{},[27,265,167,266,170,269,175],{},[14,267,268],{},"Notification",[172,270,271],{},"\u002Fdesk\u002Fnotification",[10,273,274],{},[48,275],{"alt":276,"src":277},"Liste des notifications avec les colonnes Sujet, Statut, Canal, Type de document et Envoyer une alerte lors de l'événement.","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fliste-notification.png",[24,279,280,288,294,309,315],{"start":184},[27,281,105,282,284,285,287],{},[14,283,189],{},", puis saisissez le ",[14,286,195],{}," de la notification.",[27,289,221,290,293],{},[14,291,292],{},"Activé"," est cochée par défaut. Décochez-la pour suspendre la notification.",[27,295,296,297,300,301,304,305,308],{},"Dans la section ",[14,298,299],{},"Canal d'envoi",", sélectionnez le ",[14,302,303],{},"Canal"," ",[14,306,307],{},"Outil de collaboration externe",". Le canal par défaut est « Email ».",[27,310,199,311,314],{},[14,312,313],{},"URL de webhook entrant de l'outil de collaboration"," (obligatoire), sélectionnez l'URL créée à l'étape précédente.",[27,316,317,318,321],{},"Cochez ",[14,319,320],{},"Envoyer une notification système"," si la notification doit aussi apparaître dans le panneau des notifications de Dokos.",[10,323,324,325,328],{},"Avec ce canal, la section ",[14,326,327],{},"Destinataires"," n'apparaît pas. Le message va dans le canal Mattermost lié au webhook.",[10,330,331],{},[48,332],{"alt":333,"src":334},"Haut d'une nouvelle notification : section « Canal d'envoi » avec le canal « Outil de collaboration externe » et le champ « URL de webhook entrant de l'outil de collaboration ».","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fdetails-notification.png",[336,337,339],"h3",{"id":338},"événement-déclencheur","Événement déclencheur",[24,341,342,348,354,360],{},[27,343,344,347],{},[14,345,346],{},"Type de document"," : sélectionnez le type de document surveillé.",[27,349,350,353],{},[14,351,352],{},"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 ».",[27,355,356,359],{},[14,357,358],{},"Type de condition"," : choisissez « Python » (par défaut) ou « Filtres ».",[27,361,362,365],{},[14,363,364],{},"Conditions"," : saisissez une condition facultative. La notification part seulement si la condition est vraie.",[10,367,368],{},"Exemples de conditions Python, une par notification :",[370,371,376],"pre",{"className":372,"code":373,"language":374,"meta":375,"style":375},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","doc.status == \"Open\"\ndoc.due_date == nowdate()\ndoc.grand_total > 40000\n","python","",[172,377,378,386,391],{"__ignoreMap":375},[379,380,383],"span",{"class":381,"line":382},"line",1,[379,384,385],{},"doc.status == \"Open\"\n",[379,387,388],{"class":381,"line":184},[379,389,390],{},"doc.due_date == nowdate()\n",[379,392,393],{"class":381,"line":54},[379,394,395],{},"doc.grand_total > 40000\n",[10,397,398],{},[48,399],{"alt":400,"src":401},"Section « Événement déclencheur » d'une notification : Type de document, Envoyer une alerte lors de l'événement, Type de condition et Conditions.","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Ffiltres-notification.png",[336,403,250],{"id":404},"message",[24,406,407,420,426],{},[27,408,409,412,413,416,417,419],{},[14,410,411],{},"Sujet"," (obligatoire) : saisissez un sujet. Vous pouvez utiliser Jinja, par exemple ",[172,414,415],{},"{{ doc.name }}",". Dokos n'envoie pas le sujet dans Mattermost. Seul le ",[14,418,250],{}," est envoyé.",[27,421,422,425],{},[14,423,424],{},"Editeur"," : « Markdown » par défaut. Dokos envoie le texte tel quel, après le rendu Jinja. Mattermost interprète ensuite la mise en forme.",[27,427,428,430,431,41],{},[14,429,250],{}," : saisissez le texte. Utilisez les champs du document avec Jinja, par exemple ",[172,432,433],{},"{{ doc.customer }}",[10,435,436,437,440],{},"Le champ ",[14,438,439],{},"Modèle d'email"," n'apparaît que pour le canal « Email ».",[10,442,443],{},[48,444],{"alt":445,"src":446},"Section « Message » d'une notification : Sujet, Editeur et Message.","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fmessage-notification.png",[336,448,450],{"id":449},"modifier-une-propriété-après-la-notification","Modifier une propriété après la notification",[10,452,453,454,41],{},"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 ",[14,455,456],{},"Valeur à définir",[10,458,459],{},[48,460],{"alt":461,"src":462},"Section « Modifier une propriété après la notification » avec le champ « Valeur à définir ».","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fmodifier-une-propriete.png",[336,464,466],{"id":465},"tester-la-notification","Tester la notification",[24,468,469,472,478,487],{},[27,470,471],{},"Enregistrez la notification.",[27,473,105,474,477],{},[14,475,476],{},"Aperçu"," pour voir le sujet et le message rendus pour un document. L'aperçu indique aussi si le document remplit les conditions.",[27,479,105,480,483,484,41],{},[14,481,482],{},"Actions"," > ",[14,485,486],{},"Tester cette notification",[27,488,489,490,41],{},"Sélectionnez un document, puis cliquez sur ",[14,491,492],{},"Envoyer une notification",[10,494,495],{},"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.",[10,497,498],{},[48,499],{"alt":500,"src":501},"Menu « Actions » d'une notification enregistrée, avec l'option « Tester cette notification ».","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Ftester-notification.png",[10,503,504,505,170,508,511],{},"Si l'envoi échoue, Dokos enregistre l'erreur « Failed to send Notification » dans le ",[14,506,507],{},"Journal des Erreurs",[172,509,510],{},"\u002Fdesk\u002Ferror-log",").",[10,513,514],{},[48,515],{"alt":516,"src":517},"Message de notification reçu dans Mattermost.","\u002Fimages\u002Fintegrations\u002Fcommunication\u002Fverification-mattermost.png",[19,519,521],{"id":520},"exemple-fictif","Exemple fictif",[10,523,524],{},"La société Atelier Lumière veut prévenir son équipe support dans Mattermost à chaque nouveau ticket.",[24,526,527,533,567],{},[27,528,529,530,41],{},"Elle crée l'URL de webhook entrant « Support Mattermost », service « Mattermost », pour le canal ",[172,531,532],{},"support",[27,534,535,536],{},"Elle crée la notification « Nouveau ticket » :\n",[537,538,539,544,549,554,559],"ul",{},[27,540,541,543],{},[14,542,303],{}," : « Outil de collaboration externe » ;",[27,545,546,548],{},[14,547,313],{}," : « Support Mattermost » ;",[27,550,551,553],{},[14,552,346],{}," : « Ticket » ;",[27,555,556,558],{},[14,557,352],{}," : « Nouveau·elle » ;",[27,560,561,563,564,41],{},[14,562,411],{}," : ",[172,565,566],{},"Nouveau ticket {{ doc.name }}",[27,568,569,570,572],{},"Elle saisit ce ",[14,571,250],{}," :",[370,574,578],{"className":575,"code":576,"language":577,"meta":375,"style":375},"language-md shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","**Nouveau ticket {{ doc.name }}**\n- Client : {{ doc.customer }}\n- Sujet : {{ doc.subject }}\n","md",[172,579,580,592,602],{"__ignoreMap":375},[379,581,582,586,589],{"class":381,"line":382},[379,583,585],{"class":584},"sHepR","**",[379,587,566],{"class":588},"so75L",[379,590,591],{"class":584},"**\n",[379,593,594,598],{"class":381,"line":184},[379,595,597],{"class":596},"sMK4o","-",[379,599,601],{"class":600},"sTEyZ"," Client : {{ doc.customer }}\n",[379,603,604,606],{"class":381,"line":54},[379,605,597],{"class":596},[379,607,608],{"class":600}," Sujet : {{ doc.subject }}\n",[10,610,611,612,614],{},"Quand le client « Boulangerie Martin » ouvre un ticket, le message apparaît dans ",[172,613,532],{},", avec le lien vers le ticket.",[616,617,618],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHepR, html code.shiki .sHepR{--shiki-light:#39ADB5;--shiki-light-font-weight:bold;--shiki-default:#89DDFF;--shiki-default-font-weight:bold;--shiki-dark:#89DDFF;--shiki-dark-font-weight:bold}html pre.shiki code .so75L, html code.shiki .so75L{--shiki-light:#E53935;--shiki-light-font-weight:bold;--shiki-default:#F07178;--shiki-default-font-weight:bold;--shiki-dark:#F07178;--shiki-dark-font-weight:bold}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":375,"searchDepth":382,"depth":184,"links":620},[621,622,623,629],{"id":21,"depth":184,"text":22},{"id":154,"depth":184,"text":155},{"id":257,"depth":184,"text":258,"children":624},[625,626,627,628],{"id":338,"depth":54,"text":339},{"id":404,"depth":54,"text":250},{"id":449,"depth":54,"text":450},{"id":465,"depth":54,"text":466},{"id":520,"depth":184,"text":521},"Envoyer les notifications de Dokos dans un canal Mattermost à l'aide d'une URL de webhook entrant.",{"reviewed":632,"last_verified":633,"sources":634},true,"2026-11-04",[635,636,637,638,639,640,641],"apps\u002Ffrappe\u002Ffrappe\u002Fintegrations\u002Fdoctype\u002Fincoming_webhook_url\u002Fincoming_webhook_url.json (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Fintegrations\u002Fdoctype\u002Fincoming_webhook_url\u002Fincoming_webhook_url.py (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Fintegrations\u002Fdoctype\u002Fincoming_webhook_url\u002Fincoming_webhook_url.js (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Femail\u002Fdoctype\u002Fnotification\u002Fnotification.json (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Femail\u002Fdoctype\u002Fnotification\u002Fnotification.py (v5-dev, send_an_external_collaboration_tool_msg, send_test_notification)","apps\u002Ffrappe\u002Ffrappe\u002Femail\u002Fdoctype\u002Fnotification\u002Fnotification.js (v5-dev)","apps\u002Ffrappe\u002Ffrappe\u002Flocale\u002Ffr.po (v5-dev)","\u002Fv5\u002Fintegrations\u002Fcommunication\u002Fmattermost",{"title":5,"description":630},"1.v5\u002F4.integrations\u002F11.communication\u002Fmattermost","m69KwRkkhSOc8ZQUaL6H_L8jZzEjnpcfXwlVcXni8Kc",{},1794814061661]