API для массовой отправки SMS

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 endpoints для опроса.
Планирование
send_at от 2 минут до 45 дней вперед; запланированные пакеты отменяются с полным возвратом средств.
Текст
GSM-7 и Unicode (UCS-2), длинные сообщения до 10 сегментов, поля подстановки и персонализированный текст для каждого получателя.
Оплата
Предоплаченный баланс от $40, пополнение через хостинг-чек. Неудачные сообщения возвращаются на баланс.

Базовые компоненты

Все, что нужно для интеграции массовой отправки SMS

Шесть частей одного API, все с оплатой за сообщение и все видны в одной консоли. Используйте одну или объедините их в полноценный конвейер уведомлений.

Одиночные сообщения

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

Отправить сообщение

Пакеты

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

Отправить пакет

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

Каждое доставленное или не доставленное сообщение вызывает ваш эндпоинт с подписанным JSON-событием. У каждого события есть 10 попыток за ~24 часа, поэтому развертывание не приведет к потере статуса.

Настроить вебхуки

API тарифов

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

Получить цены через API

Планирование

Добавьте send_at к любому запросу, и пакет будет ждать указанной минуты (от 2 минут до 45 дней). Отмените до начала отправки, полная стоимость вернется на баланс.

Запланировать пакет

Консоль для всей команды

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

Посмотреть консоль

Единый API для массовых SMS: коды, уведомления и кампании

Транзакционные сообщения и маркетинговые кампании используют одни и те же эндпоинты, тарифы и события доставки. Разница лишь в количестве номеров в одном запросе.

Транзакционные сообщения

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

  • POST /v1/messages возвращает 202 с ID сообщения, ценой и статусом до того, как текст покинет нашу очередь.
  • Укажите свой ID заказа или пользователя в reference, он вернется в каждом вебхуке для этого сообщения.
  • Безопасные повторы: один и тот же Idempotency-Key возвращает первый ответ в течение 24 часов вместо повторной отправки.
Отправить сообщение

Массовые кампании

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

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

Что отправляют команды через SMS API

Реальные сообщения из реальных систем: каждый, это отдельный API-вызов или запланированный пакет, тарифицируемый по сегментам для страны номера.

Коды для входа и регистрации

Отправляйте одноразовый код из вашей системы аутентификации через POST /v1/messages и проверяйте статус доставки до запроса нового кода пользователем.

Обновления о заказах и доставке

Ваша система заказов вызывает API при отправке посылки, указывая временное окно и трек-номер в одном коротком сообщении.

Напоминания о встречах

Ночной процесс формирует список на завтра и отправляет персональные сообщения каждому пациенту или клиенту вечером накануне.

Оповещения о платежах и аккаунте

Платежи, переводы и входы с новых устройств мгновенно запускают SMS, тарифицируемые по сегментам с фиксацией статуса.

Акции и запуски

Отправляйте 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.01417

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

Пополните баланс на любую сумму от $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

    Создать аккаунт

    Ваш браузер создаёт ключ аккаунта. Сохраните его один раз, это единственный способ входа, без email или пароля.

  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