docs: add markdown fields in webhook payloads (#16542)

EdwardAngert · web-flow · commit ade0a53ddbc7 · 2025-02-13T10:35:05.000-05:00
These changes were made in #14931 but didn't make it into the restructured docs Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
diff --git a/docs/admin/monitoring/notifications/slack.md b/docs/admin/monitoring/notifications/slack.md
@@ -89,11 +89,11 @@ To build the server to receive webhooks and interact with Slack:
                return res.status(400).send("Error: request body is missing");
            }
 
-           const { title, body } = req.body;
-           if (!title || !body) {
-               return res
-                   .status(400)
-                   .send('Error: missing fields: "title", or "body"');
+           const { title_markdown, body_markdown } = req.body;
+              if (!title_markdown || !body_markdown) {
+                  return res
+                      .status(400)
+                      .send('Error: missing fields: "title_markdown", or "body_markdown"');
            }
 
            const payload = req.body.payload;
@@ -119,11 +119,11 @@ To build the server to receive webhooks and interact with Slack:
                blocks: [
                    {
                        type: "header",
-                       text: { type: "plain_text", text: title },
+                       text: { type: "mrkdwn", text: title_markdown },
                    },
                    {
                        type: "section",
-                       text: { type: "mrkdwn", text: body },
+                       text: { type: "mrkdwn", text: body_markdown },
                    },
                ],
            };
diff --git a/docs/admin/monitoring/notifications/teams.md b/docs/admin/monitoring/notifications/teams.md
@@ -67,10 +67,10 @@ The process of setting up a Teams workflow consists of three key steps:
                    }
                }
            },
-           "title": {
+           "title_markdown": {
                "type": "string"
            },
-           "body": {
+           "body_markdown": {
                "type": "string"
            }
        }
@@ -108,11 +108,11 @@ The process of setting up a Teams workflow consists of three key steps:
            },
            {
                "type": "TextBlock",
-               "text": "**@{replace(body('Parse_JSON')?['title'], '"', '\"')}**"
+               "text": "**@{replace(body('Parse_JSON')?['title_markdown'], '"', '\"')}**"
            },
            {
                "type": "TextBlock",
-               "text": "@{replace(body('Parse_JSON')?['body'], '"', '\"')}",
+               "text": "@{replace(body('Parse_JSON')?['body_markdown'], '"', '\"')}",
                "wrap": true
            },
            {

Original file line number	Diff line number	Diff line change
`@@ -67,10 +67,10 @@ The process of setting up a Teams workflow consists of three key steps:`
`67`	`67`	`}`
`68`	`68`	`}`
`69`	`69`	`},`
`70`		`- "title": {`
	`70`	`+ "title_markdown": {`
`71`	`71`	`"type": "string"`
`72`	`72`	`},`
`73`		`- "body": {`
	`73`	`+ "body_markdown": {`
`74`	`74`	`"type": "string"`
`75`	`75`	`}`
`76`	`76`	`}`
`@@ -108,11 +108,11 @@ The process of setting up a Teams workflow consists of three key steps:`
`108`	`108`	`},`
`109`	`109`	`{`
`110`	`110`	`"type": "TextBlock",`
`111`		`- "text": "@{replace(body('Parse_JSON')?['title'], '"', '\"')}"`
	`111`	`+ "text": "@{replace(body('Parse_JSON')?['title_markdown'], '"', '\"')}"`
`112`	`112`	`},`
`113`	`113`	`{`
`114`	`114`	`"type": "TextBlock",`
`115`		`- "text": "@{replace(body('Parse_JSON')?['body'], '"', '\"')}",`
	`115`	`+ "text": "@{replace(body('Parse_JSON')?['body_markdown'], '"', '\"')}",`
`116`	`116`	`"wrap": true`
`117`	`117`	`},`
`118`	`118`	`{`