Всё, что стоит знать, и ничего лишнего.
Запрос
Шлюз BroadNet принимает POST-запрос к https://api.broadnet.me/sms/sendSms с токеном в заголовке Authorization: Bearer и JSON-телом: senderId (идентификатор отправителя), destinationNumber (номер получателя в международном формате, только цифры, без знака +), message (текст) и messageType (TEXT для GSM-7, UNICODE для арабского, эмодзи и других нелатинских алфавитов). Успешный вызов возвращает 200 OK с идентификатором сообщения в теле ответа.
Кодирование и длина
Сообщение GSM-7 вмещает 160 символов в сегменте (153, если сообщение занимает несколько сегментов); при переходе на Unicode для эмодзи или нелатинских алфавитов лимит снижается до 70 (67 для составных сообщений). Указывайте messageType TEXT для обычного GSM-7 и UNICODE, когда тексту нужен Unicode или арабский, чтобы символы не искажались; POST /sms/identify возвращает кодировку и число сегментов до отправки.
Отслеживайте доставку, не стоит полагаться на случай.
Возвращаемый идентификатор сообщения — это дескриптор подтверждения доставки (DLR). Настройте веб-перехватчик для получения окончательного статуса оператора — доставлено, не доставлено или истекло — вместо того, чтобы рассматривать код 200 при отправке как доказательство того, что телефон получил сообщение.
Переход к производству
Используйте международные номера E.164, зарегистрируйте свой идентификатор отправителя на каждом целевом рынке до масштабирования и используйте прямые маршруты операторов для обеспечения стабильной задержки. При больших объемах одна и та же учетная запись доступна как по SMPP, так и по REST, поэтому вы можете начать работу по HTTP и менять типы привязки без повторной регистрации.