Подключение Bitrix24 и amoCRM — лиды сразу в CRM

Когда лид становится горячим — он автоматически создаётся как Лид в вашей CRM. Никаких CSV-выгрузок и копипаста. Настраивается в /app/webhooks.

Какие CRM поддерживаются

• Bitrix24 — через входящий вебхук (crm.lead.add).
• amoCRM — через API /api/v4/leads с long-lived token.
• Generic — свой сервер / другая CRM. Шлём JSON с HMAC-подписью.

Подключение Bitrix24

1. В Bitrix24 откройте «Разработчикам» → «Другое» → «Входящий вебхук».
2. Включите права crm (другие можно не давать).
3. Скопируйте URL вида https://YOUR.bitrix24.ru/rest/USER_ID/TOKEN/. К нему нужно добавить crm.lead.add.json.
4. В MaxSurge: /app/webhooks → «Добавить вебхук».
5. Тип интеграции: Bitrix24.
6. В поле URL вставьте полный путь: https://YOUR.bitrix24.ru/rest/USER_ID/TOKEN/crm.lead.add.json
7. События: * или конкретно lead_collected.
8. Сохранить.

Теперь при появлении нового лида (например через 2GIS-парсер) MaxSurge автоматически создаёт Лид в Bitrix24 с полями:

• Название: «MaxSurge: Имя клиента»
• Имя: имя из контакта
• Телефон: с типом WORK
• Комментарий: источник, город, категория, адрес, сайт
• Источник: OTHER (можно поменять в Bitrix настройках)

Подключение amoCRM

1. В amoCRM откройте «Интеграции» → «Создать интеграцию».
2. Выберите «Внутренняя» — для приватного API без OAuth.
3. В настройках интеграции сгенерируйте долгоживущий токен.
4. В MaxSurge: /app/webhooks → «Добавить вебхук».
5. Тип интеграции: amoCRM.
6. URL: https://YOUR.amocrm.ru/api/v4/leads
7. В поле «amoCRM long-lived token» вставьте токен из шага 3.
8. События: * или lead_collected.
9. Сохранить.

amoCRM получит сделку с вложенным контактом (имя + телефон). Сделка попадёт в воронку по умолчанию — настроить можно в amoCRM на стороне интеграции.

Какие события MaxSurge отправляет

• lead_collected — новый лид через парсер 2GIS / импорт CSV / ингест-API.
• payment_success — успешная оплата клиента.
• message_sent — отправлено сообщение из рассылки.
• account_blocked — MAX-аккаунт заблокирован.
• campaign_completed — рассылка завершилась.

Если в поле «События» поставить * — пойдут все. Если задать массив ["lead_collected"] — только лиды.

Проверка

• В /app/webhooks рядом с эндпоинтом есть лог последних доставок: статус, код ответа, время.
• Если CRM отвечает не 2xx — статус ошибки виден прямо в логе.
• Также есть кнопка «Тест» — отправит фиктивное событие для проверки настройки.

Безопасность

Для Generic JSON-вебхука MaxSurge подписывает каждый payload HMAC-SHA256 с секретным ключом. Получающая сторона может проверить заголовок X-MaxSurge-Signature. Для Bitrix24/amoCRM — авторизация встроена в URL (Bitrix) или в Bearer-токен (amoCRM).