HelpCrunch Оновити КОНТАКТ / Створити КОНТАКТ

Інтеграція дозволить вам реалізувати сценарій оновлення контакту, а у разі виникнення помилки, ґрунтуючись на конкретних умовах, створення нових контактів у HelpCrunch на основі даних з інших систем, а також за допомогою блоку Логіка Якщо/Тоді ви можете надсилати повідомлення про помилки в Телеграм або на пошту, наприклад, Gmail. Це дозволить отримувати в Джерелі даних поля з даними та проводити оновлення/створення контакту в HelpCrunch за заданими значеннями та передавати дані в інші системи. Так ви зможете максимально ефективно автоматизувати процес оновлення/створення контакту та обробки даних за допомогою різних сервісів, які використовуєте.

Давайте пройдемо весь етап налаштування HelpCrunch Оновити КОНТАКТ / Створити КОНТАКТ за допомогою Логіки Якщо/Тоді разом.

Навігація:

Підключення Google Sheets як Джерела даних:
1.Які дані можна отримати з Google Sheets?
2. Як підключити акаунт Google Sheets до ApiX-Drive?
3. Вибір таблиці та аркуша, з якого вивантажуватимуться рядки.
4 . Приклад даних по одному з рядків у таблиці .

Підключення HelpCrunch як Приймач даних для оновлення контактів:
1. Що робитиме інтеграція з HelpCrunch?
2. Як підключити акаунт HelpCrunch до ApiX-Drive?
3. Як налаштувати  у вибраній дії оновлення контактів у HelpCrunch?
4. Приклад даних, які будуть оновлені у HelpCrunch.

Налаштування блоку Логіка Якщо / Тоді - HelpCrunch для створення контактів:
1. Яку логічну дію виконуватиме блок Логіка?
2. Як налаштувати певну умову для обраної дії?
3. Як додати Приймач даних всередині блоку Логіка?
4. Що робитиме інтеграція з HelpCrunch?
5. Як підключити аккаут HelpCrunch у блоці Логіка?
6. Як налаштувати у вибраній дії передачу даних у HelpCrunch?
7. Приклад даних, які будуть надіслані у ваш HelpCrunch.
8. Автооновлення та інтервал спрацьовування з'єднання.

Відповіді на питання, що часто ставляться:
1. Як налаштувати Логіку виходячи з результату передачі даних системи Приймач даних, якщо умова результату виконання Успішно чи Неуспішно?
2. Яким буде підсумковий результат за заданою умовою?

Налаштування додаткового блоку Логіка Якщо/Тоді - Телеграм:
1. Яку логічну дію виконуватиме додатковий блок Логіка?
2. Як налаштувати певну умову для обраної дії?
3. Як додати Приймач даних всередині блоку Логіка?
4. Що робитиме інтеграція з Телеграм?
5. Як підключити аккаут Телеграм у блоці Логіка?
6. Як налаштувати у вибраній дії передачу даних у Телеграм?
7. Приклад даних, які будуть надіслані до вашого Телеграму.

Налаштування ДЖЕРЕЛА Даних: Google Sheets

Для початку необхідно створити нове з'єднання, клацніть "Створити з'єднання".

Виберіть систему як Джерело даних. У цьому випадку необхідно вказати Google Sheets.

Далі, необхідно вказати дію "Завантажити РЯДКИ (нові)".

Наступний крок - вибір акаунту Google Sheets, з якого відбуватиметься вивантаження даних.
Якщо немає підключених акаунтів до системи, клацніть "Підключити акаунт".

Виберіть який акаунт ви хочете підключити до ApiX-Drive.

Дайте дозвіл ApiX-Drive на роботу з цим акаунтом.

Натисніть Вибрати таблицю та виберіть таблицю, з якої хочете отримувати дані, натисніть Select після вибору.

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

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

Далі вкажіть аркуш Google Sheets, де розташовані необхідні дані у вибраній таблиці.

Якщо потрібно, ви можете налаштувати Фільтр даних, або клацнути "Продовжити", щоб пропустити цей крок.

Щоб дізнатися, як налаштовується Фільтр даних, перейдіть за посиланням: https://apix-drive.com/ua/help/filtr-danyh

Дані в таблиці Google Sheets по одному з рядків.

Тепер ви можете побачити тестові дані в ApiX-Drive по одному з рядків у таблиці Google Sheets.

Якщо ви хочете оновити тестові дані, натисніть "Завантажити тестові дані з Google Sheets".

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

На цьому налаштування Джерела даних завершено!

Тепер підключаємо блок Приймач даних. Для цього клацаємо на "+" і зі списку вибираємо "ПРИЙМАЧ ДАНИХ".

Налаштування Приймача Даних: HelpCrunch оновлення контактів

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

Далі необхідно вказати дію "Оновити КОНТАКТ".

Наступний крок - вибір акаунту HelpCrunch, в якому будуть оновлюватися контакти.

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

У вікні необхідно вказати ваш Ключ API з HelpCrunch.

Після цього відбудеться перезавантаження сторінки і збережений акаунт автоматично буде обраний.

Ключ API знаходиться в "Settings - Developers - Public API" у вашому акаунті HelpCrunch. Скопіюйте ключ API і вставте його у відповідне поле в кабінеті ApiX-Drive.

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

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

Далі необхідно вибрати параметр за яким буде відбуватися пошук існуючого контакту HelpCrunch для оновлення, в даному прикладі ми використовуємо Email. Якщо знайдено збіг, то оновлення контакту відбудеться.

У полі "Що шукати" необхідно вказати змінну з Джерела даних, в якій знаходяться дані для пошуку, тобто змінну, з якою порівнюватиметься поле в Приймачі даних. Якщо знайдено збіг, то оновлення контакту відбудеться.

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

Для оновлення даних контакту необхідно призначити змінні, які знаходяться в клітинах Google Sheets з полями HelpCrunch, для цього натисніть на параметр і він буде призначений вибраному полю HelpCrunch. При виборі змінних ви зможете побачити, які дані є в полях Google Sheets.

Зверніть увагу, що ви можете використовувати не тільки змінні Google Sheets, але й прописані дані вручну.

Увага! Поле "Локаль користувача" слід передавати як рядок відповідно до стандарту ISO 639-1

Клацніть "Продовжити", коли закінчите роботу з призначенням полів.

Тепер ви можете побачити тестові дані, які будуть надіслані до HelpCrunch для оновлення зазначеного контакту.

Клацніть "Надіслати тестові дані в HelpCrunch" і перевірте чи оновилися дані контакту.

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

Зверніть увагу! У системах Приймача даних додано два додаткові поля: "Помилки виконання" та "Результат виконання", які можна використовувати в блоці Логіка для умов. У прикладі ми будемо використовувати ці поля.

1. Помилки виконання - при призначенні даного поля, поле міститиме інформацію про помилку, якщо вона виникне в системі Приймача даних. Якщо помилки не буде і передача даних буде успішною, то це поле залишиться порожнім.
2. Результат виконання - при виконанні умов дане поле повертатиме логічне значення, 1 або 0, де:
   1 - означає, що передача даних у блоці Приймач даних була успішною (наприклад: успішно додали новий рядок у Google Sheets, створили або оновили лід/контакт/угоду в СРМ системі або відправили повідомлення в Телеграм)
   0 - означає, що передача даних у блоці Приймач даних не виконалася, тобто була неуспішною (наприклад: виникла помилка, не знайшли контакт для оновлення, не був створений лід/угода/контакт у СРМ системі, не відправили повідомлення/лист)
   

На цьому налаштування Приймача даних HelpCrunch для оновлення контакту завершено!

Тепер підключаємо блок Логіка. Для цього клацаємо на "+" і зі списку вибираємо "ЛОГІКА ЯКЩО/ТОДІ".

Налаштування блоку ЛОГІКА ЯКЩО/ТОДІ

У полі "Логічна дія" вибираємо дію "Якщо".
У полі "Ваш коментар" ви можете вказати додаткову інформацію або пояснення до конкретної умови для дії Якщо.

Далі необхідно зробити налаштування на конкретну умову, при виконанні якої відбуватиметься передача даних у блоці Логіка.
- Параметр - у цьому полі містяться всі поля з попередніх блоків Джерело та Приймач даних, які можна використовувати для налаштування умов. У нашому прикладі ми використовуємо поле з Приймача даних "Результат виконання".
- Операція – у цьому полі необхідно вибрати дію, яка буде застосовуватись для конкретної умови. У цьому прикладі ми вибираємо "Дорівнює".
- Значення - у цьому полі необхідно вибрати "Успішно" якщо хочете, щоб умова виконувалася при успішному спрацюванні блоку Приймача даних, або виберіть "Неуспішно" якщо у блоці Приймач даних виникне помилка або з іншої причини дані не передадуть. В даному випадку ми обираємо "Неуспішно".

Також, ви можете додати додаткові умови за допомогою операторів "ТА", "АБО", якщо вам необхідно вказати кілька параметрів в одній умові. В даному випадку в цьому немає необхідності, тому клацаємо "Продовжити".

На етапі Тест ви побачите Логічний результат = 1 - це означає, що налаштування дії Якщо на конкретну умову виконано.

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

У цьому прикладі ми використовуємо блок ПРИЙМАЧ ДАНИХ.

Усередині блоку Логіка підключаємо систему Приймача даних. Для цього клацаємо на "+" і зі списку вибираємо "ПРИЙМАЧ ДАНИХ".

Налаштування ПРИЙМАЧА Даних усередині блоку ЛОГІКА ЯКЩО/ТОДІ: HelpCrunch створення контактів

Виберіть систему як Приймач даних. У цьому прикладі ми використовуємо HelpCrunch.

Далі необхідно вказати дію "Створити КОНТАКТ".

Наступний крок - вибір акаунту HelpCrunch, у якому відбуватиметься передача даних для створення контактів при неуспішному оновленні контакту.

Виберіть зі списку "активні акаунти" той же акаунт HelpCrunch, який був підключений до першого блоку Приймач даних для оновлення контактів.

Далі виберіть потрібні дані, які знаходяться в клітинах Google Sheets, клацніть за параметром і він буде призначений вибраному полю HelpCrunch для створення контакту. При виборі змінних ви зможете побачити, які дані є в полях Google Sheets.

Зверніть увагу, що ви можете використовувати не тільки змінні Google Sheets, але й прописані дані вручну.

Клацніть "Змінити та продовжити", коли закінчите роботу з призначенням полів.

Тепер ви бачите тестові дані, які будуть відправлені в HelpCrunch для створення нового контакту.

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

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

На цьому налаштування Приймача даних HelpCrunch створення контактів завершено!

В результаті ми маємо таку умову: При отриманні даних із системи Джерела даних ми передаємо дані в HelpCrunch для оновлення контакту, Якщо контакт не оновлений, тобто, виникла помилка або з іншої причини оновлення не вдалося, то передаємо дані в HelpCrunch для створення контакту.

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

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

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

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

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

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

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

На цьому налаштування HelpCrunch Оновити КОНТАКТ / Створити КОНТАКТ завершено! Бачите, як все просто!?

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

Зверніть увагу! Це не весь функціонал Логіки Якщо/Тоді. Ви можете використовувати параметр "Результат виконання" з блоку Логіка Якщо/Тоді для надсилання додаткового повідомлення в Телеграм або в поштовий сервіс, наприклад, у Gmail і бути в курсі помилок, які виникають в системі Приймача даних, якщо в ній не створилася сутність.

Налаштування додаткового блоку ЛОГІКА ЯКЩО/ТОДІ

Для цього у з'єднанні необхідно додати ще один блок Логіка та зробити ще одне налаштування умови. Для цього клацаємо на "+" та зі списку вибираємо "ЛОГІКА".

Також для додавання та налаштування нових блоків необхідно вимкнути автооновлення з'єднання, повзунок повинен бути в сірому положенні.

У полі "Логічна дія" вибираємо дію "Якщо".
У полі "Ваш коментар" ви можете вказати додаткову інформацію або пояснення до конкретної умови для дії Якщо.

Далі необхідно зробити налаштування на конкретну умову, при виконанні якої відбуватиметься передача даних у блоці Логіка.
- Параметр - у цьому полі містяться всі поля з попередніх блоків Джерело та Приймач даних, які можна використовувати для налаштування умов. У прикладі ми використовуємо поле з блоку Приймача даних HelpCrunch створення контактів - " Результат виконання " .
- Операція – у цьому полі необхідно вибрати дію, яка буде застосовуватись для конкретної умови. У цьому прикладі ми вибираємо "Дорівнює".
- Значення - у цьому полі необхідно вибрати "Успішно" якщо хочете, щоб умова виконувалася при успішному спрацюванні блоку Приймача даних, або виберіть "Неуспішно" якщо у блоці Приймач даних виникне помилка або з іншої причини дані не передадуть. В даному випадку ми обираємо "Неуспішно".

Також, ви можете додати додаткові умови, використовуючи оператори "ТА", "АБО". В даному випадку в цьому немає небхідності, тому клацаємо "Продовжити".

На етапі Тест ви побачите Логічний результат = 1 - це означає, що налаштування дії Якщо на конкретну умову виконано.

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

У цьому прикладі ми використовуємо блок ПРИЙМАЧ ДАНИХ.

Усередині блоку Логіка підключаємо систему Приймача даних. Для цього клацаємо на "+" і зі списку вибираємо "ПРИЙМАЧ ДАНИХ".

Налаштування ПРИЙМАЧА Даних усередині додаткового блоку ЛОГІКА ЯКЩО/ТОДІ: Телеграм

Виберіть систему як Приймач даних. У цьому прикладі ми обираємо Телеграм.

Далі необхідно вказати дію "Відправити повідомлення".
Ви зможете додати наш бот і отримувати від нього сповіщення про важливі події з інших систем у своєму Телеграмі або групі.

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

У вікні вкажіть назву акаунту і клацніть "Продовжити".

Далі відкриється нове вікно, в якому потрібно скопіювати дані в поле "Рядок для підключення Телеграм-бота".
Після чого натисніть на кнопку ApiX-Drive |Notifications| і натисніть Відкрити Телеграм, таким чином у вас автоматично відкриється програма Телеграм або ви можете не використовувати кнопку, а просто вручну перейдіть до програми Телеграм.

У програмі Телеграм у рядку пошуку введіть @apix_drive_bot .
Натисніть на профіль бота і натисніть "Розпочати". Якщо ви раніше цього бота підключали, то у вас буде кнопка "Перезапустити", натисніть її.

Надішліть повідомлення боту з рядком підключення, яке було скопійовано в системі ApiX-Drive.
Дочекайтеся повідомлення про успішне підключення до системи.
Після цього поверніться до системи ApiX-Drive та продовжіть налаштування.

Закрийте вікно підключення та виберіть підключений акаунт Телеграм, потім клацніть "Продовжити".

Тепер вам необхідно скласти повідомлення з даних, які будуть відправлятися в Телеграм-бот.
Для того, щоб додати змінну, клацніть у полі "Повідомлення" і виберіть потрібну змінну зі списку, що випадає. При необхідності, ви можете написати дані вручну в рядок або побудувати повідомлення для зручності в стовпчик (для переходу на наступний рядок потрібно використовувати кнопку "Enter"), як показано в прикладі.

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

Щоб отримати посилання на з'єднання, увійдіть у з'єднання і скопіюйте частину посилання на з'єднання з адресного рядка, як показано на скріншоті:

Коли повідомлення буде сформовано, натисніть "Змінити та продовжити".

Тепер ви бачите тестові дані як виглядатиме ваше повідомлення.
Клацніть "Надіслати тестові дані до Телеграм" і перевірте повідомлення у Телеграм-боті.
Якщо вас все влаштовує - натисніть "Продовжити" і знову увімкніть автооновлення з'єднання.

На цьому налаштування Приймача даних Телеграм завершено!

В результаті ми маємо таку умову: При отриманні даних із системи Джерела даних ми передаємо дані в HelpCrunch для оновлення контакту, Якщо контакт не оновлений, тобто виникла помилка або з іншої причини оновлення не вдалося, то передаємо дані в HelpCrunch для створення контакту . Якщо контакт не буде створений в HelpCrunch через виникнення помилки або з іншої причини не вдасться створити контакт , то відправляємо повідомлення в підключений бот Телеграм з даними з Джерела даних, а також з інформацією про помилку в Приймачі даних HelpCrunch створення контактів з поточного з'єднання.