[{"data":1,"prerenderedAt":340},["ShallowReactive",2],{"\u002Fnext\u002Fdodock\u002Fintegrations\u002Fnotification-webhook-url":3,"section:\u002Fnext\u002Fdodock\u002Fintegrations\u002Fnotification-webhook-url":339},{"id":4,"title":5,"body":6,"description":326,"extension":327,"meta":328,"navigation":329,"path":335,"seo":336,"stem":337,"__hash__":338},"docs\u002F2.next\u002F3.dodock\u002F05.integrations\u002Fnotification-webhook-url.md","URL de webhook de notification",{"type":7,"value":8,"toc":314},"minimark",[9,13,21,26,45,49,103,107,113,133,136,140,188,194,198,255,259,266,270,273,306],[10,11,5],"h1",{"id":12},"url-de-webhook-de-notification",[14,15,16,17,20],"p",{},"Le type de document ",[18,19,5],"strong",{}," permet d'envoyer des notifications de documents vers un service de messagerie externe à l'aide d'une URL de webhook entrante. Les services pris en charge sont : Google Chat, Matrix (Hookshot), Mattermost, Rocket.Chat, Slack, Teams, Discord, Ntfy et Raven.",[22,23,25],"h2",{"id":24},"prérequis","Prérequis",[27,28,29,36,42],"ul",{},[30,31,32,33,35],"li",{},"Avoir les droits de création sur le type de document ",[18,34,5],{},".",[30,37,38,39,35],{},"Pour envoyer un message de test depuis le formulaire, avoir le rôle ",[18,40,41],{},"Responsable système",[30,43,44],{},"Disposer de l'URL de webhook entrant fournie par le service concerné (par exemple un webhook de canal Slack ou un connecteur entrant Teams).",[22,46,48],{"id":47},"créer-une-url-de-webhook-de-notification","Créer une URL de webhook de notification",[50,51,52,62,100],"ol",{},[30,53,54,55,57,58,61],{},"Ouvrez la liste ",[18,56,5],{}," (espace de travail ",[18,59,60],{},"Intégrations",", ou recherche Ctrl+K).",[30,63,64,65],{},"Renseignez les champs suivants :\n",[27,66,67,73,79,94],{},[30,68,69,72],{},[18,70,71],{},"Nom"," : nom du webhook, obligatoire ;",[30,74,75,78],{},[18,76,77],{},"Service"," : service destinataire, obligatoire. « Slack » est proposé par défaut. Les services disponibles sont : Google Chat, Matrix (Hookshot), Mattermost, Rocket.Chat, Slack, Teams, Discord, Ntfy et Raven ;",[30,80,81,84,85,89,90,93],{},[18,82,83],{},"URL du webhook"," : obligatoire. Les espaces situées en début et en fin d'URL sont supprimées à l'enregistrement. L'URL doit être une URL ",[86,87,88],"code",{},"http"," ou ",[86,91,92],{},"https"," valide et comporter un hôte, sinon l'enregistrement est refusé ;",[30,95,96,99],{},[18,97,98],{},"Afficher le lien vers le document"," : cochée par défaut. Lorsqu'elle est cochée, un lien vers le document concerné est ajouté au message envoyé.",[30,101,102],{},"Enregistrez le document.",[22,104,106],{"id":105},"envoyer-un-message-de-test","Envoyer un message de test",[14,108,109,110,112],{},"Sur le formulaire d'un webhook enregistré, le bouton ",[18,111,106],{},", réservé aux responsables système, ouvre une boîte de dialogue :",[27,114,115,121,127],{},[30,116,117,120],{},[18,118,119],{},"Message"," : texte à envoyer, « Message de test » par défaut, obligatoire ;",[30,122,123,126],{},[18,124,125],{},"Type de document de référence"," : type de document de référence, pré-rempli avec le type de document courant, obligatoire ;",[30,128,129,132],{},[18,130,131],{},"Nom de la référence"," : nom du document de référence, pré-rempli avec le nom du document courant, obligatoire.",[14,134,135],{},"Un envoi réussi affiche le message « Message de test envoyé ». Si le service refuse le message, l'erreur correspondante est affichée.",[22,137,139],{"id":138},"configurer-une-notification-avec-le-canal-webhook","Configurer une notification avec le canal Webhook",[50,141,142,148,158,164,178,185],{},[30,143,144,145,35],{},"Créez ou ouvrez une ",[18,146,147],{},"Notification",[30,149,150,151,154,155,35],{},"Dans le champ ",[18,152,153],{},"Canal",", sélectionnez ",[18,156,157],{},"Webhook",[30,159,160,161,163],{},"Renseignez le champ ",[18,162,5],{}," : il est obligatoire pour ce canal et fait le lien avec le webhook créé précédemment.",[30,165,166,167,170,171,173,174,177],{},"Saisissez le ",[18,168,169],{},"Sujet",", obligatoire si aucun modèle d'e-mail n'est sélectionné, et le ",[18,172,119],{},". Pour le canal Webhook, le type de message est automatiquement ",[18,175,176],{},"Markdown"," et n'est pas modifiable.",[30,179,180,181,184],{},"Aucun destinataire n'est à renseigner : la section ",[18,182,183],{},"Destinataires"," est masquée pour ce canal, l'envoi s'effectue via le webhook.",[30,186,187],{},"Enregistrez la notification.",[14,189,190,191,193],{},"Au déclenchement de la notification, le message est rendu puis envoyé au service configuré. Les messages rédigés avec l'éditeur de blocs (Block Editor) sont pris en charge. Si l'option ",[18,192,98],{}," est cochée, le message comporte un lien vers le document concerné.",[22,195,197],{"id":196},"comportement-selon-les-services","Comportement selon les services",[27,199,200,210,216,226,236,242],{},[30,201,202,205,206,209],{},[18,203,204],{},"Slack"," : le message est envoyé dans le champ ",[86,207,208],{},"text"," ; l'option de lien ajoute un bouton « Voir le document ».",[30,211,212,215],{},[18,213,214],{},"Teams"," : le message est mis en forme sous forme de carte adaptative (Adaptive Card).",[30,217,218,221,222,225],{},[18,219,220],{},"Discord"," et ",[18,223,224],{},"Raven"," : le message est tronqué à 2 000 caractères si nécessaire, une entrée est alors ajoutée au journal des erreurs. L'avatar et le nom d'expéditeur utilisés sont ceux de l'application.",[30,227,228,231,232,235],{},[18,229,230],{},"Ntfy"," : le message est envoyé en texte brut ; lorsque l'option de lien est cochée, l'en-tête ",[86,233,234],{},"Click"," de la requête pointe vers le document.",[30,237,238,241],{},[18,239,240],{},"Matrix (Hookshot)"," : le lien vers le document est ajouté au message en syntaxe Markdown.",[30,243,244,247,248,221,251,254],{},[18,245,246],{},"Google Chat",", ",[18,249,250],{},"Mattermost",[18,252,253],{},"Rocket.Chat"," : le message est envoyé en texte simple, avec le lien vers le document selon l'option cochée.",[22,256,258],{"id":257},"erreurs-denvoi","Erreurs d'envoi",[14,260,261,262,265],{},"Si le service est injoignable ou répond par une erreur, l'envoi échoue et un détail est consigné dans le ",[18,263,264],{},"Journal des Erreurs"," sous le titre « Impossible d'envoyer la notification par webhook. ». Pour Slack, les causes usuelles sont précisées (canal introuvable, canal archivé, action interdite, service indisponible).",[22,267,269],{"id":268},"migration-des-configurations-existantes","Migration des configurations existantes",[14,271,272],{},"À la mise à jour, les configurations existantes sont migrées automatiquement :",[27,274,275,278,281,296],{},[30,276,277],{},"le type de document « Incoming Webhook URL » (anciennement « Slack Webhook URL ») est renommé en « Notification Webhook URL » ;",[30,279,280],{},"le canal « External Collaboration Tool » des notifications devient « Webhook » ;",[30,282,283,284,287,288,291,292,295],{},"le champ ",[86,285,286],{},"incoming_webhook_url"," (ou ",[86,289,290],{},"slack_webhook_url",") de la notification devient ",[86,293,294],{},"notification_webhook_url"," ;",[30,297,298,299,302,303,35],{},"l'option ",[86,300,301],{},"add_document_link"," du webhook devient ",[86,304,305],{},"show_document_link",[14,307,308,309,89,311,313],{},"Les notifications exportées ou importées depuis d'anciennes versions (canal « Slack » ou « External Collaboration Tool », champs ",[86,310,290],{},[86,312,286],{},") sont automatiquement converties à l'importation.",{"title":315,"searchDepth":316,"depth":317,"links":318},"",1,2,[319,320,321,322,323,324,325],{"id":24,"depth":317,"text":25},{"id":47,"depth":317,"text":48},{"id":105,"depth":317,"text":106},{"id":138,"depth":317,"text":139},{"id":196,"depth":317,"text":197},{"id":257,"depth":317,"text":258},{"id":268,"depth":317,"text":269},"Envoyez des notifications de documents vers Slack, Microsoft Teams, Discord, Matrix et d'autres services grâce aux URL de webhook de notification.","md",{"reviewed":329,"last_verified":330,"sources":331},true,"2026-11-03",[332,333,334],"frappe\u002Fintegrations\u002Fdoctype\u002Fnotification_webhook_url\u002Fnotification_webhook_url.json","frappe\u002Fintegrations\u002Fdoctype\u002Fnotification_webhook_url\u002Fnotification_webhook_url.py","frappe\u002Flocale\u002Ffr.po","\u002Fnext\u002Fdodock\u002Fintegrations\u002Fnotification-webhook-url",{"title":5,"description":326},"2.next\u002F3.dodock\u002F05.integrations\u002Fnotification-webhook-url","TpJTNrFkvupZnzmGDV173njZFkc8UntxD-y5Lkqh5Yk",{},1794701621776]