как создать локальное приложение битрикс24

Создание приложения для Bitrix24 с нуля

Для расширения функциональности Bitrix24 удобно использовать приложения. В данной статье описано создание с нуля локального serverless приложения.

Для установки нашего приложения нам понадобится собственно портал bitrix24, в котором мы обладаем правами администратора или правом установки и редактирования приложений.

Если такого портала нет — создать его можно здесь.

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

Официальная javascript-библиотека

Создадим папку с произвольным названием и в ней единственный пока файл index.html со следующим содержанием (исходный код):

Помещаем файл index.html в zip-архив и указываем этот архив в качестве значения поля Загрузите архив с вашим приложением (zip)* в диалоге создания приложения.
Затем нажимаем кнопку «Сохранить»

Посмотрим, что у нас получилось.

Кликаем по Перейти к приложению и видим… пустое место на месте нашего приложения.

Все необходимое для нас на данном этапе находится сейчас в консоли разработчика.

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

Официальная javascript-библиотека c promise

Использование callback-функций имеет свои преимущества, но не всем нравится или не всегда подходит к ситуации.
Поэтому попробуем получить тот же результат в promise-стиле. Для этого изменим наш index.html (исходный код)

Опять архивируем, опять обновляем наше приложение, опять смотрим, опять все работает.

Инструменты разработки

В папке нашего проекта инициализируем npm:

Установим необходимые пакеты:

Состояние проекта после всех изменений можно посмотреть здесь.

Создадим в корне нашего проекта файл server.js

Создадим папки src и public
В папку public перенесем index.html и изменим его содержимое на:

В папке src создадим файлы

Если package.json еще не создан, выполним:

Добавим скрипты в package.json :

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

Завершим настройку среды разработки редактированием нашего приложения в Bitrix24.
Перейдем в диалог редактирования нашего приложения и укажем в поле
Укажите ссылку* значение http://127.0.0.1:3000/

Перейдите к просмотру вашего приложения:
Вы должны увидеть приветствие с именем текущего пользователя:

Если использовать официальную библиотеку, то отличаться будут только два файла:

Итоговый код проекта для использования официальной библиотеки здесь.

Ознакомиться со всеми возможными методами и возможностями API можно здесь.

Исходный код можно увидеть здесь.

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

UPD: желающих высказаться о 1С-Битрикс или Битрикс24 прошу сделать небольшое интеллектуальное усилие и осознать, что статья не о Битрикс24 и совсем не о 1С-Битрикс.
Это если в Питере прохожий объясняет другому, как пройти к Петропавловской крепости и тут третий вмешивается с репликой:
«Да тиран был ваш Петр I. Тиран и деспот. И усы у него дурацкие».

Если есть конструктивные замечания к коду в СТАТЬЕ или к подходам или к используемым паттернам — добро пожаловать.

Источник

Создание приложений на базе Битрикс24

Поделиться в социальных сетях:

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

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

Но часто даже этой функциональности бывает недостаточно, чтобы решить определенные точечные проблемы автоматизации. Если организация не хочет уходить с облака и связываться с самостоятельным циклом разработки в рамках коробочной версии портала, то тогда верным вариантом является поиск приложения на Маркетплейс Битрикс24, которое может закрыть пробел в функциональности.

Технически приложение представляет из себя PHP и JavaScript код, обращающийся по REST API к данным Битрикс24 и используемый базовый интерфейс платформы. Код, как правило, размещается на сервере поставщика приложения, что позволяет поставщику решения быстро решить техническую проблему при прямом обращении к нему.

Группы приложений для Маркетплейс Битрикс24

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

К первой группе можно отнести наше приложение «Запись на прием к врачу», появление которого было вызвано необходимостью дать нашим клиентам – медицинским организациям – удобный и практичный функционал для бронирования времени врачей, ведущих прием пациентов.

Приложение создавалось в то время, когда в стандартном функционале CRM портала Битрикс24 отсутствовала возможность бронирования ресурсов и было в полном смысле этого слова незаменимым.

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

Также данное приложение послужило «родителем» для других программ, в которых задействован учет ограниченных по времени ресурсов. Речь идет о решении управлении парком автотранспортных средств и записи клиентов в парикмахерские (барбершопы, салоны красоты).

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

Алексей Окара,
Учредитель Пинол

К приложению второй группы можно отнести интеграцию с системой почтовых и SMS-рассылок UniSender. На момент разработки уже существовало подобное решение по почтовым рассылкам от конкурирующей компании, но оно страдало рядом недостатков, в частности, невозможностью растягивания картинок в шаблоне сообщения. В итоге, было выпущено более продвинутое решение, обладающее рядом изюминок, которых нет даже в выпущенном позднее типовом модуле CRM-маркетинг: возможности ведения рассылок по базе сделок, сотрудников, инициации отправки сообщений из бизнес-процесса.

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

Мы вложили более миллиона рублей и сотни часов в разработку, чтобы создать удобное приложение с широким функционалом для интеграции сервиса UniSender с Битрикс24.

Аналогичным образом были выстроены партнерские отношения с системами онлайн-чатов LiveTex и заказа обратного звонка Callbackhunter, с которыми были сделаны интеграции.

Компания Пинол предлагает версии своих решений не только для Битрикс24, но и для других популярных CRM-систем: AmoCRM, bpm’online. Также мы подготовили удобное приложение Пинкит, обеспечивающее обмен данными Битрикс24 с различными приложениями.

Важно, что получить все эти решения с полным объемом функционала можно совершенно бесплатно просто приобретя платную подписку на облачное CRM-решение (или лицензию на коробочную версию) у компании Пинол.

В процессе эксплуатации решений у клиентов часто возникают пожелания по их доработкам. Например, к нам обратилась компания из Израиля с просьбой убрать галочку Согласия на обработку персональных данных в онлайн форме «Записи на прием к врачу», ибо эта галочка не требуется по локальному законодательству.

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

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

Если же речь идет о создании с нуля совершенно нового решения, например, интеграции Битрикс24 с ERP-системой отличной от 1С, то здесь имеет место следующий порядок действий:

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

Выводы

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

Если остались вопросы по созданию приложений в Битрикс24, задайте их в комментариях к данной статье. Если у Вас есть предложения по доработкам приложений или разработке нового, отправьте нам заявку на почту order@pinall.ru. Наш менеджер свяжется с вами в ближайшее рабочее время для согласования всех вопросов.

Заполните форму и мы проведем вам онлайн-встречу, где вы получите примеры реализации с кейсами внедрений:

Источник

Как создать локальное приложение битрикс24

—> Всем привет, сегодня речь пойдет про собственные приложения для CRM Битрикс24.
Опыт в интеграции с этой CRM у меня не большой, но кое о чем рассказать могу.
И так, передо мной стояли 2 задачи:
1) Сделать выгрузку всех новых лидов из CRM в сервис email рассылки
2) Сделать страницу на которой отображалось количество поставленных задач в этом месяце с разбивкой по рабочим группам.

Сегодня расскажу про первую задачу, а про вторую как-нибудь в другой раз.

Важный момент, если Вы хотите использовать 2 или 3 тип то Вам нужен SSL, вот как звучит фраза с официального сайта:
На стадии разработки и тестирования приложения нет необходимости иметь сервер,подписанный SSL сертификатом. Вполне достаточно самоподписанного сертификата, если добавить его в исключения браузера.
Я себе делал бесплатно на startssl

Добавляем приложение в Битрикс24
Выбираем для личного использования, придумываем название, если приложение 3-го типа, то отмечаем галочкой «Приложение использует только API», выбираем доступ к чему нам нужен и указываем ссылку например https://domain.com/test_b24/index.php (callback пока не надо)
В результате всего этого мы получаем:
Код приложения (CLIENT_ID): local.929774с857c2c8.15465789
Ключ приложения (CLIENT_SECRET): vСсSхWсiTK4Н4uНСRLС5Н3Pse3хWoqQiНnJхС5GJq2хС4q7XСO

Готовим наше приложение
Самый простой способ начать работать с Битрикс24 это скачать демо-приложение с официального сайта
Файлы закидываем на наш домен в папку test_b24 на которую мы указали при регистрации приложения. И приступаем к настройкам, в файле include/config.php
Вносим CLIENT_ID, CLIENT_SECRET, PATH, REDIRECT_URI и SCOPE(те разрешения которые мы хотим)
Дальше остается зайти на наш портал, авторизоваться через битрикс и всё. Мы получаем access_token с временем жизни в 60 минут. Что не сомненно мало. Тут и начинается отличие приложений 2-го и 3-го типа. Если бы это было приложение второго типа, то эти 60 минут нам бы не были страшны и человек заходящий на сайт обновлял бы токен. Но к нашему счастью в Б24 есть события.

События
В моем случае всё просто, я выполнияю

Источник

Два типа приложений для «Битрикс24»

«Битрикс24» представляет собой полный набор инструментов для организации работы компании. Здесь вы найдёте все необходимое для создания коммуникаций внутри коллектива, для управления задачами и проектами, для работы с различной документацией, CRM, средства связи и многое другое. Зачастую возникают ситуации, когда стандартными средствами облачного сервиса не получается решить ту или иную бизнес-задачу. С помощью открытого API клиенты и разработчики могут легко адаптировать «облако» под свои конкретные задачи, настраивая бизнес-логику.

При желании, инструментарий можно расширять с помощью самостоятельно разрабатываемых приложений, которые условно делятся на два типа:

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

Внутренние приложения

Внутренние приложения в своей работе используют HTML + JavaScript + CSS. Вы не сможете использовать такие средства как, например, PHP, mySQL и cron. Но это не означает, что можно создавать лишь простые приложения вроде «Производственного календаря». Вы вольны использовать в своём приложении любые JavaScript-фреймворки, например, jQuery. Есть возможность подключать удалённые библиотеки: скажем, с помощью Google Charts можно создавать разнообразные графические отчеты, как в приложении «Диаграммы и графики». Самое интересное в ней — публикация созданной диаграммы в «живую» ленту. Выглядит это следующим образом:

Данное сообщение получат все пользователи портала.

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

Данное сообщение получат только те пользователи, которые указаны в параметре SPERM.

Конечно, область применения внутренних приложений очень широка и не ограничивается этими примерами. С их помощью можно осуществлять всевозможные операции с данными. Например, выбрать все сделки по контрагенту за определенный интервал, вычислить их сумму и в зависимости от неё установить значение пользовательского поля «Процент скидки».

Вообще, связка REST API + HTML + JavaScript даёт широчайший простор для творчества при создании внутренних приложений для «Битрикс24». Проще перечислить ограничения. Например, нельзя использовать базу данных для сбора информации, нельзя использовать cron для запуска приложения или его функций по расписанию, не получится реагировать на события CRM или реализовать обмен с внешним сервисом.

Если вам нужно что-то из перечисленного, то потребуется создать внешнее (серверное) приложения.

Внешние (серверные) приложения

С точки зрения реализации внутренней логики принципиальной разницы между этими подтипами нет. Они отличаются лишь способом подключения к «Битрикс24» и продления доступа к данным.

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

Приложения, работающие вне интерфейса «Битрикс24», требуют определённых действий для подключения и продления ключей доступа. Оба эти процесса описаны в документации к REST API.

Одной из возможностей «Конструктора документов» является отправка файлов по электронной почте с привязкой отправления к сущностям CRM. Сделать это можно так:

Ещё один пример внешнего приложения — интеграция с сервисом «МойСклад». Здесь используется REST API «Битрикс24» и REST API сервиса «МойСклад». Приложение может работать в автоматическом режиме с помощью планировщика cron. В данном случае у нас два «сервера» («Битрикс24» и «МойСклад») и один «клиент» — приложение.

Оно позволяет создавать счета, которые привязываются к CRM и могут участвовать в дальнейшем обмене с 1С: Предприятие стандартными средствами «Битрикс24». Пример кода для создания отчёта:

PostUrl это вспомогательная функция, которая отправляет запрос на сервер.

В качестве примеров внешних приложений, работающих вне «Битрикс24», можно привести «Сканер визиток» и «Виджет для Android». Они оба работают на мобильных устройствах, но данные для своей работы берут из «Битрикс24». В качестве аналогии можно привести схему клиент-прокси-сервер. В данном случае «клиентом» выступает мобильное устройство, «прокси» — само приложение, а «сервером» — портал «Битрикс24».

Сервер

Для внешнего приложения понадобится свой сервер, где будут размещены ваши скрипты, БД и т.д.

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

Все данные, которыми оперирует серверное приложение, хранятся в специальном объекте типа «Хранилища» внутри каждого портала «Битрикс24». Приложение не собирает никаких персональных данных пользователя. Для работы с ним используется только электронная почта администратора портала, которая не имеет отношения к рабочим данным. Поэтому можно свободно размещаю приложение у западных провайдеров, не нарушая при этом закон 152-ФЗ.

В качестве сервера приложения можно использовать VPS под управлением Unix. Размер ОЗУ должен быть не менее 512 Мб. Жёсткий диск чем больше, тем лучше. Обязательно настройте резервное копирование и обязательно на другой диск.

Обратите особое внимание, что на сервере обязательно должен быть установлен SSL-сертификат. Очень важно установить все цепочки сертификата, дабы избежать ошибок при работе приложения. В качестве поставщика сертификата достаточно самого простого RapidSSL за 14,5 евро/год.

Платформа для разработки

Серверное приложение, конечно, можно разработать и на PHP+MySQL.

Для наших партнеров и разработчиков мы рекомендуем использовать привычную платформу «1С-Битрикс: Управление сайтом». У данного метода есть несколько преимуществ:

Источник

Как написать кастомную активити для бизнес-процесса для облачного Битрикс24

На зимней партнерской конференции 1C-Битрикс 2016г Олег Строкатый и Алексей Кирсанов показывали мастер-класс, в ходе которого разработали кастомную активити для бизнес-процесса под облачный Битрикс24. Информация по данной теме есть так же в курсе «Разработчик Bitrix Framework» (ссылки — в конце поста).

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

Кастомная активити для облачного Битрикс24 реализуется как приложение так называемого «второго типа». То есть php-файл с обработчиком активити и с ее установщиком должен лежать где-то на внешнем web-сервере, а Битрикс24 будет обращаться к нему по определенному адресу, например,

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

Для корректной работы такого приложения домен должен обладать SSL сертификатом (минимум Domain Validation (DV) Certificate). Вести разработку и тестирования приложения можно и без SSL сертификата, но он понадобится для реальной работы приложения, поэтому о нем стоит позаботиться заранее.

1.2 Структура приложения

В самом файле-приложении, прежде всего, необходимо сформировать скелет — структуру страницы приложения.

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

2 Какие данные мы получаем и как их проверить

Можно (и нужно) использовать и более сложные проверки с использованием регулярных выражений, но данный пост не о них.

3 Использование REST-api Битрикс24 на php

Далее нам понадобится php-функция, которая посредством curl будет посылать запросы к Битрикс24:

Если нам нужно будет вызвать rest-апи Битрикс24 из php-кода — мы далее можем использовать данную функцию:

4 Метод отладки приложения

Сразу встает вопрос: а как отлаживать наше приложение? Оно же выполняется у нас на сервере — значит мы можем смело все логировать в какой-то файл. Можно, например, использовать функции php fopen, fwrite, fclose. Ну а у нас на сервере тоже стоит Битрикс, поэтому нам нравится использовать функцию AddMessage2Log из битрикс-фреймворка (предварительно подключив заголовок).

5 Использование REST-api Битрикс24 на javascript

Мы можем вызывать rest-апи битрикс24 и через javascript. Следующим образом:

6 Создание и удаление простого активити

В частности нам нужны 2 javaскрипт обработчика для установки и удаления нашей активити (в данном примере мы создаем для облачного Битрикс24 активити, которая запрашивает идентификатор пользователя и возвращает бизнес-процессу его данные: телефон, skype и должность):

7 Логирование запросов и ответов на javascript

Если мы планируем размещать наше приложение в Маркетплейс Битрикс24, мы обязаны логировать все запросы и все ответы от Битрикс24 — не только те, которые посылаем из php-кода, но и те, которые мы посылаем из javascript

Если у нас на сервере тоже стоит Битрикс, можно использовать функции js библиотеки битрикс-фреймворка.

Скрипт-логгер, который мы дергаем по аяксу из нашего javascript может выглядеть так:

8 Не забыть вернуть ответ бизнес-процессу

Если объявляя активити, мы задали параметр ‘USE_SUBSCRIPTION’:’Y’ мы обязаны вернуть бизнес-процессу ответ, соответсвующий описанному для активити массиву выходных параметров RETURN_PROPERTIES. Для этого используем rest-api bizproc.event.send

9 Добавление приложения в портал

Чтобы добавить приложение в портал Битрикс24, его не обязательно публиковать в Маркетплейсе — можно добавить его только в свой портал — для использования только в этом портале. Для этого в левом меню облачного Битрикс24 выбираем пункт «Добавить приложение», далее выбираем «Для личного использования».

В открывшейся форме указываем название приложение, название пункта меню, указываем, права на доступ к каким подсистемам необходимы приложению. Если наше приложение добавляет активити в бизнес-процесс, то необходимо отмечать галку Бизнес-процессы. Указываем ссылку на файл приложения, лежащий на нашем сервере.

Добавленное приложение появляется в списке локальных приложений и в меню приложений.

На странице приложения в портале Битрикс24 у нас 2 кнопки, обработчики которых описаны в посте ранее. Одна кнопка устанавливает нашу кастомную активити, вторая — удаляет.

После установки активити появлется в редакторе бизнес-процесса.

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

10 Что будет, если удалить кастомную активити, которая включена в бизнес-процесс?

В этом случае бизнес-процесс перестанет отрабатывать корректно, а в редакторе бизнес-процесса данная активити будет подсвечена красным цветом.

Источник