Перейти до основного контенту

Налаштування Webhook Call та API Call

Автор: Yevhen

Функції Webhook Call та API Call дозволяють організувати експорт даних про контакт або компанію у зовнішні ресурси безпосередньо з автоматизації на будь-якому етапі.

Створення Webhook Call

Крок 1. Створіть вебхук у панелі налаштувань

Створіть вебхук, обравши його тип залежно від даних, які ви плануєте експортувати:

  • Contact Export (Custom Call) - використовуйте для передачі даних про контакти.

  • Account Export (Custom Call) - використовуйте для передачі даних про компанії.

Ознайомтесь з інструкцією зі створення вебхуків у статті Як створити Webhook.

Крок 2. Додайте вебхук до сценарію автоматизації

Відкрийте конструктор автоматизацій. Додайте відповідний вузол Call Custom Webhook у потрібному місці вашого сіквенсу та виберіть у його налаштуваннях щойно створений вебхук.

Створення API Call

Ця інструкція описує процес створення підключення до зовнішнього API та налаштування автоматизованих запитів із передачею динамічних даних (variables).

Етап 1: Налаштування профілю авторизації (API Call Accounts)

Створіть та збережіть облікові дані для доступу до вашого зовнішнього сервісу.

  • У панелі управління перейдіть до розділу API Call Accounts (1).

  • Натисніть кнопку Add API call account (2).

  • У модальному вікні, заповніть:
    - Connection name (3): Введіть назву для цього підключення.
    - Auth type (4): Виберіть тип авторизації, який вимагає ваш сервіс та введіть дані.

Оберіть один з типів авторизації:

Тип авторизації

Необхідні дані

API Key

Key name, Value, Add to

Bearer token

Token

Basic auth

Username, Password

  • Після заповнення даних натисніть Create (5).

Етап 2: Додавання API-виклику в автоматизацію

  1. Відкрийте конструктор автоматизації.

  2. У потрібному місці створіть вузол API Call.

Етап 3: Конфігурація API-запиту (API Call Settings)

1. Основні налаштування

  • API call (headers) account (1): Виберіть у випадаючому списку профіль авторизації.

  • Method (2): Виберіть HTTP-метод запиту.

  • Endpoint (3): Введіть URL-адресу зовнішнього API. За необхідності використайте функцію { } Insert variables (4) для підстановки динамічних даних.

  • Test API Call (5): Протестуйте налаштування API-Call

2. Передача даних (опціональні налаштування)

  • Body (1): Якщо ви використовуєте методи POST, PUT або PATCH, тут можна сформувати тіло запиту.

  • Query parameters (2): Параметри рядка запиту, пари Key/Value.

  • Headers (3): Додаткові HTTP-заголовки.

3. Розширені налаштування

У самому низу панелі знаходяться важливі налаштування стабільності:

  • Timeout (1): Час очікування відповіді від сервера (за замовчуванням 30 секунд).

  • Auto retry on errors (2): Активуйте цей чек-бокс, щоб система автоматично повторювала запит у випадку тимчасових збоїв (мережеві помилки, ліміти запитів або 5xx помилки сервера).

  • Remove Empty Values (3): Увімкніть цю опцію, щоб система автоматично виключала порожні, null або undefined значення із запиту. Це захистить ваші дані від випадкового перезапису порожніми рядками.

Ви отримали відповідь на своє запитання?