メッセージ送信 (buttonTemplate)

トーク Bot を使ってボタンテンプレートを送信します。

メンバーがボタンを押すと、ボタンラベルのテキストと postback で指定したメッセージが Bot 受信サーバーに送信されます。メッセージの形式については メッセージ受信 - Callback 形式を参照してください。

ボタンテンプレートは多言語に対応しており、メンバーの言語設定に合わせて表示を切り替えることができます。

ボタンテンプレートの構成は下図の通りです。

参考

• ボタンテンプレートのボタンは最大 10 個まで登録できます。

API の種類

サーバー API

Request URL

https://apis.worksmobile.com/r/{API ID}/message/v1/bot/{botNo}/message/push

HTTP Method

POST(Content-Type: application/json; charset=UTF-8)

Request Content

パラメーター	タイプ	必須	説明
type	string	Y	"button_template"
contentText	string	Y	本文の内容
i18nContentTexts[]	array	N	多言語の本文リスト
i18nContentTexts[].language	string	Y	言語コード ●ja_JP ●ko_KR ●zh_CN ●zh_TW ●en_US
i18nContentTexts[].contentText	string	Y	本文の内容 最大 1,000 字
actions	array<Action Object>	Y	ボタンリスト

Request Example

{
  "accountId": "admin@example.com",    
  "content": {
    "type": "button_template",
    "contentText": "What do you want?",
    "actions": [{
      "type": "uri",
      "label": "WorksMobile Homepage",
      "uri": "https://line.worksmobile.com"
    }, {
      "type": "message",
      "label": "FAQ",
      "postback": "ButtonTemplate_FAQ"
    }]
  }
}

Response

呼び出しに成功すると HTTP 200 コードを返します。

Error Code

呼び出しに失敗するとエラーコードとエラーメッセージを返します。
エラーコードはトーク Bot REST API エラーコードを参照してください。