SMS-шлюз на Android: ваш телефон как шлюз для кодов подтверждения

Что понадобится

• Телефон на Android 8.0 или новее с той SIM, коды с которой вам нужны. Подходят телефоны и с одной, и с двумя SIM, root не нужен.
• Настоящий телефон. Эмуляторы в роли шлюза не поддерживаются: весь смысл — в настоящей SIM в настоящей мобильной сети.
• Приложение BusySMS из Google Play (пакет net.busysms.app).
• Аккаунт BusySMS. Вход — по одноразовому коду, который приходит на электронную почту; пароль придумывать не нужно.

Настройка шлюза за пять шагов

1. 1

   Установите приложение

   Установите BusySMS из Google Play на телефон с нужной SIM. Google Play — единственный способ установки, поэтому обновления приходят как обычно.

2. 2

   Войдите по электронной почте

   Введите адрес электронной почты и код из нашего письма. Когда номер телефона появится в аккаунте, входить можно будет и по нему. Тот же аккаунт работает на сайте, в MCP-клиентах и в расширении для Chrome.

3. 3

   Подключите телефон и подтвердите SIM

   Выберите SIM. BusySMS отправит код на этот номер, а приложение его перехватит — так подтверждается, что номер действительно на этой SIM. Пока номер не подтверждён, ничего из полученного на него не сохраняется, не читается и не оплачивается.

4. 4

   Разрешите доступ к SMS и включите шлюз

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

5. 5

   Получите первый код

   Откройте Полученные SMS в панели или создайте API-ключ в разделе REST API и вызовите GET /api/v1/codes. Каждый код, который придёт на телефон после этого, появится и там, и там.

Чтение кода через REST API

В каждом запросе передаётся ваш API-ключ, который начинается с bsk_live_, — в заголовке Authorization: Bearer. Ключ принадлежит вашему аккаунту, поэтому видит только ваши телефоны и номера, которыми с вами поделились.

export BUSYSMS_API_KEY=bsk_live_xxxxxxxx

# Wait up to 60 s for the next code on any of your numbers
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?timeoutMs=60000"

// Node 18+ (built-in fetch)
const res = await fetch("https://busysms.net/api/v1/codes?timeoutMs=60000", {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}: ${await res.text()}`);

const { code, message } = await res.json();
console.log(code ?? "No new code within 60 s", message?.sender);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,  # longer than the long-poll itself
)
r.raise_for_status()
print(r.json()["code"] or "No new code within 60 s")

Если timeoutMs больше нуля, запрос ждёт в режиме long polling до 90 секунд и возвращает только код, пришедший после начала запроса, — никогда не старый, ведь ввод использованного кода сжигает попытку входа. Эндпоинты, фильтры и коды ошибок — в руководстве по API SMS-шлюза.

Четыре способа читать коды

Ограничения, о которых стоит знать заранее

• С SIM-карты, для которой выбраны только коды, перехватываются лишь сообщения, похожие на код подтверждения; остальные остаются на телефоне. Пока шлюз выключен, не перехватывается ничего.
• Если код пришёл, пока шлюз был выключен, снова запустите его: BusySMS подхватит SMS с кодами за последние 15 минут.
• Режимы энергосбережения могут останавливать фоновые приложения. Если коды перестали приходить, исключите BusySMS из оптимизации батареи и не убирайте его уведомление.
• Перехваченные сообщения удаляются не позже чем через 7 дней. Всё, что нужно дольше, сохраняйте сами.
• Для чтения кодов нужен действующий пробный период или подписка. Если они закончились, телефон продолжает перехватывать коды, но запросы через API и MCP возвращают 402 payment_required, пока оплата не восстановлена.
• Выключенный шлюз не останавливает оплату за подтверждённый номер. Чтобы перестать за него платить, удалите номер в панели.

Цены

$5 за подтверждённый номер телефона в месяц и одна бесплатная неделя (пробный период 7 дней) на каждом аккаунте. Одна подписка покрывает весь аккаунт и оплачивается картой через Stripe в веб-панели: добавили номер — счёт вырос на $5, удалили — уменьшился. Приложение для Android показывает ваш тариф, но не продаёт его.

Вопросы и ответы

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