Вопросы и ответы по Bulk SMS API

Bulk SMS API для разработчиков: отправляйте одно сообщение или пакет до 10 000 номеров за запрос в 227 стран через REST, отслеживайте каждое сообщение с помощью подписанных вебхуков и оплачивайте каждое сообщение с предоплаченного баланса. Веб-консоль позволяет отправлять кампании из списка или CSV без написания кода.

Продуктовые и инженерные команды, которые отправляют сообщения из своих систем: коды входа и регистрации, обновления заказов и доставки, напоминания о встречах, уведомления о платежах, служебные уведомления и маркетинговые кампании. Любой, кто может сделать HTTPS-запрос, может использовать его.

227 стран и территорий, перечисленных с их ценами на странице цен и страницах стран. Один запрос может включать разные страны: каждый номер оценивается по стране, к которой он принадлежит.

Нет. Вы платите за каждый сегмент сообщения с предоплаченного баланса, и нет ежемесячной платы, платы за настройку или минимального объема. Баланс не имеет срока действия.

Аккаунты начинаются с нулевого баланса, и первое пополнение открывает все возможности. Первое пополнение добавляет бонус до 40%, поэтому первые сообщения стоят дешевле. Цены публичны, а конечная точка оценки и консоль показывают точную стоимость до отправки.

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

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

Международный формат E.164: знак плюса, код страны и национальный номер, например +14155550123. Пробелы, тире, скобки и префикс 00 автоматически удаляются; дубликаты и номера, которые невозможно прочитать, откладываются и не оплачиваются.

До 10 сегментов: 1,530 символов в GSM-7 или 670 в Unicode. Один сегмент содержит 160 символов GSM-7 или 70 символов Unicode; более длинные тексты разбиваются на части по 153 или 67 символов и снова объединяются на телефоне.

Один символ вне алфавита GSM-7, например кавычка, эмодзи или буква вроде á или ç, переводит весь текст в Unicode с 70 символами на сегмент. Композитор в консоли указывает такие символы, а POST /v1/estimates возвращает кодировку перед отправкой.

Да. Добавьте send_at в API-запрос или выберите время в консоли, от 2 минут до 45 дней вперед. Запланированный пакет можно отменить до начала отправки, и его полная стоимость вернется на баланс.

Да. Через API отправьте пакет с сообщениями, одно {to, text} для каждого получателя. В консоли вставьте или загрузите список с дополнительными столбцами и используйте поля подстановки {{1}} до {{9}} в тексте.

Настройте текст отказа один раз в Настройках, например ссылку или email, и консоль добавит его в тексты кампаний, если вы поставите галочку. Через API вы контролируете весь текст, поэтому добавьте строку отказа самостоятельно в маркетинговые сообщения. Номера из вашего списка исключений пропускаются консолью и API и не оплачиваются.

Да. В консоли есть функция тестовой отправки на один номер перед кампанией, а через API вы можете отправить одно сообщение на свой телефон с помощью POST /v1/messages.

Каждое сообщение проходит этапы: в очереди, отправлено, доставлено или не доставлено. Добавьте URL вебхука в консоли, чтобы получать подписанные события для каждого финального статуса, или используйте GET /v1/messages/{id} и GET /v1/batches/{id}.

В формате Standard Webhooks: заголовки webhook-id, webhook-timestamp и webhook-signature, где подпись, это HMAC-SHA256 от id, timestamp и тела запроса с вашим секретом whsec_. В документации есть код проверки для Node.js, Python, PHP и Go.

Каждое событие получает 10 попыток в течение примерно 24 часов, и каждая попытка отображается в консоли с ее HTTP-статусом. Вы также можете опрашивать конечные точки сообщений в любое время.

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

Пакеты, сообщения и журнал баланса остаются в вашем аккаунте и в API. Журнал запросов хранит последние 500 вызовов API, а журнал вебхуков, последние 500 доставок.

Да. В консоли вставьте номера или загрузите CSV-файл до 50 000 строк, напишите текст с полями для слияния, проверьте предварительный просмотр для каждого получателя и стоимость по странам, и отправьте сейчас или в установленное время.

Баланс, последние пакеты с текущими счетчиками, каждый пакет с его сообщениями и статусами, пополнения и журнал, API-ключи, настройки и доставки вебхуков, журнал запросов, прайс-лист, тикеты поддержки и настройки.

Со страницы поддержки в консоли. Вопросы по оплате можно задавать с первого дня; другие темы открываются после зачисления первого пополнения.