За допомогою дії API виклику ви зможете інтегрувати NetHunt практично з будь-яким програмним забезпеченням. Щоб здійснити API виклик, вам потрібно буде використовувати Автоматизацію у NetHunt CRM.
Уявімо, що нам потрібно передати контактні дані до Telegram боту щоразу, коли нам потрібно сповістити нашу команду.
Для цього:
До необхідної вам папки додайте поле типу чекбокс, або етап на який потрапляє ваш клієнт яке буде використовуватися в якості тригеру автоматизації та здійснення API виклику:
Далі оберіть дію "Зробити виклик API":
У вас буде доступний такий перелік типу запиту:
Ми будемо використовувати саме POST, бо ми будемо передавати значення.
Додайте деталі API виклику, де:
Виберіть тип запиту - POST
URL - це вебхук, взятий із програмного забезпечення, до якого ви хочете надіслати інформацію
JSON - дані для надсилання за допомогою формату даних JavaScript Object Notation
Макроси - значення полів, які ви вибираєте з NetHunt для спільного використання з іншим програмним забезпеченням
Отже, у нашому випадку, як тільки клієнт потрапляє на етап потенційний спрацьовує тригер і «API виклик» надсилає інформацію вам на особистий Telegram :
Скористайтеся цим посібником, якщо ви також хочете дізнатися, як створити бота Telegram і надсилати повідомлення на свій канал Telegram за допомогою NetHunt.
Продовжити крок API виклику при помилці
Коли ви виконуєте API виклик, то сервіс до якого ви звертаєтесь надає відповідь і повертає статус запиту. Ви можете використовувати ці відповіді, щоб створити задачу на себе, або на відповідального за автоматизацію. Перевірити чому саме виникла ця проблема і швидко її виправити.
Проставте чекбокс у вашому API виклику "Продовжити у разі невдалого виклику API":
Переглянемо коди відповіді сервера:
1xx - Інформаційні (Інформація про процес)
100 Continue: Початкова частина запиту отримана, можна продовжувати.
101 Switching Protocols: Сервер перемикається на інший протокол.
2xx - Успіх (Запит успішно оброблено)
200 OK: Запит виконано успішно.
201 Created: Запит виконано, створено новий ресурс.
202 Accepted: Запит прийнято, але обробка не завершена.
3xx - Перенаправлення
301 Moved Permanently: Сторінка переїхала на нову URL-адресу.
302 Found: Тимчасове перенаправлення.
304 Not Modified: Дані не змінювалися, використовуйте кеш.
4xx - Помилки клієнта
400 Bad Request: Синтаксична помилка в запиті.
401 Unauthorized: Потрібна авторизація.
403 Forbidden: Доступ до ресурсу заборонено.
404 Not Found: Сторінку не знайдено.
405 Method Not Allowed: Недозволений метод для запиту.
429 Too Many Requests: Перевищено ліміт запитів.
5xx - Помилки сервера
500 Internal Server Error: Загальна помилка сервера.
502 Bad Gateway: Сервер отримав недійсну відповідь від іншого сервера.
503 Service Unavailable: Сервер перевантажений або на обслуговуванні.
504 Gateway Timeout: Сервер не дочекався відповіді.
Це дозволяє додати крок «Фільтр» після кроку виклику API «Створити» та запускати різні сценарії на основі коду відповіді. Наприклад, ви можете створити фільтр, який перевіряє, чи код відповіді дорівнює 200. Якщо виконання проходить фільтр, робочий процес продовжується як завжди. Якщо код відповіді інший, ви можете ініціювати гілку винятків — наприклад, створити завдання для менеджера робочого процесу та повідомити його про порушення у виконанні робочого процесу.
Додамо після API виклику фільтр і вказуємо код помилки які частіше можуть бути. Наразі для прикладу ми використаємо код помилки 400 Bad Request: Синтаксична помилка в запиті, можливо макрос буде мати некоректний формат і треба буде перевірити його в записі, можливо в поле телефон менеджер вказав Telegram.
І додаємо до Гілки "Так", оновити поле, або створити задачу на відповідального. У цьому випадку код відповіді буде доступним далі в робочому процесі, і його можна буде використовувати як макрос.
Загальний вид автоматизації:
Це додатковий інструмент для того, щоб контролювати виклики API в інший сервіс і не пропустити нічого важливого і вчасно це проконтролювати.
💡Зверніть увагу: Це один з прикладів такої автоматизації. Ви можете створити власні рішення та налаштувати інший подібний сценарій - ланцюжок для автоматизації.
Не знайшли відповідей, які шукали? Пишіть нам у чат підтримки прямо з CRM!
А також доєднуйтесь до спільноти однодумців в нашому телеграм каналі.