Как воспроизвести проблемы с кодами на +245, не имея телефона в Бисау

Клиенты из Гвинеи-Бисау говорят, что код не приходит. Как это воспроизвести?

Обращения из небольшого рынка трудно разбирать. Пользователь в Бисау сообщает об отсутствующем коде, инженеры сидят в Лиссабоне или Дакаре, и никто не видит, что на самом деле делает экран регистрации с номером +245. Гадать по логам редко помогает.

Одноразовый номер +245 из OTP Gateway позволяет команде пройти тот же путь, что и местный клиент: ввести номер, запустить отправку SMS и посмотреть, дойдёт ли код. Поскольку каждый номер рассчитан на одну проверку, тест можно повторять после каждого исправления, не используя устаревшие данные. Такой подход подходит и службам поддержки и операционным командам, которым нужны доказательства до закрытия обращения.

Какие сервисы сейчас отправляют коды на номера +245?

В актуальном срезе по Гвинее-Бисау доступно более 900 сервисов. Среди известных — WhatsApp, Facebook, imo, Telegram, Instagram, TikTok, Google (Gmail & YouTube), Microsoft & Outlook, Signal, Viber, LinkedIn и Uber.

Считайте этот список срезом маршрута Бисау, а не фиксированным каталогом. На небольших маршрутах ёмкость в течение дня меняется заметнее, поэтому доступность берётся из API в момент запроса. Если нужной комбинации нет, помочь могут соседние маршруты, например Сенегал или Кабо-Верде, если тест не привязан к префиксу +245.

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

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

• Получите id через GET /api/v1/services и GET /api/v1/countries.
• Узнайте текущую цену и доступность через GET /api/v1/prices?country=gw&service=<id>.
• Оформите заказ через POST /api/v1/activations с телом {"service": "imo", "country": "gw"} и запишите id активации.
• Введите номер +245 в своём приложении.
• Заберите код +245 из события activation.sms_received или, как запасной вариант, опрашивайте GET /api/v1/activations/{id}.
• Если сценарий завершился раньше, вызовите POST /api/v1/activations/{id}/cancel.

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

Руководителю поддержки нужен один код сегодня. Есть ли путь без кода?

Для разовых проверок хватает панели. Выберите Гвинею-Бисау, сервис, подтвердите цену и закажите. Номер появится на экране; вставьте его в приложение, и входящий код отобразится на той же странице активации. Ничего устанавливать не нужно, а отмена неиспользованной активации возвращает деньги сразу.

Что особенного в телефонных номерах и языке SMS в Гвинее-Бисау?

Всегда храните номера +245 в формате E.164. Пользователи вводят их по-разному — с пробелами, точками или лишним ведущим нулём, поэтому очищайте ввод от знаков препинания и проверяйте длину с помощью поддерживаемой библиотеки для телефонных номеров, а не правила, которое вы когда-то написали и забыли.

Официальный язык — португальский, а в повседневной жизни широко используется гвинейско-бисауский креольский (кригиол). Проверочные сообщения международных сервисов обычно приходят на португальском или английском в зависимости от отправителя. Если ваш продукт обслуживает португалоязычных пользователей в нескольких странах, +245 — удобный случай убедиться, что шаблоны, написанные для Португалии или Бразилии, по-прежнему звучат естественно, а парсер извлекает цифры независимо от формулировки.

Гвинея-Бисау входит в ЭКОВАС и пользуется западноафриканским франком КФА вместе с соседями, поэтому команды финтеха и маркетплейсов часто тестируют её вместе с остальным регионом.

На номер +245 ничего не пришло. Что делать?

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

Шаги, которые обычно помогают:

1. Проверьте, принимает ли сервис виртуальные номера в этом сценарии; некоторые не принимают.
2. Повторите позже, когда ёмкость маршрута изменится.
3. Попробуйте другой маршрут сервиса, ведущий на тот же экран.
4. Растягивайте попытки во времени, а не запускайте новые заказы в цикле.

Можно ли оставить линию +245 надолго и как проходит оплата?

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

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

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

Можно ли получать SMS с OTP-кодами из Гвинеи-Бисау через API?

Да. Создайте активацию со страной gw, затем прочитайте код через вебхук или опросом эндпоинта активации.

Как протестировать регистрацию по +245 в своём приложении, не летя в Бисау?

Закажите номер +245 для тестирования в OTP Gateway, введите его в приложении и дождитесь кода в панели.

Сколько стоит проверочный номер Гвинеи-Бисау?

От $0.20 за код; API и панель показывают точную цену для каждого сервиса до заказа.

Что будет, если код не придёт в течение окна?

Активация истекает через 20 минут, и вся сумма возвращается на кошелёк без каких-либо запросов с вашей стороны.

На каком языке обычно приходят проверочные тексты в Гвинее-Бисау?

В основном на португальском или английском, в зависимости от сервиса-отправителя.

Есть ли постоянный номер Гвинеи-Бисау?

Не как продукт самообслуживания. Выделенные линии ограничены США и Канадой; о +245 можно спросить в поддержке по email.

Какие маршруты использовать, если для моего сервиса в Гвинее-Бисау нет номеров?

Проверьте позже или попробуйте соседнюю западноафриканскую страну, например Сенегал, если ваш тест не зависит от префикса +245.

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