Функції 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-виклику в автоматизацію
- Відкрийте конструктор автоматизації.
- У потрібному місці створіть вузол 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 значення із запиту. Це захистить ваші дані від випадкового перезапису порожніми рядками.