Как пользоваться конструктором
Виджет в Widgram собирается из готового шаблона: вы меняете тексты и поведение, а код, сервер и доставку мы берём на себя. Ниже — путь от шаблона до ссылки.
1. Выберите шаблон
В галерее девять шаблонов. Каждый можно попробовать без регистрации — он работает прямо на странице.
- Опрос — Вопрос и от двух до шести вариантов. Результаты видят все получатели и обновляются вживую.
- Квиз — От одного до восьми вопросов с вариантами ответа. Ответы проверяет сервер, в конце — уровень по баллам и, если нужно, промокод.
- Промокод — Кнопка открывает промокод, нажатие на код копирует его. Уникальные коды из вашего списка или один общий, с лимитом и сроком.
- Таймер — Обратный отсчёт до события. Когда время выйдет, виджет покажет другой текст и кнопку со ссылкой. Дату можно сдвинуть после отправки.
- Розыгрыш — Кнопка «Участвую» и счётчик участников. В назначенное время сервер сам выбирает победителей, а бот пишет им сообщение.
- Колесо фортуны — Колесо из 4–8 секторов с призами. Исход выбирает сервер по вашим весам; крутить можно один раз или раз в сутки.
- Оценка — Оценка от одной до пяти звёзд или по шкале NPS от 0 до 10. После оценки можно спросить причину.
- Статус заказа — Шаги и текущий этап заказа. Этап, пояснение и ожидаемое время обновляются через API без повторной отправки.
- Заявка в один тап — Карточка предложения с кнопкой заявки. Имя и юзернейм приходят из Telegram, вам — уведомление.
2. Настройте
Редактор открывается в кабинете; вход — через бота в Telegram, без паролей. Настройки разложены по вкладкам «Содержание», «Поведение», «Вид» и «Сообщение». Изменения сохраняются сами.
- Шкала «N из 4 096 байт» показывает, сколько места занимает виджет после сжатия.
- Ошибки настроек появляются рядом с полем: слишком длинный текст, пропущенное обязательное поле.
- Подпись сообщения обязательна: её видят в списке чатов и там, где виджеты не поддерживаются.
3. Проверьте в эмуляторе
Справа от настроек виджет работает в пузыре сообщения. Можно переключить тему, ширину пузыря, размер текста и «зрителя» — посмотреть виджет глазами другого человека. Нажатия уходят в настоящий движок, но в песочницу: голоса и выданные коды там ненастоящие и сбрасываются кнопкой.
Эмулятор приближённый. Эталон — приложение Telegram.
4. Отправьте себе и опубликуйте
- «Отправить себе в Telegram» — бот присылает виджет в ваш личный чат, чтобы увидеть его в настоящем приложении.
- «Опубликовать» — создаёт версию виджета и ссылку вида
t.me/<бот>?start=<код виджета>с QR-кодом. Человек открывает ссылку, нажимает «Запустить» и получает виджет в личном чате с ботом.
Код уже отправленных сообщений изменить нельзя — это правило Telegram. Новая версия попадает только в новые сообщения; голоса и выданные коды при этом сохраняются.
5. Смотрите результаты
- Статистика: отправки, показы, действия и число разных людей по дням; распределение ответов.
- Заявки: список с именем и юзернеймом из Telegram, выгрузка в CSV.
- Промокоды: свой список кодов для шаблонов «Промокод» и «Колесо фортуны»; один код не выдаётся дважды.
Показы считаются только у виджетов с запросами к боту: у остальных технически узнать о показе нельзя.
Свой HTML
Если вы пишете виджет сами, проверка кода работает без
регистрации: она показывает, что приложение вырежет, сжимает код, считает размер и запускает виджет в эмуляторе.
Тот же компилятор доступен по API без ключа: POST /api/v1/compile, до 10 запросов в минуту с одного адреса.
В кабинете у своего кода отдельный редактор: кнопка «Написать свой код» в списке виджетов. Код компилируется сам, пока вы печатаете: замечания показаны по строкам, шкала — размер после сжатия, справа — виджет в эмуляторе.
- На любом тарифе: редактор, эмулятор, компиляция и копирование готового кода — его можно отправить своим ботом методом
sendWidget. - «Отправить себе в Telegram» — после автоматической проверки кода: без обращения к кошельку, без ссылок на посторонние домены и без признаков фишинга.
- Публикация по ссылке — с тарифа «Старт».
- Манифест — вкладка рядом с кодом: разрешите виджету запросы и опишите, что сервер делает в ответ, готовыми действиями (голос, счётчик, выдача промокода, случайный исход, проверка ответа, заявка). Пустой манифест — статический виджет.
- AI — вкладка «AI»: опишите виджет словами, модель напишет код, а компилятор проверит его и попросит исправить. Генерации считаются по тарифу. Возможность построена, но на настоящей модели ещё не проверена.
Остальные методы API — отправка виджетов, состояние, статистика, заявки, исходящие вебхуки — описаны на странице «API»; они работают на платных тарифах.
Свой бот
По умолчанию ссылка виджета ведёт в чат с ботом Widgram. С тарифа «Старт» виджеты можно отправлять от имени своего бота — тогда человек остаётся в вашем чате. В кабинете это раздел «Боты»; бота для ссылки выбирают на странице «Поделиться» виджета.
- Создать нового. В чате с нашим ботом команда
/botпоказывает кнопку «Создать бота»: Telegram заводит бота и передаёт его под управление сервиса. Токен вводить не нужно. - Полный режим. Для бота, у которого нет другого сервера: вставляете токен, вебхук становится нашим. Бот отвечает на
/startприветствием, которое вы задаёте сами. - Прокси (с тарифа «Про»). Для бота, который уже работает на другом сервисе: запросы наших виджетов и ссылки на них обрабатываем мы, всё остальное без изменений уходит вашему серверу, а его ответ возвращается в Telegram как есть.
- Только отправка. Вебхук не трогаем. Виджеты отправляются через кабинет и API; ссылок на виджеты и рассылок в этом режиме нет.
Перед тем как что-либо менять, кабинет показывает, какой вебхук стоит у бота сейчас, и чужой вебхук молча не перезаписывает. При отключении бота прежний вебхук возвращается, а токен удаляется.
Рассылки
С тарифа «Про» виджет можно разослать тем, кто уже пользовался вашим ботом: всем, новым за последние дни или тем, кто нажимал в другом виджете. Рассылка идёт только через своего бота — сразу или по расписанию, — и не быстрее, чем разрешает Telegram. Перед запуском кабинет показывает число получателей и проверяет, что они помещаются в лимит MAU; рассылку можно поставить на паузу и продолжить.
Чего пока нет
Мы не обещаем то, что ещё не построено. В планах:
- Оплата подписки. Платные тарифы. Оплата звёздами Telegram построена; оплата картой — в планах.
- Виджет по описанию. Опишите виджет словами — модель напишет код, а компилятор проверит его и попросит исправить. Построено в редакторе своего HTML; качество на настоящей модели ещё не измерено.