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