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