SMeetМини-приложения SMeet · SDK v1
Веб-приложение в окне SMeet от автора бота.
Мини-приложение представляет собой веб-страницу, связанную с ботом: анкету, сервис заявок, небольшой инструмент. Оно открывается из профиля бота, по кнопке в чате или по ссылке, с согласия человека входит через SMeet и отправляет результат боту. Страница и её сервер принадлежат автору, а окно, согласие и подтверждение остаются за SMeet.
В каталоге собраны мини-приложения, опубликованные в публичном пространстве SMeet. Чтобы сделать своё, начните с бота в разделе «Мои боты»; сначала войдите в SMeet.
/start
Здравствуйте! Заполните анкету гостя, это займёт минуту. Ответы остаются на вашем устройстве, пока вы их не отправите.
Спасибо, анкета получена. Напишем здесь, когда место будет подтверждено.
Для людей
Вы каждый раз видите, что получит приложение.
Мини-приложение открывается только после вашего согласия, и каждый раз SMeet говорит, что получит автор. Результат уходит боту только после вашего подтверждения.
- Откройте его из профиля бота, по кнопке под сообщением бота или по ссылке, которой с вами поделились.
- Автор получает ваш идентификатор в SMeet и язык интерфейса, а отображаемое имя, только если приложение его просит. Почту, телефон, контакты и чаты он не получает никогда.
- В меню окна есть «Об авторе», «Пожаловаться», «Отозвать доступ» и «Заблокировать бота», а кнопка «Закрыть» от SMeet работает всегда.
- Тестовая версия говорит об этом в окне: SMeet её не проверял.
Перед открытием приложения
Что перечисляет экран согласия, словами самого приложения. После него идут «Открыть» и «Отмена».
Для авторов
Ваша страница, ваш сервер, окно SMeet.
Нужны бот в SMeet и страница на вашем собственном HTTPS-адресе. Окно, согласие, вход и подтверждение перед отправкой результата боту берёт на себя SMeet.
- Создайте ботаВ SMeet BotFather (
/newbot) или в разделе «Мои боты», как любого бота. - Создайте мини-приложениеОтправьте
/miniappв SMeet BotFather или откройте «Мини-приложение» на странице бота в «Моих ботах». Примите правила для авторов, затем укажите название, описание, возрастную категорию и адреса рабочей и тестовой версий. - Подтвердите доменРазместите
/.well-known/smeet-mini-app.txtс токеном приложения и разрешите встраивать свои страницы только SMeet черезframe-ancestors. - Подключите SDK и входСтраница подключает SDK и просит SMeet выполнить вход. Ваш сервер обменивает одноразовый код на сессию своим ключом и проверяет эту сессию перед каждым защищённым действием.
- Проверьте и опубликуйтеПригласите тестировщиков в тестовую версию, отправьте приложение на проверку и опубликуйте после одобрения.
Каталог
Все опубликованные мини-приложения публичного пространства на одной странице.
Каталог показывает название, описание, возрастную категорию и автора каждого приложения со ссылкой, которая открывает его в SMeet. Приложения организаций остаются внутри организации и в список не входят.
Приложения SMeet
Где работает
Web, iOS и macOS
Веб-версия SMeet, а SMeet для iOS и macOS начиная с версии, в которой появятся мини-приложения.
Android позже
Поддержка Android появится в одном из следующих выпусков. Там и в старых версиях приложений кнопка мини-приложения не открывается.
Чего нет в версии 1
Без платежей
Мини-приложения ничего не продают и не ведут на покупки.
Без доступа к устройству
У приложений других авторов нет камеры, микрофона и геопозиции, есть только файл, который выбрал сам человек.
Безопасность
Мини-приложение получает то, что разрешил человек, и ничего сверх этого.
SMeet проверяет доступ при каждом запуске, каждом входе и каждой отправке результата боту. Ничто не зависит от того, хорошо ли ведёт себя приложение.
Правила для авторов- Согласие перед каждым запускомЭкран согласия принадлежит SMeet: страница автора не может нарисовать что-то поверх него или нажать его кнопки.
- Подтверждение перед отправкойSMeet показывает, что уходит боту, и отправляет это только после подтверждения человека.
- Подтверждённые доменыПриложение открывается только по HTTPS-адресам, которые подтвердил автор, и только внутри SMeet.
- Короткие сессииКод входа работает один раз и недолго. Сессия заканчивается, когда окно закрыто или когда человек отозвал доступ или заблокировал бота.
- Проверка и жалобыПриложения публичного пространства проверяются до публикации. Администраторы SMeet разбирают жалобы и могут заблокировать приложение или все приложения его автора.
- Организация решает самаОрганизация включает и выключает создание и работу мини-приложений в своём пространстве и сама одобряет свои приложения.
Документация
Для авторов, на русском и английском.
SDK, вход, ваш сервер, публикация и правила для авторов. Читать можно без учётной записи. Нужен английский? Documentation in English.
Вопросы и ответы
О чём спрашивают, прежде чем открыть.
Что получает автор мини-приложения?
Ваш идентификатор в SMeet и язык интерфейса, а отображаемое имя, только если приложение его просит. Загрузка приложения показывает серверу автора ваш IP-адрес и сведения об устройстве, как любой сайт. Адрес электронной почты, телефон, контакты и чаты автор не получает никогда.
Нужно ли соглашаться каждый раз?
Да. Перед каждым запуском SMeet показывает приложение, его автора и то, что оно получит, и автор ничего не получает, пока вы не нажмёте «Открыть». Результат уходит боту только после вашего подтверждения.
Может ли мини-приложение включить камеру, микрофон или узнать, где я?
Нет. Мини-приложение другого автора не получает доступа к камере, микрофону и геопозиции. Из возможностей устройства ему доступен только файл, который вы выбрали сами.
Как остановить мини-приложение?
Закройте окно. В его меню есть ещё «Отозвать доступ», который отменяет то, что автор получил от вас, «Заблокировать бота» и «Пожаловаться», который передаёт приложение администраторам SMeet.
Где работает мини-приложение?
На сервере автора, по HTTPS-адресу, который автор подтвердил в SMeet. На messenger.scrile.com работают только собственные приложения SMeet.
Кто может опубликовать мини-приложение?
Во время пилота авторы, которых допустил SMeet. Приложение публичного пространства SMeet проверяет до публикации, а приложения организации проверяют её владельцы и администраторы.
Может ли мини-приложение что-то продавать?
Нет. Правила для авторов запрещают продажу цифровых товаров, подписок и платных функций, а также ссылки на такие покупки.
Совместимо ли это с Telegram Mini Apps?
Нет. У SMeet свой SDK и свой вход, и библиотеки Telegram с ними не работают. Идеи при этом знакомые: страница, связанная с ботом, которая открывается по кнопке или ссылке.
Начните с бота, затем дайте ему страницу.
Бот в SMeet BotFather, страница на вашем HTTPS-адресе, SDK и короткий обмен на вашем сервере. Документация проводит по каждому шагу.
«Создать мини-приложение» открывает «Мои боты» в веб-версии SMeet. Сначала войдите, выберите бота, затем «Мини-приложение».