Як заявка потрапляє в Telegram
Форма на сайті надсилає дані в Formgong, сервіс зберігає заявку й передає повідомлення підключеному чату. Дизайн і поля лишаються на сайті. Telegram — канал сповіщень; повний запис можна відкрити в інбоксі.
Це підходить для запитів на консультацію, контактних форм та заявок із лендингу. Якщо у вас уже є сервер зі своїм ботом і потрібна складна логіка, можна використовувати Telegram Bot API напряму з цього сервера. У прикладі нижче власного бота створювати не потрібно.
1. Спочатку підключіть форму до Formgong
Отримайте ключ на Formgong, підтвердьте свою email-адресу та підключіть сайт у розділі «Підключення сайту». Для звичайного HTML є готовий приклад, для Lovable — інструкція з промптом.
Надішліть тестове повідомлення й переконайтеся, що воно є в «Заявках». Якщо його немає, спочатку виправте підключення сайту: прив’язка Telegram не виправить неправильний ключ або адресу надсилання.
2. Підключіть особистий чат
- Відкрийте потрібну форму в дашборді та її налаштування Telegram.
- Створіть посилання підключення, якщо його ще немає, і відкрийте кнопку переходу в Telegram.
- Натисніть Start / «Розпочати» в чаті з ботом Formgong. Самого відкриття чату недостатньо.
- Дочекайтеся повідомлення про прив’язку. Поверніться до налаштувань форми й перевірте список підключених чатів.
Посилання містить одноразовий код для конкретної форми. Він має обмежений строк дії; якщо код уже використаний або прострочений, створіть новий у дашборді. Не публікуйте посилання прив’язки на своєму сайті.
3. Або надсилайте заявки у групу
Для спільної роботи додайте бота Formgong у потрібну групу Telegram. У налаштуваннях форми отримайте свіжий код і надішліть команду з цього розділу саме в групу. Нижче зразок; замініть YOUR_CONNECTION_CODE виданим кодом, а не ключем access_key.
/connect YOUR_CONNECTION_CODE
Перевірте, куди підключена група
Бот має відповісти, що форму підключено. У дашборді назва групи має бути у списку чатів цієї форми. Далі надішліть нову заявку з сайту та перевірте її в групі й інбоксі.
Публічний ключ форми та код прив’язки мають різні завдання. Перший приймає заявки; другий визначає чат сповіщень. Не передавайте код прив’язки людям, які не повинні підключати свої чати.
Кожен учасник групи може бачити надіслані туди повідомлення. Вибирайте групу відповідно до того, кому потрібні дані клієнтів. Для приватних заявок використовуйте відповідний закритий чат.
4. Перевірте доставку з опублікованого сайту
Напишіть у тестовій заявці, наприклад, «Перевірка Telegram з сайту». Після надсилання перевірте правильну форму в Formgong і саме той чат, який підключили. Якщо треба, ввімкніть сповіщення Telegram для цього чату: вимкнений звук не означає, що повідомлення не надійшло.
Пошта й Telegram — окремі канали. Вимкнення поштових сповіщень у налаштуваннях не прибирає підключений чат. Щоб припинити доставку в конкретну групу, від’єднайте її в налаштуваннях Telegram.
Якщо бот не надсилає повідомлення
- У Formgong немає заявки
- Перевірте POST на
https://formgong.com/submitта ключ потрібної форми. Почніть із діагностики надсилання. - Заявка є, а в чаті порожньо
- Перевірте підтвердження email, статус спаму та чат у налаштуваннях саме цієї форми. Бот не має бути заблокований або видалений із групи.
- Код прив’язки не працює
- Створіть новий код, відкрийте нове посилання для особистого чату або надішліть нову команду в групу. Використаний код не можна повторно застосувати.
- Заявка прийшла не в ту групу
- Перевірте список чатів форми. Від’єднайте зайву групу й підключіть потрібну свіжим кодом.
Токен бота не потрібен у коді сайту
У фронтенді має бути лише публічний ключ Formgong. Прямий виклик Telegram Bot API з браузера потребував би токена бота, який відвідувачі могли б прочитати. У цьому сценарії повідомлення надсилає сервіс, тому сайт не отримує токен.
Коли додаєте ще одну форму, перевірте її прив’язку окремо. Telegram налаштовується для конкретної форми, а не автоматично для всього акаунта.
Питання та відповіді
Чи потрібно створювати власного Telegram-бота?
Ні, для цього сценарію використовується бот Formgong. Прив’язка відбувається в налаштуваннях потрібної форми через посилання або команду /connect.
Чи можна отримувати заявки в групі?
Так. Додайте бота Formgong до потрібної групи та надішліть у ній команду /connect зі свіжим кодом із налаштувань форми. Перевірте підтвердження прив’язки.
Чи можна використовувати access_key як код /connect?
Ні. access_key приймає заявки із сайту. Код /connect видається окремо для прив’язки чату, має строк дії та використовується один раз.
Чи включений Telegram у безкоштовний тариф?
Так. Telegram і пошта включені у Free. Ліміт становить 300 заявок на місяць на акаунт; чат треба підключити до потрібної форми.
Джерела та документація
Офіційні джерела для цієї інструкції: Telegram: bot deep links. Документація Formgong, де зберігаються дані.
Завантажити текст статті (Markdown)