ボット メッセージの書式を設定する

  • [アーティクル]

メッセージの書式設定を使用すると、ボット メッセージを最大限に活用できます。 ボット メッセージを書式設定して、ボタン、テキスト、画像などの対話型要素を含む添付ファイルとしてリッチ カードを含めることができます。

注:

ボット メッセージのサイズ制限は 40 KB です。 ボット メッセージのサイズ制限が 40 KB を超える場合、ボットは状態コード (RequestEntityTooLarge) を受け取ります413。このコードにはエラー コード MessageSizeTooBigが含まれます。 ボット メッセージ サイズの制限には、UTF-16 としてエンコードされたメッセージ ペイロード全体が含まれており、Base64 でエンコードされたイメージは含まれません。

テキスト コンテンツの書式設定

ボット メッセージを書式設定するには、省略可能な TextFormat プロパティを設定して、ボット メッセージのテキスト コンテンツのレンダリング方法を制御できます。

Microsoft Teams では、次の書式設定オプションがサポートされています。

TextFormat 値 説明
plain テキストは、書式設定が適用されていない生のテキストとして扱う必要があります。
markdown テキストは Markdown 形式として扱い、必要に応じてチャネルにレンダリングする必要があります。
xml テキストは単純な XML マークアップです。

Teams では、および または HTML の書式設定タグのmarkdownxmlサブセットがサポートされています。 ボットは、チャネルに投稿されたテキスト メッセージ内の他のユーザーとタグをメンションすることもできます。 詳細については、「 メッセージにメンションを追加する」を参照してください。

現在、書式設定には次の制限が適用されます。

  • テキストのみのメッセージでは、テーブルの書式設定はサポートされていません。
  • リッチ カードでは、タイトルプロパティやサブタイトル プロパティではなく、テキスト プロパティでのみ書式設定がサポートされます。
  • リッチ カードでは、Markdown やテーブルの書式設定はサポートされていません。

テキスト コンテンツを書式設定したら、Teams でサポートされているすべてのプラットフォームで書式設定が機能することを確認します。

クロスプラットフォームのサポート

一部のスタイルは、現在、すべてのプラットフォームでサポートされていません。 次の表に、スタイルの一覧と、テキストのみのメッセージとリッチ カードでサポートされているスタイルを示します。

Style テキストのみのメッセージ リッチ カード - XML のみ
太字 ✔️️ ❌
斜体 ✔️ ✔️
ヘッダー (レベル 1 ~ 3) ❌ ✔️
取り消し線 ❌ ✔️
水平ルーラー ❌ ❌
記号付きリスト ❌ ✔️
番号付きリスト ❌ ✔️
事前書式設定済みのテキスト ✔️ ✔️
Blockquote ✔️ ✔️
Hyperlink ✔️ ✔️
画像リンク ❌ ❌

クロスプラットフォームのサポートを確認した後、個々のプラットフォームによるサポートも利用できることを確認します。

個々のプラットフォームによるサポート

テキストの書式設定のサポートは、メッセージとプラットフォームの種類によって異なります。

テキストのみのメッセージ

次の表に、デスクトップ、iOS、Android でサポートされているスタイルの一覧を示します。

Style Desktop iOS Android
太字 ✔️ ✔️ ✔️
斜体 ✔️ ✔️ ✔️
ヘッダー (レベル 1 ~ 3) ❌ ❌ ❌
取り消し線 ✔️ ✔️ ❌
水平ルーラー ❌ ❌ ❌
記号付きリスト ✔️ ❌ ❌
番号付きリスト ✔️ ❌ ❌
事前書式設定済みのテキスト ✔️ ✔️ ✔️
Blockquote ✔️ ✔️ ✔️
Hyperlink ✔️ ✔️ ✔️
画像リンク ❌ ❌ ❌

カード

カードサポートについては、「カードの書式設定」を参照してください。

次の手順

ボットから送信されたメッセージを更新および削除する

関連項目