IOSOR

IOSOR База знаний

Встраивание API vs white-label партнёрский портал

SaaS, который встраивает messaging, остаётся на поверхности ISV. White-label партнёрский портал — зона Partner: не смешивайте бренд, ключи и ownership ops.

Когда SaaS-продукт встраивает messaging, end users не открывают консоль IOSOR. Они нажимают Send внутри UI ISV; ISV владеет ключами, webhook и prepaid ledger. Это путь embed. White-label партнёрский портал — другое: admin партнёра работает на поверхностях Partner — brand-safe UI, изоляция tenant и гейты без утечки имён upstream-рельсов.

Команды смешивают пути: скрины портала в ISV-деке или ошибки «как у IOSOR» внутри SaaS. Embed значит: ваш продукт — единственное client-facing стекло. Partner — брендированный портал для reseller и subtenant: white-label и gated, но другая карта ownership. На week one выберите одно стекло.

Embed держит messaging внутри SaaS-продукта

Проводка embed кладёт API-ключи, idempotency keys и webhook receivers в engineering-орг ISV. Действия end-user мапятся на server-side send с prepaid wallet ISV. UI SaaS показывает product-native статус — queued, sent, failed — без брендов рельсов и без второго логина в консоль.

Задокументируйте microservice с production-ключами. Ротируйте по каденции ISV. Если product хочет партнёрский портал для support browser, отвечайте гейтом поверхности: это Partner, не shortcut внутри оболочки SaaS.

Партнёрский портал — отдельная white-label поверхность

Порталы служат admin reseller: subtenant, fair-share лимиты, brand-safe export. Экраны идут по Partner surface gates: без upstream-бренда в toast, API-ошибках, webhook и CSV. Live каталога совпадает с vault. Admin партнёра — не end user продукта ISV.

Не встраивайте iframe портала в SaaS «для скорости». Это смешивает trust и утекает ops-язык статуса. Держите Partner на URL и ролях Partner.

Разделите ownership: стекло продукта vs стекло партнёра

Решение Embed Партнёрский портал
Кто видит UI End users ISV Admin партнёра
Где ключи Secrets ISV Vault ops по дизайну
Язык бренда Copy SaaS White-label copy партнёра
Владелец ledger Prepaid аккаунт ISV Тот же аккаунт или изоляция
Что читать Launch habits Developers Гейт поверхности Partner

Опубликуйте таблицу в launch-тикете. Sales не обещает оба стекла на week one без именных владельцев.

Отказывайтесь от hybrid-демо со смешанными brand path

Кнопка Send в SaaS плюс скрин портала на одном слайде учит buyer ждать неверное стекло. Если buyer встраивает OTP, демострируйте embed; статьи Partner — только adjacency.

Связанные пути

Начните с IOSOR

Зафиксируйте ключи API и вебхуки в секретах вашего SaaS-продукта для встроенных отправок, чтобы конечные пользователи видели статус сообщений строго внутри вашего интерфейса. Настройте правила Partner surface gate для консоли реселлера, проверив отсутствие упоминаний платформы в ответах об ошибках и выгрузках CSV. Проведите тестовую отправку через встраиваемый API и убедитесь, что административный доступ партнера полностью изолирован от клиентского интерфейса.

Итог IOSOR

Эта статья доказала, что смешивание интерфейса встраиваемого API с порталом партнера размывает границы ответственности и дезориентирует пользователей. Встраивание сообщений должно оставаться полностью бесшовным внутри вашего SaaS-продукта, где все секреты, вебхуки и статусы DLR принадлежат вашей инженерной инфраструктуре, а конечный клиент не контактирует с внешними консолями.

Делайте чёткое разделение между продуктовым экраном для конечных пользователей и отдельным white-label порталом для администраторов партнеров. Не демонстрируйте клиентам гибридные сценарии с кнопкой отправки из приложения и скриншотами партнерского кабинета на одном слайде — изолируйте брендинг, логи и ключи на уровне конфигурации.

Был ли материал полезен?

Связанные гайды