Все материалы
Перед первой интеграциейИмпорт CSV без потерьСобытия, повторы и дубликатыКак понять, что интеграция работаетРазбор ошибок по шагамКороткий словарь интеграцийПеред первой интеграцией
Что согласовать до того, как соединять две системы.
Сначала опишите результат
Начните с одного законченного сценария: например, новая заявка из формы должна появиться в CRM с источником и ответственным. Запишите, кто проверяет результат и что считается успешной доставкой. Это поможет отделить обязательные поля от того, что можно добавить позже.
Одна интеграция — один понятный результат. Большой процесс удобнее разбить на небольшие проверяемые шаги.
Определите источник данных
Для каждого поля выберите систему, в которой хранится исходное значение. Если телефон редактируется и в форме, и в CRM, заранее договоритесь, какое изменение имеет приоритет. Без этого двусторонняя синхронизация может перезаписывать свежие данные.
- Выберите постоянный идентификатор записи.
- Согласуйте формат дат, часовой пояс и обязательные поля.
- Опишите поведение при удалении и объединении записей.
Составьте карту полей
Сохраните соответствие полей рядом с описанием процесса. Укажите преобразования: очистку пробелов, нормализацию телефона, значения по умолчанию. Не подставляйте выдуманные данные вместо отсутствующих обязательных значений.
| Исходное поле | Назначение | Проверка |
|---|---|---|
| external_id | Внешний идентификатор | Уникален, не пустой |
| Контакт | Пробелы по краям удалены | |
| created_at | Дата создания | Указан часовой пояс |
Пройдите небольшой сценарий
Проверьте одну корректную запись, одну неполную и одну повторную. Затем временно сделайте принимающую систему недоступной и посмотрите, что происходит с очередью. Успех — это не только первая доставленная заявка, но и понятное восстановление после ошибки.