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