Добавление URL-кнопок в Telegram

URL-кнопки в Telegram - это обычные ссылки, оформленные как кнопки под сообщениями и постами. Нажатие открывает указанный адрес.

Кнопка под сообщением ведёт к каталогу

Возможности URL-кнопок

FLOWIN позволяет автоматически добавлять URL-кнопки ко всем пересылаемым сообщениям и постам или только к определённым. Это позволяет реализовать следующие сценарии:

  • Автоматическая пересылка сообщений из одного чата в другой с добавлением URL-кнопок.
  • Пересылка сообщений с уже существующими URL-кнопками.

У новой кнопки вы задаёте название и ссылку, затем выбираете пересылки, в которых она нужна. FLOWIN добавляет её под сообщением при отправке в назначение. Для читателя ссылка выглядит как отдельная кнопка, например «Каталог мебели».

Ограничение для альбомов

Добавление новых URL-кнопок не применяется к обычным альбомам из нескольких фото или видео.

Создание URL-кнопки

Перед созданием кнопки нужна настроенная и включённая пересылка. В ней должен быть выбран режим «Копия», а отправителем должен быть аккаунт бота, подключённый по токену.

Бот-отправитель

Именно бот отправляет сообщение с кнопкой в назначение. Пользовательский аккаунт может читать источник, но в роли отправителя для этой задачи нужен бот. В канале у него должно быть право публикации сообщений.

В примере добавим кнопку «Каталог мебели». Вместо демонстрационного адреса https://example.com/catalog укажите ссылку на свой каталог.

  1. Откройте @flow_in_bot, отправьте команду /start и нажмите «Панель управления».

    Вход в панель управления через @flow_in_bot
    Вход в панель управления через @flow_in_bot.
  2. Откройте «Меню» → «Кнопки» → «Url кнопки» и нажмите «Создать».

    Раздел «Url кнопки» в меню FLOWIN
    Раздел «Url кнопки» в меню FLOWIN.
    Создание новой URL-кнопки
    Создание новой URL-кнопки.
  3. В поле «Название» введите текст, который читатель увидит на кнопке, например «Каталог мебели». В поле «URL» укажите полный адрес страницы, начиная с https://. Нажмите «Создать».

    Название и адрес будущей кнопки
    Название и адрес будущей кнопки.
  4. У созданной кнопки нажмите «Применить». В окне «Выбор пересылок» отметьте нужную пересылку и нажмите «Сохранить».

    Созданную кнопку нужно применить к пересылке
    Созданную кнопку нужно применить к пересылке.
    Выбор пересылки с ботом-отправителем
    Выбор пересылки с ботом-отправителем.
  5. Отправьте новое сообщение в источник и проверьте его в назначении. Под пересланным сообщением должна появиться кнопка с заданным названием и ссылкой. Теперь FLOWIN будет добавлять её к новым сообщениям в выбранных пересылках.

    Сообщение в источнике до пересылки
    Сообщение в источнике до пересылки.
    Сообщение с кнопкой в назначении
    Сообщение с кнопкой в назначении.

Как изменить URL-кнопку

Параметры созданной кнопки можно изменить в том же списке. Их значения описаны в разделе «Настройки URL-кнопок».

  1. Нажмите «Изменить» у нужной кнопки.

    Кнопка «Изменить» открывает настройки
    Кнопка «Изменить» открывает настройки.
  2. Измените нужные поля и нажмите «Сохранить». Например, заполните «Описание», чтобы легче находить кнопку. После закрытия окна проверьте новые данные в списке.

    Сохранение изменённых настроек
    Сохранение изменённых настроек.
    Описание помогает узнавать кнопку в списке
    Описание помогает узнавать кнопку в списке.

Настройки URL-кнопок

Все основные параметры находятся в окне, открытом через «Изменить». Название и URL обязательны; цвет и описание позволяют дополнить настройку.

Название

«Название» - текст на кнопке.

Можно использовать метатеги: специальные обозначения, которые FLOWIN заменяет данными конкретного сообщения. Например, <src-chat-name> подставляет название чата-источника.

Цвет

«Цвет» задаёт оформление кнопки. Доступны «По умолчанию», «Синий», «Красный» и «Зелёный». Значение «По умолчанию» использует стандартное оформление Telegram; остальные варианты задают выбранный цвет.

Доступные цвета URL-кнопки
Доступные цвета URL-кнопки.

URL

«URL» задаёт ссылку, которая открывается при нажатии. Для постоянного адреса укажите полную ссылку с https:// или http://.

Адрес также может зависеть от сообщения. В этом поле доступны два вида подстановок:

  • <src-message-link> подставляет ссылку на исходное сообщение. Если источник закрытый, читателю нужен доступ к нему.
  • <regexp>…</regexp> извлекает ссылку из текста по регулярному выражению, то есть шаблону поиска. Если подстановка не даёт допустимую ссылку, кнопка не добавляется.

Описание

«Описание» служит для вашего комментария о кнопке и не влияет на её работу. Поле можно оставить пустым.

Как добавлять кнопку только к нужным сообщениям

По умолчанию кнопка добавляется ко всем подходящим сообщениям выбранных пересылок. Ограничить её применение можно фильтром, привязанным к самой URL-кнопке. Например, фильтр может разрешать кнопку только для текста со словом «каталог».

Фильтр проверяет сообщение и решает, добавлять ли кнопку. Если условие не выполнено, сообщение пересылается без этой кнопки. Привязка фильтра к пересылке имеет другой смысл: она может остановить пересылку самого сообщения. Подробнее о создании и выборе привязки написано в инструкции по фильтрам.

Доступные действия с URL-кнопками

Рядом с каждой кнопкой расположены «Изменить» для основных настроек и «Ещё» для дополнительных действий:

  • «Применить» открывает выбор пересылок, в которых нужна кнопка.
  • «Дублировать» создаёт копию настроек кнопки.
  • «Выбрать проект» добавляет кнопку в проект.
  • «Удалить» удаляет кнопку.
Дополнительные действия с кнопкой
Дополнительные действия с кнопкой.

После применения вместо «Применить» в строке появляется «Пересылки» с числом привязок, например «Пересылки [1]». Этот элемент также открывает окно выбора пересылок. В нём можно добавить или убрать привязки, затем сохранить изменения.

Частые вопросы

Почему кнопка под постом в Telegram не появляется?

Проверьте, что кнопка применена к нужной пересылке, а сама пересылка включена и работает в режиме «Копия». Отправителем должен быть бот, подключённый по токену; для публикации в канале ему нужны соответствующие права. Если к кнопке привязан фильтр, сообщение должно проходить его условия. Если адрес зависит от текста сообщения, проверьте, что подстановка даёт допустимую ссылку.

Можно ли добавить URL-кнопку к альбому из нескольких фото или видео?

Нет. FLOWIN не добавляет новые URL-кнопки к обычным альбомам из нескольких фото или видео. Это ограничение действует и при правильной привязке кнопки к пересылке.

Как сделать кнопку со ссылкой на исходный пост?

Укажите <src-message-link> в поле «URL». FLOWIN подставит ссылку на исходное сообщение, поэтому у каждого пересланного поста будет свой адрес. Если источник закрытый, перейти к сообщению смогут только читатели с доступом к нему.

Что будет, если регулярное выражение не нашло ссылку?

Если весь адрес задан через <regexp>…</regexp> и совпадения нет, кнопка не добавится: подстановка даст пустую строку. Если шаблон содержит ещё и постоянную часть адреса, результат зависит от итоговой ссылки. FLOWIN добавит кнопку только тогда, когда после всех подстановок получится допустимый адрес.