Переведите свой SMS-трафик с любого провайдера на BroadNet.

Подключите ваш текущий API к BroadNet

Большинство SMS API используют одни и те же несколько концепций под разными названиями. Найдите концепцию в первом столбце, независимо от того, как её называет ваш провайдер, и используйте эквивалент BroadNet. Названия полей точно такие же, как в спецификации OpenAPI.

Вот пример отправки в виде одного запроса. Замените поля отправителя, получателя и текста вашего провайдера на senderId, destinationNumber и message :

curl -X POST https://api.broadnet.me/sms/sendSms \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "ACME",
    "destinationNumber": "447700900101",
    "message": "Your code is 8123",
    "messageType": "TEXT"
  }'

# 200 OK — the response body is the message ID, e.g. 2603121407537573731

Чтобы проверить статус сообщения, запросите его состояние, используя идентификатор сообщения, возвращенный запросом на отправку:

# Status lookup on the legacy HTTP API (/websmpp), by message ID
curl "https://api.broadnet.me/websmpp/websmsstatus?respid=2603121407537573731&format=json" \
  -H "Authorization: Bearer $BROADNET_TOKEN"

# "status": "DELIVRD"   (or UNDELIV, EXPIRED, REJECTD)

Переместите свои идентификаторы отправителя

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

1. 1

   Перечислите все идентификаторы отправителей, страны, в которые они отправляют сообщения, и тип передаваемого трафика: OTP, транзакционный или маркетинговый.

2. 2

   Проверьте правила каждой страны. В ОАЭ идентификаторы отправителей регистрируются в соответствии с правилами TDRA через оператора, один идентификатор на юридическое лицо на один случай использования. В Саудовской Аравии для этого требуется одобрение CST и оператора, а иностранные отправители привязываются через местного агрегатора, имеющего лицензию CST.

3. 3

   Ваш инженер по миграции отправляет заявки на регистрацию маршрутов BroadNet, а группа контроля соответствия BroadNet отслеживает каждую из них до момента утверждения.

4. 4

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

Правила для каждого рынка указаны на страницах с нормативными актами. Правила использования SMS в разных странах

Запустите оба провайдера параллельно

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

Сравнение по странам и операторам:

• Сочетание статусов доставки: доставлено, недоставлено, истек срок действия и отклонено.
• Время от отправки сообщения до получения подтверждения о его доставке.
• Отправитель отображается на экране телефона.
• Количество сегментов для того же текста, начиная с POST /sms/identify.

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

// Send a share of recipients through BroadNet; the rest stay on your
// current provider. BROADNET_SHARE is a percentage (0-100) you control.
const BROADNET_SHARE = Number(process.env.BROADNET_SHARE ?? "0");

// Same recipient -> same bucket, so OTP retries stay on one provider.
function bucket(to: string): number {
  let h = 0;
  for (const c of to) h = (h * 31 + c.charCodeAt(0)) >>> 0;
  return h % 100;
}

export async function sendSms(to: string, text: string, senderId: string) {
  if (bucket(to) < BROADNET_SHARE) return sendViaBroadNet(to, text, senderId);
  return sendViaCurrentProvider(to, text, senderId); // your existing code
}

async function sendViaBroadNet(to: string, text: string, senderId: string) {
  const res = await fetch("https://api.broadnet.me/sms/sendSms", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BROADNET_TOKEN}`,
      "Content-Type": "application/json",
    },
    // Use UNICODE for non-GSM text; POST /sms/identify tells you which.
    body: JSON.stringify({ senderId, destinationNumber: to, message: text, messageType: "TEXT" }),
  });
  if (!res.ok) throw new Error(`BroadNet send failed: ${res.status}`);
  return { provider: "broadnet", messageId: await res.text() };
}

Постепенное увеличение трафика

Перемещайте производственные объемы в BroadNet поэтапно, выбирая одну страну или один сценарий использования за раз. Оставайтесь на каждом этапе, пока подтверждения доставки не совпадут с отправленными данными, затем переходите к следующему.

1. Тестирование

   Только ваши собственные подтвержденные номера. Подтвердите идентификатор отправителя, текст сообщения и отчёты о доставке.

2. 5%

   Небольшая доля реального трафика. Трафик OTP в одну страну обеспечивает быструю и понятную доставку.

3. 25%

   Достаточный объем данных для сравнения тарифов на доставку и сроков получения с вашим текущим поставщиком.

4. 100%

   Весь трафик для данной страны или сценария использования. Ваш текущий провайдер остается активным до тех пор, пока подтверждения доставки не совпадут с отправленными вами данными.

Сколько времени это займет

Увеличение трафика занимает столько времени, сколько вы выберете. Процесс внедрения проходит по одному пути: мы отвечаем на запрос о тестовом доступе в течение одного рабочего дня, техническая интеграция занимает 2–5 рабочих дней, а проверка маршрута с подтверждением идентификатора отправителя — 3–10 рабочих дней. На большинстве рынков от этапа обнаружения до запуска проходит 5–15 рабочих дней; на рынках, где регулирующие органы дольше утверждают идентификаторы отправителей, этот процесс занимает больше времени. Ознакомьтесь с этапами адаптации.

Возврат к текущему провайдеру без перебоев в работе

Для отката используйте тот же переключатель в обратном порядке: уменьшите процент трафика, отправляемого через BroadNet, до последнего успешно выполненного шага или до нуля. Ваша текущая интеграция и регистрация идентификаторов отправителей остаются активными все время, поэтому достаточно уменьшить процент. Ничего не нужно перестраивать.

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

Кто за что несёт ответственность

Миграция затрагивает ваш код, регистрацию отправителей и реальный трафик. Вот как распределяется работа.

Соответствующая документация

Часто задаваемые вопросы