Питання та відповіді про 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}} у тексті.

Налаштуйте текст відмови один раз у Налаштуваннях, наприклад, посилання або електронну адресу, і консоль додасть його до текстів кампанії, коли ви поставите галочку. Через 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 статусом. Ви також можете опитувати кінцеві точки повідомлень у будь-який час.

Телефон може бути вимкненим занадто довго, номер може більше не бути в службі, або мережа може відхилити повідомлення. Статус невдачі містить код помилки, а вартість повертається.

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

Так. У консолі вставте номери або завантажте CSV-файл до 50 000 рядків, напишіть текст з полями злиття, перевірте прев'ю для кожного отримувача та вартість за країну, і надішліть зараз або у вказаний час.

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

Зі сторінки Support у консолі. Питання щодо оплати можна задавати з першого дня; інші теми стають доступними після зарахування першого поповнення.