Как направить коды подтверждения Нигера (+227) в ваш QA-процесс

Зачем продуктовой команде номер +227?

Нигер находится во франкоязычной Западной Африке и входит в Западноафриканский экономический и валютный союз, поэтому часто попадает в запуски, охватывающие сразу несколько соседних рынков. Типичные причины проверки там: убедиться, что форма регистрации принимает нигерские номера, проверить французские тексты онбординга или воспроизвести проблему, о которой сообщил клиент из Ниамея. Как команды выстраивают такую работу, смотрите на нашей странице о QA-тестировании.

Какие приложения охватывает маршрут Нигера?

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

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

Как вызвать OTP API для Нигера?

Авторизуйтесь с помощью Bearer-ключа, начинающегося с or_live_, и отправляйте запросы на https://otproute.com/api/v1. Идентификатор страны Нигер — ne.

• GET /api/v1/prices?country=ne&service=<id> возвращает актуальную цену и сведения о том, доступен ли маршрут сейчас.
• POST /api/v1/activations с {"service": "whatsapp", "country": "ne"} резервирует номер +227 и возвращает идентификатор активации.
• GET /api/v1/activations/{id} возвращает статус и, после доставки, код; вебхук на activation.sms_received избавляет от опроса.
• POST /api/v1/activations/{id}/cancel освобождает ненужный номер и возвращает деньги.

Доставки вебхука содержат заголовок X-OTPRoute-Signature; проверяйте HMAC и считайте повторный идентификатор активации пустой операцией. Подробности запросов и ответов описаны в документации для разработчиков.

Какой формат у нигерских номеров?

В Нигере закрытый план нумерации: национальные номера состоят из восьми цифр, магистрального префикса нет, так что убирать ведущий ноль не нужно. Храните их в E.164 как +227 и восемь цифр и следите, чтобы валидаторы не требовали по ошибке лишнюю цифру или 0.

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

Что должен включать план тестирования подтверждения для Нигера?

Короткий чек-лист делает прогоны +227 предсказуемыми и недорогими:

• Обработка ввода: вставьте номер с плюсом и без него и с пробелами и убедитесь, что форма нормализует все три варианта к одному значению E.164.
• Выбор страны: проверьте, что Нигер отображается под французским и английским названиями, а его выбор подставляет +227.
• Проверка текстов: прочитайте французские сообщения онбординга и ошибок, которые увидит нигерский пользователь.
• Тайм-ауты: убедитесь, что таймер повторной отправки в вашем приложении и 20-минутное окно активации не конфликтуют; дождитесь одного результата, прежде чем запрашивать следующий.
• Запасной вариант: заранее решите, какой соседний маршрут должен пробовать конвейер, если в этот день для нужного сервиса в Нигере нет доступности.

Наша статья о том, как снизить число неудачных доставок OTP, подробнее разбирает повторные попытки.

Можно ли заказать код без написания кода?

Да, через панель. Выберите Нигер и сервис, проверьте цену перед подтверждением, вставьте номер +227 в приложение и держите активацию открытой, пока не появится код. Здесь тоже действует 20-минутное окно, а всё неиспользованное автоматически возвращается на кошелёк.

Доступен ли долгосрочный номер Нигера и как устроена оплата?

Самостоятельно оформить долгосрочный номер для Нигера нельзя. Dedicated Virtual Numbers — продукт для США и Канады, от $1.95/month; для постоянной линии +227 напишите на [email protected], помня, что доступность зависит от местных правил и может быть невозможна.

Оплата идёт через один предоплаченный кошелёк в USD, пополняемый картой или USDT/USDC, без тарифного плана и абонентской платы, с PDF-счётом на каждое пополнение. Цены перечислены на странице тарифов, а режим песочницы для аккаунтов разработки возвращает имитированные номера и коды, когда нужно сначала проверить интеграцию.

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

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

Да. Запросите номер +227 для нужного сервиса в OTP Gateway, введите его на своём экране онбординга и получите код в панели или через API.

Начинаются ли нигерские номера с 0?

Нет, в Нигере нет магистрального префикса. Номера состоят из восьми цифр после +227, что упрощает нормализацию.

На каком языке будут сообщения с кодами для Нигера?

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

Код не пришёл на мой номер +227. Что делать?

Дайте 20-минутному окну закрыться, чтобы применился возврат, затем повторите позже или проверьте через другой маршрут сервиса. Сервис мог отклонить виртуальные номера, а частые быстрые заказы редко помогают.

Одинакова ли цена для Нигера и других стран?

Не обязательно. Цены начинаются от $0.20 за код и зависят от сервиса и страны, поэтому перед заказом вызовите GET /api/v1/prices или посмотрите в панели.

Может ли OTP Route принять второй код на тот же нигерский номер позже?

Нет, номер OTP Gateway обрабатывает один код подтверждения. Аккаунтам, в которые нужно входить многократно, лучше подходит Dedicated Number из США или Канады.

Какие соседние маршруты можно использовать для более широкого теста по Западной Африке?

У Буркина-Фасо, Бенина, Мали и Нигерии есть собственные маршруты. Что доступно сегодня, смотрите в GET /api/v1/countries.

Какие правила действуют при использовании номеров +227?

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

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