Как получать гвинейские (+224) коды подтверждения в тестах и рабочих инструментах

Зачем команде номер +224 для тестирования?

Гвинея находится во франкоязычной части Западной Африки, и продукты, выходящие на этот регион, часто должны до начала маркетинговых расходов убедиться, что регистрация работает для гвинейских абонентов. Другие типичные поводы: приложение для гвинейской диаспоры во Франции и других странах, проверка онбординга финтех-сервиса для франкоязычных рынков или полевые и операционные команды в Конакри, которые ведут общие бизнес-аккаунты. Во всех этих случаях нужен номер +224 для тестирования, который не придётся возить с собой в телефоне.

OTP Route закрывает эту задачу без возни с местными SIM-картами. На странице тестирования QA показано, как команды встраивают это в чек-листы релизов.

Какие сервисы могут отправить код на гвинейский номер?

В текущем срезе по Гвинее среди популярных сервисов — WhatsApp, imo, Telegram, Viber, Facebook, Instagram, TikTok, Snapchat, Signal, Google (Gmail & YouTube), Microsoft & Outlook и ChatGPT (OpenAI). Во всех категориях вместе маршрут охватывает более 1 700 сервисов.

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

Как устроена последовательность вызовов Guinea OTP API?

Авторизуйтесь Bearer-ключом (префикс or_live_) на https://otproute.com/api/v1. Сначала запросите GET /api/v1/prices?country=gn&service=<id>, чтобы узнать, доступен ли сервис для Гвинеи. Затем отправьте POST /api/v1/activations с телом {"service": "<id>", "country": "gn"}, сохраните id активации и введите номер в тестируемом приложении.

Код приходит событием activation.sms_received на зарегистрированный вебхук, либо вы можете опрашивать GET /api/v1/activations/{id}. Проверяйте заголовок X-OTPRoute-Signature (HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта), отклоняйте устаревшие метки времени и игнорируйте повторные события по уже обработанной активации. Прервать прогон можно через POST /api/v1/activations/{id}/cancel. Подробнее — в руководстве по интеграции и в документации.

Как работать из браузера тем, кто не пишет код?

Откройте OTP Gateway, выберите Гвинею, найдите сервис, проверьте цену и оформите заказ. Вставьте номер на экране подтверждения: входящее SMS появится на карточке активации в панели. Агентства, которые ведут клиентские аккаунты в Гвинее, часто выбирают этот путь: один общий кошелёк покрывает всех, а API-ключ не покидает инженерную команду. Регистрация требует email и 6-значный код из письма, а для самого аккаунта доступен двухфакторный вход через приложение-аутентификатор.

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

В Гвинее нет транковой приставки, национальные номера состоят из девяти цифр, а мобильные обычно начинаются с 6. Приводите ввод к виду +224 и девяти цифр и храните в базе единственный формат E.164; старые записи с восемью цифрами стоит пометить при очистке данных.

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

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

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

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

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

Через панель — нет. Для Гвинеи нет долгосрочного номера по самообслуживанию, а номера активаций рассчитаны на один код. Выделенные виртуальные номера продаются только для США и Канады, от $1.95/месяц, и включают пересылку входящих SMS на ваш вебхук, исходящие SMS и звонки из браузера. Для постоянной гвинейской линии напишите на [email protected]: доступность зависит от местных правил, и команда прямо скажет, если организовать это не получится.

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

Можно ли проверить регистрацию в приложении по гвинейскому номеру без местной SIM?

Да. Закажите номер +224 в OTP Gateway, используйте его в форме регистрации и прочитайте код в панели или через вебхук.

Какой id страны OTP Route использует для Гвинеи?

Это gn. Укажите его в теле активации и в запросе цен.

Сколько стоит получение SMS с OTP-кодом из Гвинеи?

От $0.20 за код; точная сумма зависит от сервиса и показывается до заказа.

Платить ли за активацию, на которую код так и не пришёл?

Нет. Если 20-минутное окно закончилось без SMS или вы отменили активацию, вся сумма автоматически возвращается на кошелёк.

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

Подходит и то и другое. Вебхуки удобны для параллельных наборов тестов, а опрос GET /api/v1/activations/{id} годится для простого скрипта в рамках лимита 300 запросов в минуту.

Примут ли номер +224 от OTP Route все сервисы?

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

Как оплачивать и выдаются ли счета?

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

Есть ли песочница для разработки интеграции с Гвинеей?

Да, по запросу. Аккаунт разработчика можно переключить в режим песочницы, который возвращает имитированные номера и коды, так что весь процесс SMS-верификации через API можно пройти, не тратя средства кошелька.

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