Как подключить MAX к CRM через бота и вебхук

Подключить MAX к CRM можно двумя способами. Первый: создавать карточки во встроенной CRM MAXorg. Второй: передавать данные во внешнюю систему через блок «Вебхук». Эти способы решают разные задачи и могут работать вместе.

Начинайте с момента, когда обращение становится лидом. Если отправлять данные сразу после запуска бота, CRM заполнится случайными посетителями. Полезнее создавать заявку после выбора услуги, ответа на важный вопрос, бронирования или подтверждённой оплаты.

Выберите встроенную или внешнюю CRM

Встроенная CRM подходит, если менеджеры работают в кабинете MAXorg. Карточка связывается с ботом и контактом, может содержать имя, телефон, email, заголовок, заметку и срок. Оператор открывает связанный диалог и видит историю общения.

Вебхук нужен, если сделки уже ведутся в другой CRM, ERP или собственном сервисе. Блок отправляет HTTP POST с JSON на ваш адрес. Ответ внешней системы не управляет ветвлением воронки, поэтому не стройте сценарий, который ждёт номер сделки или решение CRM перед следующим сообщением.

• Только MAXorg: создайте карточку во внутренней CRM.
• Есть корпоративная CRM: добавьте вебхук к интеграционному серверу.
• Нужен резерв: создайте карточку и отправьте вебхук.
• Нужна обратная проверка: реализуйте её отдельно на своём сервере.

Настройте карточку MAXorg

Поставьте действие «Карточка в CRM» после квалификации. Выберите колонку и задайте понятный заголовок: название услуги, имя клиента и статус. В заметку можно подставить контактные данные, последний текст и название воронки. Если перед этим было бронирование, дата может стать сроком карточки.

Проверьте, не создаёт ли блок бронирования карточку сам. Если следом поставить ещё одно CRM-действие, один клиент получит две записи. Сначала решите, нужна одна заявка на встречу или отдельная сделка. Примеры процессов можно посмотреть в каталоге.

1. Создайте колонки «Новые», «В работе» и «Готово».
2. Добавьте CRM-действие после целевого ответа.
3. Выберите колонку «Новые».
4. Укажите заголовок и короткую заметку.
5. Пройдите сценарий и откройте созданную карточку.

Подготовьте вебхук для внешней CRM

Создайте отдельный HTTPS endpoint, который принимает POST и JSON. Он должен быстро проверить запрос, сохранить событие и вернуть успешный код. Тяжёлую работу с API CRM лучше выполнять после приёма. Так сбой внешнего сервиса не заставит клиента долго ждать в чате.

MAXorg передаёт служебные идентификаторы воронки, бота, диалога и блока, время отправки, а также выбранные данные контакта. Последний текст включается отдельно. Набор полей задаётся в блоке. Не отправляйте телефон, геолокацию или свободный текст, если они не нужны для сделки.

• Принимайте только HTTPS-запросы.
• Проверяйте тип события и обязательные поля.
• Разрешайте отсутствующие необязательные значения.
• Сохраняйте связь контакта MAX с контактом CRM.
• Не полагайтесь на порядок полей JSON.

Защитите endpoint и уберите дубли

В блоке вебхука задайте длинный случайный секрет. MAXorg отправит его в заголовке X-Webhook-Secret. Сервер должен сравнить значение до обработки данных и отклонить запрос без совпадения. Само наличие заголовка ничего не защищает, если проверка не написана.

Для поиска контакта сначала используйте сохранённую связь бота и MAX user id. Затем при необходимости проверяйте нормализованный телефон или email. Имя и username не являются надёжными уникальными ключами. Повторный запуск воронки может быть законным, поэтому не отбрасывайте новое событие только из-за того, что тот же человек уже обращался.

Безопасный подход: сначала найдите контакт и активную сделку, затем решите, обновить её или создать новую.

Соберите резервный путь для оператора

Блок вебхука продолжает обычную ветку после попытки отправки. Не пишите клиенту «сделка создана во внешней CRM», если не получили такое подтверждение своим процессом. Лучше сообщить: «Мы приняли данные и передадим их менеджеру».

Для важных заявок одновременно создайте внутреннюю карточку MAXorg или отправьте уведомление сотруднику. Это даёт оператору доступ к диалогу, даже если внешняя CRM временно недоступна. Подключённые сценарии можно контролировать в разделе ботов.

• Вебхук стоит слишком рано. Перенесите его после квалификации.
• Каждый запрос создаёт новую сделку. Добавьте поиск контакта и активной заявки.
• Секрет не проверяется. Отклоняйте запрос до обработки тела.
• В CRM уходит лишний текст. Отключите ненужные поля.
• Нет резервной заявки. Добавьте карточку или уведомление.

Проверьте интеграцию от бота до сделки

Сначала используйте свой тестовый endpoint, где видны заголовки и тело запроса. Не отправляйте реальные персональные данные в публичный просмотрщик вебхуков. Проверьте запрос с заполненными и пустыми полями, верный и неверный секрет, повторное обращение того же контакта.

После подключения внешней CRM пройдите полный путь. Убедитесь, что контакт найден или создан один раз, сделка попала на правильный этап, оператор может открыть переписку, а ошибка API видна ответственному сотруднику. Зарегистрировать кабинет можно на странице MAXorg, дополнительные инструкции есть в блоге.

1. Запустите воронку тестовым контактом.
2. Сверьте поля и секрет на endpoint.
3. Проверьте создание карточки MAXorg.
4. Убедитесь, что внешняя CRM получила нужные данные.
5. Повторите запуск и проверьте дубли.
6. Верните ошибку endpoint и оцените резервный путь.
7. Откройте исходный диалог из рабочего процесса оператора.