Импорт и экспорт контактов

Массовый импорт контактов

Импорт файлов CSV и Excel

Система обеспечивает комплексные возможности массового импорта контактов для эффективного управления контактами:

Поддерживаемые форматы файлов:

CSV файлы: Стандартный формат значений, разделенных запятыми
Excel файлы: Поддерживаются форматы .xls и .xlsx
Валидация файлов: Автоматическое обнаружение и валидация формата
Ограничения размера файлов: Разумные ограничения размера файлов для производительности

Обзор процесса импорта:

Загрузка файлов: Загрузка файлов контактов через интерфейс массовой загрузки
Парсинг заголовков: Автоматическое обнаружение и парсинг заголовков файлов
Сопоставление полей: Сопоставление колонок файла с полями базы данных контактов
Импорт данных: Пакетная обработка для эффективного создания контактов

Авторизация импорта:

Требуются разрешения на создание контактов для операций импорта
Контроль доступа на основе команды для функциональности импорта
Требуется аутентификация пользователя для всех операций импорта
Проверка авторизации перед обработкой файлов импорта

Рабочий процесс импорта

Процесс импорта контактов следует структурированному рабочему процессу:

Шаг 1: Загрузка и парсинг файлов

Загрузка CSV или Excel файлов через модальное окно массовой загрузки
Автоматическая валидация формата файла (только csv, xls, xlsx)
Извлечение заголовков и расчет количества строк
Парсинг файлов с обработкой ошибок для недопустимых форматов

Шаг 2: Конфигурация сопоставления полей

Отображение обнаруженных заголовков файлов для сопоставления
Доступные поля контактов представлены для выбора сопоставления
Валидация сопоставления для предотвращения дублирования назначений колонок
Опция сопоставить все заголовки или только обязательные колонки

Шаг 3: Обработка данных и импорт

Трансформация данных контактов с использованием объектов ContactDTO
Пакетная обработка для эффективных операций базы данных (100 контактов на пакет)
Резервное создание отдельных контактов для неудачных пакетных операций
Отслеживание успеха импорта с общим количеством импортированных контактов

Импорт Pipedrive (Лица и Организации)

Загрузите экспорт Pipedrive "Persons" (CSV/XLS/XLSX) из диалога Контакты → Массовая загрузка/Импорт под вкладкой "Pipedrive: Persons".

Что импортируется:

Контакты (из Persons): имя, email, телефон, название компании и базовые поля
Опциональная связь с существующим клиентом по названию компании

Поведение:

Идемпотентное сопоставление поддерживается внутренне; дубликаты не жестко блокируются для сохранения гибкости импорта
Сводка (создано/обновлено/пропущено) показывается после завершения

Для Клиентов (из Organizations), откройте Клиенты → Массовая загрузка/Импорт и используйте вкладку "Pipedrive: Organizations" для импорта данных организации/компании в Клиенты. Поддерживаемые форматы: CSV, XLS, XLSX.

Сопоставление полей импорта

Сопоставление колонок файлов с полями контактов

Система сопоставления полей обеспечивает гибкое назначение колонок к полям:

Конфигурация сопоставления:

Индекс колонки: Числовой индекс колонок в загруженном файле
Имя колонки: Оригинальное имя заголовка из загруженного файла
Сопоставленная колонка: Целевое поле контакта для назначения данных
Валидация сопоставления: Обязательная спецификация сопоставления для всех используемых колонок

Доступные поля контактов:

Все стандартные поля контактов доступны для сопоставления через ContactDTO
Личные поля: first_name, last_name, email, phone, birth_date
Бизнес-поля: company_name, website, description
Поля адреса: address_line_1, city, zip, country
Социальные поля: skype, telegram, linkedin
Системные поля: client_id, outreach_id, company_id

Правила валидации сопоставления:

Обязательные сопоставления: Каждое сопоставление должно указывать индекс и сопоставленную колонку
Предотвращение дублирования: Одно поле контакта не может быть сопоставлено с несколькими колонками
Валидация колонок: Сопоставленные колонки должны быть действительными полями контактов
Валидация индекса: Индексы колонок должны быть действительными целыми числами

Продвинутые функции сопоставления

Система сопоставления включает сложную валидацию и предотвращение ошибок:

Валидация сопоставления:

Обнаружение дублирования: Предотвращает сопоставление нескольких колонок файла с одним полем контакта
Полное сопоставление: Валидирует, что все обязательные сопоставления указаны
Согласованность колонок: Обеспечивает, что сопоставленные колонки существуют в списке полей контактов
Полнота сопоставления: Валидирует, что все заголовки файлов имеют назначения сопоставления

Предотвращение ошибок:

Фронтенд-валидация предотвращает недопустимые конфигурации сопоставления
Валидация в реальном времени во время настройки сопоставления
Четкие сообщения об ошибках для конфликтов сопоставления
Валидация сопоставления перед началом обработки импорта

Гибкие опции сопоставления:

Опциональное сопоставление полей позволяет частичный импорт данных
Пустое сопоставление колонок пропускает неиспользуемые колонки файлов
Гибкое сопоставление поддерживает различные структуры файлов
Интеграция пользовательских полей для расширенного сопоставления данных

Валидация импорта

Валидация данных и обработка ошибок

Система импорта включает комплексную валидацию и обработку ошибок:

Валидация файлов:

Валидация формата: Принимаются только CSV, XLS и XLSX файлы
Структура файла: Обнаружение и валидация строки заголовков
Целостность данных: Валидация данных построчно во время обработки
Восстановление ошибок: Изящная обработка ошибок парсинга файлов

Валидация данных во время импорта:

Валидация данных контактов: Каждый контакт валидируется против правил создания контактов
Проверка обязательных полей: Требование имени принудительно во время импорта
Валидация формата email: Email-адреса валидируются для правильного формата
Валидация длины полей: Ограничения длины полей принудительны во время импорта

Обработка ошибок пакетного импорта:

Пакетная обработка: 100 контактов обрабатывается за пакет для эффективности
Восстановление после сбоя пакета: Резервное создание отдельных контактов для неудачных пакетов
Отслеживание успеха: Поддерживается количество успешно импортированных контактов
Изоляция ошибок: Неудачные контакты не предотвращают успешный импорт контактов

Восстановление после ошибок импорта

Система обеспечивает надежные механизмы восстановления после ошибок:

Преимущества пакетной обработки:

Большие импорты обрабатываются управляемыми пакетами
Сбои пакетов не предотвращают успех других пакетов
Эффективность памяти для больших операций импорта контактов
Оптимизация производительности для массовых операций

Резервное создание отдельных контактов:

Неудачные пакетные операции резервируются на создание отдельных контактов
Ошибки отдельных контактов регистрируются, но не останавливают процесс импорта
Частичный успех импорта позволяет максимальное завершение импорта контактов
Подробное логирование ошибок для устранения неполадок с неудачными контактами

Отчетность об ошибках:

Неудачные контакты регистрируются с подробной информацией об ошибках
Предоставляется количество успеха импорта для проверки
Сообщения об ошибках возвращаются для обратной связи пользователя
Комплексное логирование для отладки проблем импорта

Экспорт контактов

Экспорт данных контактов для внешнего использования

Система контактов поддерживает экспорт данных для внешнего анализа и резервного копирования:

Интеграция экспорта:

Данные контактов доступны через API поиска и фильтрации
Экспорт в формате JSON для интеграции API
Результаты поиска контактов могут быть экспортированы программно
Фильтрация экспорта на основе команды для правильного контроля доступа

Структура данных экспорта:

Данные контактов экспортируются со всеми стандартными полями
Значения пользовательских полей включены в данные экспорта
Информация о связях с клиентами включена
Данные ассоциации воронки доступны в экспортах

Контроль доступа к экспорту:

Операции экспорта требуют соответствующих разрешений на контакты
Фильтрация на основе команды обеспечивает правильный доступ к данным
Фильтрация владения пользователем доступна для ограниченных экспортов
Проверка авторизации для всех операций экспорта

Функции и возможности экспорта

Экспорт контактов интегрируется с более широкой функциональностью системы:

Экспорт на основе поиска:

Экспорт отфильтрованных списков контактов на основе критериев поиска
Экспорт контактов для конкретной команды с правильным контролем доступа
Данные контактов включают отношения и ассоциации
Гибкий экспорт на основе разрешений и доступа пользователя

Интеграция API:

Данные контактов доступны через конечные точки API для внешней интеграции
Формат JSON для легкой интеграции с внешними системами
Функциональность поиска поддерживает программный доступ к контактам
Возможности экспорта данных контактов в реальном времени

Логирование импорта

Отслеживание и отладка операций импорта

Система импорта включает комплексное логирование для мониторинга и отладки:

Логирование процесса импорта:

Логирование парсера файлов: Выделенный канал логов file-parser для обработки файлов
Логирование импорта контактов: Выделенный канал логов contacts для операций импорта
Обработка строк: Обработка отдельных строк регистрируется для отладки
Логирование сопоставления: Конфигурация сопоставления полей регистрируется для проверки
Логирование импорта Pipedrive: Ключи строк, распарсенные значения и действия upsert регистрируются для устранения неполадок

Подробная информация логов:

Обработка файлов: Заголовки файлов, количество строк и результаты парсинга
Данные сопоставления: Полная конфигурация сопоставления и примененные сопоставления
Данные контактов: Трансформация и создание данных отдельных контактов
Пакетные операции: Результаты пакетной обработки и отслеживание успеха/неудачи

Логирование ошибок и отладка:

Ошибки парсинга файлов: Подробное логирование ошибок для сбоев обработки файлов
Неудачи импорта: Комплексное логирование ошибок для неудачного импорта контактов
Ошибки отдельных контактов: Конкретные сообщения об ошибках для неудачного создания контактов
Логирование трассировки стека: Полный контекст ошибок для отладки

Мониторинг и анализ импорта

Система логирования поддерживает мониторинг импорта и анализ производительности:

Мониторинг производительности:

Производительность пакетов: Мониторинг эффективности пакетной обработки
Коэффициенты успеха импорта: Отслеживание успешных против неудачных импортов
Время обработки: Метрики производительности для операций импорта
Паттерны ошибок: Анализ общих паттернов неудач импорта

Аналитика импорта:

Объем импорта: Отслеживание объемов импорта контактов во времени
Метрики успеха: Анализ коэффициентов успеха импорта и паттернов
Анализ ошибок: Идентификация общих проблем импорта
Оптимизация производительности: Данные для оптимизации процессов импорта

Поддержка устранения неполадок:

Подробный контекст ошибок: Полная информация об ошибках для решения проблем
Трассировка импорта: Полный аудит-трейл операций импорта
Логирование валидации данных: Отслеживание и анализ неудач валидации
Мониторинг здоровья системы: Отслеживание производительности и надежности системы импорта