メッセージ記法について

Chatworkにはメッセージ、タスク、概要内で使える独自のメッセージ記法が存在します。 メッセージ記法を使うことで情報を見やすく表示したり、Toや返信などの機能を利用することができます。

Chatworkのメッセージ記法は、HTMLタグの < > のように [ ] とブラケット(角括弧)文字にてタグ表記され、 単独のタグとして [tagname:value][tagname attr=value] と表記される場合と、[tagname]...[/tagname] のように開始タグと終了タグとで囲む表記があります。

なお、記法の説明のうち、{account_id}{room_id} など { } で囲まれた表記は、 アカウントIDやルームIDなどの対応するデータが入ることを表しており、... は任意の文字列が入ることを表しています。

To

580

[To:{account_id}]

To機能として、相手を指名してメッセージを送信することができます。 指名された相手にはメッセージの背景が強調表示され、未読のToとして数字が未読数とは別にカウント表示されるため、より相手に気付いてもらいやすくなります。

Toタグのみでは、Toという表示と対象者のアイコン画像のみが表示されるため、よりわかりやすく名前も横に併記すると見やすくなります(例: [To:123] 山田さん)。

Toタグはメッセージ内に複数記述することができ、複数人に同時にToを送ることができます。

返信

580

[rp aid={account_id} to={room_id}-{message_id}]

返信はToと同じ意味を持ちますが、特定のメッセージに対する返信であるという情報を持たせることができます。

Chatworkのツール上では、「RE」というアイコンが表示され、そこをクリックすることで返信元のメッセージを表示することができます。

引用

985

[qt][qtmeta aid={account_id} time={timestamp}]...[/qt]

特定の文章を引用として表示できます。パラメータのaidには引用元アカウントのaccount_idを、timeには引用元メッセージのUnix時間(秒)をセットします。

[qt][qtmeta aid={account_id}]...[/qt]

なお、timeは上記のように省略することもできます。その場合は、引用元の日時は表示されません。

インフォメーション

580

[info]...[/info]

インフォメーションタグをつかうと、メッセージを枠線で囲って特別なメッセージであることを表現できます。 システムからのメッセージであることを表現する場合などに便利です。

インフォメーション + タイトル

580

[info][title]...[/title]...[/info]

インフォメーションに、タイトルを入れることができます。

罫線

580

[hr]

メッセージに横の罫線を引くことができます。情報を見やすく区切るのに便利です。インフォメーションタグの中でも使えます。

アカウントのアイコン表示

580

[picon:{account_id}]

特定アカウントのプロフィールアイコンを表示することができます。

アカウントの名前表示

580

[pname:{account_id}]

特定アカウントの名前を表示することができます。

アカウントのアイコン + 名前表示

580

[piconname:{account_id}]

特定アカウントのプロフィールアイコンと名前を表示することができます。

URL

580

[url]http://... または https://...[/url]

URLタグを使うと明示的に外部リンクの範囲を制御できるため、特殊な文字が含まれているURLを外部リンクにすることができます。外部システムとURLで連携する場合などに便利です。