Интеграция Salesforce с мобильным приложением под ключ

Интеграция 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 орга свой поддомен).

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).

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) } 

POST /services/data/v60.0/sobjects/ContentVersion/ Content-Type: multipart/form-data { "Title": "Фото клиента", "PathOnClient": "photo.jpg", "FirstPublishLocationId": "{opportunityId}" } + binary data