Перейти к содержимому
Widgram

Как пользоваться конструктором

Виджет в 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; качество на настоящей модели ещё не измерено.