メインコンテンツへスキップ
本 API を呼び出して業務通知メッセージを送信します。

API 呼び出し説明

業務通知メッセージとは、特定のアプリ名義で社員にプッシュされる業務通知メッセージです。例えば誕生日のお祝いや入社のリマインドなどです。テキスト、音声、リンクなどを送信でき、メッセージタイプとサンプルは メッセージ通知タイプ を参照してください。
API の送信が成功したにもかかわらず受信者がメッセージを受け取れない場合は、業務通知メッセージの送信結果取得 を呼び出して結果を確認し、ドキュメント内の戻りエラーコードと照合してください。

利用シーン

重要

  • 適用シーン:通知系メッセージの送信に適しています。承認タスクなどは含みません。
  • 非適用シーン:承認タスクなど、タスク系の通知リマインドを社員に送信する場合、本 API では実現できません。このようなシーンではタスク作成 API をご利用ください。

レート制限

以下の制限回数を超えた場合、API は成功を返しますが、ユーザーは受信できません。

詳しい制限の説明は レート制限 を参照してください。
  • 社内アプリは 1 回の送信で最大 5000 人まで、サードパーティ社内アプリは 1 回の送信で最大 1000 人まで送信できます。
  • 同一社員に対して、1 日に同じ内容のメッセージ通知は 1 件しか送信できません。
  • 社内アプリは 1 人の社員に対して 1 日最大 500 件、サードパーティ社内アプリは最大 100 件のメッセージ通知を送信できます。
  • 社内アプリまたはサードパーティ社内アプリがメッセージを送信する際、1 分間に最大 5000 人がメッセージを受信できます。

リクエスト

クエリパラメータ

リクエストボディ

リクエスト例

Java
Python
PHP
C#

レスポンス

レスポンスボディ

レスポンスボディ例

エラーコード

本 API の呼び出しでエラーが発生した場合、エラーメッセージをもとに グローバルエラーコード ドキュメントで解決策を検索してください。