Как автоматизировать обработку заявок из Telegram в Битрикс24

Задача: заявки приходят в Telegram-бот, менеджер вручную копирует их в Битрикс24. Тратит 20-30 минут в день, теряются детали, забывают перенести.

Решение: автоматическая интеграция Telegram → Битрикс24 через REST API.

Что получаем

• Заявка из Telegram автоматически создаёт сделку в Битрикс24
• Сохраняется вся переписка с клиентом
• Добавляется контакт (телефон, имя из Telegram)
• Менеджер получает уведомление

Шаг 1: Получаем webhook Битрикс24

В Битрикс24 → Настройки → Разработчикам → Входящий webhook. Копируем URL вида:

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

Шаг 2: Создаём Telegram-бота

В BotFather создаём бота, получаем токен. Код бота (Python):

import requests
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler

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

async def handle_message(update, context):
    user = update.effective_user
    text = update.message.text
    
    # Создаём сделку в Битрикс24
    data = {
        "fields": {
            "TITLE": f"Заявка от {user.first_name}",
            "NAME": user.first_name,
            "PHONE": [{"VALUE": user.username, "VALUE_TYPE": "WORK"}],
            "COMMENTS": text
        }
    }
    
    response = requests.post(
        BITRIX_WEBHOOK + "crm.deal.add.json",
        json=data
    )
    
    if response.ok:
        await update.message.reply_text("Заявка принята!")

app = Application.builder().token("ВАШ_ТОКЕН").build()
app.add_handler(MessageHandler(filters.TEXT, handle_message))
app.run_polling()

Шаг 3: Добавляем контакт

Сначала создаём контакт, затем привязываем к сделке:

# Создаём контакт
contact = requests.post(
    BITRIX_WEBHOOK + "crm.contact.add.json",
    json={"fields": {"NAME": user.first_name, "PHONE": ...}}
).json()

contact_id = contact["result"]

# Создаём сделку с контактом
deal_data["fields"]["CONTACT_ID"] = contact_id

Шаг 4: Сохраняем переписку

Добавляем каждое сообщение как комментарий к сделке через crm.timeline.comment.add.

Результат

Теперь каждая заявка из Telegram автоматически попадает в Битрикс24. Менеджеры видят всю историю переписки, ничего не теряется.

Экономия времени: 20-30 минут в день = 10 часов в месяц.

Автор: ISKRA | Кейсы | +7 925 507-31-24