Интеграция 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)
    }

Сравнение подходов к интеграции

Как загрузить файлы в 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.

Что входит в работу по интеграции

1. Анализ текущей CRM-структуры и требований к синхронизации.
2. Настройка Connected App и OAuth-потоков (Authorization Code / JWT Bearer).
3. Разработка REST-клиента с кэшированием и обработкой ошибок.
4. Интеграция Platform Events для real-time уведомлений.
5. Тестирование на тестовом и боевом Salesforce-оргах.
6. Документация по API и инструкция по развертыванию.
7. Поддержка после запуска (1 месяц).

Сроки и стоимость

Базовая интеграция (OAuth, SOQL-запросы, CRUD для Opportunity/Contact): 1-2 недели. Platform Events, offline-кэш, push-уведомления: плюс 1-2 недели. Полноценное приложение с Salesforce Mobile SDK, SmartStore и синхронизацией: 1,5-2 месяца. Стоимость рассчитывается индивидуально. Оценим ваш проект — пишите, получите консультацию.

Интеграция API в мобильное приложение: с чего начать

Запрос уходит, ответ не приходит, timeout — 30 секунд. Пользователь смотрит на спиннер. Сети нет — мобильная карта в метро. Или сеть есть, но сервер вернул 200 с HTML-страницей ошибки вместо JSON — и приложение крашит при JSONDecoder.decode(). Мы видим такие кейсы на каждом втором проекте. Поэтому интеграция API в мобильное приложение — это не просто вызов endpoint'а, а проектирование надёжного сетевого слоя: обработка ошибок, кэширование, offline-режим, certificate pinning. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.

Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.

Как выбрать протокол для интеграции API?

REST остаётся стандартом для большинства проектов. Но когда на экране профиля нужно 5 полей из 40, GraphQL исключает over-fetching и сокращает трафик на 30–60%. gRPC оправдан при тысячах запросов в минуту (trading, IoT) — бинарная сериализация в 3–5 раз быстрее JSON. WebSocket — единственный выбор для real-time без polling (сообщения, уведомления).

Пример из практики: для финтех-приложения мы заменили REST (40 полей) на GraphQL — размер ответа сократился с 12 КБ до 2,5 КБ, время рендера экрана упало на 70%. Экономия трафика составила около 15 000 ₽ в месяц при 100 000 активных пользователей.

Как обеспечить надёжность соединения и offline-first

Пользователи теряют сеть в метро, лифте, тоннеле. Мобильное приложение обязано работать без интернета — хотя бы в read-only режиме. Мы внедряем паттерн offline-first:

1. При открытии экрана сначала показываем данные из локального кеша (Core Data / Room).
2. Параллельно выполняем сетевой запрос, обновляем UI после ответа.
3. Если сеть недоступна — показываем кешированные данные и метку «нет соединения».
4. При восстановлении сети автоматически синхронизируем изменения.

Для кэширования HTTP-ответов используем URLCache (iOS) и OkHttp Cache (Android) с поддержкой Cache-Control. Для структурированных данных — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback отслеживают состояние сети и триггерят обновление.

REST и выбор клиентской библиотеки

Alamofire (iOS) — де-факто стандарт для Swift-проектов. Поверх URLSession добавляет request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() с .validate() возвращает ошибку для любого статус-кода вне 200–299. Без .validate() Alamofire считает 404 и 500 успешными ответами. С Swift Concurrency — async-версия через serializingDecodable.

Retrofit (Android) — аннотационный HTTP-клиент поверх OkHttp. Интерфейс с аннотациями компилируется в реализацию. @GET, @POST, @Path, @Query, @Body — декларативное описание API. OkHttp под капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логирование в debug-сборке. Authenticator — автоматический refresh токена при 401.

Ktor (KMM/Flutter) — мультиплатформенный HTTP-клиент. На iOS работает через Darwin engine (URLSession), на Android — через OkHttp. Единый код для обеих платформ при KMM-архитектуре.

GraphQL: когда REST не справляется

REST возвращает фиксированную структуру. Экран профиля требует name, avatar, email — сервер отдаёт 40 полей. Over-fetching. GraphQL решает это: клиент запрашивает ровно нужные поля. Это критично для мобайла, где трафик и время парсинга — реальные ограничения. Apollo iOS и Apollo Kotlin генерируют типизированные классы по схеме: schema.graphql + query-файлы → строгие типы на этапе компиляции. Subscriptions через WebSocket — real-time без polling. Ограничение: GraphQL сложнее кешировать на уровне HTTP. Apollo использует нормализованный in-memory кеш InMemoryNormalizedCache — запросы с пересекающимися данными обновляют кеш без дублирования. Apollo GraphQL Documentation

WebSocket: real-time без лишнего трафика

Polling (setInterval каждые 5 секунд) — трата батареи и трафика. WebSocket — постоянное двунаправленное соединение. iOS: URLSessionWebSocketTask (нативный, iOS 13+). Android: OkHttp WebSocket. Обязательная обработка reconnect: при onFailure — экспоненциальный backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надстройка с автоматическим reconnect, но для новых проектов предпочтительнее нативный WebSocket (меньше зависимостей).

gRPC: для высоконагруженных сервисов

gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.

Certificate Pinning и безопасность

Корпоративный proxy может перехватить HTTPS через подмену сертификата. Certificate pinning предотвращает это: приложение принимает только конкретный сертификат или публичный ключ. Alamofire: ServerTrustManager с PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner с SHA-256 хешем. Операционная сложность: при ротации сертификата старые версии приложения перестают работать. Решение — pinning на публичный ключ CA или поддержка нескольких пинов с grace period. Подробнее о certificate pinning на Wikipedia

Что входит в работу

Мы передаём: исходный код сетевого слоя, документацию по используемым библиотекам, инструкцию по ротации сертификатов, поддержку в течение 2 недель после сдачи.

Сроки и стоимость

Реализация сетевого слоя с REST, retry, кэшированием и offline-режимом — 1–2 недели. Добавление GraphQL или WebSocket — ещё 1–2 недели. gRPC — 2–3 недели, включая кодогенерацию. Стоимость рассчитывается индивидуально после анализа API и требований к offline-поведению. Оценим проект за 1 день — свяжитесь для консультации.