Bot API

Bot API を利用して、Botからのメッセージ送信やメニューの設定、Botの管理が可能です。

User Account 認証または Service Account 認証 (JWT) で取得した Access Token で利用できます。

Scopes: bot.message, bot, bot.read

Scope の使い分け

• bot.message scope は、Bot のメッセージやメニュー、トークルームに関する API を使用する際に利用できます。Bot 開発においてはこの Scope の利用を推奨します。
• bot scope は、全ての Bot API で有効な Scope です。Bot 作成等を API で行いたい際は、この Scope を利用してください。
• bot.read scope は、読み取り権限のみの Scope です。 どの API でどういった Scope が有効なのかについては、各 API のページをご参照ください。

参考
Bot API を利用する際には、以下の資料も参考にしてください。

• Bot の概要
  • メッセージタイプ
    • Flex Template
  • アクション
    • Callback
  • メニュー

メッセージ {#bot-message}

Bot からのメッセージ送信は以下の API で行います。

注意

• メンバーから送られたメッセージに対する応答と、Bot を起点としたメッセージ送信は、区別されずどちらも同じ「メッセージの送信」として扱われます。

制限

• 参加者が 500 名以上のトークルームへのメッセージ送信は可能ですが、プッシュ通知は動作しません。

画像メッセージやファイルメッセージを送信するためには、以下の API でコンテンツをアップロードする必要があります。

また、メッセージサーバーから画像メッセージやファイルメッセージを受け取った際に、そのコンテンツを取得するためには以下の API を使用します。

メニュー {#bot-menu}

固定メニュー・リッチメニューの管理を以下の API で行うことができます。

メニューの詳細は こちら を参照してください。

固定メニュー {#bot-persistment-menu}

リッチメニュー {#bot-rich-menu}

Bot のトークルーム {#bot-talkroom}

以下の API で、Bot とのトークルームの作成・退室や、参加しているトークルームの情報、メンバーリストを取得できます。

Bot の管理 {#manage-bot}

Bot の追加・編集・削除を以下の API で行うことができます。

Bot の追加プロセスは Bot の概要 > Bot を作成する を参照してください。

LINE WORKS テナント上の Bot 管理 {#manage-tenant-bot}

LINE WORKS ドメイン上の Bot 管理 {#manage-domain-bot}