メッセージ送信 (buttonTemplate)

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

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

    メッセージ送信は多言語に対応しています。
    多言語メッセージはメンバーの言語設定に合わせた表示が適用されます。

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

    図 1 ボタンテンプレートの構成

    参考

    • ボタンテンプレートのボタンは最大 10 個まで登録できます。
    • ボタンテンプレートは v2.2 以降の LINE WORKS アプリケーションで利用できます。

    API の種類

    サーバー API

    Request URL

    https://apis.worksmobile.com/{API ID}/message/sendMessage/v2

    HTTP Method

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

    Request content

    パラメーター タイプ 必須 説明
    type string Y "buttonTemplate" で固定。
    contentText string Y 本文の内容。
    i18nContentTexts[] array N 多言語の本文リスト。
    i18nContentTexts[].language string Y 言語コード。
    ●ko_KR
    ●ja_JP
    ●zh_CN
    ●zh_TW
    ●en_US
    i18nContentTexts[].contentText string Y 本文の内容。
    最大 1,000 字
    buttons array<object> Y ボタンテンプレートで使用するボタン。
    buttons[].text string Y ボタンテキスト。
    buttons[].i18nTexts[] array N 多言語のボタンテキストリスト。
    buttons[].i18nTexts[].language string Y 言語コード。
    ●ko_KR
    ●ja_JP
    ●zh_CN
    ●zh_TW
    ●en_US
    buttons[].i18nTexts[].text string Y ボタンテキスト。
    最大 1,000 字
    buttons[].link string Y ボタンを押した時に遷移する link (link, postback のいずれかを選択)。
    最大 1,000 字
    buttons[].postback string Y ボタンを押した時に渡す postback メッセージ (link, postback のいずれかを選択)。
    最大 1,000 字

    Request Example

    buttonTemplate 예시

    {
      "botNo": 123,
      "accountId": "admin@example.com",    
      "content": {
        "type": "buttonTemplate",
        "contentText": "What do you want?",
        "buttons": [{
          "text": "WorksMobile's Homepage",
          "link": "https://line.worksmobile.com"
        }, {
          "text": "FAQ",
          "postback": "ButtonTemplate_FAQ"
        }]
      }
    }
    

    Response

    呼び出しに成功すると送信結果を返します。

    プロパティ タイプ 説明
    code number ● 200: 成功
    ● 400 番台: クライアントリクエストエラー
    ● 500 番台: 想定外のエラー / サーバー内部エラー
    message string コードについての詳細メッセージ。

    Response Example

    {"code": 200, "message": "OK"}