このAPIのサポートはまもなく終了します。最新バージョンもしくは他のAPIを利用してください。

    メッセージ送信

    トーク Bot を使って特定のメンバーにメッセージを送信します。

    accountId に LINE WORKS アカウント情報を入力してメッセージを送信します。LINE WORKS アカウント情報はメールアドレスまたはグループ名の形式になってます。

    テンプレート形式により、対応する LINE WORKS アプリケーションのバージョンが異なります。詳細は各テンプレートの説明を確認してください。

    ボタンやリストなどのテンプレートを通じて postback メッセージを利用する場合、受信方法については メッセージ受信 Callback 形式 を参考にしてください。

    各テンプレートの構造は下図の通りです。

    図 1 テンプレートの仕組み

    図 1 テンプレート形式

    注意

    • メンバー数によってクォータ(最大送信数の制限)が設定されています。
      • メンバー数が 100 人以下 : 最大 20,000 回 / 日
      • メンバー数が 100 人超過 : 最大 20,000 回 + (超過するメンバー数)*100 回 / 日
    • クォータは 0 時(GMT +9)にリセットされます。
    • クォータの 80%、90%、100% に到達すると、Developer Console の権限を持つ管理者にサービス通知が送信されます。

    API の種類

    サーバー API

    Request URL

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

    HTTP Method

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

    Request - 共通

    パラメーター タイプ 必須 説明
    botNo number Y メッセージ送信で使用するトーク Bot 番号。
    accountId string N 送信先メンバーのアカウント (roomId, accountId のいずれかを入力)。
    roomId string N 送信先トークルーム ID (roomId, accountId のいずれかを入力)。
    content object Y メッセージの内容。
    ● type "text": "メッセージ送信 (text)" の Request content 参照
    ● type "image": "メッセージ送信 (image)" の Request content 参照
    ● type "link": "メッセージ送信 (link)" の Request content 参照
    ● type "buttonTemplate": "メッセージ送信 (buttonTemplate)" の Request content 参照
    ● type "listTemplate": "メッセージ送信 (listTemplate)" の Request content 参照
    ● type "sticker": "メッセージ送信 (sticker)" の Request content 参照