API для приёма SMS: коды подтверждения на ваши собственные номера

BusySMS и сервисы виртуальных номеров

Когда что выбирать

Если нужен одноразовый номер для разового теста и от него ничего не будет зависеть, виртуальный номер — более быстрый путь, а BusySMS — не тот инструмент. Если аккаунт важен — например, админский вход вашей компании, тестовый аккаунт, в который CI входит каждую ночь, или номер, который уже знают ваши клиенты, — принимайте на собственный номер.

И BusySMS — не способ обойти чью-то проверку. Он читает коды, отправленные на номера, которыми вы распоряжаетесь, для ваших собственных аккаунтов. Чужие сообщения он читать не может и не предназначен для массового создания аккаунтов.

Как устроен приём в BusySMS

1. 1

   Установите приёмник на телефон

   На Android — приложение BusySMS из Google Play. На iPhone — автоматизация в «Командах», с приложением BusySMS для iPhone или без него.

2. 2

   Подтвердите номер

   BusySMS отправляет код на номер, а телефон передаёт его обратно. Это доказывает, что номер на этой SIM; до этого ничего не сохраняется и не оплачивается.

3. 3

   Приём

   Сохраняются только SMS, похожие на коды подтверждения. Каждое помечается номером получателя, отправителем, распознанным сервисом и временем получения.

4. 4

   Чтение

   Ваша программа вызывает REST API, ИИ-агент использует MCP, а человек видит код в панели или доверяет его ввод расширению для Chrome.

На какие номера можно принимать

• На любой номер SIM в вашем телефоне: телефон на Android 8.0 или новее с приложением BusySMS или iPhone на iOS 14 или новее через «Команды».
• Каждая SIM в телефоне с двумя SIM — отдельный номер, который подтверждается и оплачивается отдельно.
• Номера подтверждаются отправкой SMS туда и обратно, поэтому нельзя добавить номер, SIM которого у вас нет.

Приём кода через API

Создайте ключ в панели, в разделе REST API, и храните его в переменной окружения. Затем ждите следующий код на конкретный номер:

# Digits only: the receiving number +44 7700 900123
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?phone=447700900123&timeoutMs=60000"

const params = new URLSearchParams({ phone: "447700900123", timeoutMs: "60000" });
const res = await fetch(`https://busysms.net/api/v1/codes?${params}`, {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}`);

const { code } = await res.json(); // null if nothing new arrived
console.log(code);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"phone": "447700900123", "timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,
)
r.raise_for_status()
print(r.json()["code"])  # None if nothing new arrived

phone сопоставляется с номером получателя (достаточно цифр), так что при нескольких номерах в аккаунте вы получите код именно для нужного. Ожидание длится до 90 секунд и, если ничего нового не пришло, возвращает null, а не старый код.

Чтобы прочитать историю, а не ждать, получите последние сообщения одного телефона через GET /api/v1/devices/:id/messages; перехваченные сообщения хранятся до 7 дней. Все эндпоинты и ошибки — в руководстве по API SMS-шлюза.

Что принимается, а что нет

• При настройке вы выбираете для каждой SIM-карты Android: все SMS или только SMS с кодами подтверждения. Остальные сообщения видны только вам.
• На iPhone проверка выполняется на самом телефоне: SMS, не похожее на код, никогда его не покидает.
• Пока шлюз выключен, ничего не перехватывается.
• Пока номер не прошёл подтверждение, ничего из полученного на него не сохраняется.

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

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