Канали
Створення та підключення Telegram-бота
Покроково: BotFather, токен, webhook, стартовий flow у чаті.
Як створити бота в Telegram
Бот створюється лише через офіційного @BotFather у Telegram. Нижче — мінімальний шлях від нуля до робочого бота в Epsenta.
- Відкрийте Telegram і знайдіть **@BotFather** (офіційний бот від Telegram)
- Надішліть команду **/newbot**
- Введіть ім’я бота (як його бачать люди) і username (має закінчуватися на `bot`)
- BotFather надішле **HTTP API Token** — скопіюйте його повністю (формат `123456:ABC...`)
- У Epsenta: **Налаштування → Канали → Telegram** → вставте токен → **Зберегти**
- Платформа сама зареєструє webhook; далі опублікуйте flow зі стартовим тригером і напишіть боту **/start**
Корисні команди BotFather
- **/setdescription** — опис бота в профілі
- **/setabouttext** — короткий «About»
- **/setuserpic** — аватар
- **/setcommands** — меню команд (/start, /help тощо)
- Не публікуйте токен у чатах і репозиторіях — це повний доступ до бота
Міграція з іншої платформи
Якщо бот уже працював на іншому конструкторі — у налаштуваннях Telegram є блок Паралельна міграція: синхронізація аудиторії через Ingest URL і API. Покроково: /wiki/migraciya-telegram-bota.
Відмінність від клубного бота
Цей бот — для діалогів, flows, тестів, розсилок у особистих чатах з клієнтами.
Для закритих каналів/груп з оплатою потрібен окремий клубний бот у розділі «Закриті клуби» — див. /wiki/zakryti-kluby.
Перевірка
Напишіть боту /start після публікації flow зі стартовим тригером.
Якщо немає відповіді: перевірте опублікований flow, токен і те, що бот не підключений паралельно в іншому сервісі (webhook може «перехопити» інша платформа).
Що вміє Telegram у Epsenta
- Reply та Inline клавіатури
- Медіа та галереї
- Повідомлення в групу / канал (бот — адмін)
- Блок «Перевірка підписки»
- Mini App (магазин, курси LMS)
- Оплата в чаті (де підтримує Telegram)
- Геолокація та запит контакту
Перевірка підписки vs клуб
Для перевірки підписки на публічний канал без оплати — блок Перевірка підписки у flow основного бота. Бот має бути адміном каналу.
Для платного закритого клубу — окремий клубний бот і блок Платний клуб. Див. /wiki/zakryti-kluby та /wiki/blok-telegram-check-subscription.
UTM-посилання для реклами
Telegram не передає стандартні query-параметри (?utm_source=...) боту. Epsenta пропонує два способи передати UTM-мітки:
Спосіб 1 — Launch-посилання (рекомендований). Створіть посилання в розділі «Тригери» → Launch links. Система автоматично згенерує URL виду `t.me/bot?start=...` з encoded UTM.
Спосіб 2 — Redirect-URL. Використовуйте адресу вашого API з звичайними UTM: `https://ваш-домен/api/go/юзернейм_бота?utm_source=meta&utm_medium=cpc&utm_campaign=...` — система перенаправить на Telegram з правильним payload.
В обох випадках після натискання «Start» UTM-мітки автоматично збережуться в змінних контакту: {utm_source}, {utm_medium}, {utm_campaign}, {utm_content}, {utm_term}.
- Redirect-URL підтримує додатковий параметр &flow=slug для запуску конкретного flow
- Telegram обмежує start-параметр 64 символами — довгі значення можуть обрізатися
- UTM-мітки зберігаються при першому /start; повторний /start перезапише їх