Интеграция Salesforce с мобильным приложением
Salesforce — зрелая CRM-платформа с хорошо задокументированным REST API и несколькими SDK для мобильных. В отличие от 1С или Битрикс24, здесь меньше неожиданных ограничений API, зато больше концепций для изучения: Connected App, OAuth 2.0 flows, SOQL, SOSL, Apex REST, Platform Events.
Connected App и OAuth
Всё начинается с создания 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.
На 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 орга свой поддомен).
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).
На мобильном — 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 vs кастомная интеграция
| Salesforce Mobile SDK | Кастомная интеграция | |
|---|---|---|
| OAuth | Встроен | AppAuth / кастомный |
| Offline | SmartStore (SQLCipher) | Room / Core Data |
| Push | Встроен | FCM/APNs напрямую |
| Размер | +15 МБ | Минимальный |
| Гибкость | Ограничена SDK | Полная |
SDK оправдан, если приложение преимущественно Salesforce-ориентировано. Для приложений, где Salesforce — одна из нескольких интеграций — лучше кастомный подход.
Salesforce Files и вложения
Файлы в 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.
Сроки
Базовая интеграция (OAuth, SOQL-запросы, CRUD для Opportunity/Contact): 1-2 недели. Platform Events, offline-кэш, push-уведомления: плюс 1-2 недели. Полноценное приложение с Salesforce Mobile SDK, SmartStore и синхронизацией: 1,5-2 месяца. Стоимость рассчитывается индивидуально.