SMS · SMS API

SMS API:ソフトウェアから1回のリクエストでSMS。

CRM、ERP、ECサイトのシステム、または自社アプリからSMSを送信し、配信状況を照会し、受信メッセージや拒否通知を受け取れます。RESTとJSON、認証はBearerキー、イベントはHMAC署名付きWebhookで通知します。

営業時間内にお電話します。お客様の番号はこの通話のためだけに使用されます · KVKK
# 個別メッセージの一括SMS curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # レスポンス {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # 配信イベント(Webhook、HMAC署名付き) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
含まれるもの

機能

1回のリクエストで送信

sendアクション:単一の番号、リスト、または個別の異なる文面。プレースホルダーは受信者のフィールドから埋められます。

配信レポート

statusで、送信番号またはご自身の参照番号(custom_ref)を使って、各メッセージのステータスを照会できます。

署名付きWebhook

配信、受信SMS、拒否のイベントはX-Buluthat-Signature(HMAC-SHA256)で署名されてお客様のアドレスに届きます。失敗した場合はバックオフして再試行されます。

クレジットとヘッダーの照会

balanceで残りのSMS / OTPクレジットと有効期限、headersで承認済みのヘッダーを取得できます。

予約送信とキャンセル

send_atで最大90日先まで日時指定可能。cancelで未送信のメッセージをキャンセルすると、クレジットが返還されます。

ブラックリスト

blacklist_add / blacklist_removeでご自身の拒否リストを同期してください。

OTPエンドポイント

otp_send、otp_verify、otp_statusで、別のテーブルを持たずに確認コードを管理できます。

İYSと速度の設定

is_commercialで商用メッセージはİYS確認を通ります。rate_per_minuteで1分あたりの送信数を制限できます。

申込

4ステップでSMS送信を始める

書類はパネルからアップロードしていただき、ヘッダーの承認は当社が対応します。

01
お申し込み

フォームにご記入のうえ、ご希望のパッケージをお選びください。アカウント開設後、パネルのパスワードがメールで届きます。

02
書類をアップロード

会社情報、納税証明書、代表者の身分証、署名証明書、誓約書をパネルから提出してください。

03
ヘッダー承認

SMSヘッダー(3-11文字)は、書類がそろっていれば1-3営業日以内に承認されます。

04
送信する

パネルからExcelやアドレス帳で一括送信するか、SMS APIでソフトウェアに接続します。

FAQ

SMS APIについて

開発者向けセクションのSMS APIページで、リクエスト、レスポンス、エラーコードの例とともに。

パネルの一括SMS > APIと設定画面で作成します。Webhookのアドレスも同じ画面で入力します。

同じリクエスト内で重複した番号には1回のみ送信されます。重複防止が有効な場合、同じ日に同じ文面が同じ番号へ2回送信されることはありません。