【Teams】Incoming Webhookでメンションを付けて個人宛に通知する

やりたいこと

Incoming Webhookを用いてTeamsに投稿を行う際、メッセージの中にメンションを含めて特定の個人に通知したい。

前提

function createPostContent(memberName) {
  return {
    type: "message",
    attachments: [
      {
        contentType: "application/vnd.microsoft.card.adaptive",
        content: {
          type: "AdaptiveCard",
          body: [
            {
              type: "TextBlock",
              text: `Hello ${memberName}.`,
            },
          ],
          $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
          version: "1.0",
        },
      },
    ],
  };
}

今回は例として、上記のようなシンプルなメッセージを送信する場合を想定する。

そもそものIncoming Webhookを利用してのTeamsへの投稿方法に関しては下記の記事にまとめている。 GASとTeamsを連携しWebhookでチャネルに自動通知を行う2023-06-11

解決法

function createPostContent(memberName) {
function createPostContent(memberName, memberEmail) {
  return {
    type: "message",
    attachments: [
      {
        contentType: "application/vnd.microsoft.card.adaptive",
        content: {
          type: "AdaptiveCard",
          body: [
            {
              type: "TextBlock",
              text: `Hello ${memberName}.`,
              text: `Hello <at>${memberName}</at>.`,
            },
          ],
          $schema: "http://adaptivecards.io/schemas/adaptive-card.json",
          version: "1.0",
          msteams: {
            entities: [
              {
                type: "mention",
                text: `<at>${memberName}</at>`,
                mentioned: {
                  id: memberEmail,
                  name: `${memberName}`,
                },
              },
            ],
          },
        },
      },
    ],
  };
}

メンバー名とメールアドレス（Teamsアカウントのもの）を紐付け、<at>でメンバー名を埋め込むことで実現できる。