Как получить регистрационный код Signal на номер, который контролирует ваша команда

Зачем команде телефонный номер для Signal, не принадлежащий конкретному человеку?

Обычно повод внутренний. Команде безопасности или реагирования на инциденты нужен общий аккаунт Signal для координации, а редакции, службе поддержки или заботящемуся о приватности основателю нужна рабочая учётная запись, не привязанная к личной SIM-карте сотрудника. Signal регистрирует каждый аккаунт на номер телефона, поэтому какой-то номер должен принять первый код. Вторая группа — продуктовые и IT-команды, которые документируют или тестируют процедуры онбординга, например регламент развёртывания, устанавливающий Signal на корпоративные телефоны, где нужна SMS-верификация Signal для тестирования.

Signal запрашивает подтверждение телефона при регистрации, при переустановке приложения или переносе на новое основное устройство и при повторной регистрации аккаунта после перерыва. Необязательная Registration Lock добавляет проверку PIN-кода поверх SMS-шага, а имена пользователей позволяют общаться, не раскрывая номер, но аккаунт всё равно держится на номере, способном принимать коды. Именно этот факт определяет, какой продукт OTP Route выбрать.

Одноразовый код или постоянный номер: что подходит для аккаунта Signal?

OTP Gateway даёт виртуальный номер для Signal, который принимает один код подтверждения в окне 20 минут. Это подходит для разовой репетиции процедуры регистрации. Аккаунту Signal, которому позже нужно войти снова, после переустановки или на новом телефоне, потребуется ещё один код на том же номере, а одноразовая активация этого не обеспечит.

Для долгоживущих аккаунтов лучше подходит Dedicated Number. Такие линии доступны мгновенно в США и Канаде от $1.95/month, продлеваются с кошелька, показывают входящие SMS в панели и пересылают их через вебхук number.sms_received, а освободить их можно когда угодно. Сравните оба варианта в материале о временных и выделенных номерах и на странице виртуальных номеров. Во всех остальных странах доступны только одноразовые активации, по крайней мере через самообслуживаемую панель.

Как работает API кодов подтверждения Signal?

Вызовы идут на https://otproute.com/api/v1 с Bearer-ключом (префикс or_live_), созданным в консоли разработчика. Идентификатор сервиса Signal: signal.

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

На аккаунте может быть 10 ключей и 5 эндпоинтов вебхуков, лимит — 300 запросов в минуту. Справочные материалы по эндпоинтам есть в документации.

Как обработчик вебхука должен работать с входящими кодами Signal?

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

Сделайте обработчик идемпотентным, записывая id активации после обработки, потому что доставки могут повторяться. Считайте activation.expired и activation.cancelled конечными состояниями, закрывающими шаг в вашем регламенте. Код Signal открывает доступ к приватному аккаунту мессенджера, поэтому записывайте его только туда, где он нужен, и не оставляйте в логах открытым текстом. Опрос остаётся допустимым запасным вариантом там, где нет публичного эндпоинта, например на ноутбуке за корпоративным файрволом. Подробнее в руководстве по защите вебхуков с HMAC.

В каких странах можно получить OTP-коды Signal?

Получать OTP-коды Signal можно на маршрутах 198 стран. Среди них США, Канада, Великобритания, Германия, Нидерланды, Швейцария, Швеция, Украина, Индия, Япония, Бразилия, Мексика, Кения, Нигерия и Филиппины.

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

В панели шаги короткие: откройте OTP Gateway, выберите Signal, укажите страну, проверьте цену и закажите. Код появляется рядом с номером Signal, как только поступает.

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

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

Что делать дальше:

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

Как выглядит ответственное использование номера для Signal?

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

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

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

Можно ли получить OTP Signal на виртуальный номер?

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

Какой id у Signal в API?

signal. Используйте его вместе с id страны из GET /api/v1/countries, когда обращаетесь к эндпоинтам цен и активаций.

Стоит ли использовать для постоянного аккаунта Signal команды одноразовый номер?

Нет. Signal присылает новый код при регистрации аккаунта на другом устройстве, поэтому долгоживущему аккаунту нужен Dedicated Number в США или Канаде от $1.95/month.

Нужен ли Signal номер телефона, если мы используем имена пользователей?

Да. Имена пользователей скрывают номер от контактов, но регистрация по-прежнему зависит от номера, способного принять код.

Можно ли включить Registration Lock для аккаунта на номере OTP Route?

Да, это настройка Signal, защищённая выбранным вами PIN-кодом. Храните PIN в менеджере паролей команды: для повторной регистрации заблокированного аккаунта он нужен вместе с номером.

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

От $0.20 за код. Точная сумма зависит от страны, её возвращает GET /api/v1/prices, и она показывается в панели до заказа.

Можно ли протестировать интеграцию, не тратя средства кошелька?

Да. Запросите режим sandbox для аккаунта разработки: он возвращает имитированные номера и коды для сквозных тестов.

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