Начните с данных
Запишите, что передаётся: контакт, заявка, заказ, товар, цена или остаток. Для каждого поля укажите источник. Например, каталог может поступать из CRM на сайт, а заявки — уходить с сайта в CRM. Двусторонний обмен сложнее одностороннего и требует отдельных правил.
Выберите систему под команду
На этапе обсуждения можно рассмотреть Bitrix24, amoCRM, Paloma 365, 1С или собственную систему. Это разные решения с разными возможностями. Доступность нужных методов API, тариф и права аккаунта нужно проверить до обещания конкретной функции.
Опишите работу менеджеров
Кто получает новое обращение? Что происходит, если сотрудник недоступен? Как избежать дублей? Нужна ли очередь? Ответы на эти вопросы важнее названия кнопки в интерфейсе. Если подключаются мессенджеры, отдельно проверьте ограничения каналов и используемого способа интеграции.
Заложите обработку ошибок
Внешняя система может временно не отвечать. В ТЗ стоит описать повторную отправку, журнал ошибок и уведомление ответственного. Секретные ключи не должны находиться в общедоступном коде страницы. Доступы передаются через согласованный защищённый канал.
Пример из практики
В проекте SALTASHOP каталог синхронизируется с Paloma 365. В Mamiyo Biomed административная система объединяет управление данными и сообщения из WhatsApp, Instagram и Telegram. Эти задачи отличаются по составу работ, поэтому цену интеграции определяем по конкретному сценарию.
Пример понятного задания на интеграцию
Вместо фразы «подключить CRM» опишите результат: после отправки формы создаётся обращение с именем, телефоном, выбранной услугой и источником. Ответственный назначается по согласованному правилу. Повторный контакт обрабатывается так, чтобы менеджер видел предыдущую историю. Затем отдельно решите, что происходит при ошибке передачи. Такой сценарий можно проверить на тестовых данных и использовать как критерий приёмки.
Список доступов, который экономит время
До начала работы уточните систему и тариф, контакт администратора, наличие тестового окружения и документации нужных методов. Для мессенджеров потребуются согласованные бизнес-аккаунты и поддерживаемые способы подключения. Секреты передают ответственному специалисту через отдельный защищённый канал. Не размещайте ключи API в переписке с большим числом участников, общедоступном макете или коде браузерной страницы.
Как проверить интеграцию до запуска
Отправьте тестовую заявку, найдите её в CRM и сравните поля. Повторите отправку с тем же телефоном, проверьте обязательные значения и назначение ответственного. Для каталога сопоставьте несколько товаров, измените данные в источнике и убедитесь, что нужное обновление произошло. Для каждого процесса нужен ожидаемый результат. Без него можно подтвердить технический обмен, но не понять, помогает ли он работе команды.
Что обсудить о поддержке
Интеграция зависит от двух сторон: вашего сайта и внешнего сервиса. Уточните, кто контролирует подписки, права доступа и изменения API, кто получает уведомления и как диагностируются ошибки. Эти условия лучше включить в порядок сопровождения. Новая функция внешней системы или смена способа обмена может потребовать отдельной доработки; это следует отличать от исправления ошибки уже согласованной разработки.
