Маршрутизация проверочных кодов Республики Конго (+242) в ваш тестовый стек

Какие вызовы API получают код +242 от начала до конца?

Всё находится под https://otproute.com/api/v1 и авторизуется Bearer-ключом, начинающимся с or_live_. Ключи создаются в консоли разработчика; на аккаунте может быть до 10, так что stagingу, CI и ноутбуку коллеги легко выдать отдельные учётные данные, которые отзываются независимо.

Типичный тестовый прогон для рынка Браззавиля выглядит так:

1. Получите GET /api/v1/services и GET /api/v1/countries и закэшируйте id. Республика Конго — это cg (не путайте с более крупным соседом, у которого свой id и страница Конго (ДРК)).
2. Запросите GET /api/v1/prices?country=cg&service=<id>, чтобы узнать актуальную цену и доступность тестируемого приложения.
3. Создайте активацию через POST /api/v1/activations с телом вроде {"service": "telegram", "country": "cg"}. Вы получите id активации и номер +242.
4. Введите этот номер на экране регистрации или входа вашего продукта.
5. Заберите конголезский код из доставки вебхука или опросом GET /api/v1/activations/{id}. Если тест прервался, освободите номер через POST /api/v1/activations/{id}/cancel.

Выполните GET /api/v1/balance перед запуском набора тестов, чтобы пустой кошелёк обрушил задачу сразу, а не посередине. Лимит 300 запросов в минуту оставляет достаточный запас для нескольких параллельных воркеров. Полные формы запросов и ответов — в документации для разработчиков.

Как подключить подписанный вебхук для конголезских активаций?

Опроса достаточно, когда один инженер прокликивает сценарий; для парка CI вебхук удобнее. Добавьте эндпоинт в консоли разработчика (на аккаунт допускается пять) и подпишитесь на activation.sms_received, activation.expired и activation.cancelled.

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

Считайте события привязанными к id активации. Если одно и то же событие пришло дважды, ваш обработчик должен заметить, что id уже обработан, и просто вернуть статус успеха. Руководство по приёму вебхуков показывает схемы очередей, при которых медленные тестовые раннеры не упираются в тайм-ауты.

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

Сегодняшний срез для cg включает WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, X (Twitter), ChatGPT (OpenAI), Claude, Microsoft & Outlook, LinkedIn, Signal, Viber и imo. Всего в стране в OTP Gateway доступно более 1 000 сервисов.

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

Как хранить и нормализовать номера +242?

Номера Республики Конго состоят из девяти цифр после кода страны, и, в отличие от многих планов нумерации, ведущий 0 здесь — часть абонентского номера, а не транковый префикс. Мобильные линии обычно записываются локально как 06… или 05…, а в международном виде — как +242 06…. Нормализатор, скопированный из европейской кодовой базы и убирающий любой ведущий ноль, тихо испортит такие номера, поэтому храните ровно ту строку E.164, которую возвращает API, и проверяйте длину по странам, а не одним глобальным правилом.

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

Команды обычно тестируют здесь при запуске продукта в франкоязычной Центральной Африке, поддержке операционных сотрудников в Браззавиле или Пуэнт-Нуаре, а также при обслуживании конголезцев за рубежом, которые по-прежнему регистрируются на домашний номер. Проверка всего сценария на реальном маршруте +242 выявляет проблемы форматирования и текстов, которые симулятор бы пропустил.

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

Тишина — это обычно вопрос маршрута или приёма, а не ошибка интеграции. Разумный порядок действий:

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

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

Можно ли держать долгосрочную конголезскую линию?

Самостоятельной долгосрочной линии для Республики Конго нет. OTP Gateway выдаёт один номер на один проверочный код, и сейчас для cg это единственный предлагаемый продукт.

Dedicated Virtual Numbers (выделенные виртуальные номера) OTP Route — продукт для США и Канады от $1.95 в месяц, с входящими и исходящими SMS и звонками из браузера. Если вашей команде действительно нужна постоянная конголезская линия, напишите на [email protected]; можно ли что-то организовать, зависит от местных правил, так что воспринимайте это как вопрос, а не как обещание. Компромиссы кратко описаны в материале о временных и выделенных номерах.

Как оплачивать и безопасно тестировать маршрутизацию OTP для Конго?

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

Прежде чем подключать к конвейеру реальные деньги, попросите поддержку перевести тестовый аккаунт в режим песочницы. Он возвращает имитированные номера и коды, так что весь путь SMS verification API можно прогнать целиком, ничего не потратив. Используйте OTP Route только для собственных продуктов и аккаунтов, которыми вы вправе управлять; условия каждого сервиса и наша Политика допустимого использования по-прежнему действуют. О том, как списания и возвраты отображаются в кошельке, смотрите на странице тарифов.

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

Какой id у Республики Конго в API OTP Route?

Это cg. Демократическая Республика Конго — отдельная страна со своим id, поэтому дважды проверьте, на какую ссылается ваш конфиг.

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

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

Нужно ли убирать ведущий ноль при сохранении номера +242?

Нет. В Республике Конго 0 принадлежит девятизначному абонентскому номеру, поэтому храните значение E.164 точно в том виде, в каком его возвращает API.

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

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

Спишутся ли деньги, если код не придёт?

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

Сколько стоит получение SMS OTP из Конго?

От $0.20 за код; цена +242 для каждого приложения указывается в реальном времени, поэтому запросите её перед заказом.

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

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

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