Быстрый старт с TextBee

01Быстрый старт

1. Установите приложение из RuStore — «SMS-шлюз» с пересылкой входящих или «Отправка SMS» без неё (чем отличаются). Порядок — на странице установки. Нужен Android 6.0 или новее.
2. Зарегистрируйтесь в личном кабинете — через Яндекс, VK или по почте.
3. Выдайте разрешения — приложение попросит их по очереди и объяснит, зачем каждое. Отправка SMS нужна всегда; чтение входящих — только шлюзу.
4. Подключите телефон — получите шестизначный код в личном кабинете и введите его в приложении.
5. Отправьте тестовое SMS прямо из личного кабинета, чтобы убедиться, что всё работает.

02Подключение телефона

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

Если телефон отключился (например, долго не было соединения с интернетом), статус устройства в личном кабинете покажет это, переподключение происходит автоматически, когда телефон снова окажется в сети.

03Отправка SMS через API

Токен доступа (Bearer-токен) вы получаете после входа в личный кабинет. Пример запроса:

curl https://api.textbee.ru/v1/sms/send \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "+79161234567", "text": "Здравствуйте! Ваш код: 12345"}'

Ответ содержит идентификатор сообщения: по нему можно проверить статус доставки через GET /v1/messages/{id}.

Поля запроса

Отправка с конкретной SIM-карты

Каждая SIM-карта — отдельное устройство со своим deviceId. Список доступных вернёт GET /v1/routing/sims; полученный идентификатор передаётся в deviceId. Так же работает маршрутизация по оператору: на номер МТС можно отправлять с мегафоновской SIM и наоборот.

Рассылка на много номеров

curl https://api.textbee.ru/v1/messages/bulk \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumbers": ["+79161234567", "+79261234567"], "text": "Текст рассылки"}'

В ответ приходит batchId, ход рассылки виден в GET /v1/messages/bulk/{batchId}. Каждый номер расходует одну отправку по тарифу.

Отложенная отправка

curl https://api.textbee.ru/v1/messages/scheduled \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "+79161234567", "text": "Напоминание о визите",
       "scheduledAt": "2026-08-20T09:00:00Z"}'

Время — в формате ISO-8601. Отменить запланированное сообщение до его отправки: DELETE /v1/messages/scheduled/{id}. Текст такого сообщения на сервере не хранится — в назначенный час облако передаёт задание телефону, и отправляет он.

04Отправка из личного кабинета

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

05Переадресация входящих

В личном кабинете настраивается переадресация входящих SMS. Переадресация бесплатна на всех тарифах, квота тарифа считается только на отправку. Доступные каналы:

• Push-уведомление (ntfy) — быстрее всего.
• Telegram — переадресация в чат или бот.
• MAX — сообщение приходит от нашего бота.
• Другой номер — SMS дублируется на указанный номер.
• E-mail — письмо на указанный адрес.
• Вебхук — POST на ваш URL. Доступен на платных тарифах.

Каналов можно включить сразу несколько. Фильтров два, и работают они вместе: по тексту сообщения (например, только те, где встречается слово «код») и по отправителю. Сообщение уезжает, только если прошло оба.

На каких SIM-картах работает правило

Если к аккаунту подключён больше чем один телефон или в телефоне две симки, у каждого правила появляется выбор «На каких SIM-картах». Так разводятся потоки: например, рабочая симка — в Telegram отдела, домашняя — на почту.

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

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

Как приостановить правило, не удаляя

У каждого правила есть кнопка «Выключить». Правило перестаёт пересылать, но условия, каналы и выбранные симки остаются на месте — «Включить» возвращает всё как было. Удаление, в отличие от этого, стирает настройки безвозвратно.

Фильтры: шаблоны и переменные

Фильтра два — по тексту сообщения и по отправителю. Каждый работает в одном из трёх режимов:

• Все — фильтр выключен, проходит любое сообщение.
• Белый список — проходит только то, что совпало с шаблоном.
• Чёрный список — проходит всё, кроме того, что совпало с шаблоном.

Шаблон — это регулярное выражение. Совпадение частичное: достаточно, чтобы выражение нашлось где-то внутри строки, привязывать к началу и концу не нужно. Регистр важен: код и КОД — разные шаблоны. Если сообщение проходит по обоим фильтрам сразу, оно уезжает; если хотя бы один отсёк — нет.

Что чаще всего нужно:

• (?i)код — слово «код» в любом регистре. (?i) в начале выключает чувствительность к регистру для всего шаблона.
• код|пароль|секрет — любое из перечисленных слов. Вертикальная черта — «или».
• \d{4,6} — подряд от четырёх до шести цифр: так ловятся коды подтверждения.
• Сбербанк|900 — в фильтре по отправителю: сообщения от «Сбербанк» или с номера 900.

06Лимиты тарифа

Актуальные лимиты — на странице тарифов. Коротко:

• Переадресация входящих — без ограничений по количеству сообщений на всех тарифах. Квота считается только на отправку. На «Старте» — одно правило (канал любой на выбор), на платных тарифах — несколько каналов сразу.
• Старт — 1 SIM-карта, 50 отправок в месяц; одно правило переадресации, не чаще 1 сообщения в 30 секунд.
• Персона — 1 SIM-карта, 300 отправок в месяц; переадресация без задержки, вебхук как канал.
• Про — до 5 SIM-карт, 1 500 отправок в месяц.
• Бизнес — до 15 SIM-карт, 5 000 отправок в месяц.
• Нужно больше — напишите на support (собака) textbee.ru, посчитаем под вашу задачу.

07Частые проблемы

Настроил, а SMS не отправляются

• Проверьте отдельно разрешение на отправку. В настройках телефона видна общая группа «SMS», и по ней кажется, что доступ выдан, — а разрешение на отправку при этом может быть не выдано. В приложении это видно на экране «Состояние шлюза»: там прямо написано, чего не хватает.
• Проверьте, что у телефона есть интернет — без него он не связан с облаком. Светофор на дашборде краснеет, если связи нет дольше полуминуты.
• На Xiaomi, Huawei, Samsung разрешите автозапуск и снимите ограничение на работу в фоне (обычно раздел «Безопасность» или «Батарея»). Без этого система выгружает приложение через некоторое время после блокировки экрана.
• Если приложение просит разрешение «Будильники и напоминания» — выдайте: им телефон будит сам себя, когда сообщение ждёт отправки.

Отправка идёт не с той SIM-карты

Без указания deviceId сообщение уходит с любой доступной SIM. Чтобы выбрать конкретную, передайте её deviceId из GET /v1/routing/sims — или настройте правило маршрутизации по оператору в личном кабинете.

Не приходит шестизначный код

Код выдаётся в личном кабинете сразу, никуда «приходить» отдельно не должен: если кода нет на экране, обновите страницу личного кабинета.

Сообщение отправлено, но получатель его не увидел

Проверьте статус сообщения в личном кабинете или через API. Доставка зависит от мобильного оператора отправляющего телефона, и TextBee не может гарантировать доставку, если у оператора на его стороне произошёл сбой.

Куда обращаться, если ничего из этого не помогло

В Telegram — самый быстрый способ, или на support (собака) textbee.ru.