Налаштування Приймача даних Webhooks

Інтеграція дозволить вам передавати дані з різних систем у потрібну вам систему, якщо вона підтримує передачу Webhooks. Наприклад, ви можете передавати дані на замовлення з CRM або Google Sheets в потрібну вам систему. Так ви зможете максимально ефективно автоматизувати процес обробки даних, наприклад замовлень, за допомогою різних послуг, які використовуєте.

Давайте пройдемо весь етап налаштування Webhooks разом!

Навігація:
1. Що робитиме інтеграція з Webhooks?
2. Як підключити акаунт Webhooks до ApiX-Drive?
3. Як налаштувати у вибраній дії передачу даних у Webhooks?
    Надіслати ДАНІ
    Надіслати ДАНІ (Користувацький)
4. Приклад даних, які будуть відправлені до вашого Webhooks.
5. Автооновлення та інтервал спрацьовування з'єднання.

Після того, як ви налаштували систему Джерела даних, наприклад Google Sheets, можна приступити до налаштування Webhooks як Приймача даних.

Для цього натискаємо "Почати налаштування Приймача Даних".

Виберіть систему як Приймач даних. В даному випадку необхідно вказати Webhooks.

Далі, необхідно вказати дію - Відправити ДАНІ.

- Відправити ДАНІ - на вказаний вами url буде надіслано дані згідно із зазначеними налаштуваннями.

- Відправити ДАНІ (Користувацький) - на вказаний вами url буде надіслано дані згідно із зазначеними параметрами, дія дає змогу вказати розширені параметри, а саме Заголовок. так само дія дає змогу отримати відповідь на надісланий запит.

Наступний крок - вибір акаунту Webhooks, в який буде відбуватися відправка даних.

Якщо немає підключених акаунтів до системи ApiX-Drive, натисніть "Підключити акаунт".

Приклад налаштування полів і тестові дані дії "Відправити ДАНІ"

У вікні необхідно заповнити поле "URL для надсилання даних".

URL для надсилання даних - знаходиться у вашому особистому кабінеті вибраної системи.
Для прикладу роботи використовуємо систему ProveSource.

Ви можете зробити те саме в будь-якій іншій системі, яка підтримує Webhooks.

Перейдемо до особистого кабінету ProveSource, у вкладку "Notifications" і натиснемо кнопку "New Notification".

Далі вибираємо "Stream".

Потім вибираємо "Webhook".

У полі "Your Webhook URL" знаходиться посилання Webhook. Необхідно скопіювати URL-адресу та вставити її у відповідне поле в системі ApiX-Drive.

Після цього повертаємося в особистий кабінет ProveSource натискаємо на кнопку "Next".

У полі "Select URL match type" вписуємо "apix-drive.com".

Далі необхідно заповнити поле Message Text, в даному полі необхідно прописати текст повідомлення.

Вибираємо потрібний вам стиль та налаштування.

Вписуємо назву цього повідомлення, у полі "Notification Name" та натискаємо кнопку "Launch".

Переходимо у вкладку "Notifications", знаходимо щойно створене повідомлення та перевіряємо, що воно увімкнено.

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

Увага! Якщо ваш акаунт знаходиться у списку "неактивні акаунти" перевірте свій доступ до цього логіну!

Тепер необхідно налаштувати зв'язок полів Джерела даних на прикладі Google Sheets з відповідними полями в ProveSource.

Для початку потрібно вибрати "Тип відправки" POST Json.

Далі, необхідно вказати назви полів, під якими ви передаватимете в ProveSource дані. В даному випадку вам необхідно прописати значення, які доступні в сервісі ProveSource.

Ознайомитись зі списком доступних значень, ви зможете за цим посиланням - https://help.provesrc.com/en/articles/3474258-setup-a-custom-webhook

У полі Значення ви призначаєте змінну з Джерела даних. Як результат, у вас буде називатися поле "firstName" і до нього буде надходити значення, яке міститься в колонці А з Google Sheets.

Тепер ви можете побачити тестові дані.

Якщо ви хочете відправити тестові дані в ProveSource для того, щоб перевірити коректність налаштування, клацніть "Надіслати тестові дані в ProveSource" і перейдіть у ваш ProveSource, щоб перевірити результат.

Результат відправлення даних знаходиться у вашому особистому кабінеті ProveSource, у вкладці "Feed".

Якщо ви хочете змінити налаштування - натисніть "Редагувати" і ви повернетеся на крок назад.

Якщо вас все влаштовує - натисніть "Далі".

Приклад лога відправлених даних:

Приклад налаштування полів і тестові дані дії "Відправити ДАНІ (Користувацький)"

Для прикладу роботи використовуємо систему Click Send. Ви можете зробити те саме в будь-якій іншій системі, яка підтримує Webhooks.

Тепер необхідно провести налаштування зв'язку полів Джерела даних на прикладі Google Sheets з відповідними полями в Click Send.

Для початку необхідно вказати URL для приймання даних згідно з документацією сервісу та обраної вами дії. Для прикладу ми візьмемо Створення контакту в Click Send.

Далі виберіть зазначений у документації Метод, а також вкажіть Логін і Пароль.

У цьому випадку ми вказуємо логін від акаунта Click Send і ключ API. Заповніть Заголовок так само згідно з документацією.

Тепер ви можете побачити тестові дані.

Якщо ви хочете надіслати тестові дані в Click Send для того, щоб перевірити коректність налаштування, натисніть "Надіслати тестові дані в Webhooks " і перейдіть у ваш Click Send, щоб перевірити результат.

Результат надсилання даних, знаходиться у вашому особистому кабінеті Click Send.

Якщо ви хочете змінити налаштування - клікніть "Редагувати" і ви повернетеся на крок назад.

Якщо вас усе влаштовує - клікніть "Далі".

Приклад лога відправлених даних:

Тепер можна розпочати вибір інтервалу оновлення та увімкнення автооновлення.

Для цього клацніть "Увімкнути оновлення".

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

Увага! Щоб Запуск за розкладом спрацював у вказаний час, необхідно щоб інтервал між поточним часом та вказаним часом був більше 5 хвилин. Наприклад, ви вибираєте час 12:10 та поточний час 12:08 - у цьому випадку автооновлення з'єднання відбудеться о 12:10 наступного дня. Якщо ви вибираєте час 12:20 та поточний час 12:13 – автооновлення з'єднання спрацює сьогодні і далі щодня о 12:20.

Для того щоб поточне з'єднання спрацьовувало після іншого з'єднання, поставте галочку "Оновлювати лише після з'єднання" і вкажіть з'єднання, після якого спрацьовуватиме поточне з'єднання.       

Щоб увімкнути автооновлення, переведіть повзунок у положення, як показано на малюнку.

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

На цьому налаштування Webhooks як Приймача даних завершено! Бачите, як все просто!?

Тепер можете не турбуватися, далі ApiX-Drive зробить все самостійно!