битрикс 24 добавить приложение
Создание приложения для Bitrix24 с нуля
Для расширения функциональности Bitrix24 удобно использовать приложения. В данной статье описано создание с нуля локального serverless приложения.
Для установки нашего приложения нам понадобится собственно портал bitrix24, в котором мы обладаем правами администратора или правом установки и редактирования приложений.
Если такого портала нет — создать его можно здесь.
Заполняем следующие поля: | Название поля | Значение |
---|---|---|
Название приложения* | exampleApp | Или любое другое |
Russian (ru) | Пример приложения | Также можно заполнить значения для других нужных языков |
Пользователи (user) | отмечаем галочкой | Сейчас нам понадобится только это разрешения, но в дальнейшем разрешения для приложения можно будет корректировать |
Здесь нам нужно будет остановится, так как добавлять пока нечего. Оставим вкладку браузера открытой и приступим к созданию нашего приложения.
Официальная 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 добавить приложение
—> Всем привет, сегодня речь пойдет про собственные приложения для 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
Добавьте новые возможности в свой Битрикс24. В магазине приложений вы найдете готовые шаблоны для лендингов, решения для телефонии, банковских операций, платежных систем и чат-ботов.
В Битрикс24 можно работать даже без ноутбука и офисного компьютера. В этом вам поможет мобильное приложение Битрикс24, которое доступно для iPhone, iPad и Android-устройств.
Установите приложение на компьютер, чтобы работать над проектами и задачами, общаться с коллегами в чатах и по видеосвязи, обрабатывать заявки клиентов. Полная версия Битрикс24 всегда будет доступна на вашем рабочем столе.
Данный веб-сайт использует аналитические и технические cookie-файлы. Аналитические cookie-файлы используются для того, чтобы определить из какой страны или с какой веб-страницы пользователь перешел на веб-сайт, а также какие действия он производит на веб-сайте Технические cookie-файлы необходимые для надлежащего функционирования некоторых функций данного веб-сайта, таких как возможность использования чата в реальном времени. Отключение этих cookies-файлы приведет к отключению доступа к этим функциям и ухудшению качества работы веб-сайта.
Файлы cookie данных типов могут быть включены или отключены в этом плагине.
Мобильное приложение Битрикс24
В Битрикс24 можно работать не только на компьютере в офисе, но и вне офиса – из аэропорта, кафе, из любой точки, где есть Интернет. В этом вам поможет мобильное приложение Битрикс24.
Мобильное приложение Битрикс24 – это бесплатное приложение, работающее с iPhone, iPad и Android-устройствами.
Сейчас я вам расскажу, что же это приложение умеет.
Общение
Во-первых, это прежде всего о бщение – чаты с коллегами и чаты с клиентами (открытые линии):
Вы можете создать новый чат из мобильного приложения, также как в браузере или десктоп-приложении!
Для этого нужно просто нажать на иконку + в правом углу, выбрать тип чата (открытый или закрытый чат) и пригласить в него сотрудников.
В списке чатов появилась возможность закреплять и откреплять диалоги вверху списка – опция Закрепить/Открепить, а также скрывать диалоги – опция Удалить:
В групповых чатах можно еще выключать и включать уведомления с помощью опции Не следить/Следить в списке чатов. Такая же опция есть и в самом групповом чате:
В чат можно приглашать как по одному сотруднику, так и целый отдел или подразделение. А если вы владелец чата, то в нем можете назначить нового владельца, а так же исключить пользователей из чата.
Для этого откройте раздел участников чата и проведите справа на лево (свайп) по участнику и выберите нужный пункт.
Просматривайте ленту Новостей, комментируйте и лайкайте сообщения коллег. Отправляйте фотографии с телефона прямо в ленту. Формы создания сообщений специально адаптированы под iOS и Android:
Контакты
Под рукой у вас всегда есть полный и актуальный список контактов коллег. В мобильной версии Битрикс24 найти информацию о нужном сотруднике также просто, как и на портале – просто перейдите в главном меню в раздел Сотрудники:
Синхронизировать контакты телефона и портала можно в разделе Настройки > Синхронизация приложения.
Настройки
Все настройки приложения вы найдете в одном месте. Для этого перейдите на вкладку Еще и вверху вызовите меню настроек.
Настройки мобильного приложения разделены на несколько групп:
Настройки приложения
Получать уведомления – включает или выключает возможность получения push-уведомлений.
Интеллектуальная фильтрация – при включенной опции, пока вы работаете в десктопном приложении, в мобильное приложение не будут приходить уведомления. Полезно для экономии батареи.
Cчетчик приложения – эта настройка определяет, какие счетчики инструментов (например счетчики ленты Новостей или Чатов) будут влиять на общий счетчик приложения на иконке рабочего стола.
Также в этом разделе вы можете отключить ненужные типы уведомлений мобильного приложения в Сообщениях, Календарях, Чатах, Задачах и Телефонии.
Здесь можно создать профили синхронизации контактов и календарей.
На Android-устройствах это часть системных настроек, там дополнительно можно настроить синхронизацию более детально.
Настройки устройства
Тактильная вибрация – отключение или включение вибрации в приложении.
Использовать светлую тему – смена цветовой темы приложения.
Память – в данном разделе можно очищать кэш приложения и загруженных документов.
Файлы – здесь выбирается размер и качество отправляемых видеофайлов в ленту Новостей или в чаты.
Звук – вы можете настроить звук уведомлений.
Разрешения – в этом разделе вы можете управлять правами доступа к фото, камере, микрофону и геопозиции.
Версия приложения – информация о номере версии приложения.
Управление рабочим днем
Теперь вы можете начинать и завершать рабочий день, а также ставить перерыв прямо с мобильного телефона:
Управление задачами
В мобильном приложении можно создавать задачи, контролировать их выполнение, следить за статусами. В мобильных задачах доступны любые действия с задачами, которые есть в Битрикс24. Если в задачах прикреплены файлы, их также можно открыть на мобильном устройстве:
Работа с файлами
Мобильное приложение позволяет просматривать документы, презентации и изображения. Все, что доступно вам по правам на портале: ваши личные файлы, общедоступные файлы компании, файлы коллег и ваших групп. Поддерживаются популярные форматы и документы: TXT, PNG, PDF, JPG, XLS, XLSX, DOC, DOCX, PPT, PPTX. Также присутствует встроенный поиск – в текущей папке по заголовкам и названиям файлов:
Файлы можно загрузить с мобильного телефона как в Мой диск и потом прикрепить его из Диска в задачу, в сообщение в ленте Новостей или в чате, так и напрямую:
Если вы загружаете картинки или видео сначала в Мой диск, то такие файлы не сжимаются, т.е загружаются как оригинал.
Если вы загружаете картинки или видео напрямую в ленту Новостей, комментарии, задачи, в чаты, то такие файлы будут сжиматься. Это должно сильно сказаться на скорости загрузки. Качество загружаемого видео можно регулировать в разделе Настройки > Файлы приложения.
Можно выбрать до 10 разных разных файлов, а во время загрузки вы можете отменить передачу файлов.
Календарь
В мобильном Календаре выводятся актуальный список встреч, планерок, собраний и прочих мероприятий. Также с мобильного устройства вы можете принимать приглашения или отказываться от участия во встречах, создавать новые события и приглашать на них своих коллег:
Синхронизировать события календаря телефона и портала можно в разделе Настройки > Синхронизация приложения.
Мобильная CRM
Приложение позволяет работать с такими CRM-элементами как Дела, Контакты, Компании, Сделки, Счета, Предложения, Лиды, Товары. Можно завести новый лид или изменить статус сделки, находясь прямо на переговорах с клиентом:
В разделе Контакты можно быстро отсканировать визитку и завести новый контакт в CRM – все поля визитки автоматически распознаются и заносятся CRM, как новый Контакт или Компания:
Аудио- и Видеозвонки
Телефония Битрикс24 работает и в мобильном приложении! Если вам нужно лично и голосом пообщаться с коллегой, вы можете ему просто позвонить. А при звонке с клиентом вы можете сразу увидеть информацию о сделке из CRM. В Битрикс24 ведется запись разговоров, работает перенаправление звонка на другого сотрудника (перенаправление на мобильный телефон работает только из портала, с мобильного приложения перенаправить звонок пока нельзя), автоматическое направление звонка на ответственного и многое другое:
Аудио- и Видеозвонки работают через Wi-Fi, LTE, 3G, с поддержкой HD 16:9.
Опция Софтфон позволяет звонить клиентам прямо из мобильного приложения, используя телефонию Битрикс24 и интеграцию с CRM! Найти Софтфон можно в главном меню:
Группы
В мобильном приложении можно работать с группами Интранет и Экстранет:
Доступен просмотр активности группы, возможность написать сообщение в группу, создание и просмотр задач, файлов группы, а также загрузка файлов в Диск группы:
Мультипортальность
Мобильное приложение позволяет одновремено работать с несколькими Битрикс24. Для переключения между Битрикс24 нужно в меню нажать в верхнем меню на кнопку Сменить аккаунт и выбрать нужный портал:
Подключить еще один Битрикс24 можно нажатием на иконку +, ввести данные от нового Битрикс24, и он появится в списке:
В режиме редактирования аккаунтов можно либо удалить учетную запись из мобильного приложения, либо изменить параметры авторизации:
Уведомления
Уведомления можно сворачивать и разворачивать. Также есть функция удаления уведомления.
Где скачать?
И в конце концов возникает резонный вопрос – где же скачать это чудо-приложение? 🙂
Мобильное приложение Битрикс24 вы всегда можете бесплатно скачать из раздела Битрикс24. Приложение доступно для платформ: Android 4.4+ и iOS 11.0+.