Типы приложений в Битрикс24

Один из самых быстрых и эффективных способов прокачать свой Битрикс24 и получить новые инструменты — это создать свое приложение.

Глобально все приложения для Битрикс24 можно разделить на два вида:

1. Тиражные разрабатываются для решения задач, которые возникают у многих пользователей Битрикс24, размещаются в Маркете, их могут скачать все
2. Локальные добавляются непосредственно на конкретном Битрикс24, выполняют точечные задачи конкретной компании

Типы тиражных приложений для Битрикс24

Раньше было всего 3 типа тиражных приложений, но по мере развития Битрикс24 появлялись новые типы, так что теперь их 6:

1. Статичный архив
2. Ссылка на приложение на сервере
3. Предустановленная CRM
4. Умные сценарии
5. Лендинги на Сайты24
6. Отчёты в BI-конструкторе

Статичный архив

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

Если потребуется разработать для Битрикс24 приложение Калькулятор, оно будет статичным архивом, так как будет использовать только введенные пользователем значения и не потребует ничего более.

Ссылка на приложение на сервере

Такие приложения требуют больше данных и доступов для работы, поэтому хранятся не в архиве на вашем портале, а на сервере, там же они работают.

При добавлении такого приложения в Маркет разработчик обязательно должен указать ссылку на приложение на сервере.

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

Если у приложения подразумевается возможность задавать пользовательские настройки, то эта ссылка приведет пользователя на страницу с этими самыми настройками.

Предустановленная CRM

Предустановленная CRM это готовое решение для определенной сферы деятельности. В таких решениях обычно реализованы самые востребованные для конкретного бизнеса функции, автоматизированы типовые бизнес-процессы, подготовлены шаблоны документов и т.д.

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

Умные сценарии

Это достаточно простой по сути тип приложений. Битрикс24 позволяет создавать умные сценарии на базе роботов. Роботы это инструмент для автоматизации процессов. Объединив несколько роботов для решения конкретной задачи, вы получите умный сценарий. Созданный сценарий можно сохранить и быстро запускать из контекстного меню CRM. А можно выгрузить в Маркет и потом легко развернуть на другом портале.

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

Лендинги на Сайты24

Тут все совсем просто. В Битрикс24 есть конструктор сайтов, а в Маркете есть огромное количество готовых сайтов и лендингов, собранных на этом конструкторе.

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

Отчёты в BI-конструкторе

Не так давно в Битрикс24 появился BI-конструктор, позволяющий создавать мощные отчеты и проводить детальную аналитику работы компании по различных показателям.

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

Технически готовый отчет это архив, который распаковывается на вашем портале. Отчету требуется доступ к данным, доступ у вас запросят при установке. А сразу после установки вы получите новый удобный инструмент аналитики.

Типы локальных приложений для Битрикс24

Локальными называются приложения, которые описываются и добавляются непосредственно на конкретном Битрикс24. Именно в этом суть термина локальный. Администратор портала решает, какие права дать такому приложению и как оно будет называться в интерфейсе.

Существует два вида таких приложений.

Статичные

Статичные приложения состоят на основе HTML/JS. Фактически, на основе этих технологий вы можете реализовывать приложения-одностраничники, обращаясь к REST API при помощи SDK на JS. В интерфейсе они представлены в виде отдельной страницы, с ссылкой из левого меню. Статичные приложения не могут получать события Битрикс24.

Код представленный ниже, нужно сохранить в файл index.html, и запоковать в архив index.html.zip это и есть готовое приложение, обращающееся к REST API и показывающее ФИО текущего пользователя:

index.html<!DOCTYPE html>
<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>
        // Make a call to REST when JS SDK is loaded
        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());
            });
            console.log('B24 SDK is ready!', BX24.isAdmin());
        });
    </script>
</body>
</html>

Установить локальное приложение можно из раздела Разработчикам:

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

После сохранения новое приложение будет показано в списке интеграций. Запущенное приложение выведет ФИО текущего пользователя, получая его по REST API библиотеки JS.

Серверные

Серверные приложения с back-end на любых подходящих языках программирования. Они могут обращаться к REST API, используя протокол OAuth 2.0, а также получать события от Битрикс24 в свои обработчики.

Представлены в интерфейсе в виде отдельной страницы, а также в виде встраиваемых popup-диалогов в доступных для встраивания объектах Битрикс24. Есть вариант, когда приложение никак не проявляет себя в интерфейсе, но использует REST API.

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

Если галочка не активна, в Битрикс24 появится страница которая через frame вставит страницу из поля Путь вашего обработчика.

Пример состоит из библиотеки SDK CRest, файлы с примером вы должны разместить на своем веб-сервере до добавления приложения в свой Битрикс24.

Готовое приложение нужно скачать и сохранить на своем веб сервере.

Установить локальное приложение можно из раздела Разработчикам:

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

Опция Приложение использует только API указывает Битрикс24, что ваше приложение не будет показывать пользовательский интерфейс внутри Битрикс24. Приложение, у которых включена опция Приложение использует только API, либо предоставляют пользовательский интерфейс по какому-то своему URL, либо вообще не предоставляют пользовательский интерфейс.

В поле Путь для первоначальной установки, указали install.php из архива с примером. Этот URL вызывается только один раз при сохранении формы локального приложения. Именно этот URL служит обработчиком события ONAPPINSTALL, в котором мы и сохраняем токены пользователя, установившего приложение. URL представляет собой некий мастер установки приложения с любой необходимой бизнес-логикой: формой настройки, информационным интерфейсом и т.д. Также этот URL можно использовать для инициализации и создания нужных объектов в Битрикс24. Например, можно установить обработчики событий, зарегистрировать виджеты, добавить провайдера платёжной системы или кассы:

Поскольку приложение без интерфейса работает вне Битрикс24, то оно должно реализовывать полный протокол авторизации OAuth. Откройте файл settings.php и заполните константы с кодом приложения C_REST_CLIENT_ID и секретным ключом C_REST_CLIENT_SECRET, полученными при сохранении формы.