Bulk SMS API

開発者が半日で組み込める一括SMS API

BulkSMSAPIは開発者向けの一括SMS APIです:1回のリクエストで1件のテキストまたは最大10,000件の番号リストを227ヶ国にREST経由で送信でき、各メッセージには署名付きWebhookで配信状況を追跡可能。前払い残高からメッセージ単位で支払います。

  • メッセージごとの課金
  • 月額料金なし
  • 署名付きウェブフック

アメリカ合衆国へのSMSは1セグメントあたり$0.00507

BulkSMSAPI概要

概要
一括SMS送信のためのREST APIとウェブコンソール: 1通、数千件のバッチ、または貼り付けたリストからのキャンペーン
対応地域
227の国と地域、それぞれセグメントごとに独自の価格
価格
1セグメントあたり$0.00247(ブラジル)から、アメリカ合衆国では$0.00507。月額料金・初期費用なし
リクエスト
HTTPS経由のJSON、Bearer APIキー、1バッチリクエストあたり最大10,000件、キーごとに1分あたり600リクエスト
配信レポート
配信成功/失敗した各メッセージの署名付きウェブフック、1イベントあたり10回の試行、ポーリング用GETエンドポイント付き
スケジューリング
send_atは2分後から45日後まで設定可能、スケジュール済みバッチは全額返金でキャンセル可
テキスト
GSM-7とUnicode (UCS-2)、最大10セグメントの長文、マージフィールドと受信者ごとの個別テキスト
支払い
$40からのプリペイド残高、ホスト型チェックアウトでチャージ。失敗したメッセージは残高に返金

構成要素

一括SMS連携に必要なすべて

1つのAPIの6つの機能、すべてメッセージ単位の課金で同じコンソールから可視化。単体利用も、組み合わせて完全な通知パイプラインの構築も可能

単一メッセージ

POST /v1/messages は1つの番号に1つのテキストを送信し、即座にメッセージIDを返します。ログインコード、パスワードリセット、支払いアラートは、コードが呼び出した瞬間に送信されます。

メッセージを送信

バッチ

POST /v1/batches は1リクエストで最大10,000の番号を受け取り、全員に同じテキストを送信するか、番号ごとに個別のテキストを送信します。重複や無効な番号は除外され、回答にリストされます。

バッチを送信

署名付きウェブフック

配信または失敗したメッセージは、署名付きJSONイベントでエンドポイントを呼び出します。各イベントは約24時間にわたって10回試行されるため、デプロイによってステータスが失われることはありません。

ウェブフックを設定

料金API

GET /v1/pricing は、キーなしで各国のセグメントごとの料金を返します。自社の製品でコストを表示したり、大規模な送信前にルートを確認したりできます。

APIで料金を確認

スケジューリング

send_at をリクエストに追加すると、バッチはその分まで待機します(2分から45日先まで)。開始前にキャンセルすると、全額が残高に戻ります。

バッチをスケジュール

チーム全体のコンソール

リストを貼り付けるかアップロードし、テキストを書き、受信者ごとにプレビューしてコードなしで送信します。APIからのすべてのバッチは、ライブカウントとともに同じコンソールに表示されます。

コンソールを見る

コード、アラート、キャンペーンのための一括SMS API

トランザクションテキストとマーケティングキャンペーンは、同じエンドポイント、同じ料金表、同じ配信イベントを使用します。違いは、1リクエストに含める番号の数だけです。

トランザクションメッセージ

システム内の1つのイベント、1人への1つのテキストが数秒以内に送信されます。

  • POST /v1/messages は、テキストがキューを離れる前に、メッセージID、料金、ステータスを202で返します。
  • 独自の注文IDまたはユーザーIDを reference に入れると、そのメッセージのすべてのウェブフックで返されます。
  • 安全に再試行: 同じ Idempotency-Key を使用すると、24時間以内に最初の回答が返され、二重送信を防ぎます。
メッセージを送信

一括キャンペーン

1つのテキスト、または1人ごとに1つのテキストを、1リクエストで数千のリストに送信します。

  • POST /v1/batches は1リクエストで 10,000 の番号を受け取り、コンソールは貼り付けまたはCSVファイルからキャンペーンごとに 50,000 を受け取ります。
  • 番号は自動的にクリーンアップされます: スペース、ダッシュ、00プレフィックスが修正され、重複や無効な番号はリストアップされてスキップされます。
  • まず POST /v1/estimates で見積もりを行います: 総コスト、セグメント、国ごとの分割を、何も送信せずに確認できます。
バッチを送信

チームがSMS APIを通じて送信するもの

実際のシステムからの実際のメッセージ: それぞれが単一のAPI呼び出しまたはスケジュールされたバッチで、番号の国ごとにセグメント単位で課金されます。

ログインとサインアップコード

認証サービスからPOST /v1/messagesを使用してワンタイムコードを送信し、ユーザーが新しいコードを要求する前に配信イベントを読み取ります。

注文と配達の更新

荷物がデポを出るときに、注文システムがAPIを呼び出し、時間帯と追跡コードを短いテキストで送信します。

予約リマインダー

毎晩のジョブが明日のリストを作成し、患者やクライアントごとにパーソナライズされたテキストを含む1つのバッチを前日の夜に送信します。

支払いとアカウントアラート

カード支払い、送金、新しいデバイスのサインインが同じ秒にテキストをトリガーし、セグメントごとに課金され、そのステータスが記録されます。

セールとローンチキャンペーン

コンソールから50,000件、またはCRMから10,000件のバッチを送信し、すべてのテキストに配信停止リンクを追加します。

サービスと障害のお知らせ

サービス、フライト、配達ルートが変更されたときに、影響を受けるすべての顧客にすぐに通知し、修正されたときにフォローアップします。

1つのリクエストでバッチを送信

コンソールでAPIキーを作成し、BULKSMSAPI_KEYとしてエクスポートして、これらのいずれかを実行します。各サンプルは標準ライブラリのみを使用した完全なプログラムで、回答はバッチのID、コスト、およびライブカウントです。
バッチを作成
curl https://bulksmsapi.cc/v1/batches \
  -H "Authorization: Bearer $BULKSMSAPI_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: spring-sale-0412" \
  -d '{
    "name": "Spring sale",
    "text": "Spring sale at Northwind: 20% off until Sunday. Opt out: northwind.example/sms",
    "to": [
      "+14155550123",
      "+447400123456",
      "+4915123456789"
    ]
  }'

料金

国別の一括SMS価格

各国のメッセージセグメントごとに1つの価格があり、米ドルで、APIとコンソールで同じです。160文字までのプレーンテキストは1セグメントです。それ以上の長さやUnicodeテキストはさらにセグメントを使用し、価格リストは送信前のコストを表示します。
国
セグメントごと
$0.00507
10,000 メッセージ
$50.70
アメリカ合衆国へのSMS API

送信の価格の計算方法

  • 番号の国ごとのセグメント価格に、テキストのセグメント数を掛け、受信者数を掛けます。それ以外は追加されません。
  • リクエストが承認されると、コストが残高から差し引かれるため、資金不足でバッチが途中で停止することはありません。
  • 失敗したメッセージは自動的に残高に返金され、キャンセルした予約バッチは全額返金されます。
  • 価格はGET /v1/pricingからリアルタイムで読み取られるため、あなたの製品でも同じ数値を表示できます。
全価格リスト

227か国中227か国

国SMSごと
アイスランド$0.01467
アイルランド$0.01417
アゼルバイジャン$0.05557
アフガニスタン$0.03117
アメリカ合衆国$0.00507
アラブ首長国連邦$0.00447
アルジェリア$0.02267
アルゼンチン$0.01417
アルバ$0.01387
アルバニア$0.01357
アルメニア$0.01417
アンギラ$0.01297

プリペイド残高から従量制で支払い

$40 から $5,000 までの任意の金額をチャージし、どの国にも自由なペースで使用できます。残高には有効期限や月額料金はなく、初回チャージでボーナスが加算されます。
$40初回チャージ +10%

初回チャージで残高 $44

アメリカ合衆国へ約8,678件の1セグメントメッセージ

$100初回チャージ +20%

初回チャージで残高 $120

アメリカ合衆国へ約23,668件の1セグメントメッセージ

$200初回チャージ +25%

初回チャージで残高 $250

アメリカ合衆国へ約49,309件の1セグメントメッセージ

$300初回チャージ +30%

初回チャージで残高 $390

アメリカ合衆国へ約76,923件の1セグメントメッセージ

$500初回チャージ +35%

初回チャージで残高 $675

アメリカ合衆国へ約133,136件の1セグメントメッセージ

$1,000初回チャージ +40%

初回チャージで残高 $1,400

アメリカ合衆国へ約276,134件の1セグメントメッセージ

アカウントを作成

メッセージ数は アメリカ合衆国 の $0.00507 セグメントあたりの料金です。 支払いの仕組み

高ボリューム向けの制限

以下の数字はAPIを実行するコードの制限値で、ドキュメントには各制限値とそれに関連するヘッダーやエラーが記載されています。

10,000

バッチリクエストあたりの番号数

1回の呼び出しでリストを送信し、国ごとに分割して受信者ごとに料金を設定します。

600

キーあたりの1分間のリクエスト数

各回答のレート制限ヘッダーには、ウィンドウ内の残りが表示されます。

1,200

アカウントあたりの1分間のメッセージ数

キューはメッセージを順番にルートに渡し、2秒ごとに処理します。

アカウントから配信レポートまでの4つのステップ

営業電話や契約はありません。アカウントはブラウザで作成されたキーで、初回チャージ後にAPIが利用可能になります。
  1. ステップ 1

    アカウントを作成

    ブラウザがアカウントキーを作成します。一度保存してください。これが唯一のログインで、メールやパスワードの管理は不要です。

  2. ステップ 2

    残高をチャージ

    ホストされたチェックアウトから $40 を追加します。残高はコンソールとGET /v1/balanceで確認できます。

  3. ステップ 3

    APIキーを作成

    アプリや環境ごとにキーに名前を付け、一度コピーし、他のキーに影響を与えずにいつでも取り消すことができます。

  4. ステップ 4

    送信してリスン

    /v1/messages または /v1/batches を呼び出し、webhook URLを追加します。配信済みと失敗したイベントは署名付きで届きます。

今日最初のバッチを送信

数秒でアカウントを作成し、$40 からチャージして、HTTPSを話す任意の言語からAPIを呼び出します。メッセージあたりの料金は $0.00247 から始まります。

開発者向け一括SMS API:REST、Webhook、227ヶ国対応 | BulkSMSAPI