Cubic VisionPRO, на главную
Большая видеопанель в атриуме офиса показывает новость компании из ленты Битрикс24: фотография с корпоративного события и короткий заголовок, мимо идут сотрудники

Интеграция с Битрикс24

Данные Битрикс24 на корпоративных экранах

Cubic Studio подключается к Битрикс24 через REST API с авторизацией по входящему вебхуку. Новости, данные сотрудников, события и сделки используются в экранных макетах с заданным оформлением, отбором и расписанием.

Лента компании из Битрикс24 на экране в атриуме: что опубликовано в портале, то и на панели

Архитектура интеграции

Единый источник для портала и экранов

Интеграция использует данные корпоративного портала в проектах Cubic Studio. Состав полей, оформление и периодичность обновления задаются при настройке; режим получения данных выбирается с учётом сетевой архитектуры объекта.

Использование данных портала

Доступны новости компании, карточки сотрудников, календарь и сделки CRM. Состав получаемых данных ограничен правами учётной записи вебхука; состав выводимых полей настраивается в проекте.

Повторное использование источника

Несколько виджетов могут использовать один настроенный источник. Пакетные запросы сокращают число обращений к порталу. При обновлении на плеерах нагрузка зависит от числа устройств и интервалов опроса.

Ключ вебхука остаётся у оператора

По умолчанию Cubic Studio запрашивает данные у портала при публикации, а на плеер передаются только результаты запроса. Обновление непосредственно на устройстве включается отдельно, и вместе с ним ключ вебхука входит в состав пакета публикации.

Последний полученный набор данных

При недоступности портала виджет сохраняет предыдущий результат. Допустимый срок актуальности информации и порядок действий при сбое необходимо определить до ввода системы в эксплуатацию.

Сценарии

Сценарии применения

Данные одного портала можно использовать в проектах для разных зон. Для каждого экрана задаются состав информации, оформление и расписание показа.

Корпоративное телевидение в холле

Лента компании на большой панели у входа: заголовок, фотография, автор и дата. Запись, опубликованная в портале, выводится на экран при следующем обновлении данных.

Внутренние коммуникации и важные объявления

Отбор по признаку «важное», который проставляет автор записи в портале: на экран попадают только помеченные публикации, остальная лента остаётся в браузере у сотрудников.

Дни рождения сотрудников на экране

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

Юбилеи стажа и новые сотрудники

Годовщины работы в компании и представление новых коллег — два отдельных экрана на тех же карточках сотрудников. Срок, в течение которого сотрудник считается новым, задаётся в днях.

Экран отдела продаж

Сделки со стадиями, суммами и ответственными менеджерами выводятся таблицей на панель над рабочими местами. Данные берутся из воронки за последние 90 дней.

Календарь событий и переговорные

Ближайшие планёрки, обучение и общие собрания из календаря компании; брони переговорных — на панели у двери. Оба набора выводятся таблицей и бегущей строкой.

Видеопанель в зоне отдыха показывает ленту новостей компании из Битрикс24 тремя карточками с фотографиями, авторами и датами

Лента компании

Новости портала в четырёх подачах

Одна и та же лента требует разного оформления в зависимости от того, где установлен экран и с какого расстояния его читают. Подача переключается в свойствах виджета, переделывать слайд не нужно.

  • «Лента» — список карточек с фотографией автора и датой: универсальная подача и для узкой колонки, и для целого экрана
  • «Главное» — одна новость крупно с автоматическим перелистыванием: для холла, где экран читают с пяти-десяти метров
  • «Плитки» — сетка карточек с постраничным перелистыванием: для широкой панели в зоне отдыха
  • «Строка» — бегущие заголовки в узкой полосе внизу слайда, рядом с основным контентом
  • Отбор: только записи с признаком «важное» и исключение коротких реплик без заголовка
  • Автор, его фотография, дата и объём отрывка текста включаются по отдельности

Наборы данных

Какие данные портала доступны

Набор данных выбирается в карточке источника. Права выдаются при создании вебхука — Cubic Studio сообщает, каких прав не хватает выбранному набору, до публикации проекта на экраны.

Новости компании

Заголовок, текст, автор, дата публикации и признак «важное». Форматированный текст преобразуется в строки; записи без заголовка по умолчанию исключаются.

Права вебхука
Права: «Лента», «Пользователи»
Виджеты отображения
Показывает виджет «Битрикс24», вид «Новости»

Сотрудники

Имя, должность, отдел, фотография, дата рождения и дата приёма на работу. Текущая выборка ограничена 500 карточками; достаточность лимита проверяется для конкретного портала.

Права вебхука
Права: «Пользователи», «Отделы»
Виджеты отображения
Виды «Дни рождения», «Юбилеи», «Новые сотрудники»

Календарь компании

События на 30 дней вперёд: название, дата и время начала, место проведения. Подходит для анонса планёрок, обучения и общих собраний.

Права вебхука
Права: «Календарь»
Виджеты отображения
Таблица, Смарт-текст, Бегущая строка

Переговорные

Список переговорных и брони на неделю вперёд: время, продолжительность и автор брони. Основа для панели у двери переговорной.

Права вебхука
Права: «Календарь»
Виджеты отображения
Таблица, Смарт-текст, Бегущая строка

Сделки CRM

Сделки за 90 дней со стадиями воронки, суммами и ответственными менеджерами. Названия стадий берутся из настроек портала и не задаются повторно.

Права вебхука
Права: «CRM», «Пользователи»
Виджеты отображения
Таблица, Смарт-текст, Бегущая строка
Огромный экран в атриуме офиса во время общего собрания компании показывает объявление из ленты Битрикс24, сотрудники стоят перед ним силуэтами

Одно объявление на все экраны

Обновление содержания из корпоративного портала

Записи с выбранным признаком или отбором используются в соответствующих экранных макетах. Изменения появляются после следующего успешного обновления данных в настроенном режиме.

    Вертикальная видеопанель у ресепшн офиса показывает поздравление с днём рождения сотрудницы: портрет, имя и должность из карточки Битрикс24

    Сотрудники

    Дни рождения, юбилеи и новые сотрудники у ресепшн

    Три вида на одних и тех же карточках сотрудников портала. Они разделены намеренно: на экране это три разных сообщения, и размещают их обычно на разных слайдах и в разных зонах.

    • Подачи: список с портретами, сетка плиток и один сотрудник крупно с автоматической сменой
    • Период — от сегодняшнего дня до двух месяцев вперёд: поздравить вовремя и заранее подготовиться
    • Отбор по отделу: на экране цеха — сотрудники цеха, в головном офисе — весь портал
    • Должность и отдел выводятся по выбору, а вместо незаполненной фотографии показывается монограмма
    • Если дата приёма на работу в портале не заполнена, стаж считается по дате создания карточки — это включается отдельной настройкой
    • Срок, в течение которого сотрудник считается новым, задаётся в днях
    Тёмное табло над рабочими местами отдела продаж показывает сделки недели из CRM Битрикс24: менеджеры, суммы и общий итог

    Отдел продаж

    Сделки из воронки на панели над рабочими местами

    Данные CRM поступают из того же источника и выводятся Таблицей — виджетом, который уже умеет читать источник данных. Колонки, сортировка и оформление настраиваются в Cubic Studio.

    • Сделки за 90 дней: стадия воронки, сумма, ответственный менеджер и дата изменения
    • Названия стадий берутся из настроек портала — после переименования воронки меняется и подпись на экране
    • Бегущая строка внизу слайда для выигранных сделок, если отдавать экран целиком под показатели не нужно
    • Доступен только тот участок воронки, который открыт сотруднику, от имени которого создан вебхук
    • Экран показывает результат отдела, а данные по каждому сотруднику остаются внутри портала

    Подключение

    Настройка подключения к порталу

    Проверьте доступ к REST API и создайте вебхук с необходимыми правами. Источник, режим обновления и экранные макеты настраиваются в Cubic Studio.

    1. 1

      Входящий вебхук в портале

      Администратор создаёт входящий вебхук штатными средствами Битрикс24 и выдаёт права для выбранных наборов данных: ленты, пользователей, календаря или CRM.

    2. 2

      Карточка источника в Cubic Studio

      В библиотеке источников создаётся коннектор Битрикс24 — так источник называется в редакторе: адрес портала, ссылка вебхука, набор данных и интервал обновления. Ключ хранится в библиотеке на компьютере оператора.

    3. 3

      Проверка связи

      Studio показывает, к какому порталу выполнено подключение, название компании, от имени какого сотрудника выполняются запросы и какие права выданы вебхуку. Здесь же видно, каких прав не хватает выбранному набору данных.

    4. 4

      Режим обновления

      «Снимок при публикации» — данные обновляются при выгрузке проекта, ключ остаётся в Studio. «Обновлять на устройстве» — плеер запрашивает портал самостоятельно по заданному интервалу, и тогда ключ входит в состав пакета публикации.

    5. 5

      Виджет на слайде

      На слайд добавляется виджет «Битрикс24», выбирается вид и подача. Тот же источник одновременно доступен Таблице, Смарт-тексту и Бегущей строке — для данных, у которых готового оформления нет.

    Дальше действуют общие правила работы экранов: расписание и сценарии определяют, в какие часы вместо ленты выводится объявление, а остальные виджеты размещаются на слайде рядом с данными портала.

    Что учесть

    Условия внедрения

    До настройки необходимо проверить доступность API, права учётной записи, состав выводимых данных и режим сетевого доступа.

    Облако или коробочная версия

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

    Учётная запись, от имени которой создан вебхук

    Через вебхук доступны ровно те данные, которые открыты выпустившему его сотруднику. Для экрана разумно завести отдельную учётную запись с минимальными правами: лента и сотрудники — без доступа к CRM, если показатели продаж на экран не выводятся.

    Состав информации для каждой зоны

    Заказчик определяет допустимость показа сведений о сотрудниках и согласует необходимые основания для их использования. В проекте можно выбрать выводимые поля, настроить отбор по отделу и назначить отдельные макеты для внутренних и общедоступных зон.

    Периодичность обновления

    Интервал выбирают по требованиям к актуальности и допустимой нагрузке на API. Для новостей может быть достаточно обновления при публикации; для оперативных показателей нужен более частый опрос и контроль доступности источника.

    Проектирование

    Проектирование корпоративного вещания

    При внедрении согласуют аудиторию экранов, источники содержания и ответственность за публикацию. Интеграция обеспечивает получение данных; правила их использования задаёт заказчик.

    Состав экранной сети

    Определите зоны установки, количество видеовыходов, ориентацию панелей и режим работы. Эти параметры определяют выбор медиаплееров и состав проектов.

    Редакционная политика

    Укажите, какие публикации портала предназначены для экранов. Для общих и внутренних зон можно подготовить разные макеты и условия отбора.

    Аудитория и доступ

    Согласуйте состав сведений для посетителей, офисных сотрудников и производственных подразделений. Не все данные, доступные в портале, подходят для публичного показа.

    Экранные макеты

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

    Подключение REST API

    Администратор портала создаёт вебхук с необходимыми правами. В Cubic Studio настраиваются адрес, набор данных и режим обновления, затем проверяется доступ к выбранным полям.

    Эксплуатация интеграции

    Назначьте ответственных за права вебхука, доступность портала и актуальность материалов. Изменения учётной записи или сетевых правил требуют повторной проверки подключения.

    Вопросы

    Вопросы об интеграции

    Своего вопроса тут нет? Спросите — ответим по делу.

    Задать вопрос

    Интеграция входит в Cubic Studio. Доступность REST API и входящих вебхуков на стороне Битрикс24 зависит от редакции и действующих условий сервиса; их проверяют перед внедрением.

    Битрикс24 — товарный знак компании «1С-Битрикс». Cubic Vision PRO не является её партнёром или аффилированным лицом и не действует от её имени: интеграция выполнена через открытый программный интерфейс портала, доступный любому его владельцу.

    Техническая проверка подключения

    Согласуем тестовый набор данных, права вебхука и режим обновления. Покажем отображение информации в макете и проверим работу с вашим порталом.

    Обсудить проект