必要な情報はすべて、不要な情報は一切なし
リクエスト
BroadNetのゲートウェイは、Authorization: Bearerトークンおよび以下のJSONを含む、https://api.broadnet.me/sms/sendSmsへのPOSTリクエストを受け付けます:senderId(送信元ID)、destinationNumber(国際形式の電話番号、数字のみ、プラス記号なし)、message(本文)、messageType(GSM-7の場合はTEXT、アラビア語、絵文字、その他の非ラテン文字の場合はUNICODE)。呼び出しが成功すると、レスポンスボディにメッセージIDを含む200 OKが返されます。
エンコーディングと文字数
GSM-7メッセージは1セグメントあたり160文字(メッセージが複数セグメントにわたる場合は153文字)収まります。絵文字や非ラテン文字のためにUnicodeに切り替えると、70文字(連結SMSの場合は67文字)に減少します。本文にUnicodeやアラビア文字が必要な場合は、文字化けを防ぐためにmessageTypeをTEXT(プレーンなGSM-7用)またはUNICODEに設定してください。POST /sms/identifyは、送信前にエンコーディングとセグメント数を返します。
配信状況を推測せず、追跡してください
返されたメッセージIDは、配信レポート(DLR)のハンドルとなります。送信時の200レスポンスを端末へのメッセージ受信の証明として扱うのではなく、Webhookを設定して通信事業者の最終ステータス(配信済み、失敗、または期限切れ)を受信するようにしてください。
本番環境への移行
国際E.164番号を使用し、規模を拡大する前に各対象市場で送信元IDの登録を済ませ、安定したレイテンシを実現するために通信事業者との直接接続ルートを利用してください。大量送信の場合、同一のアカウントでSMPPおよびRESTからもアクセス可能なため、HTTPから開始して、再登録の手間なくバインドタイプを切り替えることができます。