Чилийские коды верификации для QA и команд запуска через API

Номер шлюза или Dedicated Number: что нужно для чилийского теста?

Выбор определяется одним вопросом: понадобится ли кому-то код именно на этот номер +56 ещё раз? Для большинства задач по Чили, таких как тест регистрации, разовая проверка онбординга или подтверждение бизнес-профиля, ответ отрицательный, и подходит OTP Gateway. Вы получаете один номер, он принимает один код, и работа закончена.

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

• Используйте OTP Gateway, когда код нужен один раз: регрессия регистрации, дымовой тест перед чилийским релизом, подтверждение одного аккаунта.
• Используйте американский или канадский Dedicated Number, когда общий вход в стейджинг должен продолжать получать коды, а чилийская идентичность аккаунту не нужна.

Компромиссы подробнее описаны в материале о временных и выделенных номерах.

Как OTP API для Чили работает от заказа до кода?

API для SMS-верификации — это обычный REST по адресу https://otproute.com/api/v1, с аутентификацией Bearer-ключом с префиксом or_live_, который вы создаёте в консоли разработчика. Идентификатор страны для Чили — cl.

1. Вызовите GET /api/v1/services и закешируйте идентификаторы сервисов, которые используют ваши тесты, например whatsapp или uber.
2. Читайте актуальную цену из GET /api/v1/prices?country=cl&service=<id>, а не зашивайте стоимость в код.
3. Сделайте заказ через POST /api/v1/activations с телом вида {"service": "whatsapp", "country": "cl"}. В ответе будут номер +56 и идентификатор активации.
4. Введите этот номер в тестируемый процесс и запустите отправку SMS.
5. Опрашивайте GET /api/v1/activations/{id} или положитесь на вебхук activation.sms_received.
6. Если запуск отменён, отправьте POST /api/v1/activations/{id}/cancel, и кошелёк будет пополнен сразу.

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

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

Чилийский маршрут сейчас охватывает более 1800 сервисов. Чаще всего QA-команды берут WhatsApp, Telegram, Google (Gmail & YouTube), Facebook, Instagram, TikTok, Uber, Microsoft & Outlook, Amazon, LinkedIn, ChatGPT (OpenAI), Discord и Netflix.

Наличие меняется в течение дня, поэтому воспринимайте любой список, и этот в том числе, как снимок. Перед запланированным заданием спрашивайте у GET /api/v1/countries и эндпоинта цен, что доступно для cl, и аккуратно пропускайте отсутствующие пары, а не обнаруживайте пробел на полпути прогона тестов.

Как хранить и проверять номера +56?

Чилийские мобильные номера состоят из девяти цифр после кода страны +56 и начинаются с 9, поэтому полный мобильный номер в формате E.164 выглядит как +569 и ещё восемь цифр. Действующие чилийские номера внутри страны записываются теми же девятью цифрами, которые следуют за +56, поэтому нормализация коротка.

Пользователи всё равно вводят номер тремя способами: с пробелами и плюсом, как 56 и национальные цифры без плюса или только девять местных цифр. Храните одну каноническую строку E.164, рядом сохраняйте сырой ввод для обращений в поддержку и добавьте тестовые случаи для всех трёх форм. Отклонение восьмизначного ввода на этапе формы избавит вас от SMS, которое всё равно не дошло бы.

Зачем продуктовые команды проверяют регистрацию в Чили?

Чили — частая ранняя остановка для продуктов, расширяющихся по Латинской Америке, а её пользователи ждут испанских текстов, написанных для региона, а не локализованных для Испании. Коды на номера +56 обычно приходят на испанском, хотя многие приложения следуют языку аккаунта, поэтому проверьте, что ваш парсер извлекает цифры независимо от слов вокруг них.

Другие причины, по которым команды проводят чилийские проверки: убедиться, что поле телефона по умолчанию подставляет +56 для местных посетителей, доказать, что весь маршрут работает именно для чилийских номеров, и дать сотрудникам поддержки или операций подтверждать бизнес-аккаунты, не одалживая личную SIM-карту. На странице QA-тестирования показано, как команды включают это в чек-листы релизов.

Что делать, если чилийский код не появляется?

Каждая активация остаётся открытой 20 минут. Вы платите только если код пришёл; когда окно закрывается пустым или вы отменили активацию раньше, вся сумма автоматически возвращается на кошелёк. Если номер +56 молчит:

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

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

Как устроены оплата и тестирование в песочнице?

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

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

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

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

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

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

Какой идентификатор страны ожидает API для Чили?

Используйте cl, например GET /api/v1/prices?country=cl&service=telegram.

Сколько стоит номер +56 для тестирования?

От $0.20 за код; точная сумма зависит от сервиса и возвращается API в реальном времени. Плата списывается только когда код пришёл.

Можно ли оставить чилийский номер, чтобы аккаунт мог войти снова в следующем квартале?

В режиме самообслуживания нет. Dedicated Numbers — продукт для США и Канады от $1.95/месяц; по линии +56 напишите на [email protected], доступность зависит от местных правил.

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

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

Что лучше для чилийских тестов: опрос или вебхук?

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

Может ли наша финансовая служба платить стейблкоинами?

Да. Кошелёк принимает карты и USDT/USDC, а за каждое пополнение приходит PDF-счёт.

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