Понедельник — Пятница
9:00 —18:00
Введение в приложение RoboRest: Конструктор роботов и активити для бизнес-процессов
Обзор приложения RoboRest: Представление приложения как конструктора роботов и активити для автоматизации бизнес-процессов.
Интерфейс приложения: Демонстрация основного экрана со списком созданных роботов, возможностью их добавления, редактирования и удаления.
Предустановленные роботы: При установке приложения доступны примеры роботов с основными сценариями использования.
Создание и настройка робота: Указание названия робота, настройка входящих и исходящих параметров (поддерживаются строки, включая JSON и списки).
Код робота: Написание кода на Python с доступом к стандартным функциям, библиотекам (requests, Pillow, NumPy, matplotlib) и объекту Bitrix24 REST API.
Тестирование кода: Возможность тестирования робота с отображением входящих параметров и логов (поддержка уровней логирования: Debug, Info, WARN, ERROR).
Интеграция с Bitrix24: Поддержка запуска роботов по расписанию (по крону) и добавление встройки в интерфейс Bitrix24 (планируется).
Сохранение изменений: Кнопка «Сохранить» для сохранения настроек робота и его интеграции в сущности Bitrix24.
Дополнительные возможности: Доступ к логеру, токену приложения, идентификатору портала и библиотекам для работы с QR-кодами, HTTP-запросами, изображениями и сложными вычислениями.
Пример расчета суммы сделок
Пример расчета суммы сделок: Демонстрация робота, который вычисляет сумму сделок в Bitrix24.
Работа с входящими и исходящими параметрами: Прием входящих параметров и возврат суммы сделок как исходящего параметра.
Использование Python SDK Bitrix24: Настройка клиента для работы с Bitrix24 REST API.
Фильтрация сделок: Настройка фильтра для получения сделок после 2023 года с ненулевой стоимостью.
Обработка пагинации: Получение всех записей сделок, а не только первых 50, с учетом пагинации REST API.
Цикл по сделкам: Итерация по полученным сделкам для подсчета общей суммы.
Логирование и тестирование: Вывод суммы (3500) в исходящий параметр и логирование найденных сделок (1000 и 2500) в тестовом запуске.
Проверка корректности: Подтверждение правильности расчетов (1000 + 2500 = 3500).
Работа с задачами и диском
Работа с задачами и комментариями: Демонстрация добавления комментария к задаче в Bitrix24.
Интеграция с диском приложения: Объяснение необходимости загрузки файлов на диск приложения, так как некоторые методы REST API (например, добавление комментария) не поддерживают прямую передачу файлов в формате base64.
Получение ID хранилища: Вызов метода для получения идентификатора хранилища приложения.
Загрузка файла на диск: Использование метода disk.storage.uploadfile для загрузки файла и получения его ID.
Генерация QR-кода: Создание файла с QR-кодом, содержащим текст комментария, с помощью библиотеки QR-кода.
Добавление комментария: Передача ID загруженного файла в метод добавления комментария к задаче (например, задача №3190).
Тестирование кода: Запуск кода для добавления тестового комментария с QR-кодом.
Результаты выполнения: Получение ID созданного комментария в исходящем параметре и логирование этапов (запуск активности, получение ID хранилища, загрузка файла, добавление комментария).
Проверка результата: Просмотр добавленного комментария с QR-кодом в задаче, который содержит текст комментария.
Получение результатов и комментариев задач
Работа с результатами задач: Демонстрация получения закрепленных комментариев к задачам в Bitrix24.
Настройка параметров: Использование идентификатора задачи во входящих параметрах и множественной строки для результатов в исходящих параметрах.
Варианты обработки комментариев: Возможность возвращать комментарии как множественное поле или объединять их в одну строку.
Метод TaskResultList: Вызов метода TaskResultList для получения списка результатов по задаче с передачей идентификатора задачи.
Обработка результатов: Добавление полученных результатов в исходящий параметр.
Тестирование кода: Запуск теста для задачи №3190, где возвращается один закрепленный комментарий ("итоговый коммент").
Проверка результата: Подтверждение успешного выполнения теста с отображением одного закрепленного комментария в задаче.
Работа с внешними API. Пример с Dadata
Интеграция с внешними API: Демонстрация запроса к API Dadata для получения информации о компании по её ИНН.
Настройка параметров: Входящий параметр — ИНН компании, исходящий параметр — название компании, полученное из API.
Альтернативный подход: Возможность использовать идентификатор компании для получения ИНН и последующего запроса к Dadata.
Настройка запроса: Указание токена доступа и формирование POST-запроса к API Dadata с передачей ИНН.
Обработка ответа: Получение ответа в формате JSON, извлечение названия компании и запись его в исходящий параметр.
Тестирование кода: Запуск теста с передачей ИНН, результат — название компании "G-Prom" в исходящем параметре.
Логирование: Проверка логов, где отображается статус ответа от Dadata (200) и возвращенное название компании.
Перенос задач между порталами
Перенос задачи на другой портал: Описание сценария передачи задачи с одного портала Bitrix24 на другой.
Переопределение клиента: Использование webhook для переопределения клиента Python SDK Bitrix24.
Настройка webhook: Создание статичного входящего webhook на целевом портале с указанием домена и части статического токена.
Параметры задачи: Определение заголовка, описания и ответственного лица задачи, где заголовок и описание берутся из входящих параметров Activity.
Исходящий параметр: Запись идентификатора созданной задачи для дальнейшего использования, например, для добавления комментария.
Создание задачи: Прямое создание новой задачи через Python SDK Bitrix24 без предварительной проверки существования (упрощенный подход).
Тестирование: Успешное выполнение кода с созданием задачи на целевом портале.
Работа с роботом в Битрикс24
Добавление робота в CRM: Демонстрация процесса добавления робота в раздел "Сделки" CRM Bitrix24.
Поиск и выбор робота: Использование поиска в интерфейсе Bitrix24 для нахождения роботов приложения по его названию.
Пример робота: Добавление действия "Получить сумму по сделкам" с входящим параметром — идентификатор направления сделок.
Настройка уведомления: Добавление уведомления для отображения итоговой суммы по сделкам, выбор получателя сообщения и параметра результата.
Логи выполнения: Доступ к логам выполнения для всех Activity, полезным для диагностики ошибок при нештатных ситуациях.
Порядок выполнения: Настройка последовательности выполнения робота и уведомления, учитывая время работы робота.
Тестирование в CRM: Сохранение настроек, перемещение сделки на стадию с роботом и получение уведомления с итоговой суммой и логами.
Результат выполнения: Подтверждение получения уведомления с суммой по двум сделкам и соответствующими логами.
Отправить заявку