Інтеграції

Робота з вебхуками: створення та налаштування

Вебхуки (Webhooks) - це інструмент для автоматичної передачі даних з вашого робочого простору до зовнішніх систем (наприклад, у вашу CRM, Slack, або до сервісів-оркестраторів, як Make чи Zapier) у режимі реального часу, коли відбувається певна подія. Як створити Webhook Щоб додати нову інтеграцію, перейдіть у загальні налаштування системи (іконка шестірні на лівій бічній панелі) та відкрийте розділ Webhooks. 1. Натисніть кнопку Create webhook у правому верхньому куті екрана. 2. У модальному вікні заповніть необхідні поля: - Name: Введіть зрозумілу для вас назву для вебхука. - Event: Оберіть зі списку подію-тригер, яка буде запускати передачу даних (детальний перелік див. нижче). - Target URL: Вставте посилання на приймаючу сторону (URL вашого застосунку або згенерований лінк від Make/Zapier/etc). 3. Filters criteria (Опціонально): Ви можете додати правила фільтрації (Add rule / Add group). Якщо налаштувати фільтри, вебхук буде спрацьовувати не для всіх контактів, а лише для тих, які відповідають заданим критеріям. 4. Натисніть Create, щоб зберегти налаштування. Список доступних тригерів (Events) Під час створення вебхука ви можете обрати одну з багатьох системних подій, на які він буде реагувати. Їх можна умовно поділити на кілька категорій: - Дії контактів: Contact Enriched (контакт збагачено даними), Contact Accepted LinkedIn Connection Request (прийнято запит у друзі), Contact Replied (відповідь у LinkedIn, Email або InMail). - Дії відправника (Sender Profile): Успішна відправка запиту в контакти (Sent LinkedIn Connection Request) або повідомлення через будь-який канал (Sent LinkedIn Message, Email, InMail). - Системні сповіщення: Sender Profile Run Issue (виникнення помилки в роботі профілю). - Custom Call: Contact Export та Account Export. 🟡 Примітка: На відміну від стандартних тригерів, події Custom Call використовуються для налаштування спеціальних вузлів Webhook Call всередині ваших автоматизацій (Детальніше про логіку їхньої роботи читайте у статті [Налаштування Webhook Call]), а також для масового вивантаження контактів за запитом із розділу CRM - Contacts (кнопка Export - Webhook). Управління вебхуками На головній сторінці розділу відображається таблиця з усіма створеними вами вебхуками. Для швидкої навігації над списком передбачено панель пошуку: ви можете знайти потрібний вебхук за його назвою - поле Search by name (1). Або відфільтрувати загальний список за конкретним тригером - випадаючий список Select event (2). У правому кінці кожного рядка знаходиться меню дій - іконка з трьома крапками (3). Воно дозволяє: - Test: Надіслати тестовий запит, щоб перевірити, чи коректно приймаюча сторона отримує ваші дані. - Edit: Відкрити модальне вікно для редагування налаштувань вебхука. - Delete: Назавжди видалити вебхук із системи. Кожен рядок у таблиці містить вичерпну інформацію про вебхук, розподілену за такими колонками: - Status: Тогл для швидкого ввімкнення або вимкнення роботи вебхука без необхідності його видаляти. - Name: Задана вами назва вебхука. - Event: Подія-тригер, яка активує даний вебхук. - URL: Посилання на приймаючу сторону (Target URL), куди відправляються дані. - Filters: Показує, чи застосовані до цього вебхука правила фільтрації контактів. - Requests: Загальна статистика спрацьовувань. Тут відображається кількість як успішних, так і неуспішних (failed) запитів. - Last Triggered: Дата та час останнього спрацьовування вебхука. Історія та логування (History) Поруч із головною вкладкою знаходиться вкладка History. Це журнал системних подій, який фіксує абсолютно всі спрацьовування ваших вебхуків. Тут ви можете перевірити статус кожного запиту, побачити назву вебхука, подію, а також переглянути детальний лог (View log), щоб розібратися в причинах помилки, якщо дані не були доставлені. Списки в історії можна фільтрувати за назвою вебхука, статусами або діапазоном дат.

Початок роботи з Grinfi API

Публічний API Grinfi дозволяє безшовно під'єднати платформу до ваших власних інструментів: CRM-систем, внутрішніх дашбордів, no-code платформ (на кшталт Make чи Zapier) або кастомних скриптів. Майже все, що ви робите у вебзастосунку Grinfi, доступне і через API: керування контактами, запуск автоматизацій, надсилання повідомлень у LinkedIn та Email, а також налаштування вебхуків для відстеження подій у реальному часі. У цій статті ми розглянемо базові кроки: як створити свій перший API-ключ, зробити тестовий запит та які можливості загалом відкриває наш API. Крок 1. Створення API-ключа Для початку роботи вам знадобиться унікальний ключ доступу: 1. Увійдіть у свій акаунт Grinfi за адресою leadgen.grinfi.io. 2. Відкрийте загальні налаштування та перейдіть до розділу Settings -> API Keys. 3. Скопіюйте вже існуючий ключ або натисніть кнопку для створення нового. 🟡 Важливі нюанси безпеки та доступу: - Кожен API-ключ жорстко прив'язаний до тієї команди (робочого простору), яка була активною на момент його створення. Усі запити з цим ключем матимуть доступ до контактів, автоматизацій та повідомлень виключно цієї команди. - Тримайте ваш API-ключ у секреті. Будь-хто, хто має до нього доступ, отримує контроль над даними вашого акаунта. Якщо ключ випадково скомпрометовано - негайно видаліть його та згенеруйте новий. Крок 2. Створення запиту Базова адреса для всіх API-запитів: https://leadgen.grinfi.io. Кожен ваш запит обов'язково має містити ключ у заголовку авторизації: Authorization: Bearer ВАШ_API_КЛЮЧ. Для швидкої перевірки роботи API спробуйте виконати пошук контактів у вашому акаунті за допомогою цього cURL-запиту: curl -X POST "https://leadgen.grinfi.io/leads/api/leads/search" \ -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \ -H "Content-Type: application/json" \ -d '{"filter": {}, "limit": 5, "offset":0}' Якщо все налаштовано правильно, у відповідь ви отримаєте JSON із першими п'ятьма контактами з вашої CRM. 💡 Дві речі, які варто запам'ятати при роботі з запитами: - Завжди надсилайте заголовок Content-Type: application/json. Запити у форматі form-encoded не пройдуть валідацію системою. - Великі списки даних віддаються посторінково за допомогою параметрів limit та offset. У відповіді сервера завжди є поля total і has_more, щоб ви точно знали, коли зупинити парсинг сторінок. Що вміє API Grinfi Наш API логічно поділений на чотири основні розділи: | Розділ | Що охоплює | | ---------------- | ----------------------------------------------------------------------------- | | CRM | Контакти, компанії, списки, теги, pipeline-етапи, кастомні змінні та нотатки. | | Outreach | Автоматизації, задачі та профілі відправників (Sender Profiles). | | Повідомлення | Повідомлення LinkedIn, Email, поштові скриньки та вкладення. | | Інтеграції | Налаштування вебхуків для отримання сповіщень про події в реальному часі. | Найпопулярніші сценарії використання API: - Синхронізація з вашою CRM: Створюйте або оновлюйте контакти разом із кастомними полями за допомогою одного виклику POST /leads/api/leads/upsert. - Додавання контактів в автоматизації: Програмно додавайте контакти у запущену послідовність (наприклад, одразу після заповнення лід-форми на вашому сайті). - Пряме надсилання повідомлень: Надсилайте повідомлення в LinkedIn або на Email конкретному контакту безпосередньо з вашого власного воркфлоу. - Реакція на події в реальному часі: Налаштуйте вебхук і отримуйте HTTP-виклик щоразу, коли контакт відповів, змінив статус або був збагачений новими даними. - Масовий імпорт та експорт: Завантажуйте CSV-файли для масового імпорту бази або ставте в чергу вивантаження контактів і компаній. Поширені питання (FAQ) Отримую помилку 401 або 403. Що робити? Це означає, що ключ відсутній у запиті, є недійсним або його термін дії закінчився. Перевірте, чи коректно передається заголовок Authorization: Bearer, і за потреби згенеруйте новий ключ у розділі API Keys. Чи є ліміти на кількість запитів (Rate Limits)? Так, тому ми рекомендуємо використовувати пагінацію та налаштовувати розумну частоту запитів. Для масових операцій з даними набагато ефективніше використовувати спеціальні ендпоінти mass-action та інструменти CSV-імпорту/експорту замість циклу з десятків окремих дрібних викликів. Повна документація Ця стаття - лише базовий огляд можливостей. Повний технічний довідник API, який містить усі ендпоінти, детальні схеми запитів та приклади відповідей сервера, доступний за посиланням: [Grinfi API Documentation].

Підключення Grinfi до Claude через MCP-сервер

Grinfi MCP Server створює прямий міст між вашим акаунтом Grinfi та AI-асистентом Claude від Anthropic. Це унікальна можливість керувати всіма процесами аутрічу за допомогою звичайної мови. Замість того, щоб шукати потрібні розділи та клікати по інтерфейсу платформи, ви можете просто написати в чат запит: «Покажи контакти з непрочитаними повідомленнями і підготуй чернетку відповіді для кожного». Claude безпечно підключиться до вашого робочого простору за протоколом MCP (Model Context Protocol), знайде необхідні дані та виконає дію. Що можна робити за допомогою інтеграції Після підключення Claude зможе взаємодіяти майже з усіма елементами вашого робочого простору в Grinfi: - Контакти та CRM: Здійснюйте пошук, створення та оновлення контактів. Ви можете легко керувати лістами, призначати теги та переміщувати контакти між етапами пайплайну. - Автоматизації: Переглядайте статистику, запускайте або зупиняйте автоматизації. Додавайте або видаляйте контакти з автоматизацій прямо у чаті з Claude. - Інбокс (Unibox): Читайте листування в LinkedIn та Email, шукайте непрочитані відповіді та миттєво надсилайте повідомлення. - Аналітика та здоров'я акаунтів: Отримуйте швидкий огляд робочого простору одним запитанням. Дізнавайтеся про активність за сьогодні, перевіряйте стан підключених LinkedIn-акаунтів та поштових скриньок, а також контролюйте активні автоматизації. - Діагностика: Аналізуйте причини невдалих задач, виконуйте масовий повтор (retry) або пропуск (skip) дій. - Імпорт та експорт: Завантажуйте CSV-файли, імпортуйте контакти або ставте вивантаження бази в чергу. Як підключити Claude до Grinfi Доступно два способи налаштування інтеграції, вибір яких залежить від вашого тарифу в Claude. Спосіб 1. Хмарне підключення (Рекомендований) Якщо ви використовуєте платний тариф Claude (Pro, Team або Enterprise), вам не потрібно нічого встановлювати на локальний пристрій: 1. Відкрийте сторінку mcp.grinfi.io 2. Зареєструйтеся та дотримуйтесь інструкцій на екрані, щоб додати Grinfi як конектор у вашому акаунті Claude. 3. Інструменти Grinfi з'являться у вашому чаті, і всі запити будуть безпечно прив'язані до вашого особистого акаунта. Спосіб 2. Локальне встановлення (Claude Desktop) Якщо ваш тариф не підтримує хмарні конектори і ви бажаєте запустити сервер на власному комп'ютері: 1. Скопіюйте ваш API-ключ на платформі Grinfi (розділ Settings -> API Keys). 2. Завантажте файли сервера з репозиторію (натисніть зелену кнопку Code -> Download ZIP). 3. Двічі клацніть по інсталятору для вашої операційної системи (install.sh на Mac або install.bat на Windows). 4. Коли інсталятор попросить, вставте ваш скопійований API-ключ. (Зверніть увагу: інсталятор самостійно завантажить та встановить середовище Node.js, якщо його немає на вашому пристрої). 5. Повністю закрийте та відкрийте заново застосунок Claude Desktop. У списку інструментів з'явиться grinfi. Популярні сценарії використання Ось кілька прикладів того, як ви можете ставити задачі штучному інтелекту: 💡 Ранковий розбір інбоксу «Перевір мої непрочитані діалоги і підсумуй, хто відповів. Підготуй фолоу-ап для всіх, хто виявив інтерес.» 💡 Керування кампаніями «Покажи мої автоматизації. Постав на паузу ті, де reply rate нижче 2%, і виведи їхню статистику.» 💡 Швидка робота з CRM *«Знайди контакт з email *john@example.com, додай тег 'warm lead' і перемісти на етап Engaging.» 💡 Перевірка здоров'я системи «Зроби health check мого робочого простору - чи все гаразд із LinkedIn-акаунтами та скриньками? Чи є невдалі задачі, на які варто звернути увагу?» 💡 Масові виправлення помилок «Покажи, чому падали задачі цього тижня, і перезапусти все, що впало через помилку проксі.» Поширені питання (FAQ) Це безпечно? Абсолютно. З'єднання використовує ваш особистий API-ключ Grinfi (для локального варіанта) або безпечний персональний вхід (для хмарного). Claude має доступ до даних виключно вашої команди. Ви можете відкликати доступ у будь-який момент, просто видаливши ключ або конектор. Чи надсилає Claude повідомлення автоматично без мого відома? Ні, Claude виконує дії лише за вашими прямими інструкціями в чаті. Перед виконанням будь-якої дії, що передбачає надсилання реального повідомлення контакту, ШІ завжди покаже чернетку та попросить вашого підтвердження. Який спосіб підключення мені обрати? Ми радимо використовувати хмарне підключення через mcp.grinfi.io. Цей спосіб працює як у вебверсії Claude, так і в десктопному застосунку, не вимагає встановлення додаткових файлів на пристрій та оновлюється автоматично. Локальне встановлення варто використовувати лише тоді, коли ваш поточний тариф Claude не підтримує роботу з конекторами.