Получение кодов подтверждения WhatsApp без привязки к телефону сотрудника

Почему команде нужен номер WhatsApp, который никому лично не принадлежит?

Ситуация знакомая. Продуктовая команда строит службу поддержки в WhatsApp или проверяет, как приложение передаёт пользователей в чат, и кому-то нужно зарегистрировать аккаунт. Самый быстрый вариант — телефон коллеги. Но это привязывает рабочую настройку к SIM-карте одного сотрудника, смешивает тестовый трафик с его личной перепиской и ломается в день его ухода.

С той же стеной сталкиваются агентства, которые настраивают WhatsApp для клиентов, и QA-инженеры, которым нужен тестовый аккаунт в конкретной стране, чтобы увидеть, как ведёт себя региональный онбординг. Номер WhatsApp из OTP Gateway не задействует чью-либо личную линию: вы выбираете страну, получаете код регистрации и идёте дальше.

Когда WhatsApp запрашивает код подтверждения по телефону?

WhatsApp идентифицирует каждый аккаунт по номеру телефона, поэтому проверяет контроль над номером одноразовым кодом в нескольких случаях:

• Регистрация: новый аккаунт получает шестизначный код по SMS, а WhatsApp может предложить голосовой звонок как альтернативу.
• Новое устройство: переустановка или переход на другой телефон повторяет проверку, а предыдущий телефон выходит из аккаунта.
• Бизнес-аккаунты: настройка приложения WhatsApp Business на номере проходит через тот же шаг.
• Двухэтапная проверка: необязательный PIN, который выбирает пользователь. Его никогда не присылают по SMS, но при включённой функции он запрашивается вместе с кодом.

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

Как устроен процесс получения кода WhatsApp через API?

Используйте идентификатор сервиса whatsapp вместе с идентификатором страны тестируемого рынка, например in, br или us. С ключом Bearer из консоли разработчика:

1. GET /api/v1/prices?country=<id>&service=whatsapp возвращает актуальную цену и сообщает, открыт ли этот маршрут прямо сейчас.
2. POST /api/v1/activations с телом {"service": "whatsapp", "country": "<id>"} резервирует номер и запускает 20-минутное окно.
3. Введите номер на экране регистрации WhatsApp и запросите SMS.
4. Код приходит к вам событием вебхука activation.sms_received, либо вы опрашиваете GET /api/v1/activations/{id} каждые несколько секунд.
5. Если прогон прерван, POST /api/v1/activations/{id}/cancel вернёт сумму на кошелёк.

Проверяйте X-OTPRoute-Signature, прежде чем доверять телу запроса: вычислите HMAC-SHA256 от <t>.<raw body> с секретом эндпоинта, сравните с v1 и отклоняйте слишком старые метки времени. Затем фиксируйте событие по идентификатору активации, чтобы повторная доставка ничего не меняла. Опрос — более простой вариант, если тестовый раннер не может открыть публичный URL; оба пути описаны в документации для разработчиков.

В каких странах есть номера WhatsApp и важен ли выбор?

Маршруты WhatsApp сейчас доступны в 198 странах, среди них Индия, Бразилия, Индонезия, Нигерия, Германия, Мексика, Великобритания, США, Пакистан, Филиппины, Египет, Кения, Испания, Турция и Южная Африка. Полный список — на странице стран.

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

Почему код WhatsApp может не прийти?

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

Что делать:

• Оставьте активацию открытой на всё окно, а не отменяйте через минуту.
• Убедитесь, что на экране регистрации выбрано SMS, а не звонок.
• Повторите позже или попробуйте маршрут другой страны, если рынок аккаунта это допускает.
• Делайте паузы между попытками. Запрос кода за кодом в быстром цикле обычно только ухудшает ситуацию.

Нужен ли долгоживущему аккаунту WhatsApp выделенный номер?

Как правило, да. Номер OTP Gateway рассчитан на один код, а если аккаунт придётся подтверждать заново после смены телефона или переустановки, понадобится тот же самый номер. Для линии поддержки, общего бизнес-аккаунта или QA-аккаунта, которым тестировщики пользуются месяцами, лучше подходит Dedicated Virtual Number. Они продаются мгновенно в США и Канаде от $1.95/месяц, продлеваются с кошелька, пересылают входящие SMS на ваш вебхук как number.sms_received и могут быть освобождены в любой момент. За пределами этих двух стран самостоятельной долгосрочной линии нет; напишите на [email protected]. Подробности — на странице виртуальных номеров.

Можно ли сделать это из панели без доступа к API?

Да. Войдите, пополните кошелёк картой или в USDT/USDC, выберите WhatsApp и страну, подтвердите показанную цену и закажите номер. Введите его в WhatsApp, и код появится на странице активации сразу после получения. Ежемесячной платы и тарифов нет, к каждому пополнению по электронной почте приходит PDF-счёт, а правило возврата то же, что и в API. Разработчики, которые хотят сначала отработать интеграцию, могут попросить поддержку перевести тестовый аккаунт в sandbox: там симулированные номера и коды позволяют прогнать вебхук, не тратя средства.

Что считается ответственным использованием номеров WhatsApp?

OTP Route существует для тестирования и работы ваших собственных законных продуктов и аккаунтов. Соблюдайте условия использования WhatsApp, держите один аккаунт на реального человека или компанию и не используйте маршруты для массовой регистрации, рассылки нежелательных сообщений или возвращения на платформу после блокировки. К каждой активации применяется политика допустимого использования OTP Route. WhatsApp — товарный знак его владельца, и OTP Route не связан с ним.

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

Можно ли получить OTP WhatsApp без SIM-карты?

Да. Номер OTP Gateway принимает регистрационное SMS WhatsApp и показывает код в вашей панели или отправляет его на ваш вебхук, физическая SIM-карта не нужна.

Какой идентификатор сервиса WhatsApp в API?

Используйте whatsapp как сервис в GET /api/v1/prices и POST /api/v1/activations вместе с идентификатором страны, например in или us.

Примет ли WhatsApp любой виртуальный номер?

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

Смогу ли я позже снова войти в аккаунт WhatsApp с тем же номером?

С номером из шлюза — нет: он рассчитан на один код. Если аккаунт придётся подтверждать снова, используйте Dedicated Virtual Number в США или Канаде.

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

Цены начинаются от $0.20 за код и зависят от страны. Актуальная цена видна в панели и через эндпоинт цен до оформления заказа.

Можно ли использовать SMS-подтверждение WhatsApp для тестов в CI-конвейере?

Да, для ваших собственных тестовых аккаунтов. Разрабатывайте на sandbox, а затем обращайтесь к реальным маршрутам изредка и с паузой между попытками.

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