Как принимать эритрейские коды подтверждения +291 для QA и поддержки

Зачем продуктовой команде эритрейский номер?

Чаще всего +291 просят команды, у пользователей которых есть семейные или деловые связи с Эритреей, а не те, кто запускается в стране всерьёз. Мессенджеры и сообщества нередко обслуживают заметную эритрейскую диаспору, и эти люди ждут, что родная страна будет работать в списке выбора кода, на шаге с SMS и на экране восстановления доступа. Реальная линия +291 позволяет QA убедиться, что весь путь регистрации принимает этот префикс, корректно его показывает и выдаёт рабочий код.

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

Какие приложения могут присылать коды на номер +291?

В текущем срезе по Eritrea указано более 500 сервисов. Чаще всего запрашивают WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber и imo.

Наличие на небольшом направлении меняется в течение дня, поэтому считайте этот список отправной точкой. Пусть тестовый стенд непосредственно перед заказом читает GET /api/v1/prices?country=er&service=<id>, а не доверяет вчерашнему кешу.

Как выглядит последовательность вызовов Eritrea OTP API?

1. Создайте Bearer-ключ в консоли разработчика. Ключи начинаются с or_live_, в одном аккаунте их может быть до 10.
2. Один раз получите идентификаторы через GET /api/v1/countries и GET /api/v1/services; Eritrea — это er.
3. Проверьте цену и наличие для вашей пары через GET /api/v1/prices.
4. Отправьте POST /api/v1/activations с телом вида {"service": "telegram", "country": "er"} и сохраните возвращённый id активации.
5. Получите activation.sms_received на свой вебхук или опрашивайте GET /api/v1/activations/{id} с необременительным интервалом.
6. Если тестовый прогон прекращён, вызовите POST /api/v1/activations/{id}/cancel, чтобы снять резерв.

Каждая доставка вебхука содержит X-OTPRoute-Signature. Пересчитайте HMAC-SHA256 от метки времени и сырого тела с секретом вашего эндпоинта, сравните значения и отбрасывайте всё с устаревшей меткой. Лимит на весь аккаунт — 300 запросов в минуту, этого более чем достаточно для работы с таким SMS verification API.

Как хранить номера +291 и на каком языке приходят коды?

Храните каждый номер в формате E.164: знак плюс, 291, затем национальные цифры без пробелов и знаков препинания. Если пользователь вводит внутренний формат с ведущим 0, уберите эту цифру перед добавлением кода страны, а удобное группированное написание применяйте только при отображении.

У Эритреи нет единого официального языка: в повседневной жизни встречаются тигринья, арабский и английский. Коды от глобальных приложений обычно приходят на языке, выбранном в аккаунте или на устройстве, чаще всего это английский или арабский. Если ваш продукт сам отправляет локализованные тексты, проверьте, что тигринья в письменности геэз целиком переживает ваши SMS-шаблоны.

Что делать, если код не приходит?

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

Истёкшая или отменённая активация ничего не стоит: вся сумма возвращается в кошелёк.

Есть ли способ получить код +291 без программирования для сотрудников поддержки?

Да. Сотрудник без доступа к API входит в аккаунт, выбирает сервис и Eritrea, смотрит показанную цену и оформляет заказ. Временный номер появляется сразу, а код отображается рядом, как только приходит SMS. Такой путь подходит агенту поддержки, который воспроизводит жалобу клиента на эритрейский шаг регистрации.

Можно ли сохранить эритрейский номер и как устроена оплата?

Самостоятельно оформить долгосрочную линию +291 нельзя. Dedicated Numbers — продукт для США и Канады от $1.95/месяц (как это работает); по Eritrea можно написать на [email protected] и спросить, но ответ зависит от местных правил, и ничего не обещается.

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

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

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

Да. Закажите номер +291 для своего приложения или поддерживаемого сервиса, запустите отправку SMS и прочитайте код в дашборде или через API.

Какой идентификатор у Eritrea в API OTP Route?

Это er. Используйте его в поле country запроса POST /api/v1/activations и как значение параметра в GET /api/v1/prices.

Сколько стоит номер подтверждения для Eritrea?

Коды начинаются от $0.20, а точная цена для каждого сервиса возвращается в реальном времени перед заказом. Вы платите только тогда, когда код доставлен.

Как долго активация +291 остаётся открытой?

Двадцать минут. Если номер больше не нужен, отмените раньше; в любом случае активация без кода возвращается полностью.

Примут ли номер +291 все сервисы для тестов?

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

Есть ли песочница, чтобы сначала отладить интеграцию?

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

На каком языке придёт эритрейский SMS-код?

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

Можно ли открывать эритрейскими номерами много аккаунтов?

Нет. OTP Route предназначен для тестирования собственного продукта и работы с легитимными бизнес-аккаунтами: один аккаунт на одного реального человека или компанию.

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