Интеграция чат-бота с Битрикс24: пошаговый гайд по REST API 2026

У Битрикс24 — самая большая доля рынка CRM в России, и у него бесплатный тариф. Именно поэтому его чаще всего выбирают компании, у которых уже есть бот в Telegram или WhatsApp, но заявки из него по-прежнему приходится переносить в CRM руками.

В отличие от amoCRM, где всё строится вокруг OAuth-приложений, Битрикс24 даёт более простой путь — входящий вебхук. Для большинства ботов этого достаточно, и разбираться с полноценным приложением не требуется. В этом гайде — оба варианта.

Два способа подключения: вебхук vs приложение

Способ	Когда подходит	Сложность
Входящий вебхук	Один бот → один портал Битрикс24, без перепродажи решения	Настройка за 10 минут, без OAuth
Локальное/облачное приложение	Продукт для многих клиентов, публикация в Маркете Битрикс24	OAuth 2.0, регистрация приложения, сложнее в 3-4 раза

Для 9 из 10 задач — «бот принимает заявки и складывает их в CRM конкретной компании» — хватает входящего вебхука. Дальше разберём именно этот путь.

Шаг 1: Создание входящего вебхука

В Битрикс24 откройте раздел «Разработчикам» → «Другое» → «Входящий вебхук»
Отметьте права доступа: CRM (обязательно), при необходимости — «Задачи»
Нажмите «Сохранить» — система выдаст ссылку вида:

https://ваш-портал.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/

Эта ссылка — и есть ключ доступа. Всё, что нужно для вызова методов REST API — подставлять название метода в конец этого URL.

⚠️ Важно: ссылку с вебхуком нельзя публиковать в открытом коде или коммитить в публичный репозиторий — она даёт полный доступ к CRM без пароля. Храните её в переменных окружения (.env), не в коде бота.

Шаг 2: Создание лида из бота

Когда пользователь заполнил анкету в боте (имя, телефон, услуга), вызывается метод crm.lead.add:

# Создание лида в Битрикс24 (Python)
import requests

WEBHOOK = "https://ваш-портал.bitrix24.ru/rest/1/xxxxxxxxxxxxxxxx/"

def create_lead_in_bitrix24(name, phone, service, telegram_user_id):
    payload = {
        "fields": {
            "TITLE": f"Заявка из Telegram-бота: {service}",
            "NAME": name,
            "PHONE": [{"VALUE": phone, "VALUE_TYPE": "WORK"}],
            "SOURCE_ID": "OTHER",
            "SOURCE_DESCRIPTION": "Telegram-бот",
            "COMMENTS": f"Telegram ID: {telegram_user_id}",
        }
    }
    response = requests.post(WEBHOOK + "crm.lead.add.json", json=payload)
    return response.json()  # {"result": lead_id}
                

Что происходит дальше

Лид появляется в разделе CRM → Лиды, менеджер видит источник «Telegram-бот», телефон и комментарий с деталями заявки. Если в компании настроена интеграция с телефонией или email, дальнейшая коммуникация тоже логируется в карточке лида.

Шаг 3: Постановка задачи менеджеру

Если нужно не просто создать лид, а сразу назначить ответственного и поставить задачу — например, «перезвонить в течение часа» — используется метод tasks.task.add:

# Постановка задачи ответственному менеджеру
def create_task_for_lead(lead_id, responsible_id, deadline_iso):
    payload = {
        "fields": {
            "TITLE": f"Перезвонить по заявке из бота (лид #{lead_id})",
            "RESPONSIBLE_ID": responsible_id,
            "DEADLINE": deadline_iso,  # например "2026-08-01T12:00:00+03:00"
            "UF_CRM_TASK": [f"L_{lead_id}"],  # привязка задачи к лиду
        }
    }
    response = requests.post(WEBHOOK + "tasks.task.add.json", json=payload)
    return response.json()
                

Шаг 4: Перевод лида в сделку и по воронке

Когда лид квалифицирован (клиент подтвердил интерес), его конвертируют в сделку методом crm.lead.convert, а дальше сделку можно двигать по стадиям воронки методом crm.deal.update:

# Перевод сделки на стадию "Оплачено"
def move_deal_stage(deal_id, stage_id):
    payload = {
        "id": deal_id,
        "fields": {"STAGE_ID": stage_id}  # например "WON" или ID кастомной стадии
    }
    requests.post(WEBHOOK + "crm.deal.update.json", json=payload)
                

Уведомление бота, когда менеджер меняет статус

Обратная связь — «CRM → бот» — устроена сложнее: входящий вебхук работает только в одну сторону. Чтобы бот узнавал об изменениях в CRM (например, «сделка оплачена» → отправить клиенту подтверждение), нужен исходящий вебхук — Битрикс24 сам вызывает URL на вашем сервере при срабатывании события:

Разработчикам → «Другое» → «Исходящий вебхук»
Выбираете событие, например ONCRMDEALUPDATE
Указываете URL вашего обработчика — Битрикс24 будет слать туда POST-запрос при каждом изменении сделки

Стоимость и сроки разработки

Базовая интеграция (от 25 000 ₽)

Создание лида из бота через входящий вебхук
Комментарий с деталями заявки и Telegram ID
Срок: 2-4 дня

Расширенная интеграция (от 45 000 ₽)

Всё из базовой + постановка задач менеджерам
Конвертация лида в сделку и движение по воронке
Уведомления клиенту через исходящий вебхук при смене статуса
Срок: 7-10 дней

Приложение для Маркета Битрикс24 (от 90 000 ₽)

OAuth 2.0, установка одним кликом на любой портал
Публикация решения в Маркете как отдельного продукта
Срок: от 3 недель

Нужна интеграция бота с Битрикс24?

Настроим лиды, задачи и воронку под вашу CRM за 2-10 дней. Поддержка 152-ФЗ, гарантия.

Получить расчёт стоимости

Частые вопросы (FAQ)

1. Нужен ли платный тариф Битрикс24 для интеграции?

Нет, входящие вебхуки и базовые методы CRM.* доступны на бесплатном тарифе. Ограничение — количество пользователей и объём хранилища, не сам API.

2. Чем вебхук отличается от amoCRM-интеграции по сложности?

Проще: не нужен OAuth 2.0 с обменом токенов и их обновлением — вебхук-ссылка работает сразу и не «протухает». Минус — её нельзя раздавать нескольким клиентам, для этого уже нужно полноценное приложение.

3. Можно ли одновременно вести лиды и в Битрикс24, и в Google Таблице?

Да, дублирование данных в резервную таблицу — частое дополнение к интеграции, занимает 1-2 дня разработки сверху.

4. Сколько лидов в день выдержит вебхук?

Официальный лимит Битрикс24 — 2 запроса в секунду на одно приложение/вебхук. Для подавляющего большинства ботов малого и среднего бизнеса этого более чем достаточно.

Заключение

Интеграция с Битрикс24 через входящий вебхук — один из самых быстрых способов связать бота с CRM: без OAuth, без длинной проверки приложения, с рабочим прототипом за пару дней. Для сравнения с amoCRM — читайте гайд по интеграции с amoCRM.

📞 Контакты ITMagic.SPB:

Telegram: @ITMagicSPB
Сайт: itmagic.spb.ru
Работаем по всей России и за рубежом. Офис в Санкт-Петербурге