2015年10月30日 星期五

ChatWork 表示法

  • このエントリーをはてなブックマークに追加

ChatWork 表示法

關於表示法

在 ChatWork 內有一套專屬在訊息、工作及描述欄位內使用的表示法。
您可以運用這套表示法讓資訊更容易閱覽,也能夠活用 To 或是回覆等等功能。
ChatWork 的表示法使用 [ ]方括號來標記、就如同 HTML 語法使用< >來做標記一般。
其標示法分為這種單獨標記的方式[tagname:value][tagname attr=value]以及[tagname]...[/tagname]這樣的包圍在起始標記及終止標記方式。
在以下表示法說明中,使用{ }符號標記例如{account_id}{room_id}這種標記方式可以用來表示帳號ID或是 room ID 等等資料。而...則用來表示任意文字。

To






[To:{account_id}]
To為一個可以指定對象來傳送訊息的功能。
收到To訊息的成員的介面訊息背景會變色,和未讀訊息的數量也會分開表示,這麼一來訊息可以立刻被查覺,不容易遺漏。
To標籤只會表示To的標籤以及訊息傳送對象的大頭照,而且旁邊會自動標記名字,使用起來非常方便。範例:[To:123] 山田
您可以在一封訊息內複數標記TO標籤,也就是說您可以一次傳TO訊息給多人。

回覆





[rp aid={account_id} to={room_id}-{message_id}]
回覆和To有些類似,但回覆功能主要為回覆指定訊息。
在 ChatWork 上點擊「RE」圖示,便可查看所回覆的訊息內容。

引用









[qt][qtmeta aid={account_id} time={timestamp}]...[/qt]
可以引用指定的文章。
參數 aid 請填入欲引用文章之發佈者的帳號 account_id 以及該訊息發佈時間 (請使用 Unix 時間格式填入)。
[qt][qtmeta aid={account_id}]...[/qt]
此外,如上所示 time 可以省略。若省略將不會顯示該訊息引用的發佈時間。

資訊






[info]...[/info]
若使用資訊標籤,訊息將會加上框線呈現比較特別的訊息格式。適合使用於發佈系統公告訊息。

資訊 + 







[info][title]...[/title]...[/info]
也可以為資訊標籤加入標題。

分隔線





[hr]
可以在訊息中加上水平的分隔線使資料更容易閱覽,資訊標籤內也可使用。

顯示帳號的頭像





[picon:{account_id}]
可可以顯示指定帳號的個人大頭像。

顯示帳號的大頭像 + 名字





[piconname:{account_id}]
可以顯示指定帳號的個人大頭像及名字。
【相關資料】
API認證方法
Endpoints (資料傳輸接點)
ChatWork API 的 Endpoints 項目
ChatWork表示法
RAML
  • このエントリーをはてなブックマークに追加