Logo
エッセンシャルズ
API の要点
SMPP仕様

SMPP仕様

ショートメッセージピアツーピア(SMPP)**は、SMSアプリケーションシステムとSMSセンター(SMSC（Short Message Service Center）)の間でSMSメッセージを交換するために電気通信業界で使用されるオープンな業界標準プロトコルです。

アプリケーションと Infobip SMPP サーバー間の接続は SMPP バージョン 3.4 (opens in a new tab) です (バージョン 3.3 と 5.0 はサポートされていません)。

サポートされる SMPP 機能

SMPP トラフィックのセキュリティ

適切なアカウント管理と安全な SMPP API トラフィック ブロードキャストを確保するために、両方の目的で同じユーザーを使用しないことをお勧めします。代わりに、SMPP API トラフィック ブロードキャスト専用のクレデンシャルを持つ専用ユーザーが必要です。

SMPP トラフィックは通常、静的 IP アドレスを介して送信されるため、カスタマー サクセス マネージャーに連絡し、SMPP API トラフィックのブロードキャストを担当するユーザーに許可する必要がある IP アドレスのリストを提供する必要があります。暗号化されたSSL/TLSエンドポイントsmpp2.infobip.com:8887にバインド要求を送信して、安全な接続を確立します。

バインド パラメーター

手記

必要なパスワードの長さは、SMPP v3.4 プロトコル自体ではなく、SMPP ライブラリによって異なります。パスワードの長さが 8 文字を超えるセットアップを可能にするライブラリを使用することをお勧めします。追加情報が必要な場合は、 サポート (opens in a new tab) チームに連絡して、アカウントのパスワード強度ポリシーを調整してください。

Name MandatoryDescription
system_idはいユーザーの ユーザー名 は、Infobipプラットフォームで作成されます。
パスワードはいクライアントごとに提供されます。
IPアドレスはいsmpp3.infobip.com (プライマリ)smpp1.infobip.com (セカンダリ)smpp2.infobip.com (SSL)
港はい8888 (プライマリおよびセカンダリ)8887 (SSL)
タイムアウト(キープアライブまたはメッセージ)はい30秒
system_typeいいえ
大事な

送信機、受信機、またはトランシーバーとしてバインドできます。配信レポートを受信するには、トランシーバーまたはレシーバーとしてバインドする必要があります。

配送レポートを受け取るのは、ルートが配送レポートを提供している場合のみです。配信レポートは、受信可能な現在利用可能なすべてのセッション(トランシーバーまたはレシーバー)に均等に送信されます。

デフォルトでは、4 セッション でバインドできます。インターネット速度以外にスループット (TPS) の制限はありません。

PDUタイプ

  • bind_transmitter
  • bind_receiver
  • bind_transceiver
  • unbind (バインド解除)
  • submit_sm
  • deliver_sm
  • enquire_link

データ・コーディング・スキーム

DCS を 0 または 1 に設定すると、IA5 / GSM7 コーディング スキームがメッセージに適用されます (GSM7 は既定の Infobip SMSC（Short Message Service Center） アルファベットです)。

Latin1 (ISO-8859-1) の場合は DCS = 3 を、Unicode/UCS-2 (ISO/IEC-10646) としてメッセージを送信する場合は DCS = 8 を設定します。

スケジュールされた配信

スケジュールされた配信は、相対時間形式 を使用した SMPP プロトコルでサポートされます。

070605040302100R

たとえば、メッセージが今から 7 年、6 か月、5 日、4 時間、3 分、2 秒、10 分の 1 秒後に配信されることを意味します。

コマンドの状態

システムへの各要求は、command_statusを含む SMPP v 3.4 標準に従って確認応答を受け取ります。Infobip 固有のものを含め、最も関連性の高いコマンドの状態を次の表に示します。

command_statusPDUDescription
0x0000000Ebind_resp無効な資格情報
0x00000022 / 34submit_sm_respネットワークがカバーされていない
0x000000FF / 255submit_sm_respアカウントの残高が不足しています
0x0000000asubmit_sm_resp無効な送信元アドレス
0x0000000bsubmit_sm_resp無効な宛先アドレス
0x0000000csubmit_sm_respメッセージ ID が重複しているか無効です
0x000004a1submit_sm_respシステムエラーまたはチャネルが無効になっています
0x0000009Fsubmit_sm_resp省略可能なパラメーターの長さが無効です

配信レポートの形式

次の形式の配信レポートは、deliver_sm PDU の短いメッセージ フィールドで返されます。

id:{message_id} sub:{message_sub} dlvrd:{message_dlvrd} submit date:{message_submit_date} done date:{message_done_date} stat:{message_stat} err:{message_err}

配信ステータス

  • DELIVRD (デリヴルド)
  • 「期限切れ」
  • 「アンデリブ」
  • 「承認済み」
  • 「不明」
  • ENROUTE
  • 「却下されました」

GSMエラーコード

GSM エラー コードは DLR で返され、メッセージの状態 (中間または最終) を示します。エラー コードは、配信情報の一部としてshort_messageで返されるか、(Infobip スペシャリストによって有効になっている場合は)オプションの TLV 0x423で返されます。

考えられる エラー コード を確認します。

フラッシュ通知

Infobip SMPP アカウントを使用して Flash 通知を送信できます。このような通知は、到着時にすぐに携帯電話の画面に表示され、デバイスのメモリには保存されません。デフォルトのsystem_idとパスワードを使用して、データコーディングを 16(Unicode の場合は 24)に設定してメッセージを送信し、Flash 通知を送信します。

長いSMS機能は、フラッシュ通知ではサポートされていません。配信レポートは、DeliverSM PDUを使用して送信されます。

番号検索

Infobip SMPPアカウントを使用して、番号検索データを要求できます。番号検索を使用するには、デフォルトのsystem_idと「パスワード」を使用し、「バインドPDU」でsystem_type = HLRを設定します。

SubmitSM PDU は、必要な宛先アドレスに設定された destAddress パラメータを使用して、番号番号検索要求を送信するために使用されます。他のすべてのパラメータ(srcAddress、TON/NPIなど)は無視されます。

Infobip 番号検索 サブシステムは、message_id 参照を含む通常の SubmitSMResp を使用して応答します。

Infobip システムで番号検索要求が確定すると、必須の destAddress の IMSI（International Mobile Subscriber Identity）、または失敗した場合は エラー コード、パッケージに応じて追加の オプションの情報フィールド を含む短いメッセージを含む DeliverSM PDU を受け取ります。

オプションの情報フィールド

種類

16 進

小数

元のネットワーク名TLVString (英語)0x14125138
元のネットワーク接頭辞TLVString (英語)0x140B5131
元の国TLVString (英語)0x14225154
元の国コードTLVString (英語)0x14235155
元の国の接頭辞TLVString (英語)0x14245156
移植されたネットワーク名TLVString (英語)0x14135139
移植された国のプレフィックスTLVString (英語)0x14425186
移植されたネットワーク接頭辞TLVString (英語)0x143e5182
移植されたネットワークの国名TLVString (英語)0x143f5183
番号が移植されているTLVInt0x14215153
ローミング ネットワーク名TLVString (英語)0x14145140
ローミング ネットワーク プレフィックスTLVString (英語)0x14195145
ローミング国名TLVString (英語)0x14155141
ローミング国コードTLVString (英語)0x14175143
ローミング国のプレフィックスTLVString (英語)0x14205152
MCCMNCのTLVString (英語)0x14165142
メッセージあたりの価格 (互換性の理由から 100 を掛けた値)TLVInt0x14185144
HLR の提供TLVString (英語)0x14095129
番号は正しいですかTLVInt0x14255157

追加のオプションの情報フィールド

種類

16 進

小数

IMSI（International Mobile Subscriber Identity）10月0x14035123

番号検索要求が成功した場合、DeliverSM は次のようになります ('IMSI（International Mobile Subscriber Identity） 219101100935850')。

addr: 0 0 38591xxxxxxx addr: 0 0 0000000000 msg: id:40072910491427628 sub:001 dlvrd:001 submit date:1007291049 done date:1007291049 stat:DELIVRD err:000 IMSI:219101100935850 MSC:38591016 HLR:38591xxxxxxx ORN:VipNet PON:VipNet RON:VipNet ROC:HR MCCMNC:21910 opt: (oct: (tlv: 1059) 030000) (byte: (tlv: 1063) 2) (str: (tlv: 30) 40072910491427628) (str: (tlv: 5129)38591xxxxxxx) (str: (tlv: 5138) VipNet) (str: (tlv: 5139) VipNet) (str: (tlv: 5140) VipNet) (str: (tlv:5141) Croatia ) (str: (tlv: 5143) HR) (str: (tlv: 5142) 21910) (int: (tlv: 5144) 1) (str: (tlv: 5145) 91) (str: (tlv: 5152) 385) (int: (tlv: 5153) 1) (str: (tlv: 5154) Croatia ) (str: (tlv: 5155) HR) (str: (tlv: 5156) 385) (int: (tlv: 5157) 1) ) (extraopt: (oct: (tlv: 5123) 323139313031313030393335383530) )

エラーが発生した場合、DeliverSM は次のようになります。

addr: 0 0 38591xxxxxxx addr: 0 0 0000000000 msg: id:40072910491419819 sub:001 dlvrd:001 submit date:1007291049 done date:1007291049 stat:UNDELIV err:001 IMSI: MSC: ORN:VipNet MCCMNC: opt: (oct: (tlv: 1059) 030001) (byte: (tlv: 1063) 5) (str: (tlv: 30) 40072910491419819) (str: (tlv: 5138) VipNet) (str: (tlv: 5142) ) (int: (tlv: 5144) 1) (int: (tlv: 5153) 0) (str: (tlv: 5154) Croatia ) (str: (tlv: 5155) HR) (str: (tlv: 5156) 385) (int: (tlv: 5157) 1) )

URL 短縮

次の TLV を使用して、SMPP 接続を [URL 短縮](/URL 短縮)機能と組み合わせて使用できます。

省略可能なフィールド

種類

16 進

小数

価値

筆記

URLの短縮TLVString (英語)0x14945268‬任意の値で有効になりますカスタム ドメイン TLV セットが設定されている場合は不要
カスタムドメインTLVString (英語)0x14955269‬カスタムドメインでは、http:// または https:// は必要ありません
プロトコルの削除TLVString (英語)0x14965270‬ブーリアン 

Logo

ご不明点は

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

ください

© NTTCom Online Marketing Solutions Corporation