# Налаштування вебхуків під час пересилання в Telegram Language: uk Canonical: Published: 2026-11-12T23:29:52+00:00 Modified: 2026-11-12T23:30:00+00:00 Вебхуки є механізмом автоматичного надсилання даних між сайтами й застосунками за певних подій. Дані передаються за допомогою HTTP-запиту: один застосунок надсилає їх через інтернет на заздалегідь указану адресу іншого. ![Передавання повідомлення з Telegram на інший сайт або в застосунок]() Зміст статті - [Можливості вебхуків]() - [Створення вебхука]() - [Налаштування вебхуків]() - [Доступні дії з вебхуком]() - [Поширені запитання]() ## Можливості вебхуків У FLOWIN вебхуки працюють із пересиланнями. Вони можуть спрацьовувати під час появи, зміни, видалення або закріплення повідомлення у вихідному чаті (джерелі), а також під час натискання кнопки в чаті, куди пересилаються повідомлення (призначенні). Так можна пов’язати FLOWIN із соціальними мережами, біржами, таблицями та CRM (системами для роботи з клієнтами). Такий зв’язок називається інтеграцією й дає змогу: - Автоматично додавати заявки з Telegram у CRM. - Передавати торгові сигнали з Telegram на біржу для автослідування, тобто автоматичного укладання угод за цими сигналами. - Пересилати повідомлення з Telegram в інші соціальні мережі. - Копіювати дописи й повідомлення в Google Таблиці. - Налаштувати автовідповідач у боті. Для кожного сценарію потрібно налаштувати приймання даних і потрібну дію на боці сайту або застосунку. ## Створення вебхука Перевіримо вебхук на сайті webhook.site, який видає адресу для приймання даних і показує отримані запити. Надішлемо на нього текст нового повідомлення з Telegram. Для цього потрібне [налаштоване й робоче пересилання]() у FLOWIN. Для першого тесту Використовуйте окремий тестовий чат і вигадану заявку. Для перевірки достатньо передати текст без імен, телефонів та інших особистих даних. 0. Відкрийте [@flow\_in\_bot](), надішліть команду ` /start ` і натисніть «Панель керування». [![Вхід до панелі керування через @flow\_in\_bot.]()]() Вхід до панелі керування через @flow\_in\_bot. 1. Відкрийте [webhook.site]() в окремій вкладці. Скопіюйте адресу для приймання запитів із поля «Your unique URL». [![Адреса для отримання тестового запиту]()]() Адреса для отримання тестового запиту. 2. У панелі FLOWIN відкрийте «Меню» → «Вебхуки» й натисніть «Створити». [![Розділ «Вебхуки» в меню FLOWIN]()]() Розділ «Вебхуки» в меню FLOWIN. [![Створення першого вебхука]()]() Створення першого вебхука. 3. У верхнє поле вставте скопійовану адресу. У полі «Тіло запиту» вкажіть ` {"message":""} ` і натисніть «Створити». Це шаблон даних, що надсилаються: замість ` ` FLOWIN підставить текст повідомлення, а отримувач побачить його в полі ` message `. [![Адреса й тіло тестового запиту]()]() Адреса й тіло тестового запиту. 4. Натисніть «Застосувати» біля створеного вебхука. Позначте потрібне пересилання й натисніть «Зберегти». [![Підключення вебхука до пересилання]()]() Підключення вебхука до пересилання. [![Вибір пересилання для вебхука]()]() Вибір пересилання для вебхука. 5. Надішліть у чат-джерело тестове повідомлення, наприклад «Заявка №1042: потрібен каталог меблів.». Поверніться на webhook.site: перший отриманий запит відкриється автоматично. У блоці «Request Content» з’явиться текст заявки в полі ` message `. Тепер FLOWIN автоматично надсилатиме текст кожного нового повідомлення на вказану адресу перед його пересиланням у чат призначення. [![Тестова заявка в чаті-джерелі]()]() Тестова заявка в чаті-джерелі. [![Отриманий текст заявки на webhook.site]()]() Отриманий текст заявки на webhook.site. ## Налаштування вебхуків Розглянемо налаштування на прикладі створеного вебхука: як їх змінити й що означає кожне поле. Звідки брати налаштування Для підключення іншого сайту або застосунку використовуйте його документацію. Зазвичай правила приймання даних містяться в розділі API, який описує взаємодію з іншими програмами. Там указано адресу, HTTP-метод і формат даних для заповнення полів нижче. ### Як змінити налаштування вебхука 1. У списку «Вебхуки» натисніть «Змінити» біля потрібного вебхука. [![Відкриття налаштувань вебхука]()]() Відкриття налаштувань вебхука. 2. Змініть потрібні поля й натисніть «Зберегти». [![Збереження змінених налаштувань]()]() Збереження змінених налаштувань. [![Опис збережено в налаштуваннях вебхука]()]() Опис збережено в налаштуваннях вебхука. ### HTTP-метод HTTP-метод задає дію запиту: POST передає дані на обробку, GET запитує дані, PUT замінює їх. За замовчуванням вибрано POST, який підходить для нашого тесту. Для іншого сайту або застосунку вибирайте метод, указаний у його документації. [![Доступні HTTP-методи]()]() Доступні HTTP-методи. ### URL-адреса URL означає адресу в інтернеті. Тут указують адресу для приймання даних, отриману на підключуваному сайті або в застосунку. У нашому прикладі її видав webhook.site. ### Тіло запиту Тіло запиту містить дані, що надсилаються, у форматі JSON: пари «назва поля: значення». Склад полів залежить від вимог підключуваного сайту або застосунку. Метатеги є позначеннями, замість яких FLOWIN підставляє дані повідомлення. Наприклад, ` ` замінюється текстом, а ` ` іменем автора. Список метатегів також відкривається за посиланням «метатеги» під полем. Номери користувачів, повідомлень, чатів і тем у списку нижче означають їхні ідентифікатори (ID) у Telegram. #### Повідомлення й автор - Текст повідомлення: ` `. - Дата повідомлення: ` `. - Час повідомлення: ` `. - Номер автора: ` `. - Ім’я автора: ` `. - Ім’я автора в HTML-посиланні на його профіль: ` `. - Ім’я автора у вигляді хештегу: ` `. - Нікнейм автора: ` `. #### Джерело - Текст повідомлення: ` `. - Номер повідомлення: ` `. - Посилання на повідомлення: ` `. - Номер чату: ` `. - Назва чату: ` `. - Нікнейм чату: ` `. - Номер теми: ` `. - Назва теми: ` `. #### Призначення - Текст повідомлення: ` `. - Номер повідомлення: ` `. - Посилання на повідомлення: ` `. - Номер чату: ` `. - Назва чату: ` `. - Нікнейм чату: ` `. - Номер теми: ` `. - Назва теми: ` `. Номер і посилання повідомлення в призначенні з’являються після пересилання. Щоб передати їх, виберіть «Після надсилання» в полі [«Тригер запиту»](). #### Натискання кнопки - Номер користувача, який натиснув кнопку: ` `. - Ім’я користувача, який натиснув кнопку: ` `. - Дані кнопки: ` `. - Дата натискання: ` `. - Час натискання: ` `. #### Вибір тексту - Регулярний вираз задає правило пошуку тексту. Наприклад, ` (short|sell) ` підставляє перший знайдений збіг із ` short ` або ` sell `. - Випадковий текст ` 1|2|3|4|5 ` підставляє один із п’яти варіантів. Між тегами можна вказати власні варіанти, розділивши їх символом ` | `. ### Заголовки запиту «Заголовки запиту» містять службові відомості для отримувача. Наприклад, ключ доступу дає змогу перевірити, хто надіслав запит. Заголовки задають у форматі JSON. Зазвичай це поле змінювати не потрібно; потрібні значення беруть із документації підключуваного сайту або застосунку. ### Тригер запиту «Тригер запиту» визначає подію та момент, коли вебхук має надіслати запит на вказану адресу. Як подію можна вибрати: - «Надсилання» вибрано за замовчуванням. Вебхук спрацьовує під час пересилання нового повідомлення. - «Редагування» спрацьовує під час обробки зміни повідомлення в джерелі. - «Закріплення» спрацьовує під час обробки закріплення повідомлення в джерелі. - «Видалення» спрацьовує під час обробки видалення повідомлення в джерелі. - «Натискання кнопки» спрацьовує для кнопок зі зворотним викликом (callback) у чаті призначення. Така кнопка повідомляє боту про натискання й передає задані для неї дані. Звичайна кнопка з посиланням цей вебхук не запускає. [![Події, які запускають запит]()]() Події, які запускають запит. Момент надсилання визначає, на якому етапі пересилання піде запит: - «До обробки»: запит надсилається до перекладу й обробки повідомлення штучним інтелектом (ШІ). - «Після обробки»: запит надсилається після [перекладу]() і [обробки ШІ](). - «Після надсилання»: запит надсилається, коли повідомлення вже успішно надіслано або змінено в чаті призначення. [![Момент надсилання запиту]()]() Момент надсилання запиту. Доступні моменти надсилання Усі три варіанти доступні для подій «Надсилання» та «Редагування». Для «Закріплення», «Видалення» та «Натискання кнопки» використовується «До обробки», вибрати інший момент не можна. ### Опис «Опис» слугує коментарем для вашої зручності й не впливає на роботу вебхука. Поле можна залишити порожнім. ## Доступні дії з вебхуком Створеними вебхуками можна керувати зі списку «Вебхуки»: - «Змінити» відкриває основні налаштування вебхука. - «Дублювати» в меню «Ще» створює копію налаштувань вебхука. - «Вибрати проєкт» у меню «Ще» додає вебхук до проєкту. - «Видалити» в меню «Ще» видаляє вебхук. [![Додаткові дії з вебхуком]()]() Додаткові дії з вебхуком. Крім того, у кожного вебхука є кнопка «Пересилання \[N\]», яка відкриває вибір пересилань, до яких він застосовується. N означає кількість вибраних пересилань. Якщо пересилання ще не вибрано, замість неї показано кнопку «Застосувати». ## Поширені запитання **Що таке вебхук простими словами?** Це спосіб автоматично передати дані іншому застосунку за певної події. Наприклад, під час пересилання нового повідомлення FLOWIN надсилає його текст на вказану вами адресу за допомогою HTTP-запиту. Тут запит надсилає FLOWIN; метод Telegram ` setWebhook ` налаштовує інший напрям: доставлення оновлень від Telegram програмі, яка обслуговує бота. **Чи достатньо вказати адресу CRM?** Ні. Потрібна адреса для приймання даних із документації CRM, а також відповідні HTTP-метод, поля JSON і заголовки, якщо вони потрібні для доступу. Звичайна адреса сайту CRM для цього не підходить. FLOWIN надсилає запит, а створення заявки або інша дія залежить від того, як CRM обробляє отримані дані. Значення полів описано в розділі [«Налаштування вебхуків»](). **Чому посилання на повідомлення в призначенні порожнє?** До успішного надсилання нового повідомлення у FLOWIN ще немає його номера й посилання в призначенні. Для передавання ` ` і ` ` виберіть подію «Надсилання» або «Редагування» і момент «Після надсилання» в полі [«Тригер запиту»](). Посилання формується для каналів і супергруп. Для особистого чату або звичайної групи ` ` залишиться порожнім і після надсилання. **Чи можна запускати вебхук натисканням звичайної URL-кнопки?** Ні. Звичайна URL-кнопка відкриває посилання. Для події «Натискання кнопки» потрібна кнопка зі зворотним викликом (callback) у чаті призначення: вона передає боту дані про натискання. Цю відмінність описано в розділі [«Тригер запиту»](). **Як перевірити, що зовнішній сервіс отримав дані?** Надішліть вигадане повідомлення й перевірте отриманий запит на боці сервісу. У [прикладі з webhook.site]() текст заявки з’являється в блоці «Request Content». Успішне пересилання в Telegram саме по собі не підтверджує, що зовнішній сервіс прийняв дані або виконав потрібну дію. Для перевірки достатньо тексту без імен, телефонів та інших особистих даних.