<![CDATA[ilyushko.ru]]>https://ilyushko.ru/https://ilyushko.ru/favicon.pngilyushko.ruhttps://ilyushko.ru/Ghost 5.75Fri, 24 Apr 2026 19:32:01 GMT60<![CDATA[Кейс | Restful сервис для обмена Битрикс24 и 1С]]>https://ilyushko.ru/restful/6763079519671702d9375a7cSun, 01 Dec 2024 21:00:00 GMT

Что требовалось сделать

  • Реализовать обмен между CRM системой Битрикс24 и 1С логистика
    • Обеспечить двух стороннюю синхронизацию контактов и компаний
    • Обеспечить сценарии при которых контакты и компании могут быть созданы или отредактированы как в Битрикс24 так и в 1С
если создаем компанию в 1с – она должна появится в битриксе, если менеджер добавил этой компании номер телефона в битриксе, он должен быть передан в 1С
если в 1с для компании добавили несколько реквизитов, их надо передать в битрикс

Что было сделано

  • REST API Приложение обеспечивающее обмен между двумя системами
  • Промежуточная база данных для хранения данных о клиентах и компаниях
  • Учет клиента который совершал манипуляции с данными
    • Под клиентом подразумевается система которая отправляет запросы в апи.
    • Под учетом клиента подразумевается системный сценарий, записи даты последнего изменения элемента в базе, с указанием каким клиентом было внесено изменение, это нужно для синхронизации изменений.
  • Интерактивная документация с функционалом тестирования запросов
Кейс | Restful сервис для обмена Битрикс24 и 1С

Логика работы приложения

Mermaid Diagram
sequenceDiagram participant Bitrix24 participant 1C participant FastAPI participant Database Bitrix24->>FastAPI: HTTP Запрос FastAPI->>FastAPI: Валидация Запроса FastAPI<<->>Database: Взаимодействие с Базой Данных FastAPI->>FastAPI: Подготовка Ответа FastAPI-->>Bitrix24: HTTP Ответ 1C->>FastAPI: HTTP Запрос FastAPI->>FastAPI: Валидация Запроса FastAPI<<->>Database: Взаимодействие с Базой Данных FastAPI->>FastAPI: Подготовка Ответа FastAPI-->>1C: HTTP Ответ

Модель взаимодействия построена следующим образом:

  • Есть два клиента
    • Битрикс
    • 1С
  • Клиенты отправляют запросы на приложение
  • Приложение узнает клиента по токену (у каждого свой)
  • После получения и проверки запроса, приложение выполняет манипуляции с базой данных
  • Промежуточная база пополняется данными асинхроно

Данная парадигма исключает взаимодействие битрикс и 1с напрямую, все взаимодействие между двумя системами (клиентами) случается через промежуточную базу, по запросу от разработчиков 1С был добавлен дополнительный метод позволяющий получить изменения сделанные конкретным клиентом, в определенный промежуток времени, чтобы 1С могла забирать только те контакты и компании которые были изменены или созданы с момента последнего запроса

Кейс | Restful сервис для обмена Битрикс24 и 1С

Что в итоге получилось, какие боли вылечили

  • Исключили рассинхрон в данных между системами (теперь карточки компаний и контрагентов выглядят одинаково во всех системах)
  • Клиентская база пополняется в двух системах одновременно
  • Исключили передачу клиентских данных по "голубиной почте" между сотрудниками
    • Если у сотрудника, который работает в 1с но не работает в битриксе возникает потребность связаться с клиентом, ему больше не нужно изыскивать его контакты у отдела продаж, или просить что-то ему передать, контакты теперь в удобном для него месте.
  • Повышено качество данных при работе с CRM
    • как следствие открывается огромный пул возможностей для crm маркетинга
💡

- С какими версиями 1С может работать это решение?
- С любой версией, которая может отправлять http запросы
- Можно даже подключить несколько баз 1С, если бизнесовые сценарии того требуют.

С каким версиями Битрикс24 может работать это решение?
Облако, любой платный тариф, а также в Коробке.
]]><![CDATA[Серверное приложение для Битрикс24 "Авто закрытие подзадач"]]>

Логика работы

  • Закрылась базовая задача
  • Если Пользователь
]]>https://ilyushko.ru/sierviernoie-prilozhieniie-dlia-bitriks24-avto-zakrytiie-podzadach/65dceb4569871a02e9c1becdMon, 26 Feb 2024 20:04:02 GMT

Логика работы

  • Закрылась базовая задача
  • Если Пользовательское поле в задаче `Закрывать подзадачи при завершении` == `Да`
    • Получить открытые подзадачи
    • Закрыть Подзадачи
  • Если Пользовательское поле в задаче `Закрывать подзадачи при завершении` == `Нет`
    • Ничего не делать
]]><![CDATA[Rest Активити для Битрикс24 на Python "Пауза в секундах"]]>

Что потребуется:

  • Портал б24 на который будем ставить приложе
]]>https://ilyushko.ru/rest/65d86dec69871a02e9c1be1fFri, 23 Feb 2024 16:48:41 GMT

Что потребуется:

  • Портал б24 на который будем ставить приложение =)
  • Сервер на котором будет работать приложение на питоне, сервер понадобится для приема и обработки запросов от Б24.
    Для этого проекта я арендую виртуальный сервер на таймвеб -> https://timeweb.cloud/r/tx99429
  • На сервере развернем FaStapi https://fastapi.tiangolo.com/ и напишем обработчик который будет обеспечивать паузу
  • Подготовить файл для регистрации приложения
    • Приложение можно зарегистрировать разными способами, примеры описаны в официальной документации. Я возьму самый простой пример - Локальное приложение оно представляет из себя 1 html файл в архиве, загружаемый на портал в момент создания приложения

Подготовка файла для регистрации приложения

  • Возьмем архив локального приложения из примера
  • Дополним его методом для создания активити `bizproc.activity.add`
    ссылка на доку по этому методу
  • Упаковываем отредактированный файл в `.ZIP` архив и загружаем на портал

В итоге должно получится примерно вот так:


<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Quick start. Local static application</title>
</head>
<body>
    <div id="name"></div>

    <script src="//api.bitrix24.com/api/v1/"></script>
    <script>
        BX24.init(function(){
            // Получение текущего пользователя
            BX24.callMethod('user.current', {}, function(res){
                var name = document.getElementById('name');
                name.innerHTML = res.data().NAME + ' ' + res.data().LAST_NAME;
                console.log(res.data());
            });

            // Добавление пользовательского действия в бизнес-процесс
            var activityData = {
                CODE: 'custom_activity_code', // Уникальный код вашего действия
                HANDLER: 'http://82.97.250.59/activity_pause/', // URL обработчика на который активти будет отправлять данные
                NAME: 'Пауза в секундах', // Название действия
                DESCRIPTION: 'Останавливает действие бизнес процесса на заданное кол-во секунд', // Описание действия
                PROPERTIES: {
                    StringParameter: { // Имя параметра
                        Name: "Пауза", // Название параметра для отображения
                        Description: "Сколько ждать в секундах", // Описание параметра
                        Type: "string", // Тип параметра
                        Required: "Y" // Параметр обязателен
                    }
                },
                RETURN_PROPERTIES: {
                    // Возвращаемые значения вашего действия, если они требуются
                    ResultString: {
                Name: "Результат ожидания",
                Description: "Результат выполенения дейтсвия",
                Type: "string"
            }

                }
            };

            BX24.callMethod('bizproc.activity.add', activityData, function(response){
                if(response.error())
                    console.error("Ошибка добавления активити: ", response.error());
                else
                    console.log("Активити успешно добавлено: ", response.data());
            });

            console.log('B24 SDK is ready!', BX24.isAdmin());
        });
    </script>
</body>
</html>
Замените в этом файле параметр `HANDLER` на урл своего обработчика

Подготовка сервера и установка FastApi

  • Арендуем сервер -> https://timeweb.cloud/r/tx99429
  • Заходим по ssh
  • Устанавливаем FastApi
  • Запускаем FastApi чтоб убедится что все работает
uvicorn main:app --reload --port 80 --host 82.97.250.108
Замените 89.97.250.108 на адрес своего хоста

Метод для обработки запросов из битрикса на стороне FastApi

Что делает метод:

  • Принимает запрос от Б24
  • Из запроса берет значение паузы
  • Засыпает на полученное из запроса кол-во секунд
  • Выходит из спячки и отправляет ответ в б24

Исполняемый файл должен выглядеть примерно вот так:

from fastapi import FastAPI, Request
from urllib.parse import parse_qs
import asyncio
import requests

app = FastAPI()

@app.post('/activity_pause/')
async def handler(request: Request):
    body = await request.body()
    body_str = body.decode('utf-8')
    
    parsed_body = parse_qs(body_str)
    pause = int(parsed_body['properties[StringParameter]'][0])
    await asyncio.sleep(pause)  # Пример использования asyncio

    params = {
        "auth": parsed_body['auth[access_token]'][0],
        "event_token": parsed_body['event_token'][0],
        # Пример использования parsed_body, полученного с помощью parse_qs
        "return_values": {
            "ResultString": f"Бп висел в паузе {pause} секунд",
        }
    }
    
    rest_api_url = parsed_body['auth[client_endpoint]'][0] + 'bizproc.event.send'
    response = requests.post(rest_api_url, json=params)  # Пример использования requests

    if response.status_code == 200:
        return {"message": "Результат успешно возвращен в БП"}
    else:
        return {"error": "Ошибка при возвращении результата в БП", "status_code": response.status_code}
]]><![CDATA[Тестовое задание / настройка портала с нуля]]>

Что надо сделать

  • Создайте облачный портал Битрикс24
  • Включи
]]>https://ilyushko.ru/tiestovoie-zadaniie-nastroika-portala-s-nulia/659ab46522fc74392a043d46Sun, 07 Jan 2024 15:32:59 GMT

Что надо сделать

  • Создайте облачный портал Битрикс24
  • Включите демо-режим
  • Создайте трех пользователей:
    • Михаил
    • Александр
    • Евгений
  • Установить роли для пользователей:
ЮзерРоль
АлександрРОП
МихаилСотрудник
ЕвгенийСотрудник
  • Создайте три компании с любым названием и для каждой из компании назначить ответственного
  • Настройте бизнес-процесс по следующим правилам:
    • Если лид приходит от компании с назначенным ответственным, то ему отправляется письмо-уведомление (текст произвольный)
    • Если лид приходит от новой компании без закрепленного ответственного, то ответственным автоматически назначается менеджер с наименьшим количеством лидов
    • Если количество лидов у двух менеджеров одинаковое, то ответственным назначается руководитель для дальнейшего распределения лида вручную. Руководитель должен получить задачу для распределения такого лида (текст произвольный)

Реализация

Приемка лидов

Для приема лидов создал crm форму -> https://b24-hp5692.bitrix24.site/crm_form_xyu3s/

Доступы_crm

Тестовое задание / настройка портала с нуля

Структура компании

Тестовое задание / настройка портала с нуля

Бизнес процесс приемка лидов

Схема процесса

Тестовое задание / настройка портала с нуля

Ссылка на бп -> https://b24-73dc79.bitrix24.ru/crm/configs/bp/CRM_LEAD/edit/32/

Видео демонстрация работы

Узкие места

Тестовое задание / настройка портала с нуля
  • Менеджер получит письмо, только если он был отв. за компанию, в случае если он был назначен отв. в следствии отработки БП, письмо не отправляется 🤷‍♂️
Тестовое задание / настройка портала с нуля
  • Отсутствие дальнейших действий на стороне системы после постановки задачи РОПу. Что делать после того роп. выбрал отв. за лид?
Тестовое задание / настройка портала с нуля
  • Что если у лида в момент появления отсутствует связь с компанией?

Доступы

Админские доступы / доступы к вспомогательным сервисам

Админская учетка
Площадкаhttps://b24-73dc79.bitrix24.ru/
Логинyeakr@telegmail.com
Парольkdjfnver!@34djfiWWEeee1223

Доступы сотрудников

Александр РОП
Площадкаhttps://b24-73dc79.bitrix24.ru/
Логинqnebxs@hi2.in
Парольkdjfnver!@34djfiWWEeee1223
Евгений Сотрудник
Площадкаhttps://b24-73dc79.bitrix24.ru/
Логинjvlakmw@hi2.in
Парольkdjfnver!@34djfiWWEeee1223
Михаил Сотрудник
Площадкаhttps://b24-73dc79.bitrix24.ru/
Логинlbvpxugp@hi2.in
Парольkdjfnver!@34djfiWWEeee1223
]]><![CDATA[Регулярный отчет по лидам для компании застройщика]]>Идея

Идея в том, что надо проверить лиды и сделки в б24, отсортир

]]>https://ilyushko.ru/rieghuliarnyi-otchiet-po-lidam-dlia-kompanii-zastroishchika/659ab25d22fc74392a043d34Sun, 07 Jan 2024 14:23:25 GMTИдеяРегулярный отчет по лидам для компании застройщика

Идея в том, что надо проверить лиды и сделки в б24, отсортировать их по дате создания и/или определенным событиям, а после отписаться в общий чат. Это каждый день кто-то делал. Иногда бывало, что данные были не точные или не приходили вовремя.

Реализация

  • Описываем метрики на основе которых должен собираться отчет, цель определить конкретные формулы сборки. Отрывок из ТЗ по описанию метрик:
Сегодня = 21:00 вчерашнего дня - 21:00 сегодня 

#Чтобы под параметр сегодня попадали лиды созданные в не рабочее время. 
#К примеру лид создан сегодня 21:30 он должен отображаться в завтрашнем отчете.

Метрика "Дозвон": 
- статус лида = 'Новая заявка'
- Дата создания = сегодня
- Название лида не содержит "Лид из неуспешно"

Сбор метрики 'ДДУ': 
- Переход на статус = сегодня 
- Статус = "Договор подписан",'Договор зареистрирован' 
# считать 1 раз, если уже засветилось на каком-то статусе, 
# в сегодняшний отчет не попадает

Доп. фильтры: 
Наша_Реклама(Рекламный_источник != 'реклама застройщика')
  • После точной формализации метрик пишем / отлаживаем скрипт, который будет запускаться 1 раз в сутки собирать данные по указанной выше логике. На выходе у скрипта получается вот такого вида пост:
Ежедневный отчет от 2022-03-04

🚩 Звонки: 5
Дозвон : 3 
В работе : 0 
Встречи : 1
Отказ от сделки : 0

🚩 Заявки с сайтов: 7
Дозвон : 1 
В работе : 0 
Встречи : 1
Отказ от сделки : 0

🚩 Реанимация / Лиды "из неуспешно": 2
Дозвон : 2 
В работе : 0 
Встречи : 1
Отказ от сделки : 0

---
Брони: 0
ДДУ: 0
  • Данный пост автоматически отправляется после сборки в два канала:
    • В ленту новостей в битркис24
    • В общий телеграм чат
Регулярный отчет по лидам для компании застройщика
Регулярный отчет по лидам для компании застройщика
]]><![CDATA[Авто поиск совпадений по базе контактов]]>Приложение проверяет входящий лид на уникальность по вход

]]>https://ilyushko.ru/avto-poisk-sovpadienii-po-bazie-kontaktov/659ab0c022fc74392a043d29Sun, 07 Jan 2024 14:14:42 GMT

Приложение проверяет входящий лид на уникальность по входящему номеру, актуально использовать когда у портала много точек входа (например самописные интеграции с какими-то без численными лендингами)

Видео демонстрация работы приложения -> https://youtu.be/x-QpvpHXSx0

]]><![CDATA[Балансировщик входящих лидов]]>Приложение для гибкого управления очередью распределени

]]>https://ilyushko.ru/coming-soon/6599e7ca48450d3749a8ac35Sat, 06 Jan 2024 23:52:42 GMT

Приложение для гибкого управления очередью распределения входящих лидов

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

Видео демонстрация работы приложения -> https://youtu.be/lK2hYzH9Hm0

]]>