Slack APIのメッセージのBlock Kitによるレイアウト

Slack APIのメッセージのBlock Kitによるレイアウト

Slack APIのメッセージのレイアウト方法を調べると、まだまだ古い仕様での解説のものがたくさん出てくる状態ですので、Block Kitによるレイアウト方法のHow Toと困ったことのメモです。

仕様などの情報は公式ドキュメントを見ます。
古い仕様からの移行方法も参考にしたアプリなどからレイアウトを起こす場合に必要になったりもするでしょう。

カラーバーは使わないようにする

メッセージの横に色付きの棒が置かれているものをCIやアラート系アプリで良く見ます。

これはBlock Kitでは添付ファイル系で利用するAttachmentでしか利用できません。
Attachmentは通常のMessageとは違い、長いコンテンツは折り畳まれて表示されます。
それでも構わない場合はAttachmentを利用しても構わないとは思いますが、Slack自身も例外措置としての利用を説明しているだけで利用には消極的です。

There is one exception, and that's the color parameter, which currently does not have a block alternative. If you are strongly attached (🎺) to the color bar, use the blocks parameter within an attachment.

Messageとは異なる表示になるかもしれませんので利用するのは避けたほうが無難でしょう。（しかしながら2019年にリリースされてもう何年経つのか

マークダウン表記で日本語ドメイン形式の文字列がPunycodeに変換されてしまう

mrkdwnブロックを利用した時に、日本語ドメイン形式の文字列がPunycodeに変換されてしまいます。
サンプルコード

これを避けるにはverbatim属性をtrueに設定します。
サンプルコード