SMS配信管理

2026/11/09

この画面でできること

  • 送ったSMSを、期間・電話番号・ステータスなどで探せます
  • 1通ごとに、届いたかどうか(配信結果)を確かめられます
  • 止まっているSMSの再送と、検索結果のCSV出力ができます
先に用意するもの探したいSMSの送信日や電話番号など、検索の手がかり
ポイント「届いたか」は、詳細の「配信結果」で確かめます。見方は下の「配信ステータスの説明」にまとめています。

操作手順

  1. 「期間指定 (開始/終了)」に、検索する期間の開始日と終了日を入力します。画面を開いたときは、今月の1日から末日までが入力されています。
    期間指定 (開始/終了)。
    期間指定 (開始/終了)。
  2. 「APIアカウント」を選択します。「全てのAPIアカウント」を選択すると、このポータルアカウントに紐づくすべてのAPIアカウントが対象になります。
    APIアカウントの選択。
    APIアカウントの選択。
  3. 「ステータス」で、検索する配信ステータスにチェックを入れます。画面を開いたときは、すべてのステータスにチェックが入っています。
    ステータスの選択。
    ステータスの選択。
  4. 必要に応じて、電話番号、オーダーID、クライアントオーダーID、分割数、課金数、キャリア、表示件数を指定します。
    そのほかの検索項目と表示件数。
    そのほかの検索項目と表示件数。
  5. 「検索」をクリックします。検索結果は「SMS配信結果 一覧」に表示されます。
    「検索」ボタン。
    「検索」ボタン。

詳しい説明・困ったとき

検索項目
項目説明
期間指定 (開始/終了)SMSを受け付けた日時で検索する期間です。開始日と終了日を「yyyy/MM/dd」の形式で入力します。どちらも必須です。
APIアカウント「全てのAPIアカウント」、またはこのポータルアカウントに紐づくAPIアカウントの1つを選択します。
ステータス送信前 (queued)、送信中 (sending)、送信完了 (sent)、リトライ (queue_pending)、無効 (not_charge) から選択します。複数選択できます。
電話番号宛先の電話番号です。ハイフンを付けずに10〜15桁の数字で入力します(先頭の「+」は入力できます)。番号が完全に一致するSMSを検索します。送信したSMSの電話番号は「+」なしの10〜14桁で記録されているため、「+」を付けたり15桁で入力したりすると、一致するSMSは見つかりません。
オーダーIDシステムが発行したオーダーIDです。完全に一致するSMSを検索します。
クライアントオーダーID送信時に指定したクライアントオーダーIDです。完全に一致するSMSを検索します。
分割数分割数が入力した数と一致するSMSを検索します。
課金数課金数が入力した数と一致するSMSを検索します。
キャリアdocomo、au、softbank、rakuten、不明から選択します。空欄のままにすると、キャリアで絞り込みません。
表示件数1ページに表示する件数です。5、20、50、100、200から選択します。画面を開いたときは20件です。
検索結果

検索すると、「SMS配信結果 一覧」が表示されます。IDの大きい順(新しい順)に並び、表示件数を超える場合はページに分かれます。一覧の上部には、次の3つの集計が表示されます。

集計項目説明
検索結果検索条件に一致したSMSの件数です。
分割総件数検索条件に一致したSMSの分割数の合計です。
課金総件数検索条件に一致したSMSの課金数の合計です。
SMS配信結果 一覧と、上部の集計。
SMS配信結果 一覧と、上部の集計。

検索条件に一致するSMSがない場合は、「検索結果がありませんでした。」と表示されます。

検索項目の表示・非表示

検索すると、検索項目は自動で閉じ、一覧が画面の上部に表示されます。「検索項目」の横の「+」をクリックすると検索項目が開き、「−」をクリックすると閉じます。

検索項目が閉じた状態。「+」をクリックすると開きます。 → 図4.1.2を参照
検索項目が閉じた状態。「+」をクリックすると開きます。
検索項目が開いた状態。「−」をクリックすると閉じます。 ← 図4.1.1を参照
検索項目が開いた状態。「−」をクリックすると閉じます。

結果の各列について

一覧の1行が、1件のSMSです。各列の内容は次のとおりです。

列説明
IDSMSごとに採番されるIDです。
送信者名ULTIQUE SMSでは使用しません。管理画面から送ったSMSは空欄です(APIで指定した値が表示されることがありますが、配信には使われません)。
電話番号宛先の電話番号です。
SMSメッセージメッセージ本文の先頭20文字です。それより長い場合は「...」で省略されます。全文は「詳細」で確認できます。
ステータス配信ステータスです。送信完了 (sent) は緑、リトライ (queue_pending) は赤字のリンク、それ以外はオレンジ色で表示されます。意味は配信ステータスの説明を参照してください。
配信日時SMSを受け付けた日時です。「期間指定」はこの日時で検索します。
キャリア宛先のキャリアです(docomo、au、softbank、rakuten、不明)。キャリアの情報がない場合は空欄です。
分割数メッセージが分割された通数です。
課金数請求の対象となる通数の目安(暫定値)です。配信が完了したSMSだけが対象で、長文のSMSは分割された通数で数えます。送信中のSMSには見込みの通数が入り、配信結果が届くと実際の通数(配信されなかった場合は0)に変わります。請求の通数は翌月15日に確定します。
詳細クリックすると、SMSメッセージの詳細ダイアログが開きます。
注意: 「キャリア」が空欄でも、送信に失敗したという意味ではありません。キャリアの情報が返ってこなかったSMSは、空欄のままになります。
ポイント: ポータルアカウントで電話番号のマスク表示が設定されている場合、電話番号の数字は「*」で表示されます。一覧、詳細ダイアログ、CSVエクスポートのすべてが対象です。設定については、サポートまでお問い合わせください。
配信ステータスの説明

ステータス列には、各SMSが送信のどの段階にあるかが表示されます。各ステータスの意味は次のとおりです。

ステータス検索項目での表示説明
queued送信前 (queued)送信を受け付け、送信を待っている状態です。再送したSMSも、この状態に戻ります。
:sending:送信中 (sending)SMS回線への送信が終わり、配信結果を待っている状態です。
:sent:送信完了 (sent)配信に成功した状態です。
:queue_pending:リトライ (queue_pending)決められた回数まで再試行しても送信できなかったか、デポジット残高が不足していたため、送信が止まっている状態です。この画面から再送または削除できます(queue_pendingの再送を参照)。
:not_charge:無効 (not_charge)配信されなかった状態です。課金数は0になり、料金はかかりません。
SMSメッセージ説明

一覧の「詳細」をクリックすると、「SMSメッセージの詳細」ダイアログが開き、そのSMSのすべての項目とメッセージの全文を確認できます。ダイアログは「閉じる」または「×」で閉じます。

詳細ダイアログの項目

一覧の「詳細」。
一覧の「詳細」。
「SMSメッセージの詳細」ダイアログ。
「SMSメッセージの詳細」ダイアログ。

ダイアログには、次の項目が上から順に表示されます。

項目説明
IDSMSのIDです。
配信日時SMSを受け付けた日時です。
APIアカウントこのSMSを送信したAPIアカウントです。
オーダーIDシステムが発行したオーダーIDです。
クライアントオーダーID送信時に指定したクライアントオーダーIDです。指定がない場合は空欄です。
その他項目1送信時に指定した任意の値です。一括配信で送信したSMSには、一括配信タスクのIDが入ります(一括配信かどうかの確認を参照)。
その他項目2送信時に指定した任意の値です。一括配信で送信したSMSには、一括配信を示す文が入ります(一括配信かどうかの確認を参照)。
その他項目3送信時に指定した任意の値です。
ステータス配信ステータスです。意味は配信ステータスの説明を参照してください。
配信結果SMS回線から返った配信結果です(例:「delivrd」)。
宛先電話番号宛先の電話番号です。
キャリア宛先のキャリアです。キャリアの情報がない場合は空欄です。
送信者名ULTIQUE SMSでは使用しません。管理画面から送ったSMSは空欄です(APIで指定した値が表示されることがありますが、配信には使われません)。
SMSメッセージメッセージの全文です。
分割数メッセージが分割された通数です。
課金数請求の対象となる通数の目安(暫定値)です。配信が完了したSMSだけが対象で、長文のSMSは分割された通数で数えます。送信中のSMSには見込みの通数が入り、配信結果が届くと実際の通数(配信されなかった場合は0)に変わります。請求の通数は翌月15日に確定します。

一括配信かどうかの確認

SMSが一括配信で送信されたものかどうかは、「SMSメッセージの詳細」ダイアログの「その他項目1」と「その他項目2」で確認できます。

一括配信の目印: 「その他項目1」に一括配信タスクのIDが表示され、「その他項目2」に「This distribution is a bulk SMS distribution process.」と表示されている場合、そのSMSは一括配信で送信されたものです。
「その他項目1」に表示される一括配信タスクのID。このIDをSMS一括配信リストの「ID」欄に入力して検索すると、そのタスクが表示されます。 → 図6.2.2を参照
「その他項目1」に表示される一括配信タスクのID。このIDをSMS一括配信リストの「ID」欄に入力して検索すると、そのタスクが表示されます。
「ID」欄に同じIDを入力して検索した「SMS一括配信リスト」。 ← 図6.2.1を参照
「ID」欄に同じIDを入力して検索した「SMS一括配信リスト」。

同じダイアログの「その他項目2」には、一括配信を示す文が表示されます(下図)。

「その他項目2」に表示される一括配信の目印。
「その他項目2」に表示される一括配信の目印。
queue_pendingの再送

ステータスがqueue_pendingのSMSは、この画面から再送または削除できます。まとめて処理する方法と、1件ずつ処理する方法があります。

  1. まとめて処理する場合は、一覧の下にある「一括処理」をクリックします。
    一覧の下の「一括処理」ボタン。
    一覧の下の「一括処理」ボタン。
  2. 「全てのキューの処理」ダイアログが開きます。「再送」をクリックすると、queue_pendingのSMSをすべて再送します。「削除」をクリックすると、すべて削除します。「Cancel」をクリックすると、何もせずにダイアログを閉じます。
    「全てのキューの処理」ダイアログ(Cancel・再送・削除)。
    「全てのキューの処理」ダイアログ(Cancel・再送・削除)。
  3. 1件だけ処理する場合は、その行のステータス列にある赤字の「queue_pending」をクリックします。
    ステータス列の「queue_pending」リンク。
    ステータス列の「queue_pending」リンク。
  4. 「キューの再送, もしくは削除」ダイアログが開き、「ID:(SMSのID) のSMSキューを処理します。」と表示されます。「再送」「削除」「Cancel」の動作は、一括処理と同じです。
    「キューの再送, もしくは削除」ダイアログ(Cancel・再送・削除)。
    「キューの再送, もしくは削除」ダイアログ(Cancel・再送・削除)。
注意: 「一括処理」の対象は、検索結果ではありません。このポータルアカウントに紐づくすべてのAPIアカウントのqueue_pendingのSMSが対象です。検索条件や、選択したAPIアカウントは関係しません。
  • 再送すると、ステータスはqueuedに変わり、もう一度送信されます。
  • 1件ずつ再送したSMSは、配信日時が再送した日時に変わります(「一括処理」で再送した場合は変わりません)。一覧に表示されなくなった場合は、「期間指定」を変えて検索してください。
  • 削除すると、そのSMSの記録が削除され、一覧に表示されなくなります。削除したSMSは再送できません。
  • 処理を受け付けると、「再送処理 完了」または「削除処理 完了」と表示され、ダイアログは自動で閉じます。
  • 「SMSキューの再送信に失敗しました。」と表示された場合は、そのSMSがすでにqueue_pendingではない可能性があります。もう一度検索して、ステータスを確認してください。
ポイント: 再送しても再びqueue_pendingになる場合は、ダッシュボードでデポジット残高を確認してください。
CSVエクスポート

検索結果を、CSVファイルとして出力できます。ファイルはその場ではダウンロードされません。依頼を受け付けた後、エクスポートタスク画面で作成状況を確認し、完成したファイルをダウンロードします。

  1. 出力したい条件で検索し、一覧の右上にあるCSVエクスポートをクリックします。検索結果が0件のときは、このボタンは表示されません。
  2. ダイアログで、対象が「SMS配信結果(検索条件適用後)」であることと、出力件数(目安)を確認します。文字コードは「UTF-8(BOM付き)」です。
    SMS配信管理のCSVエクスポートダイアログ。
    SMS配信管理のCSVエクスポートダイアログ。
  3. CSVに出力する項目にチェックを入れます。すべての項目を出力する場合は全選択、すべてのチェックを外す場合は全解除をクリックします。
  4. エクスポートをクリックします。
  5. 「CSVエクスポート 受付完了」ダイアログに表示される受付番号を控えます。エクスポートタスク画面のリンクから、作成状況を確認できます。
  • 依頼した時点の検索条件に一致する、すべてのSMSが対象です。表示しているページや表示件数は関係しません。行の順番は、この画面の一覧と同じ(IDの大きい順)です。
  • 出力できる項目は、ID、電話番号、SMSメッセージ、ステータス、配信日、キャリア、分割数、課金数です。CSVの「配信日」は、一覧の「配信日時」と同じ値です。詳細ダイアログだけにある項目(オーダーIDなど)は出力できません。
  • 項目を1つも選択していないときは、「項目を1つ以上選択してください」と表示され、エクスポートはクリックできません。ダイアログを開くたびに、すべてのチェックが外れた状態に戻ります。
  • 出力件数(目安)は、検索した時点の件数です。CSVファイルはエクスポート実行時のデータで作成するため、実際の件数と異なる場合があります。
  • 検索条件に誤りがある場合は、「検索条件が不正です。再度検索してからエクスポートしてください。」と表示され、依頼は受け付けられません。
注意: 待機中と処理中のエクスポートは、1つのポータルアカウントで同時に3件までです。上限に達しているときに依頼すると、「同時に実行できるエクスポートの件数を超えています。完了を待ってから再度実行してください。」と表示され、依頼は受け付けられません。
ヒント: 各項目の内容やファイルの形式(ZIP形式、文字コードなど)は、エクスポートタスクページの出力できる項目(SMS配信管理)とCSVファイルの形式を参照してください。
よくある確認ポイント
現象対処
「検索結果がありませんでした。」と表示される期間、ステータス、APIアカウントなどの検索条件を確認してください。電話番号、オーダーID、クライアントオーダーIDは、完全に一致する値で検索します。
:queue_pending:「一括処理」、またはステータス列の「queue_pending」から再送できます。再送しても再びqueue_pendingになる場合は、デポジット残高を確認してください。
:not_charge:この画面からは再送できません。宛先の電話番号が正しいかを確認し、必要に応じて改めて送信してください。
CSVエクスポートボタンが表示されない検索結果が0件のときは表示されません。条件を変えて検索してください。
「エクスポート」がクリックできないCSVに出力する項目が1つも選択されていません。項目にチェックを入れるか、「全選択」をクリックしてください。ダイアログを開くたびに、チェックはすべて外れた状態に戻ります。
「同時に実行できるエクスポートの件数を超えています。完了を待ってから再度実行してください。」と表示される待機中と処理中のエクスポートが、合わせて3件あります。エクスポートタスク画面で完了を待ってから、もう一度依頼してください。急ぐ場合は、不要なエクスポートをキャンセルしてから依頼してください。
「検索条件が不正です。再度検索してからエクスポートしてください。」と表示される検索項目の入力内容を確認し、「検索」をクリックし直してから、もう一度エクスポートしてください。
CSVファイルが見つからないCSVファイルは、依頼したその場ではダウンロードされません。エクスポートタスク画面で、受付番号の行のステータスが完了になってからダウンロードしてください。ダウンロードできるのは、エクスポートが完了した日時の30日後までです。期限を過ぎて期限切れになった場合は、もう一度依頼してください。