Що таке вебхуки?
Вебхуки в RemOnline дозволяють вашим системам отримувати оновлення в реальному часі, коли відбуваються певні події. Оновлення надсилаються у вигляді HTTP POST-запитів на ваш вказаний кінцевий пункт, що дає змогу автоматизувати процеси та інтегруватися з іншими додатками.
Яка різниця між API та Вебхуками?
Параметр | API | Вебхуки |
Як працює | Ви робите запит до API і отримуєте відповідь. | Система автоматично надсилає дані на ваш кінцевий пункт, коли відбувається подія. |
Ініціатор взаємодії | Ваш додаток ініціює запит (наприклад, отримати список замовлень). | RemOnline ініціює відправку даних на ваш сервер. |
Частота використання | Потрібно періодично робити запити, навіть якщо немає змін (Polling). | Дані надсилаються тільки тоді, коли щось відбувається (Event-driven). |
Ресурси сервера | Залежить від частоти запитів – часті запити можуть перевантажити сервер. | Використовує менше ресурсів, оскільки запити виконуються тільки при подіях. |
Приклади використання | Отримання інформації про замовлення, клієнтів, задачі тощо за запитом. | Оповіщення про зміну статусу замовлення, створення задачі чи отримання нового відгуку клієнта в реальному часі. |
Затримка в оновленнях | Може бути затримка через необхідність ручних або автоматичних періодичних запитів. | Оновлення надсилається миттєво після виникнення події. |
Складність налаштування | Вимагає розробки та інтеграції запитів (GET, POST, PUT, DELETE тощо). | Потрібно лише вказати кінцевий пункт і обрати події, які вас цікавлять. |
💡 Якщо простими словами, то:
API — це як магазин, у який ви йдете, щоб отримати потрібну інформацію. Ви вирішуєте, коли піти, і питаєте, що вам потрібно. Використовуйте API, якщо вам потрібно запитувати дані або виконувати дії за запитом.
Вебхуки — це як доставка додому. Вам не потрібно йти кудись; дані автоматично надходять до вас, щойно вони з’являються. Використовуйте вебхуки, якщо ви хочете автоматично отримувати оновлення в реальному часі без постійних запитів
Як працюють вебхуки?
Виникнення події: У системі активується певна подія, наприклад, створення замовлення або оновлення статусу.
Відправка даних: Система надсилає HTTP POST-запит із деталями події у форматі JSON на ваш кінцевий пункт.
Обробка даних: Ваша система обробляє отримані дані для подальших дій або інтеграцій.
Налаштування вебхуків
1. Увійдіть до свого облікового запису.
2. Перейдіть до розділу Налаштування > API.
3. Натисніть + Вебхук і вкажіть такі дані:
URL кінцевого пункту: URL, на який надсилатимуться дані подій.
Опис: Короткий опис вебхука.
Події: Оберіть події, для яких бажаєте отримувати оновлення.
4. Натисніть Створити.
Важливо: переконайтеся, що ваш кінцевий пункт доступний і використовує HTTPS для безпечної передачі даних.
На кожен обліковий запис можна створити максимум 5 вебхуків для забезпечення ефективності системи.
Всі деталі можна переглянути на цій сторінці.
Підтримувані події
Вебхуки підтримують різні категорії подій, зокрема задачі, звернення, замовлення, клієнти та рахунки.
Повний список подій можна знайти на сторінці Налаштування > API > Вебхуки у вікні створення нового вебхука або у цій документації.
Як можна використовувати вебхуки?
Маючи прямий доступ до API інших сервісів або за допомогою онлайн-конекторів, як от Zapier або Make.com, ви можете створити endpoint і вказати його URL для вебхука, на який RemOnline автоматично надсилатиме сповіщення про вибрану подією.
Таким чином, ви можете автоматизувати багато процесів:
Надсилання SMS-сповіщень:
Використання сторонніх SMS-сервісів для інформування клієнтів про зміну статусу замовлення, дату готовності чи зміну менеджера.
Інтеграція з Google Sheets:
Автоматичне додавання нових даних про замовлення або задачі в Google Таблиці для аналітики або звітності.
Автоматизація нагадувань:
Надсилання нагадувань клієнтам або співробітникам через обраний канал (email, месенджери, push-сповіщення) про дедлайни замовлень або завершення терміну дії задач.
Звітування в реальному часі:
Оновлення інформаційних панелей (наприклад, в Power BI чи Tableau) при створенні або зміні статусу замовлень, задач, рахунків тощо.
Інтеграція з бухгалтерськими програмами:
Автоматична передача даних про створені рахунки та зміни в оплатах у програми для бухгалтерського обліку (наприклад, 1С, QuickBooks).
Сповіщення про видалення даних:
Інформування керівників або відповідальних осіб про видалення клієнтів, замовлень, рахунків чи задач для відстеження змін у системі.
Ці приклади демонструють, як вебхуки можуть автоматизувати бізнес-процеси, інтегруватися з різними платформами та покращувати комунікацію. Проте можливості їх використання практично безмежні — усе залежить від ваших потреб та креативності!