このエンドポイントは廃止されました。

送信SMSメッセージレポートの受信 Webhook

送信するすべてのメッセージについて、配信レポートを受け取るオプションが用意されています。この機能を使用するには、これらのレポートを受信するようにエンドポイントを設定する必要があります。SMS送信時のエンドポイントを指定できます。または、契約管理でエンドポイントURLを設定することもできます。このプロセスについてサポートが必要な場合は、サポート にお問い合わせください。1 回のリクエストでの配信レポートのデフォルト数は 100 です。この値は、サブスクリプション管理APIを使用して「maxBucketSize」を定義することでカスタマイズできます。 このタイプのペイロードは、Send SMS messageSend binary SMS message を使用して送信されたメッセージに対して受信します。

post
https://{yourDomain}/your/webhook/path
Request Body schema:
application/json
すべて折りたたむ -
results
Array of objects
配列
bulkId
string

複数の受信者にメッセージを送信する場合、または 1 つの API 要求を介して複数のメッセージを送信する場合に要求に割り当てられる一意の ID。

messageId
string

一意のメッセージ ID。

to
string

メッセージの宛先アドレス。

from
string

英数字または数字の送信者 ID (例: CompanyName)。

sentAt
string <date-time>

メッセージが スケジュール 送信された日時。形式は 'yyyy-MM-dd'T'HH:mm:ss です。SSSZ' です。

doneAt
string <date-time>

Infobip サービスがメッセージの処理を終了した日時 (つまり、宛先に配信された、宛先ネットワークに配信されたなど)。形式は 'yyyy-MM-dd'T'HH:mm:ss です。SSSZ' です。

smsCount
integer <int32>

メッセージの内容が分割された部分の数。

mccMnc
string

モバイルの国コードとネットワークコード。

callbackData
string

メッセージ送信時に「callbackData」フィールドを介して送信されるコールバックデータ。

price
object

SMS価格を送信しました。

pricePerMessage
number <double>

1 SMSあたりの価格。

currency
string

価格を表す通貨。

status
object

メッセージの status と、エラーが発生した場合の回復方法を示します。

groupId
integer <int32>

ステータス グループ ID。

groupName
string

ステータスコードが属するカテゴリを説明するステータスグループ名(例:PENDING、UNDELIVERABLE、DELIVERED、EXPIRED、REJECTED)。

id
integer <int32>

ステータス ID。

name
description
string

人間が判読できる状態の説明。

action
string

エラーから回復するために実行する必要があるアクション。

error
object

クエリの実行中にエラーが発生したかどうかを示します。

groupId
integer <int32>

エラー・グループ ID。

groupName
string

エラー・グループ名。

id
integer <int32>

エラー ID。

name
string

エラー名。

description
string

人間が判読できるエラーの説明..

permanent
boolean

エラーが永続的かどうかを示します。

entityId
string

メッセージの送信時に使用されるエンティティ。詳細については、ドキュメントを参照してください。

applicationId
string

メッセージの送信時に使用されるアプリケーション。詳細については、ドキュメントを参照してください。

campaignReferenceId
string

送信チャネルごとの個々のキャンペーンの概要とパフォーマンスを集計して追跡、分析、表示できる ID。

レスポンス

200

Your server returns this code if it accepts the callback.

サンプルをリクエストする

コンテンツタイプ
application/json
コピー
すべて折りたたむ
{
  • "results":
    [
    • {
      • "bulkId": "BULK-ID-123-xyz",
      • "messageId": "MESSAGE-ID-123-xyz",
      • "to": "41793026727",
      • "sentAt": "2019-11-09T16:00:00.000+0000",
      • "doneAt": "2019-11-09T16:00:00.000+0000",
      • "smsCount": 1,
      • "callbackData": "callbackData",
      • "price":
        {
        • "pricePerMessage": 0.01,
        • "currency": "EUR"
        },
      • "status":
        {
        • "groupId": 3,
        • "groupName": "DELIVERED",
        • "id": 5,
        • "name": "DELIVERED_TO_HANDSET",
        • "description": "Message delivered to handset"
        },
      • "error":
        {
        • "groupId": 0,
        • "groupName": "Ok",
        • "id": 0,
        • "name": "NO_ERROR",
        • "description": "No Error",
        • "permanent": false
        },
      • "entityId": "promotional-traffic-entity",
      • "applicationId": "marketing-automation-application"
      },
    • {
      • "bulkId": "BULK-ID-123-xyz",
      • "messageId": "12db39c3-7822-4e72-a3ec-c87442c0ffc5",
      • "to": "41793026834",
      • "sentAt": "2019-11-09T17:00:00.000+0000",
      • "doneAt": "2019-11-09T17:00:00.000+0000",
      • "smsCount": 1,
      • "price":
        {
        • "pricePerMessage": 0.01,
        • "currency": "EUR"
        },
      • "status":
        {
        • "groupId": 3,
        • "groupName": "DELIVERED",
        • "id": 5,
        • "name": "DELIVERED_TO_HANDSET",
        • "description": "Message delivered to handset"
        },
      • "error":
        {
        • "groupId": 0,
        • "groupName": "Ok",
        • "id": 0,
        • "name": "NO_ERROR",
        • "description": "No Error",
        • "permanent": false
        },
      • "applicationId": "default"
      }
    ]
}

ご不明点は

サポートまでお問い合わせ

ください

© NTTCom Online Marketing Solutions Corporation