ТЕХНИЧЕСКАЯ ДОКУМЕНТАЦИЯ

Интеграция с Salesforce

Пошаговое руководство по подключению CRM-системы Salesforce к платформе AimShift. Синхронизируйте данные клиентов и прогнозируйте стратегию продаж в реальном времени.

Схема интеграции AimShift и Salesforce

// ШАГ 1: ПРЕДВАРИТЕЛЬНЫЕ ТРЕБОВАНИЯ

Проверьте доступы и версию системы

Перед началом настройки убедитесь, что ваша учетная запись соответствует следующим критериям.

01. Роли пользователей

Административный доступ

Вам необходимы права System Administrator или Integration Manager для создания коннекторов и настройки веб-хуков.

02. Версия API

Winter '24 или новее

AimShift требует использование Salesforce API версии 59.0 или выше для поддержки новых протоколов шифрования данных.

03. IP-адреса

Белый список (Whitelist)

Добавьте диапазоны IP-адресов AimShift в настройки безопасности вашей организации Salesforce (Setup > Remote Site Settings).

// ШАГ 2: ГЕНЕРАЦИЯ КЛЮЧЕЙ

Создание Connected App

Для безопасного соединения необходимо создать приложение в Salesforce, которое выдаст Consumer Key и Consumer Secret.

  1. Перейдите в Setup > App Manager.
  2. Нажмите New Connected App.
  3. Включите Enable OAuth Settings.
  4. В поле Callback URL укажите:
    https://api.aimshift.io/auth/salesforce/callback
  5. Выберите scope: Full access (full) и Perform requests on your behalf at any time (refresh_token, offline_access).

Важно: Никогда не публикуйте Consumer Secret в открытом доступе или в клиентском коде.

Пример конфигурации JSON:
{
  "client_id": "3MVG9Z...",
  "client_secret": "YOUR_SECRET",
  "instance_url": "https://your-domain.my.salesforce.com",
  "api_version": "v59.0",
  "encryption": "AES-256"
}

// ШАГ 3: СОПоставка ПОЛЕЙ

Mapping Data Fields

Синхронизируйте объекты Salesforce с моделями данных AimShift для корректного построения аналитики.

Объект Salesforce Поле (Field) Модель AimShift Тип данных
Lead Industry Market_Sector String
Opportunity Amount Projected_Revenue Decimal
Account AnnualRevenue Client_Tier_Value Currency
Contact Email User_ID_Hash Hash(SHA-256)

// ШАГ 4: НАСТРОЙКА СИНХРОНИЗАЦИИ

Режим Real-Time Stream

Включите непрерывную потоковую передачу данных. AimShift использует Salesforce Streaming API (CometD) для мгновенного получения обновлений.

  • Частота обновления: Push (Мгновенно)
  • Обработка конфликтов: Последнее изменение побеждает (LWW)
  • Резервное копирование: Ежедневный Batch Job в 03:00 UTC
Запустить тестовый пул
System Log Running...
[10:42:01] Initializing handshake...
[10:42:02] Auth token verified.
[10:42:03] Subscribing to /event/LeadChangeEvent...
[10:42:05] Connection Established.
[10:42:05] Latency: 12ms
[10:42:10] Received batch #49201 (14 records)

Устранение неполадок

Решение распространенных проблем при интеграции.

Ошибка: "INVALID_SESSION_ID"
Это означает, что токен доступа истек. AimShift автоматически пытается обновить его, используя refresh_token. Если ошибка сохраняется, проверьте, не был ли отозван доступ у Connected App в настройках Salesforce (Setup > Connected Apps Oauth Usage).
Данные не обновляются более 15 минут
Проверьте статус очереди событий (Event Bus). Возможно, вы исчерпали лимит API-вызовов вашего Salesforce Edition. Убедитесь, что включен режим "Bulk API" в настройках коннектора AimShift для обработки больших объемов данных.
Ошибка парсинга кастомных полей
AimShift по умолчанию импортирует только стандартные поля. Для кастомных полей (оканчивающихся на __c) необходимо явно добавить их в конфигурацию маппинга через интерфейс администратора.

Нужна помощь с интеграцией?

Наша команда инженерной поддержки готова помочь с настройкой сложных коннекторов и кастомизацией API.