Кастомные поля Pipedrive
В этой статье описана работа с кастомными полями Pipedrive в LightLead.
Обнаружение кастомных полей
Кастомные поля загружаются из /api/v1/dealFields, /api/v1/personFields, /api/v1/organizationFields. Pipedrive поддерживает три отдельных эндпоинта кастомных полей: /api/v1/dealFields (для сделок), /api/v1/personFields (для контактов), /api/v1/organizationFields (для компаний). Всего 17 базовых полей сделки. При переименовании кастомного поля ключ не меняется.
Сопоставление полей
LightLead использует идентификатор поля (field_id или field_code) для сопоставления. Это обеспечивает:
Устойчивость к переименованию: при изменении названия поля в CRM сопоставление сохраняется
Уникальность: каждое поле идентифицируется однозначно
Кросс-аккаунтность: поля из разных аккаунтов не пересекаются
Типы кастомных полей
| Тип поля | Поддержка | Использование |
|---|---|---|
| Текст (text) | Полная | Группировка, фильтрация |
| Число (number) | Полная | Метрики, фильтрация по диапазону |
| Дата (date) | Полная | Фильтрация по периоду |
| Список (select) | Полная | Группировка, фильтрация |
| Множественный выбор (multi-select) | Частичная | Фильтрация по вхождению |
| Флажок (checkbox) | Полная | Фильтрация (да/нет) |
| Телефон (phone) | Полная | Группировка, фильтрация |
| Email (email) | Полная | Группировка, фильтрация |
| Файл (file) | Не поддерживается | — |
| Изображение (image) | Не поддерживается | — |
Влияние на сохранённые отчёты
Важные аспекты при изменении кастомных полей:
Переименование поля: отчёты продолжают работать, название обновляется автоматически
Изменение типа поля: может привести к ошибкам в отчётах, использующих это поле как метрику
Удаление поля: отчёты с этим полем будут показывать ошибку, поле помечается как недоступное
Добавление поля: новое поле становится доступно после повторного обнаружения
Рекомендации
Планируйте структуру кастомных полей заранее
Не меняйте тип существующего поля без необходимости
При удалении поля предварительно проверьте, какие отчёты его используют
Используйте осмысленные названия полей для удобства поиска в интерфейсе