Головна Найкращі практики та Гайди Як експортувати контакти разом з історією переписки

Як експортувати контакти разом з історією переписки

Востаннє оновлено Aug 25, 2026

Вивантаження бази контактів разом із контекстом діалогів - важливий крок для передачі даних у вашу CRM-систему, підготовки розширених звітів, глибокого аналізу або просто для створення резервної копії вашої бази.

У цій статті ми розглянемо три способи експорту.

Спосіб 1. Вивантаження через Grinfi MCP + Claude

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

Завдяки MCP, Claude отримує безпечний доступ до вашого робочого простору. Він бачить контакти, теги, етапи пайплайну та повні треди переписок (LinkedIn та Email зведені в єдиний хронологічний потік, як у вашому інбоксі).

🟡 Примітка: Claude має обмеження на обробку великих масивів інформації, ми рекомендуємо використовувати цей спосіб для вивантаження баз розміром не більше ніж 1000 контактів. Якщо вам потрібно експортувати значно більший обсяг даних, краще скористатися вивантаженням через API.

Як налаштувати експорт:

  1. Відкрийте вебверсію claude.ai або десктопний застосунок Claude.

  2. Перейдіть до Settings -> Connectors.

  3. Натисніть Add Custom Connector та вставте адресу: https://mcp.grinfi.io

  4. Увійдіть за допомогою ваших облікових даних Grinfi.

Після підключення просто напишіть запит у чат, вказавши потрібні фільтри та формат файлу (Excel, CSV або Google Sheets).

Приклади запитів:

  • "Вивантаж усі контакти зі списку 'Enterprise Q2' разом з повною історією переписки. Формат: Excel, один рядок = один контакт, переписка - окремою колонкою в хронологічному порядку."

  • "Знайди всі контакти на стадії 'Interested', які відповідали за останні 30 днів. Збери файл: ім'я, компанія, посада, LinkedIn, email і повний тред переписки по кожному."

Головна перевага цього методу: Claude може не лише вивантажити файл, а й одразу проаналізувати його. Наприклад, розбити відповіді за категоріями або знайти спільні патерни в діалогах, які конвертують найкраще.

Спосіб 2. Запуск готового Python-скрипта локально

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

Як запустити скрипт

  1. Встановіть на свій комп'ютер Python 3, якщо він ще не встановлений.

  2. Завантажте архів зі скриптом за посиланням та розархівуйте його: export_contacts_script.zip

  3. Відкрийте консоль (Terminal для Mac/Linux або Command Prompt/PowerShell для Windows) та запустіть завантажений скрипт.

  4. Скрипт попросить ввести API-ключ (його можна згенерувати в кабінеті Grinfi у розділі Settings -> API Keys). Вставте його та натисніть Enter.

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

  5. Далі скрипт запитає, що саме вивантажувати:
    What do you want to export?

    1) All contacts

    2) Only contacts that have a conversation (people who replied) 

    Enter 1 or 2 (default 1):

    Введіть 1 (щоб вивантажити всі контакти) або 2 (щоб вивантажити тільки ті контакти, з якими є переписка) і натисніть Enter.

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

🔴 Важливо: API-ключ надає доступ до всіх даних вашого робочого простору. Ставтеся до нього так само як до пароля, не передавайте його третім особам і не пересилайте в незахищених чатах. Якщо ключ було скомпрометовано - негайно видаліть його в налаштуваннях воркспейсу та згенеруйте новий.

Результат роботи скрипта

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

  • export.json - містить детальний масив даних у форматі { contact, linkedin_messages[], emails[] }. Для кожного повідомлення буде вказано його тип (inbox - від контакту, outbox - відправлено вами), текст / тему (text / subject), час відправки (sent_at) та ідентифікатор діалогу.

  • contacts.csv - зведена таблиця, де один рядок дорівнює одному контакту. Містить базову інформацію: ім'я, компанію, посаду, посилання на LinkedIn, email, поточну стадію пайплайну та загальну кількість повідомлень (самі тексти повідомлень зберігаються у файлі export.json).

Спосіб 3. Власна логіка через API

Якщо вам потрібна кастомна інтеграція, найкращим рішенням буде написання власних запитів до відкритого API платформи.

Повна технічна документація з усіма доступними ендпоінтами знаходиться за адресою api.grinfi.io.

Покрокова логіка для вивантаження

  1. Отримання доступу: Створіть унікальний API-ключ у вашому робочому просторі (розділ Settings -> API Keys).

    🔴 Важливо: API-ключ надає доступ до всіх даних вашого робочого простору. Ставтеся до нього так само як до пароля, не передавайте його третім особам і не пересилайте в незахищених чатах. Якщо ключ було скомпрометовано - негайно видаліть його в налаштуваннях воркспейсу та згенеруйте новий.

  2. Збір бази контактів: Зробіть запит до ендпоінта пошуку лідів, щоб отримати список потрібних контактів. Обов'язково налаштуйте пагінацію (limit та offset), щоб коректно витягнути всі сторінки масиву даних.

  3. Вивантаження історії діалогів: Використовуючи ідентифікатори (ID) контактів, отримані на попередньому кроці, зробіть відповідні запити до ендпоінтів повідомлень. Це дозволить витягнути історію тредів з LinkedIn та Email для кожного ліда.

  4. Об'єднання та збереження: Зведіть отримані дані (інформацію про профіль контакту + масив його повідомлень) на своєму боці та конвертуйте у потрібний вам формат.