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