Интеграция MAX с CRM: подключаем amoCRM, Битрикс24 и 1С к мессенджеру

Подключив мессенджер MAX к CRM, вы превращаете обычный чат в рабочий инструмент отдела продаж. Каждое обращение клиента само становится лидом, менеджер сразу получает уведомление, а покупатель видит статус своей заявки прямо в переписке с ботом. Ниже разберём, как связать MAX с тремя самыми востребованными в России системами — amoCRM, Битрикс24 и 1С — и на что обратить внимание при запуске.

Зачем вообще связывать MAX и CRM

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

Как устроена интеграция

• Бот в MAX — принимает сообщения клиентов и отправляет ответы.
• Middleware — промежуточный сервис, который ловит события от MAX и дёргает API CRM (и наоборот). Это может быть небольшое приложение на Python, Node.js или PHP.
• CRM — хранит контакты, сделки и историю.

Какие CRM официально работают с MAX

• Битрикс24 — сообщения из MAX попадают в CRM через Открытые линии и Контакт-центр. Хороший вариант, если Битрикс24 уже ваша основная система.
• RetailCRM — маркетинг, продажи и лояльность; оптимальна для интернет-магазинов и розничных сетей.
• YClients — онлайн-запись для сферы услуг: салоны, клиники, фитнес, автосервисы.
• BPMSoft — low-code платформа с ИИ для компаний с повышенными требованиями к безопасности.
• Мегаплан — CRM с управлением задачами и проектами, удобна среднему бизнесу.

amoCRM + MAX: настройка по шагам

Порядок действий

• Создайте бота в MAX и получите токен.
• Зарегистрируйте интеграцию в amoCRM: Настройки → Интеграции → Создать интеграцию. Сохраните client_id, client_secret и redirect_uri.
• Разверните middleware с валидным HTTPS-сертификатом.
• Подпишите бота на webhook MAX, указав URL вашего middleware.
• В обработчике: при событии message_created от MAX создавайте контакт и сделку в amoCRM через её API.
• Настройте обратный поток: смена статуса сделки в amoCRM → уведомление клиенту в MAX.
• Прогоните все сценарии на тестовом аккаунте и только потом переводите в бой.

Приём событий от MAX

import requests
from flask import Flask, request, jsonify

MAX_TOKEN = "ВАШ_ТОКЕН_MAX"

# Подписываем бота на webhook (выполняется один раз)
requests.post(
    "https://platform-api.max.ru/subscriptions",
    headers={"Authorization": MAX_TOKEN},
    json={"url": "https://your-server.com/max-webhook"},
)

app = Flask(__name__)

@app.route("/max-webhook", methods=["POST"])
def on_max_update():
    payload = request.json or {}
    for update in payload.get("updates", []):
        if update.get("update_type") != "message_created":
            continue

        message = update["message"]
        chat_id = message["recipient"]["chat_id"]
        text = message.get("body", {}).get("text", "")
        sender = message.get("sender", {})

        push_lead_to_amocrm(
            name=sender.get("name", "Клиент из MAX"),
            phone=text if text.startswith("+") else None,
            source="Мессенджер MAX",
            chat_id=chat_id,
        )
    return jsonify(ok=True)

Создание контакта и сделки в amoCRM

import requests

AMOCRM_DOMAIN = "ваш-домен.amocrm.ru"
AMOCRM_TOKEN = "ВАШ_ТОКЕН_AMOCRM"

def push_lead_to_amocrm(name, phone=None, source="MAX", chat_id=None):
    """Создаёт контакт и привязанную к нему сделку в amoCRM."""
    auth = {"Authorization": f"Bearer {AMOCRM_TOKEN}"}

    contact = {"name": name, "custom_fields_values": []}
    if phone:
        contact["custom_fields_values"].append({
            "field_code": "PHONE",
            "values": [{"value": phone}],
        })

    r = requests.post(
        f"https://{AMOCRM_DOMAIN}/api/v4/contacts",
        headers=auth,
        json=[contact],
    )
    contact_id = r.json()["_embedded"]["contacts"][0]["id"]

    lead = {
        "name": f"Заявка из MAX: {name}",
        "pipeline_id": 12345,   # ID вашей воронки
        "status_id": 67890,     # ID этапа «Новая заявка»
        "_embedded": {"contacts": [{"id": contact_id}]},
        "custom_fields_values": [{
            "field_id": 111222,  # поле «Источник»
            "values": [{"value": source}],
        }],
    }

    return requests.post(
        f"https://{AMOCRM_DOMAIN}/api/v4/leads",
        headers=auth,
        json=[lead],
    ).json()

Битрикс24 + MAX: Открытые линии без единой строки кода

Подключение Открытых линий

• Откройте Контакт-центр → Мессенджеры → MAX.
• Нажмите «Подключить» и авторизуйте приложение MAX по OAuth.
• Привяжите MAX к существующей Открытой линии или создайте новую.
• Задайте правила распределения обращений: по очереди, по загрузке или по компетенциям.
• Укажите рабочее время — вне графика сработает автоответ.
• Включите автосоздание лида при первом обращении.
• Проверьте связку: напишите боту и убедитесь, что сообщение появилось в Битрикс24.

Что умеет Контакт-центр

• автосоздание лидов из первого сообщения;
• маршрутизация по менеджерам, отделам и компетенциям;
• автоответы и простые чат-боты для типовых вопросов;
• вся переписка привязана к карточке клиента;
• оценка качества обслуживания и отчёты по времени ответа.

1С + MAX: документы и уведомления

Типовые сценарии

• Статусы заказов — 1С сообщает клиенту в MAX: принят, собран, отправлен, доставлен.
• Счета и оплаты — бот присылает PDF-счёт и уведомляет о поступлении денег.
• Остатки — клиент спрашивает про наличие, бот проверяет остаток в 1С и отвечает.
• Заявки — заказ из бота превращается в документ «Заказ покупателя».
• Закрывающие документы — акты и накладные уходят клиенту после проведения в 1С.
• Оповещения менеджерам — push при новом контрагенте или оплате.

Как это работает технически

import requests

def get_stock_from_1c(product_name):
    """Забираем остаток из HTTP-сервиса 1С."""
    return requests.get(
        "https://your-1c-server.com/api/stock",
        params={"product": product_name},
        auth=("user", "password"),
        timeout=10,
    ).json()

def reply_with_stock(chat_id, product_name):
    stock = get_stock_from_1c(product_name)

    if stock.get("available", 0) > 0:
        text = (
            f"Товар «{product_name}» в наличии.\n"
            f"Остаток: {stock['available']} шт.\n"
            f"Цена: {stock['price']} ₽\n\n"
            f"Оформить заказ? Напишите «Заказать»."
        )
    else:
        eta = stock.get("expected_date", "уточняется")
        text = (
            f"Товар «{product_name}» временно закончился.\n"
            f"Ожидаемое поступление: {eta}.\n\n"
            f"Прислать уведомление, когда появится? Напишите «Уведомить»."
        )

    send_max_message(chat_id, text)

Полный путь заявки: от сообщения до сделки

• Клиент пишет боту. Например: «Хочу записаться на приём». Сообщение приходит через webhook.
• Бот квалифицирует. Уточняет имя, телефон, удобное время — быстрее всего через inline-кнопки.
• Middleware создаёт сделку. Контакт, сделка и примечание с текстом обращения появляются автоматически, источник — «Мессенджер MAX».
• Менеджер получает push. С именем клиента, темой и ссылкой на карточку.
• Менеджер работает с заявкой. Видит историю переписки, связывается с клиентом.
• Статус обновляется. Клиент получает в MAX: «Заявка принята, менеджер Анна свяжется через 10 минут».
• Сделка закрывается. Бот предлагает оценить сервис и подписаться на рассылку.

Что выбрать: сравнение способов

• amoCRM — сильна гибкими воронками и мощным API, подходит отделам продаж. Интеграция через webhook + middleware, запуск за считанные дни. Для доступа к API нужен тариф не ниже «Расширенного».
• Битрикс24 — лучший вариант, если вы уже в нём работаете. Нативная связка через Открытые линии настраивается за 20–30 минут без кода. Сложные сценарии — через REST API.
• 1С — незаменима, когда учёт ведётся в 1С. Обмен через HTTP-сервис + middleware, требует доработки конфигурации, но даёт полную синхронизацию заказов, остатков и документов.

Другие CRM: RetailCRM, YClients, Мегаплан

• RetailCRM — для e-commerce: приём заказов через бота, статусы доставки, триггерные рассылки (брошенная корзина, повторная покупка). Настраивается встроенным модулем, без middleware.
• YClients — для услуг: клиент записывается через бота, запись сразу появляется в системе, а напоминание о визите приходит в MAX за сутки. Отлично подходит клиникам, салонам и автосервисам.
• Мегаплан — универсальная CRM с проектами: из сообщений можно создавать задачи, оповещать сотрудников о дедлайнах и следить за выполнением.

Частые ошибки при интеграции

• Нет защиты от дублей. Клиент написал дважды — завелись две сделки. Проверяйте контакт перед созданием, используйте chat_id как уникальный ключ.
• Нет повторов при сбоях. CRM не ответила — лид пропал. Ставьте очередь с retry и экспоненциальной задержкой.
• Токены прямо в коде. Прямой путь к утечке. Только переменные окружения или секрет-менеджеры.
• Нет логов. Без них не понять, почему лид не создался. Логируйте каждый запрос и ответ с временем и chat_id.
• Игнор лимитов API. amoCRM ограничивает частоту запросов; превышение — временная блокировка. Нужна очередь с контролем скорости.
• Нет мониторинга. Бот упал ночью — узнали утром. Заведите healthcheck и алерты об ошибках.
• Слишком сложный старт. Не пытайтесь автоматизировать всё сразу — начните с одного сценария и расширяйтесь.
• Тесты на боевой CRM. Заведите отдельный тестовый аккаунт и sandbox-бота.

Безопасность и 152-ФЗ

• HTTPS везде — между MAX, middleware и CRM только защищённое соединение; самоподписанные сертификаты не годятся.
• Ротация токенов — регулярно обновляйте ключи доступа к API и настройте напоминания.
• Минимум прав — middleware даётся доступ только к нужным разделам CRM; в amoCRM заведите отдельного пользователя для API.
• Шифрование очереди — если middleware хранит промежуточные данные, шифруйте их и держите серверы в РФ для соответствия 152-ФЗ.
• Аудит доступа — логируйте обращения к API и храните логи хотя бы полгода.

Частые вопросы

Коротко