Bulk SMS API

API масових SMS, який розробник підключить за пів дня

BulkSMSAPI, це API для масової розсилки SMS для розробників: надсилайте один текст або пакет до 10 000 номерів за запит у 227 країн через REST, відстежуйте кожне повідомлення з підписаними вебхуками та оплачуйте за повідомлення з попередньо оплаченого балансу.

  • Плата за повідомлення
  • Без щомісячної плати
  • Підписані вебхуки

Одне SMS до Сполучені Штати коштує $0.00507 за сегмент.

BulkSMSAPI: основи

Що це
REST API та веб-консоль для масової розсилки SMS: одне повідомлення, пакет з тисяч або кампанія зі списку.
Покриття
227 країн та територій, кожна зі своєю ціною за сегмент.
Ціна
Від $0.00247 за сегмент (Бразилія), $0.00507 до Сполучені Штати. Без щомісячної плати, без плати за налаштування.
Запити
JSON через HTTPS, Bearer API ключі, до 10,000 отримувачів за пакетний запит та 600 запитів на хвилину на ключ.
Звіти про доставку
Підписані вебхуки для кожного доставленого чи невдалого повідомлення, 10 спроб на подію, плюс GET ендпоінти для перевірки.
Планування
send_at від 2 хвилин до 45 днів вперед; заплановані пакети скасовуються з повним поверненням коштів.
Текст
GSM-7 та Unicode (UCS-2), довгі повідомлення до 10 сегментів, поля злиття та персоналізований текст для кожного отримувача.
Оплата
Передплачений баланс від $40, поповнюється через хостинг-чек. Невдалі повідомлення повертаються на баланс.

Будівельні блоки

Все, що потрібно для інтеграції масової SMS-розсилки

Шість частин одного API, всі з оплатою за повідомлення та видимі в одній консолі. Використовуйте одну або об'єднайте їх у повний конвеєр сповіщень.

Одиночні повідомлення

POST /v1/messages надсилає один текст на один номер і миттєво повертає ідентифікатор повідомлення. Коди входу, скидання паролів та сповіщення про платежі відправляються в момент виклику вашого коду.

Надіслати повідомлення

Пакети

POST /v1/batches обробляє до 10 000 номерів в одному запиті, з одним текстом для всіх або індивідуальним текстом для кожного номера. Дублікати та невірні номери відокремлюються та вказуються у відповіді.

Надіслати пакет

Підписані вебхуки

Кожне доставлене або невдале повідомлення викликає ваш endpoint з підписаною JSON-подією. Кожна подія має 10 спроб протягом приблизно 24 годин, тому розгортання ніколи не призведе до втрати статусу.

Налаштувати вебхуки

API ціноутворення

GET /v1/pricing повертає ціну за сегмент для кожної країни без ключа. Показуйте вартість у своєму продукті або перевіряйте маршрут перед масштабною розсилкою.

Отримати ціни через API

Планування

Додайте send_at до будь-якого запиту, і пакет чекатиме до вказаної хвилини (від 2 хвилин до 45 днів). Скасуйте його до початку, і повна вартість повернеться на баланс.

Запланувати пакет

Консоль для всієї команди

Вставте або завантажте список, напишіть текст, перегляньте його для кожного отримувача та надішліть без коду. Кожен пакет з API відображається в тій самій консолі з лічильниками у реальному часі.

Переглянути консоль

Єдиний API для масових SMS: коди, сповіщення та кампанії

Транзакційні повідомлення та маркетингові кампанії використовують однакові endpoint, один прайс-лист і однакові події доставки. Різниця лише в кількості номерів у одному запиті.

Транзакційні повідомлення

Одна подія у вашій системі, один текст одній особі, надісланий за лічені секунди.

  • POST /v1/messages повертає 202 з ідентифікатором повідомлення, ціною та статусом ще до того, як текст залишить нашу чергу.
  • Додайте свій order_id або user_id в reference, і цей ідентифікатор повертатиметься у кожному вебхуку для цього повідомлення.
  • Безпечний повтор: той самий Idempotency-Key повертає першу відповідь протягом 24 годин замість повторного надсилання.
Надіслати повідомлення

Масова розсилка

Один текст або індивідуальний текст для кожного отримувача у списку з тисяч номерів в одному запиті.

  • POST /v1/batches обробляє 10,000 номерів на запит; консоль приймає 50,000 номерів на кампанію з вставки або CSV-файлу.
  • Номери автоматично очищаються: пробіли, дефіси та префікси 00 виправляються, дублікати та невірні номери вказуються та пропускаються.
  • Спочатку оцініть за допомогою POST /v1/estimates: загальна вартість, сегменти та розподіл за країнами без надсилання.
Надіслати пакет

Що команди надсилають через SMS API

Реальні повідомлення з реальних систем: кожне, це окремий API-виклик або запланований пакет, з ціною за сегмент залежно від країни номера.

Коди для входу та реєстрації

Надішліть одноразовий код з вашої системи автентифікації за допомогою POST /v1/messages та перевірте статус доставки, перш ніж користувач запросить новий код.

Оновлення щодо замовлень та доставки

Ваша система замовлень викликає API, коли посилка залишає склад, вказуючи часовий проміжок та код відстеження в одному короткому повідомленні.

Нагадування про зустрічі

Щоденний процес формує список на завтра та надсилає один пакет із персональним повідомленням для кожного пацієнта чи клієнта, запланований на вечір напередодні.

Сповіщення про платежі та рахунки

Платежі карткою, перекази та вхід з нового пристрою запускають повідомлення в ту ж секунду, з оплатою за сегмент та збереженням статусу.

Розпродажі та запускові кампанії

Надсилайте до 50,000 номерів з консолі або пакети по 10,000 з вашого CRM, додаючи рядок відмови до кожного повідомлення.

Повідомлення про обслуговування та перебої

Повідомте всіх зачеплених клієнтів одразу, коли змінюється послуга, рейс чи маршрут доставки, та повідомте, коли проблема вирішена.

Надішліть пакет одним запитом

Створіть 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 за країнами

Кожна країна має одну ціну за сегмент повідомлення в доларах США, однакову через API та консоль. Простий текст до 160 символів, це один сегмент; довші або Unicode тексти використовують більше, а ціновий список показує вартість перед відправкою.
Країна
За сегмент
$0.00507
10,000 повідомлень
$50.70
SMS API до Сполучені Штати

Як розраховується ціна відправки

  • Ціна за сегмент країни номера, помножена на кількість сегментів тексту та кількість одержувачів. Нічого іншого не додається.
  • Вартість списується з вашого балансу, коли запит прийнято, тому пакет ніколи не зупиняється на півдорозі через нестачу коштів.
  • Повідомлення, які не вдалося доставити, автоматично повертаються на баланс, а запланований пакет, який ви скасували, повертається повністю.
  • Ціни зчитуються в реальному часі з GET /v1/pricing, тому ваш продукт може показувати ті самі цифри.
Повний ціновий список

227 з 227 країн

КраїнаЗа SMS
Австралія$0.00507
Австрія$0.00707
Азербайджан$0.05557
Албанія$0.01357
Алжир$0.02267
Американське Самоа$0.02177
Ангілья$0.01297
Ангола$0.00987
Андорра$0.00987
Антигуа і Барбуда$0.01327
Аргентина$0.01417
Аруба$0.01387

Оплачуйте за фактом використання з попередньо оплаченого балансу

Поповнюйте будь-яку суму від $40 до $5,000 і витрачайте її на будь-яку країну у будь-якому темпі. Баланс не має терміну придатності та щомісячної плати, а перше поповнення додає бонус.
$40+10% за перше поповнення

Баланс $44 за перше поповнення

Приблизно 8,678 односегментних повідомлень до Сполучені Штати

$100+20% за перше поповнення

Баланс $120 за перше поповнення

Приблизно 23,668 односегментних повідомлень до Сполучені Штати

$200+25% за перше поповнення

Баланс $250 за перше поповнення

Приблизно 49,309 односегментних повідомлень до Сполучені Штати

$300+30% за перше поповнення

Баланс $390 за перше поповнення

Приблизно 76,923 односегментних повідомлень до Сполучені Штати

$500+35% за перше поповнення

Баланс $675 за перше поповнення

Приблизно 133,136 односегментних повідомлень до Сполучені Штати

$1,000+40% за перше поповнення

Баланс $1,400 за перше поповнення

Приблизно 276,134 односегментних повідомлень до Сполучені Штати

Створити акаунт

Кількість повідомлень для Сполучені Штати за ціною $0.00507 за сегмент. Як працюють платежі

Ліміти, розраховані на великі обсяги

Цифри нижче, це ліміти в коді, який керує API, а документація перелічує кожен з них разом із заголовком або помилкою, що його відображає.

10,000

номерів у пакетному запиті

Надсилайте список одним запитом, розділений за країнами та тарифікований за отримувачем.

600

запитів на хвилину на ключ

Заголовки обмеження швидкості у кожній відповіді показують, що залишилось у вікні.

1,200

повідомлень на хвилину на акаунт

Черга передає повідомлення маршруту по порядку, кожні дві секунди.

Від акаунта до звіту про доставку у чотири кроки

Без продажних дзвінків та контрактів: акаунт, це ключ, створений у вашому браузері, а API відкривається після першого поповнення.
  1. Крок 1

    Створити акаунт

    Ваш браузер створює ключ акаунта. Збережіть його один раз; це єдиний логін, без електронної пошти чи пароля для керування.

  2. Крок 2

    Поповнити баланс

    Додайте від $40 через хостинг-касу. Баланс відображається у консолі та через GET /v1/balance.

  3. Крок 3

    Створити API-ключ

    Назвіть ключ для кожної програми чи середовища, скопіюйте його один раз і відкликайте будь-коли, не чіпаючи інші.

  4. Крок 4

    Надсилайте та слухайте

    Викличте /v1/messages або /v1/batches і додайте URL вебхука: події доставки та помилки надходять підписані.

Надішліть свій перший пакет сьогодні

Створіть акаунт за секунди, поповніть від $40 та викличте API з будь-якої мови, що підтримує HTTPS. Ціни починаються від $0.00247 за повідомлення.

API для масової розсилки SMS для розробників: REST, вебхуки, 227 країн | BulkSMSAPI