• 228 направлений
  • Без KYC — всегда
  • Bitcoin, Monero, USDT и ещё 4 валюты

Начало работыНачальный2 минуты чтенияОбновлено 18 октября 2026

Панель или API: как выбрать

Баланс, тарифы и отчёты везде одинаковы. Критерии выбора, смешанные схемы, ключи, права и теги для отправки из панели, через API или обоими способами.

Часть 1 из 4 в маршруте Интеграция API

Что остаётся одинаковым

У аккаунта один баланс, одна таблица тарифов и один отчёт. Сообщение стоит одинаково, ушло ли оно из редактора рассылок или из скрипта, отображается в том же списке и вызывает те же вебхуки. Общим является и всё, что определяет доставку: один маршрут для каждого направления, правило отправителя каждой страны, правила кодировки (160 символов GSM-7 или 70 в Unicode для одного сообщения, до 6 частей), момент списания (сообщение оплачивается, когда передаётся оператору связи, а отклонённое — никогда) и статусы от В очереди до Доставлено. Выбор касается рабочего процесса, а не цены или качества.

Пять решающих вопросов

ВопросПанельAPI
Что запускает отправку?Человек со списком и сообщениемСобытие в вашей системе: регистрация, заказ, оповещение
Где хранятся номера?В файле: CSV, TXT или XLSXВ вашей базе данных
Кто пишет текст?Человек, с подстановками {column}Ваш код, для каждого получателя
Когда сообщение должно уйти?Сейчас, в заданный момент или в окне по местному времениЧерез несколько секунд после события или в момент send_at
Кто читает результат?Люди, в отчёте в реальном времениВаша система, через вебхуки

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

Когда удобнее панель

Кампания — это файл, текст и дата. Редактор выполняет работу, которую иначе пришлось бы вручную прописывать в скрипте:

  • Импорт. CSV, TXT или XLSX, файлы до 50 МБ и до 1 000 000 номеров на кампанию. Номера приводятся к формату E.164, а для местных форматов задаётся страна по умолчанию; дубликаты объединяются после нормализации; неверные строки перечисляются в отчёте, не отправляются и не оплачиваются.
  • Текст. Подстановки вида {first_name}; счётчик, который показывает кодировку, число сегментов и самый длинный итоговый вариант; название любого символа, из-за которого включился Unicode, и замена в одно нажатие для типографских кавычек, длинных тире, символа многоточия и специальных пробелов.
  • Предварительный расчёт стоимости по направлениям до какого-либо списания.
  • Время. Отправка сейчас, в заданный момент или в окне по местному времени для каждого направления; ограничения по времени отправки применяются внутри окна; темп задаётся в сообщениях в минуту или распределением на несколько часов; отправку можно приостановить и возобновить.

Командам маркетинга и поддержки и всем, кто отправляет несколько кампаний в неделю, редко нужно что-то ещё. Тариф фиксируется на весь срок кампании, поэтому отправка, растянутая на три дня, оплачивается по тарифу, использованному в предварительном расчёте. Импорт подробно разобран в руководстве по подготовке списка контактов.

Когда нужен API

Коды, оповещения, квитанции и всё, что вызвано событием в вашей системе, лучше отправлять через API: один запрос на сообщение, Idempotency-Key, чтобы повторы были безопасными, вебхук, чтобы ваша система знала, что дошло, и собственное значение reference, которое возвращается в ответах и вебхуках. Массовая отправка из вашего конвейера данных идёт через пакетный метод — до 1000 сообщений за запрос. Некорректный запрос отклоняется целиком; в остальных случаях неверные элементы возвращаются как отклонённые с указанием ошибки, а корректные ставятся в очередь, и в ответе перечислены batch_id, accepted, rejected, total_price и сами сообщения. Подробнее — в статье об отклонениях в пакетах.

Важны два отличия от редактора. API никогда не изменяет текст: он возвращает encoding и segments, а типографский апостроф, который редактор предложил бы заменить, вам придётся отлавливать самостоятельно. Кроме того, время задаётся для каждого сообщения: send_at — для заданного момента, window с местным временем начала и окончания — для доставки по местному времени, validity — чтобы указать, сколько сообщение может ждать, а в пакетах — pace в сообщениях в минуту или с распределением на несколько часов. Описание OpenAPI и примеры SDK на cURL, Python, Node, PHP и Go ускоряют первую интеграцию; начните с быстрого старта.

Как использовать оба способа

Так поступает большинство аккаунтов. Три примера таких схем:

  • Магазин. Подтверждения заказов и уведомления об отправке уходят через API из системы заказов; ежемесячная акция отправляется из панели на основе выгрузки клиентов.
  • Программный продукт. Коды входа и оповещения об инцидентах идут через API, каждый поток — на своём ключе; анонсы релизов отправляются из панели.
  • Клиника. Напоминания о записях на следующий день уходят одним ночным пакетом; объявление о закрытии набирается в панели, когда в этом возникает необходимость.

Три правила помогают им не мешать друг другу. Помечайте сообщения API полем campaign, чтобы в отчёте они группировались так же, как кампании из панели. Используйте отдельный ключ для каждой системы, чтобы отзыв одного не останавливал остальные. И договоритесь, кто следит за общим балансом, чтобы вышедший из-под контроля скрипт никогда не остановил кампанию, которую маркетинговая команда запланировала на завтра.

Ключи, права и списки разрешённых IP

Ключи — это bearer-токены: sk_live_ для реального трафика, sk_test_ для разработки. Каждому ключу выдаются права отправки, чтения или оба, и его можно ограничить списком разрешённых IP-адресов; запросы с других адресов получают 401. Отдельного тарифа для разработчиков или этапа согласования нет: аккаунт, который отправляет из панели, создаёт ключ и уже через минуту отправляет из кода.

  • Один ключ на систему. У сервиса кодов, системы заказов и задачи формирования отчётов — собственные ключи. Ограничение в 50 запросов в секунду действует для каждого ключа, поэтому массовая задача не сможет израсходовать лимит, необходимый вашим кодам.
  • Минимальные права. Дашборду нужно право чтения, сервису уведомлений — право отправки, и лишь немногим системам нужны оба.
  • Фиксированные адреса — в список разрешённых. Серверы со стабильными исходящими адресами стоит внести в список разрешённых; для функций, адреса которых меняются, полагайтесь на права и аккуратное хранение ключей.
  • Рабочие ключи остаются на серверах. Ключ, встроенный в мобильное приложение или веб-страницу, может извлечь кто угодно, поэтому отправляйте сообщения со своего бэкенда.
  • Сначала тестовые ключи. Они проверяют запросы, рассчитывают цену и отвечают как рабочие ключи, возвращают статус test и вызывают подписанные вебхуки, но ничего не отправляют и не списывают.

Теги для согласованных отчётов

Всю работу выполняют два поля. campaign длиной до 64 символов — это группа: сообщения с одинаковым тегом в отчётах стоят рядом, как кампания из панели. reference длиной до 128 символов указывает на конкретную запись: номер вашего заказа, идентификатор записи на приём или проверки; он возвращается в ответах и вебхуках, чтобы каждое событие находило свою запись.

  • Называйте кампании по назначению, а не по дате: otp-login, order-dispatched, reminder-24h. Время и так видно по временным меткам.
  • Используйте отдельный тег для каждого варианта, который хотите сравнить, чтобы A/B-тест отображался в отчёте двумя строками.
  • Не помещайте персональные данные ни в одно из этих полей: для связи записей достаточно внутреннего идентификатора.
  • Договоритесь о названиях между командами один раз и письменно, чтобы панель и API никогда не создавали два разных тега для одного потока.

Отчёты при любом способе отправки

Каждое сообщение, откуда бы оно ни было отправлено, попадает в один и тот же отчёт о доставке: статусы в реальном времени, ошибки, сгруппированные примерно в двенадцать понятных причин с исходным кодом оператора, удаление неизвестных номеров одним нажатием и выгрузки в CSV или JSON с идентификатором сообщения, номером, статусом, кодом оператора, временными метками и ценой. Поле from всегда показывает фактически использованного отправителя, что важно везде, где имя заменяется номером. Записи по отдельным сообщениям хранятся 90 дней, а сводки по кампаниям — бессрочно, поэтому архивируйте выгрузки, если вам нужна более долгая история на уровне сообщений.

Трафик API добавляет представление в реальном времени: вебхуки передают каждый статус в вашу систему по мере его изменения, и именно там место оперативным оповещениям. Люди читают отчёт, системы — вебхуки. Одно не заменяет другое.

Переход с одного способа на другой

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

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

Примените знания на практике.Для регистрации достаточно адреса электронной почты. Тарифы опубликованы, оплата принимается в криптовалюте, тестовый ключ бесплатный.
Начать отправку

Что-то непонятно или устарело? Сообщите нам на странице поддержки. Мы внесём исправления в руководство и обновим дату.