Как превратить SMS API в отдельный продукт для партнёров

Обычно API для SMS-рассылок воспринимают довольно просто: передал номер, текст сообщения, имя отправителя — получил статус доставки. Для базовых сценариев этого достаточно. 

Но когда рассылки нужно встроить в партнёрскую платформу, всё становится сложнее.

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

Мы в i-Digital доработали наш SMS API — Direct API — именно под такой сценарий, чтобы партнёр мог управлять SMS-рассылками всех своих клиентов через единую интеграцию.

Обычный API отправки отвечает на вопрос: «Как отправить сообщение?»

В партнёрской модели вопрос другой: «Как дать платформе возможность управлять рассылками множества клиентов так, будто это её собственный продукт?»

Поясним, что значит «партнёрская модель». Представьте компанию, которая разрабатывает CRM или маркетинговую платформу. Её клиенты — десятки и сотни бизнесов, каждому из которых нужны SMS-рассылки. Вместо того чтобы каждый бизнес самостоятельно подключался к SMS-провайдеру, платформа берёт это на себя: интегрируется один раз и предоставляет рассылки как часть своего продукта. Именно эта платформа и есть наш партнёр.

Для полноценной работы такой модели нужно не только отправлять SMS, но и закрывать весь жизненный цикл:

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

И всё это должно работать через API — программно, без ручного сопровождения каждого клиента.

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

• Компания. Это клиент партнёра, зарегистрированный в нашей системе. У компании есть юридические данные, документы, бюджет и собственный набор рассылок. Например, если партнёр — CRM-платформа, а его клиент — сеть автосервисов, то «компания» в API — это и есть эта сеть автосервисов.
• Имя отправителя. Его можно создать для конкретной компании, передать необходимые документы и отслеживать статус регистрации у операторов — от черновика и модерации до одобрения или отклонения.
• Рассылка. Это уже не просто разовый запрос на отправку, а управляемый объект с жизненным циклом. Рассылку можно создать, наполнить сообщениями, запустить, остановить и получить по ней статистику.
• Сообщение. Единица внутри рассылки. По каждому сообщению можно получить статус: создано, передано оператору связи, доставлено адресату или завершилось ошибкой.

Дополнительно мы реализовали работу с чёрными списками номеров (blacklist), автоматическими уведомлениями о событиях (callback), тарифами и стоимостью регистрации отправителей.

В итоге API стал покрывать не только отправку сообщений, но и всю операционную модель партнёрского продукта.

В партнёрской схеме основная сложность появляется не в моменте отправки SMS, а вокруг неё.

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

Наша доработка позволяет партнёру масштабировать сервис без пропорционального роста операционных затрат.

Новый клиент становится новой «компанией» в API. Новое имя отправителя — управляемым объектом со статусом, который можно отслеживать автоматически. Новая рассылка — объектом с жизненным циклом, предварительной стоимостью, расписанием и отчётами.

Отдельно мы проработали финансовую часть.

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

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

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

В рассылках важно уметь не только запускать трафик, но и быстро его останавливать.

Например, если клиент партнёра ошибся в базе получателей, отправил некорректный текст или возникла жалоба от абонентов, партнёру нужен быстрый способ вмешаться — не дожидаясь, пока будет отправлена вся рассылка.

Поэтому в API есть возможность остановить рассылку и приостановить использование конкретного имени отправителя.

Это работает как операционный стоп-кран: партнёр может мгновенно ограничить трафик, разобраться в ситуации и при необходимости возобновить отправку. Без этого механизма одна ошибка клиента может обернуться финансовыми и репутационными потерями для всей платформы.

Если упростить, схема интеграции выглядит так:

Пользователь — Партнёрская платформа — Direct API — Операторы связи — Получатели SMS

Конечный пользователь работает в интерфейсе партнёра: создаёт рассылку, выбирает имя отправителя, загружает базу получателей, задаёт расписание. Он может даже не знать, что за доставку отвечает i-Digital.

Партнёрская платформа через наш API создаёт компанию, регистрирует отправителей, запускает рассылку и получает статусы — всё автоматически.

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

После доработки Direct API стал не просто транспортом для сообщений, а инфраструктурным слоем для партнёрских коммуникационных продуктов.

Для конечного пользователя всё остаётся прозрачным: он работает в интерфейсе знакомой платформы и получает понятный сервис рассылок.

Для партнёра — это возможность масштабировать продукт без ручного сопровождения каждого клиента и без наращивания собственной инфраструктуры для работы с операторами.

Для нас — это следующий шаг в развитии Direct API: от интерфейса отправки сообщений к платформе, на которой можно строить полноценные партнёрские решения.

Контакты для связи: sales@i-dgtl.ru