Інтеграція Salesforce з мобільним додатком
Ви розробляєте мобільний додаток для відділу продажів, який має синхронізувати ліди, контакти, угоди та кейси з Salesforce. Стандартний підхід через Salesforce Mobile SDK додає 15+ МБ до розміру додатку та прив'язує до SDK, що не завжди зручно. Ми пропонуємо гнучку інтеграцію: від легкого REST-клієнта до повноцінної синхронізації з використанням Platform Events для real-time оновлень. Наша команда має 5+ років досвіду в мобільній розробці та інтеграції CRM — ми вже реалізували 20+ подібних проєктів під ключ.
Salesforce — зріла CRM-платформа з добре задокументованим REST API (https://developer.salesforce.com) та кількома SDK для мобільних. На відміну від 1С або Бітрікс24, тут менше неочікуваних обмежень API, зате більше концепцій для вивчення: Connected App, OAuth 2.0 flows, SOQL, SOSL, Apex REST, Platform Events. Ми гарантуємо, що інтеграція відповідатиме всім рекомендаціям App Store Connect та Google Play Console.
Як налаштувати Connected App та OAuth 2.0 для мобільного додатку?
Все починається зі створення Connected App у Salesforce Setup: App Manager → New Connected App. Вказуєте Callback URL (deeplink додатку), вмикаєте OAuth scopes: api, refresh_token offline_access.
Мобільний додаток використовує OAuth 2.0 Authorization Code Flow або JWT Bearer Flow для server-to-server. Для користувацького контексту — Authorization Code. Ми використовуємо перевірені бібліотеки: AppAuth для Android та ASWebAuthenticationSession для iOS.
На Android — AppAuth бібліотека:
val serviceConfig = AuthorizationServiceConfiguration( Uri.parse("https://login.salesforce.com/services/oauth2/authorize"), Uri.parse("https://login.salesforce.com/services/oauth2/token") ) val request = AuthorizationRequest.Builder( serviceConfig, clientId, ResponseTypeValues.CODE, Uri.parse("myapp://oauth/callback") ).setScope("api refresh_token offline_access").build() authService.performAuthorizationRequest(request, pendingIntent) Після обміну коду на токен зберігаємо access_token, refresh_token та instance_url — базовий URL для всіх API-викликів (у кожного Salesforce org свій піддомен).
REST API та SOQL: як отримувати дані ефективно?
Salesforce REST API — головний інтерфейс. Базовий URL: {instance_url}/services/data/v60.0/. Версію API обирайте під мінімально підтримувану Salesforce API версію у клієнта.
Запит через SOQL (Salesforce Object Query Language):
GET /services/data/v60.0/query/? q=SELECT+Id,Name,Amount,StageName,CloseDate,Account.Name +FROM+Opportunity +WHERE+OwnerId='{userId}'+AND+IsClosed=false +ORDER+BY+CloseDate+ASC+LIMIT+50 SOQL — SQL-подібна мова, але зі своїми обмеженнями: немає JOIN у звичному розумінні, пов'язані об'єкти через relationship query (Account.Name). LIMIT максимум 2000. Для великих наборів — queryMore з nextRecordsUrl з відповіді.
Створення запису — POST /services/data/v60.0/sobjects/Opportunity/ з JSON-тілом. Оновлення — PATCH /services/data/v60.0/sobjects/Opportunity/{id}. Важливо: Salesforce використовує PATCH, не PUT для оновлення.
Чому варто використовувати Platform Events для real-time оновлень?
Salesforce Platform Events — publish/subscribe механізм. Сервер публікує подію (OpportunityUpdated__e), клієнти отримують через CometD (Bayeux протокол, long polling).
Детальніше про CometD та реалізацію
На мобільному — Salesforce Mobile SDK або власна реалізація CometD. Mobile SDK включає готовий SFRestAPI та StreamingAPI клієнт. Але SDK важкий — 15+ МБ, що критично для деяких проєктів.
Легка альтернатива: кастомний CometD клієнт на OkHttp:
val cometdClient = BayeuxClient( "${instanceUrl}/cometd/60.0", LongPollingTransport.create(null, okHttpClient) ) cometdClient.handshake() cometdClient.getChannel("/event/OpportunityUpdated__e") .subscribe { message -> val payload = message.dataAsMap handleOpportunityUpdate(payload) } При оновленні угоди в Salesforce → Platform Event → CometD → мобільний клієнт оновлює екран. Latency: 1-3 секунди.
Порівняння підходів до інтеграції
| Критерій | Salesforce Mobile SDK | Кастомна інтеграція |
|---|---|---|
| OAuth | Вбудований | AppAuth / кастомний |
| Offline | SmartStore (SQLCipher) | Room / Core Data |
| Push | Вбудований | FCM/APNs напряму |
| Розмір | +15 МБ | Мінімальний |
| Гнучкість | Обмежена SDK | Повна |
| OAuth Flow | Застосування | Підтримка на мобільних |
|---|---|---|
| Authorization Code | Користувацький контекст, потрібен браузер | Так (AppAuth, ASWebAuthenticationSession) |
| JWT Bearer | Сервер-сервер (без користувача) | Ні |
| Client Credentials | Фонова синхронізація | Не рекомендується |
Як завантажити файли в Salesforce з мобільного додатку?
Файли в Salesforce — ContentDocument та ContentVersion. Завантаження файлу з мобільного додатку:
POST /services/data/v60.0/sobjects/ContentVersion/ Content-Type: multipart/form-data { "Title": "Фото клієнта", "PathOnClient": "photo.jpg", "FirstPublishLocationId": "{opportunityId}" } + binary data FirstPublishLocationId — об'єкт, до якого прив'язується файл. Обмеження: один файл за запит. Для завантаження кількох — послідовні запити або Salesforce Bulk API.
Що входить у роботу з інтеграції
- Аналіз поточної CRM-структури та вимог до синхронізації.
- Налаштування Connected App та OAuth-потоків (Authorization Code / JWT Bearer).
- Розробка REST-клієнта з кешуванням та обробкою помилок.
- Інтеграція Platform Events для real-time сповіщень.
- Тестування на тестовому та бойовому Salesforce-оргах.
- Документація по API та інструкція з розгортання.
- Підтримка після запуску (1 місяць).
Строки та вартість
Базова інтеграція (OAuth, SOQL-запити, CRUD для Opportunity/Contact): 1-2 тижні. Platform Events, offline-кеш, push-сповіщення: плюс 1-2 тижні. Повноцінний додаток з Salesforce Mobile SDK, SmartStore та синхронізацією: 1,5-2 місяці. Вартість розраховується індивідуально. Оцінимо ваш проєкт — пишіть, отримайте консультацію.