Lanka Документація Ланки
English Увійти

Документація Ланки

Як зробити Telegram-бота в Ланці: підключення бота, редактор, усі типи кроків і робота з Claude Code.

Початок роботи

Шаблони

Кроки

  • Кроки

    Перший крок у новій ланці: натисніть «Обрати тип першого кроку». Наступний крок: натисніть «+ Крок» під останнім кроком. Крок посередині: наведіть...

  • Повідомлення

    Бот надсилає повідомлення: текст, за бажанням — з картинкою, відео чи аудіо і кнопками під ним.

  • Reply-клавіатура

    Повідомлення з меню під полем вводу: кнопки стоять замість клавіатури телефона, і людина натискає їх, як швидкі відповіді.

  • Заглушка

    Повідомлення «зачекайте» — наприклад, «⏳ Хвилинку…», — яке наступне повідомлення бота замінить на тому ж місці.

  • Тимчасове повідомлення

    Бот надсилає повідомлення, альбом чи голосове, а через заданий час сам видаляє його з чату.

  • Задати питання

    Бот ставить запитання і чекає, поки людина напише відповідь. Відповідь зберігається у змінну, і діалог іде далі.

  • Попросити номер телефону

    Бот просить номер і показує під полем вводу кнопку, яка його надсилає. Номер зберігається у змінну, і діалог іде далі.

  • Попросити локацію

    Бот просить локацію і показує під полем вводу кнопку, яка надсилає геолокацію. Відповідь зберігається у змінну, і діалог іде далі.

  • Попросити файл

    Бот просить файл і чекає, поки людина його надішле. Файл зберігається у змінну, і діалог іде далі.

  • Попросити голосове

    Бот просить голосове і чекає, поки людина його запише. Голосове або надісланий аудіофайл зберігається у змінну, і діалог іде далі.

  • Вибрати дату

    Бот надсилає календар і чекає, поки людина вибере день. Дата зберігається у змінну, і діалог іде далі.

  • Опитування

    Бот надсилає опитування Telegram — запитання з варіантами відповіді, за які люди голосують.

  • Альбом

    Кілька фото одним повідомленням (до 10), як альбом у Telegram.

  • Надіслати голосове

    Бот надсилає аудіо голосовим повідомленням.

  • Точка на карті

    Бот надсилає місце на карті. Людина натискає на мініатюру карти й відкриває місце у своїх картах, щоб прокласти маршрут.

  • Відкрити посилання

    Кнопка, що відкриває посилання: сайт, канал, інший бот, файл.

  • Набір кнопок

    Додає не одну кнопку, а одразу набір кнопок, які дозволяють вибрати значення зі змінної: товари, лікарі, дати, послуги. Кнопок буде стільки, скільки...

  • Умова видимості кнопки

    Кнопка, яку бачать не всі: вона з'являється лише тоді, коли виконується умова.

  • Запустити Web App

    Відкриває Mini App — сторінку всередині Telegram: каталог, календар запису, форму.

  • Прибрати клавіатуру

    Прибирає меню під полем вводу (Reply-клавіатуру).

  • Поділитись

    Кнопка, щоб поділитися посиланням з друзями.

  • Скопіювати текст

    Кнопка, що копіює текст у буфер обміну: промокод, номер картки, адресу.

  • Умова

    Перевіряє умову і продовжує діалог гілкою «Так», якщо вона виконується, або гілкою «Ні», якщо ні.

  • Скрипт

    Порахувати чи змінити змінні, звернутися до зовнішнього сервісу — без відповіді людині.

  • Навігація

    Переводить людину в інше місце діалогу. Після цього кроку поточна гілка закінчується.

  • Розгалуження

    Для кожного значення змінної — своя гілка діалогу, а для всіх інших значень — гілка «інакше».

  • Перевірка підписки

    Перевіряє, чи підписана людина на ваш канал, і веде діалог гілкою «Так» або «Ні».

  • Затримка

    Зупиняє ланку на заданий час — секунди, хвилини чи години, — а потім продовжує з наступного кроку.

  • Бот пише

    Показує «друкує…» в чаті на кілька секунд (від 1 до 5), а потім іде далі.

  • Нагадування

    Надсилає повідомлення пізніше — у заданий час відносно дати зі змінної або від поточного часу. Діалог при цьому одразу йде далі.

  • Сповіщення

    Повідомляє вас — або ваш канал чи групу — про те, що зробила людина в боті. Наприклад, коли вона залишила заявку чи оформила замовлення, ви отримаєте...

  • Анонс

    Коли діалог доходить до цього кроку, бот розсилає новину вибраній аудиторії відвідувачів або у ваші канали.

  • Переслати повідомлення

    Коли діалог доходить до цього кроку, бот пересилає останнє повідомлення людини як є: з форматуванням, підписом, фото, відео чи голосовим.

  • Як надати доступ до закритого Telegram-каналу через бота

    Крок «Надати доступ до каналу» відкриває людині доступ до закритого каналу або групи: на термін або назавжди. Коли термін виходить, бот вилучає людину з...

  • Забрати доступ до каналу

    Вилучає людину із закритого каналу або групи й скасовує доступ, який їй дав крок «Надати доступ до каналу».

  • Оплата зірками

    Бот надсилає рахунок на оплату в Telegram Stars. Людина платить у вікні Telegram, не виходячи з чату.

  • Оплата карткою

    Бот надсилає рахунок на оплату банківською карткою через платіжного провайдера. Людина вводить картку у вікні Telegram. Гроші йдуть на рахунок...

Змінні й скрипти

  • Змінні й токени

    Змінна — це значення, яке бот запам'ятовує під іменем і потім використовує в розмові.

  • Скрипти

    Скрипт рахує і змінює змінні. Його виконує крок «Скрипт».

  • Секрети

    Секрет — ключ API чи пароль, який бот передає іншому сервісу під час запиту зі скрипта. Секрет зберігається в налаштуваннях бота, а не в тексті скрипта,...

  • Завдання

    Завдання запускається за розкладом. Є два види:

Відвідувачі й розсилки

  • Відвідувачі

    Тут видно кожного, хто писав вашому боту, і все, що бот про нього пам'ятає. Звідси можна написати людині від імені бота або запустити їй ланку.

  • Аудиторії

    Аудиторія — це збережений відбір відвідувачів, наприклад «ті, хто приходив більше чотирьох разів». Аудиторії використовують розсилки і крок «Анонс».

  • Розсилки

    Розсилка надсилає повідомлення всім відвідувачам бота, вибраним аудиторіям або у ваші канали. Надіслати її можна одразу або за розкладом.

Панелі

  • Панелі

    Панель — це таблиця над даними бота: замовленнями, заявками, записами або самими відвідувачами. У ній можна шукати, фільтрувати, міняти статус,...

  • Розклад

    Панель «Розклад» зберігає робочі години й бронювання. З неї бот показує клієнтам вільний час.

  • Вітрина

    Панель «Вітрина» зберігає товари й замовлення магазину. З неї бот показує клієнтам товари й кошик.

Claude Code

  • Плагін для Claude Code

    Плагін дає Claude Code читати ваші ланки й редагувати їхні чернетки. Публікуєте зміни ви самі кнопкою «Опублікувати».