Выгрузка товаров из сделок Битрикс24 в Google Sheets (построчно с указанием их количества)
Сегодня делимся не совсем обычным кейсом для клиента, который запросил нестандартную кастомизацию отчета по сделкам: выгрузку товаров из сделки построчно, а не в одной ячейке, с указанием их количества. Стандартный метод авторизации в Битрикс24 для него недоступен, поэтому мы использовали вебхук. Подробности читайте далее.
1. Ситуация. Боль. Решение
В чем заключается специфика данного кейса?
Чтобы настроить автоматический импорт товаров из сделок Битрикс24 в Google Sheets (построчно с указанием их количества) воспользуемся интеграционной платформой Пинкит. Для этого потребуется регистрация в личном кабинете и нужно установить приложение Пинкит из Маркета Битрикс24.
Но так как клиент не мог установить приложение из Маркета, где размещена наша платформа, мы предложили другой способ, как настроить связку Битрикс24 + Пинкит: делаем авторизацию через вебхук (инструкция здесь).
Про вебхуки мы уже писали ранее, они закрывают множество бизнес-сценариев. Вебхук добавляется через доступы, генерируется авторизационный токен и затем данные можно отправить из Битрикс24 в любой другой сервис по API: в Тильду, таблицу Гугл, МойСклад и так далее.
Сама же суть автоматизации проста: клиенту нужно выгружать в таблицу Гугл для отчетов данные из сделок и смарт-процессов при их создании и обновлении. Только есть нюанс: все товары из сделок должны попадать не в одну ячейку через запятую, а выгружаются в отдельные ячейки столбца "Товары" сверху вниз с указанием их количества в сделке.
Также клиенту для оптимизации планирования нужна визуализация данных в виде дашбордов по затраченному времени сотрудников. Такие отчеты в разрезе менеджеров помогут понять, на какие задачи уходит больше всего времени, чтобы дальше руководитель мог принимать оптимальные управленческие решения.
Для этого воспользуемся стандартной настройкой интеграции Пинкит, которая будет выгружать тайминг по задачам из Битрикс24 в таблицу Google.
Расскажем далее подробнее о настройке интеграции.
2. Настройка интеграции Битрикс24 и Гугл Шитс с помощью вебхука
2.1. Добавляем вебхук: в личном кабинете Пинкит в разделе Доступы выбираем Webhook, указываем название доступа и нажимаем кнопку "Предоставить доступы":
2.2. Далее можно использовать вебхук в интеграции. Добавляем интеграцию в разделе Интеграции и настраиваем ее:
2.2.1. На шаге 1 "Откуда" указываем источником Битрикс24, авторизованный через вебхук. "Когда" - выбираем событие (для клиента нужна выгрузка при создании сделки и смарт-процесса, а также при обновлении сделки), и выбираем преднастроенный доступ к Битрикс24 через вебхук.
2.2.2. Шаг 2 - "Инструменты": здесь можно обработать данные, которые пришли из вебхука, разными инструментами Пинкит. Это может быть запрос, фильтр и так далее. Мы используем инструмент преобразования массива для выгрузки товаров построчно.
2.2.3. Шаг 3 - "Куда": данные будем выгружать в сервис Google Sheets. Для каждой операции (например, создание сделки) будем создавать новую строку, для каждого товара в сделке - также отдельную строку с указанием количества. Выбираем таблицу и лист и подключаем доступы к аккаунту Гугл Шитс.
2.2.4. Шаг 4 - "Сопоставление данных": здесь настраиваем соответствие поля сущности Битрикс24 и столбца таблицы (например, "Товар") или Название смарт-процесса.
2.2.5. Шаг 5 - "Запуск": указываем название и запускаем интеграцию. Готово!
Пинкит не ограничивает вас в выборе сервисов, а если в нем отсутствуют какие-то необходимые действия, мы добавляем их недельным спринтом.
Так мы сделали для нашего заказчика инструмент преобразования массива в JSON для построчной выгрузки товаров, который теперь доступен и для решения ваших задач :)