Приём малагасийских (+261) одноразовых кодов для тестирования продукта

Кто тестирует номера Мадагаскара или работает с ними и зачем?

Мадагаскар — франкоязычный рынок, где малагасийский является национальным языком, и оба языка официальные. Такая двуязычность делает его полезной контрольной точкой для любого продукта, который поставляет французские тексты африканским пользователям: экран регистрации, прекрасно выглядящий в Париже, всё равно может сломаться на формате номера +261 или в мобильном браузере.

К командам, которым обычно нужен номер верификации Мадагаскара, относятся:

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

Во всех случаях цель одна: увидеть, как настоящее сообщение приходит по реальному маршруту +261, а не доверять заглушке.

Как номер +261 выглядит в базе данных?

Внутри страны малагасийские мобильные записывают с транковым 0 и десятью цифрами, обычно начиная с 03. В международной форме этот 0 исчезает, и получается +261 и девять цифр.

Практические правила для вашей таблицы пользователей:

• Удаляйте транковый 0 при преобразовании в E.164; +2610… всегда неверно.
• Допускайте привычный ввод с группировкой через пробелы, затем удаляйте всё, что не является цифрой или ведущим плюсом.
• Проверьте, что для мобильного остаётся ровно девять национальных цифр.

Сообщения глобальных приложений обычно приходят на французском или английском — в зависимости от языка аккаунта, а тексты на малагасийском встречаются реже. При извлечении кода сопоставляйте цифры, а не переведённое слово.

Какие сервисы работают на маршруте Мадагаскара?

Сейчас код на номера Мадагаскара могут доставлять более 1 000 сервисов. Из часто используемых — WhatsApp, Facebook, Telegram, Google (Gmail и YouTube), TikTok, Instagram, Microsoft и Outlook, LinkedIn, Viber, imo, Signal и ChatGPT (OpenAI).

Этот состав меняется в течение дня, поэтому перед тестовым прогоном считывайте его в реальном времени из GET /api/v1/services, а не считайте, что вчерашний список остаётся верным.

Как получать коды +261 в собственные системы?

REST API по адресу https://otproute.com/api/v1 использует Bearer-ключи, начинающиеся с or_live_. На аккаунт можно держать до 10 ключей и зарегистрировать 5 вебхук-эндпоинтов при лимите 300 запросов в минуту.

Идентификатор страны для Мадагаскара — mg. Чёткая последовательность:

1. Узнайте цену через GET /api/v1/prices?country=mg&service=telegram.
2. Создайте активацию через POST /api/v1/activations с телом {"service": "telegram", "country": "mg"}.
3. Введите полученный номер в тестируемый продукт.
4. Получите activation.sms_received на своём эндпоинте или вызывайте GET /api/v1/activations/{id}, если предпочитаете опрос.
5. Если сценарий брошен, POST /api/v1/activations/{id}/cancel завершает его и возвращает удержанную сумму.

Проверяйте каждый вебхук, прежде чем ему доверять: заголовок X-OTPRoute-Signature содержит t=<unix>,v1=<hex>, и v1 должен совпадать с HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта. Отклоняйте всё со старой меткой времени и привязывайте записи к идентификатору активации, чтобы повторная доставка не навредила. Полный обработчик разобран в руководстве по приёму вебхуков.

Есть ли способ через панель для нетехнических сотрудников?

Есть. Руководитель операций может войти, открыть OTP Gateway, выбрать Мадагаскар и сервис, проверить показанную цену и оформить заказ. Номер +261 появляется на карточке активации, и входящее сообщение отображается на той же карточке. Никакого терминала и управления ключами, а 20-минутное окно работает точно так же, как и через API.

Код с Мадагаскара не пришёл. Что дальше?

Большинство неудач связано с отправляющим сервисом, а не с вашей настройкой. Прежде чем эскалировать:

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

Когда SMS не приходит до закрытия окна или вы отменяете заказ, вся сумма возвращается на кошелёк без обращения в поддержку.

Долгосрочные линии и оплата использования

На OTP Route нет самообслуживаемого долгосрочного номера для Мадагаскара. Наши Dedicated Numbers охватывают только США и Канаду, от $1.95/месяц; если вам нужна постоянная линия +261, напишите на [email protected], и команда сообщит, позволяют ли это местные правила, без каких-либо обещаний. Какой продукт подходит для какой задачи, объясняет статья о временных и выделенных номерах.

Оплата идёт с единого предоплаченного кошелька в долларах США: без подписки и выбора тарифа. Пополняйте его картой или USDT/USDC и получайте PDF-счёт на почту за каждое пополнение. Актуальные ставки по каждой паре — на странице цен. Разработчики также могут запросить режим sandbox, который выдаёт имитированные номера и коды, чтобы интеграция была проверена до начала реальных расходов.

Частые вопросы

Можно ли проверить процесс регистрации моего приложения на Мадагаскаре без местной SIM-карты?

Да. Закажите номер +261 для своего сервиса в OTP Gateway, и код появится в панели или придёт на ваш вебхук. Вы платите, только если он пришёл.

Какой идентификатор страны OTP Route использует для Мадагаскара?

Идентификатор — mg, он используется в вызовах вроде POST /api/v1/activations.

Нужно ли сохранять ведущий 0 при хранении малагасийского мобильного номера?

Нет. Отбросьте транковый 0 и сохраните +261 и девять цифр; форматируйте пробелами только для отображения.

На каком языке будет текст с кодом?

Это зависит от отправителя и настроек аккаунта. Обычно это французский и английский, поэтому разбирайте числовой код, а не фиксированную фразу.

Можно ли использовать номер +261 для тестирования повторно позже?

Каждая активация рассчитана на один код в течение 20 минут. Аккаунтам, в которые нужно входить повторно со временем, нужен другой подход, а долгосрочные номера доступны самообслуживанием только в США и Канаде.

Есть ли правила использования?

Да. Соблюдайте условия каждого сервиса и Политику допустимого использования OTP Route; используйте номера для тестирования собственного продукта или ведения настоящих бизнес-аккаунтов, один аккаунт на одного реального человека или компанию.

Нужен ли отдельный договор для OTP-маршрутизации на Мадагаскар?

Нет. Один и тот же кошелёк и API для SMS-верификации работают для всех стран, а зарегистрироваться можно по коду из письма или через вход Google.

Названия сервисов являются товарными знаками их владельцев. OTP Route не связан с ними. Используйте номера законно, соблюдайте условия каждого сервиса и нашу Политику допустимого использования.