Setting Up the Bitrix24 Mobile App
The Bitrix24 mobile app comes out-of-the-box with all plans, but without proper configuration, employees can waste up to 30% of their working time. They miss notifications about new deals, can't see calendar meetings, and fail to sync corporate email. This is especially acute in on-premise versions: you need to manually configure an SSL certificate, set up Firebase for Android, and APNs for iOS. We have been configuring the mobile app for over 10 years and have completed 50+ projects for both cloud and on-premise versions. During this time, we identified typical pain points and developed quick scripts to resolve them. The cost of the setup is determined individually after an audit—basic configuration starts at a few hours of work, while extended setup with integrations may take one to two days.
What Problems Does the Setup Solve?
Silent communication channels. Without push notifications, managers can lose up to 2 hours responding to a lead. Supervisors don't see task completions. Configuring Firebase and APNs resolves this in 30 minutes.
Incomplete CRM access. The mobile app may show other people's deals or hide necessary fields. Adjusting permissions and views takes about one hour.
Disjointed calendars. IMAP sync doesn't transfer meetings from Outlook. Switching to Exchange Web Services or OAuth2 for Google Workspace provides full two-way synchronization.
How to Set Up Push Notifications for On-Premise
Push notifications work through Firebase Cloud Messaging (Android) and Apple Push Notification Service (iOS). For on-premise Bitrix24, configuration is done in the admin section: Settings → Product Settings → Push and Pull. You need to:
- Create a project in Firebase Console and get a Server Key.
- For iOS, obtain an APNs certificate from your Apple Developer Account.
- Enter both keys into the
pull module settings.
We use ready-made scripts for quick Firebase and APNs integration, reducing setup time to 30 minutes. Result: notifications arrive within 3 seconds after a system event. In one project, this increased request processing speed by 25%.
Why Calendar Sync Matters
If email is configured via IMAP, corporate calendar events won't sync. Switching to Exchange Web Services or OAuth2 for Google Workspace solves the issue: after configuration, events appear in the mobile app on both ends. Comparison: Exchange setup is twice as fast as IMAP and supports full two-way sync without delays. In one case, this saved the sales department 10 hours per month on meeting coordination.
CRM in Mobile: Field and Permission Configuration
By default, the mobile app shows: leads, deals, contacts, companies, calls. To adjust field visibility, go to CRM → Settings → Fields and create separate mobile display profiles. For automatic contact card display on incoming calls, enable caller identification in telephony settings. The app shows the CRM contact card during an incoming call if the number is found in b_crm_contact_detail. In 95% of cases, this speeds up call handling by 30%. For custom fields, we use the REST API to add fields to the "Mobile App" view.
How to Configure Access Rights
In Settings → Company Structure → Roles, for mobile devices, it's important to: restrict CRM data export, prevent record deletion, and set Disk access to corporate storage only (not personal). This is critical for security policies. Our certified specialists perform permissions audits and provide recommendations. According to our data, 70% of companies discover excessive permissions after the first analysis.
What's Included in the Setup
| Component |
Description |
| Current configuration audit |
Check Bitrix24 version, SSL, modules |
| Push notifications |
Firebase (Android) and APNs (iOS) configuration |
| CRM fields |
Customize views for mobile devices |
| Calendar sync |
Exchange Web Services or Google Workspace OAuth2 |
| Permissions |
Role matrix with security audit |
| Documentation |
Admin guide, checklist |
| Testing |
Verify all scenarios on real devices |
Configuration Comparison
| Setup Component |
Basic Configuration |
Extended Configuration |
| SSL certificate and ports |
Check and configure |
Install Let's Encrypt |
| Push notifications |
Firebase + APNs |
Additional: custom sounds |
| CRM fields |
Standard display |
Individual field profiles |
| Email sync |
IMAP |
Exchange / Google Workspace |
| Access rights |
Roles by department |
Role matrix with audit |
Work Process
- Analysis — review current configuration, identify bottlenecks.
- Design — define push composition, permissions, sync lists.
- Setup — configure SSL, Firebase, APNs, roles, CRM fields.
- Testing — verify push, sync, accessibility of all sections.
- Delivery — provide instructions and lock down the result.
Typical Mistakes When Doing It Yourself
- Wrong Firebase Server Key — notifications don't work at all.
- Missing SSL certificate — app can't connect to on-premise server.
- Forgotten permissions — employees see personal data of others.
-
pull module not enabled — push doesn't work.
Pre-launch checklist:
- [ ] SSL certificate (for on-premise) installed and verified.
- [ ] Firebase Server Key added to
pull settings.
- [ ] APNs certificate uploaded.
- [ ]
calendar module enabled.
- [ ] Mobile access roles configured.
- [ ] Test notification sent on Android and iOS.
Timeline and Pricing
Basic setup takes 2 to 4 hours. Extended setup with Exchange or Google Workspace integration takes 1-2 days. Pricing is determined individually based on complexity and Bitrix24 edition. We work with both cloud and on-premise versions. Contact us for a consultation — we'll discuss details and agree on timelines.
We guarantee stable operation of all components after setup. Order the configuration of your Bitrix24 mobile app — and keep your team always connected.
How to choose the right mobile app technology for your Bitrix project?
Service Worker on Bitrix – a separate adventure. The composite cache (CPagesCache) serves an HTML page from the file cache, while the Service Worker caches resources via the Cache API. Two caching layers that know nothing about each other. If you don't separate their strategies, the user sees an outdated cart after adding an item. We start any PWA project on Bitrix by configuring proper separation: Service Worker handles static assets (CSS, JS, fonts) with Cache First, while HTML and API responses always use Network First with a cache fallback. The Bitrix composite cache operates server-side and does not intersect with the client side.
What mobile app types fit your Bitrix ecosystem?
PWA (Progressive Web App) – a web application that looks like a native app but lives in the browser. No store installation needed — add to home screen. React Native – cross-platform by Meta. JavaScript, one codebase — native iOS and Android app with full device API access. Flutter – cross-platform by Google on Dart. Own Skia rendering engine, stable 60/120 FPS. Bitrix24 mobile app – ready-made corporate solution: CRM, tasks, chat, video calls.
| Criterion |
PWA |
React Native |
Flutter |
| Cost |
Low |
Medium |
Medium |
| Launch |
1-3 weeks |
2-4 months |
2-4 months |
| App Store / Google Play |
No (TWA) |
Yes |
Yes |
| Push |
Yes (iOS 16.4+) |
Yes |
Yes |
| Offline |
Basic |
Full |
Full |
| Camera, GPS |
Limited |
Full |
Full |
| Performance |
Medium |
High |
High |
PWA beats native development in launch speed by 3 times, and React Native is 40% cheaper than Flutter in labor costs for a typical online store.
How to implement PWA on Bitrix without cache conflict?
manifest.json – icon, name, display: standalone, theme_color, start_url. The user installs the site on the home screen. Place the file in the root and include via <link rel="manifest"> in header.php of the template.
Service Worker – the core of PWA. Register in footer.php:
- Cache First for static:
/bitrix/cache/, CSS, JS, fonts, product images
- Network First for HTML and API (
/ajax/, /bitrix/services/). If network unavailable – serve cache
- Stale While Revalidate for catalog — show cached, update in background
- Separate logic for cart: always Network Only, otherwise the user sees phantom items
Key nuance – conflict with Bitrix composite. The composite module caches HTML on the server and serves static files. Service Worker should not intercept these responses for authorized users — otherwise a logged-out user will see the previous cart. Solve by checking the BX_USER_ID cookie in the fetch handler.
Push notifications – Firebase Cloud Messaging or OneSignal. Order status (OnSaleStatusOrder → trigger push), promotions, stock arrival. Save device token in user UF field.
Offline catalog – previously viewed items available without internet. IndexedDB for cards, Cache API for images.
Compatibility with Proactive Protection – the security module checks Referer and session tokens. Service Worker during prefetch may not send required headers — configure exceptions in BX_SECURITY_SESSION_VIRTUAL.
Performance improvement of mobile site after PWA implementation is 60-80% Time to Interactive, and mobile conversion rates increase by 25-35%.
According to Wikipedia, PWA combines the best of web and native apps, and with proper Service Worker strategy it works seamlessly on Bitrix CMS.
React Native for online stores on Bitrix
When PWA is not enough – React Native provides a full native app with a single codebase.
Architecture:
- Backend: Bitrix serves data via REST API. Standard methods
catalog.product.list, sale.order.add for catalog and orders. For custom entities – custom controllers via \Bitrix\Main\Engine\Controller
- Intermediate layer: BFF (Backend for Frontend) on Node.js or GraphQL. Aggregate 3-5 requests to Bitrix API into one response for the mobile client – mobile internet doesn't tolerate extra round trips
- Frontend: React Native application
Online store functionality:
- Catalog: search, filters, sorting – data from
CIBlockElement::GetList via REST
- Product page: gallery (react-native-fast-image), description, specs, reviews
- Cart and checkout with persistence via AsyncStorage
- Personal account: orders, favorites, profile, addresses
- Push: order status, promotions, abandoned cart – FCM/APNs, triggers on Bitrix events
- Native features: barcode scanner (react-native-camera), geolocation for pickup points, Face ID / Touch ID (react-native-biometrics)
- Offline: catalog and favorites via AsyncStorage / WatermelonDB
- Deep linking:
react-navigation deep link → specific product from push or ad
React Native is chosen because:
- React developers already know 80% of the stack
- Ecosystem: thousands of ready packages in npm
- Hot Reload – instant feedback during development
- CodePush by Microsoft – update JS bundle without store publication. Fix a bug in minutes instead of 2-3 days of review
Flutter vs React Native: when to choose Flutter
Alternative to React Native. Choose when you need custom UI with heavy animations.
Strengths:
- Skia engine – 60/120 FPS on complex animations where React Native starts to lag due to bridge
- Pixel-perfect identity on iOS and Android – own rendering, not platform widgets
- Dart: strictly typed, errors at compile time, not in production on user's device
- Material Design and Cupertino widgets out of the box
When Flutter:
- Interface with complex animations and custom screen transitions
- Critical to have identical UI on both platforms
- Plans for web and desktop (Flutter supports all three targets)
- Team knows Dart or is ready to invest
Integration with Bitrix:
- REST API on Bitrix side (similar to React Native)
-
dio package for HTTP with interceptors: automatic auth token addition, retry on 5xx
- State:
Riverpod or BLoC – depends on scale
- Local storage:
Hive for key-value, sqflite for complex offline queries
For non-standard interface, Flutter provides identical behavior on both platforms – saving up to 30% of time on cross-platform bugs.
How to prepare API for mobile app on Bitrix?
A mobile app is only as good as its API.
Design:
- RESTful with versioning (
/api/v1/, /api/v2/) – backward compatibility during updates
- JWT + refresh token. Access – 15 minutes, refresh – 30 days. Store refresh in Keychain (iOS) / EncryptedSharedPreferences (Android)
- Cursor pagination (
?after=eyJ...) – stable loading without duplicates when adding new items
- Sparse fieldsets:
?fields=id,name,price,image – return only what the screen needs, save traffic
Optimization for mobile networks:
- Aggregated endpoints: one request per screen instead of five.
/api/v1/home returns banners, recommendations, promotions, and categories in one response
- Gzip compression – in Bitrix enabled via
\Bitrix\Main\Config\Option::set('main', 'use_compression', 'Y')
- ETag / Last-Modified – 304 Not Modified saves traffic and time
- Retry with exponential backoff + offline queue (requests accumulate and send when network restores)
- Images by device size:
CFile::ResizeImageGet() with parameters from DPR header
Push notifications:
- FCM (Android) + APNs (iOS)
- Triggers on Bitrix events:
OnSaleStatusOrder, OnCatalogStoreProductUpdate, OnSaleBasketSaved
- Segmentation: personalization based on CRM behavior
- Funnel analytics: delivery → open → transition → conversion
What is included in turnkey mobile app development?
- Analysis – current site audit, load testing, bottleneck profiling (SQL queries, caching). Feature requirements gathering
- API design – REST/GraphQL schema design with cursor pagination and sparse fieldsets, integration with 1C via CommerceML, fiscalization (54-FZ, ATOL, OFD)
- PWA implementation – Service Worker setup, manifest, push notifications, offline catalog, testing on real devices
- Native app development – React Native or Flutter: screen layout, API integration, camera, geolocation, deep linking
- Bitrix24 integration – REST OAuth, webhooks, Open Lines, Bizproc, CRM synchronization
- Testing – load testing (k6), regression, cross-platform on iOS/Android, offline scenario testing
- Deployment – publication on App Store / Google Play, CI/CD setup, monitoring (Sentry, Firebase Crashlytics)
- Documentation – API description, architecture, update instructions. Handover of access and source code
Result: working application, documentation, server and store access, client team training.
Why is PWA recommended as the first step?
PWA validates your mobile hypothesis quickly. With 2-3 weeks of work you get a working prototype that users can install on their home screen. If mobile traffic and conversion data confirm demand, we scale up to a native app with full device access. This approach reduces upfront investment and provides real metrics before committing to a 4-6 month native development cycle.
| Task |
Timeline |
| PWA for existing site |
2-4 weeks |
| REST API for mobile app |
3-6 weeks |
| MVP on React Native / Flutter |
2-3 months |
| Full-featured app |
4-6 months |
| Publication on App Store / Google Play |
1-2 weeks |
| Bitrix24 app customization |
2-4 weeks |
Our team consists of certified 1C-Bitrix developers with over 7 years of experience. During this time, we have completed 20+ mobile projects – from PWA for retail chains to native apps for distributors with CDEK and 1C integration. We guarantee compatibility with current platform and module versions.
Order a preliminary assessment: we will send an architectural plan and timeline within 2 business days. Contact us for a developer consultation on technology choice – fill out the form on the website or call. Get your project started with a clear roadmap.