Будь-який сервіс інтегрується з HAPP через webhook
HAPP надсилає повідомлення та заявки на твій URL
у CRM, дашборд чи інший сервіс — в реальному часі
Telegram
Viber
Instagram
Facebook
WhatsAppЩо дає Chat Webhook
Підключаєш свій сервіс до HAPP однією формою — URL і пароль. Нові повідомлення одразу починають летіти у твою систему.
Працює з будь-яким сервісом
Якщо він приймає HTTPS — він прийме Chat Webhook. Твій бекенд, сценарій Zapier, n8n, Make — будь-що, що ти вже використовуєш.
// POST /your-endpoint { "event": "message.created", "messageId": "msg_8f3a…", "chatId": "chat_19b…", "from": "client", "text": "Доставка по Україні?", "createdAt": "2026-05-26T14:02:11Z" }
Події прилітають за секунду
Як тільки повідомлення зайшло в HAPP, ми надсилаємо його на твій URL. Зазвичай ≤ 200 мс. Дашборди й CRM лишаються синхронні.
Message → your endpoint · last 7d
Опціональний захист паролем
Якщо URL куди ти надсилаєш події вимагає авторизацію — встав пароль, і HAPP підставлятиме його на кожному виклику.
Авто-ретраї при збоях
Твій сервіс був недоступний або відповів помилкою? Ми ретраїмо з backoff — події не губляться на коротких збоях.
Exponential backoff · auto-recovery
Текст, автор, чат, таймстемпи
Усі поля, які тобі потрібні — id повідомлення, id чату, хто написав, сам текст, статус і час. Можна одразу класти у сховище.
Telegram, WhatsApp, Instagram, Facebook, Viber
Один вебхук покриває всі месенджери. Канал є в payload — гілкуй обробник, якщо потрібна канало-специфічна логіка.
Як підключити Chat Webhook до HAPP
Три кліки у HAPP — знайди плашку, встав URL і пароль, тисни Connect.
Крок 1: Знайди інтеграцію
Відкрий Інтеграції → Chat Webhook
Що тобі потрібно щоб підключити
Короткий чек-лист — як тільки відмітив чотири пункти, далі займе хвилину.
URL куди отримувати події
Посилання на сервіс, куди ти хочеш отримувати події чатів — твій бекенд, сценарій автоматизації (Zapier, n8n, Make) або будь-який сервіс, який приймає HTTPS POST.
Пароль до вебхука (опціонально)
Якщо твій сервіс вимагає авторизацію — візьми пароль з його налаштувань. HAPP підставлятиме його на кожному виклику, щоб сервіс знав, що це ми. Якщо сервіс відкритий — лиши порожнім.
Сервіс відповідає швидко
Відповідь 2xx за 5 секунд. Повільні відповіді ми рахуємо як збій — будемо ретраїти, але доставка затримається.
Акаунт HAPP із чатом
Активний воркспейс на my.happ.tools з підключеним хоча б одним месенджером — щоб був реальний потік подій, які ми надсилатимемо.
Як зрозуміти що все підключено
Коли HAPP достукається до твого сервісу і отримає 2xx у відповідь, плашка Chat Webhook перемкнеться у Connected — той самий зелений пілл, як на інших інтеграціях.
Ассистент по прийому інтернет-замовлень на покупку гаджетів
Call WebhookAccount Information
https://api.happ.tools/api/voice-assistant-webhooks/call-event
06.02.2026, 14:41
Telegram PushAccount Information
Slava Saloid
24.01.2026, 16:53
Chat WebhookAccount Information
https://api.acme.io/happ/chat
25.05.2026, 14:30
Зелений пілл "Connected"
Блакитна кнопка Connect зникає, замість неї зелений пілл — твій сервіс підписаний на події чатів.
URL видно на плашці
На плашці відображається твій webhook URL — легко аудитити або змінити.
Перша подія прилітає
Як тільки хтось напише в будь-якому чаті, подія полетить на твій URL. Побачиш у логах свого сервісу.
Налаштування і disconnect поряд
відкриває налаштування (змінити URL або пароль), дає Disconnect — без полювання по меню.
Якщо події не приходять
Чотири типові випадки — знайди свій і пофікси за хвилину.
Потрібна допомога?
Застряг після всіх перевірок?
Напиши нашій команді — глянемо логи разом.
Звʼязатись з підтримкою →401
Невірний пароль
401 Unauthorized
Пароль у HAPP не співпадає з паролем у твоєму сервісі. Відкрий плашку, встав правильний, збережи.
Timeout
ETIMEDOUT
Повільна відповідь
Твій обробник відповідав довше 5 секунд — це для нас збій. Відповідай 200 одразу, роботу роби потім.
404
URL не знайдено
404 Not Found
Неправильний шлях або сервіс не задеплоєний. Перевір що URL відкривається в браузері.
5xx
Сервіс лежить
500–599
Подивись логи свого сервісу — ми вже ретраїмо в фоні.
Після N ретраїв
Подію скинули після ліміту ретраїв
MAX_RETRIES_EXCEEDED
Якщо твій сервіс лежить годинами, ми зрештою припиняємо ретраї. Як відновитись:
- 1Спершу пофікси сервіс — перевір що URL відкривається і повертає 2xx.
- 2Disconnect → Connect у HAPP — це відновить стрім.
- 3Back-fill за потреби — через HAPP API.
Часті запитання
Швидкі відповіді — якщо твоєї нема, прокрути нижче до контактної форми.
Можна підключити кілька вебхуків?
Поки що один Chat Webhook URL на воркспейс. Якщо треба fan-out — постав тонкий проксі на своєму боці, який роздає запит на N даунстрімів.
Ви зберігаєте повідомлення?
Ми зберігаємо спроби доставки (статус, час відповіді, остання помилка) для дебагу. Сам контент повідомлень лежить у твоїй історії чатів у HAPP — вебхук це one-way дзеркало.
Як змінити пароль?
Відключи плашку, зміни пароль у своєму сервісі, потім підключи з новим значенням. Запити в дорозі зі старим паролем впадуть — або прийми кілька секунд накладання, або зупини трафік на час зміни.
Що буде під час downtime HAPP?
Доставка вебхуків ставиться в чергу. Коли платформа підіймається, ми зливаємо чергу по порядку — твій сервіс побачить берст, потім нормальна частота.
Чи можна фільтрувати які події я отримую?
Поки що ні — кожне повідомлення тригерить вебхук. Фільтруй у себе за полями channel і chatId з payload.
Як відключити і знову підключити
Два короткі флоу — те саме місце, протилежні кнопки.
Disconnect
Зупинити доставку без втрати історії
Коли треба поставити стрім на паузу — тимчасове обслуговування, виведення ендпоінта, зміна провайдера.
- 1Відкрий Інтеграції → плашка Chat Webhook.
- 2Тисни меню ⋮ на картці → Disconnect.
- 3Підтвердь — плашка повертається у блакитний стан Connect.
- 4Історія чатів у HAPP не чіпається; зупиняється тільки вихідна доставка.
Після Disconnect
- Події які вже полетіли на твій ендпоінт можуть ще дійти (in-flight запити).
- Через HAPP API підтягни що пропустив перш ніж знову підключитись.
Reconnect
Відновити — той самий URL чи новий
Коли ендпоінт знову здоровий або ти його переніс.
- 1Відкрий Інтеграції → плашка Chat Webhook.
- 2Тисни Connect, встав URL і секрет.
- 3Тисни Connect — летить ping, ти живий.
- 4Перевір що перше реальне повідомлення прийшло у твої логи.
Після Reconnect
- Через стрім ідуть тільки нові події — історичні автоматом не реплеяться.
- Через HAPP API back-fill якщо треба заповнити пропуск.