> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudgen.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Подключение приложения и синхронизация контактов

> Выберите аудитории, проверьте контакты и управляйте синхронизацией интеграции

## Почему это важно

Выбор исходной аудитории помогает импортировать только те контакты, которые вы намерены использовать. Предварительный просмотр импорта и подтверждение разрешения на отправку писем позволяют обнаружить ошибочный выбор до начала синхронизации.

## Перед началом работы

* Войдите в рабочее пространство, которое должно получить контакты.
* Если у вас нет необходимых прав, попросите владельца или администратора рабочего пространства управлять подключением.
* Убедитесь, что в сведениях о приложении указана доступность синхронизации контактов. Другие состояния описаны в разделе [Статусы доступности](/ru/integrations/overview).
* Убедитесь, что у вас есть разрешение отправлять письма контактам, которых вы собираетесь импортировать. Подключение приложения само по себе не дает такого разрешения.

## Подключение и выбор контактов

<Steps>
  <Step title="Подключите аккаунт">
    В разделе **Настройки** → **Интеграции** найдите приложение и нажмите **Подключить**. Пройдите авторизацию на странице провайдера, затем вернитесь в Nudgen. Nudgen запрашивает доступ только для чтения к email-адресу, имени и телефону контакта, его принадлежности к аудитории и разрешению на отправку писем, если провайдер поддерживает эти данные. Nudgen не изменяет контакты в исходном приложении.
  </Step>

  <Step title="Выберите аудитории">
    Найдите списки, сегменты или теги и выберите до 10 аудиторий. Если в источнике есть дополнительные результаты, нажмите **Загрузить другие аудитории**. Контакт, входящий в несколько выбранных аудиторий, импортируется один раз. Каждое подключение поддерживает не более 10 000 уникальных исходных контактов с учетом лимита контактов рабочего пространства.
  </Step>

  <Step title="Предварительно просмотрите контакты">
    Нажмите **Предварительный просмотр контактов**. Проверьте образец и отображаемое количество, которое может быть точным, приблизительным или недоступным до первой синхронизации. Некоторым провайдерам требуется дополнительный шаг: для noCRM перед предварительным просмотром выберите столбец с email-адресом для каждого выбранного списка; столбцы с именем и телефоном необязательны.
  </Step>

  <Step title="Проверьте и запустите">
    Нажмите **Продолжить**, проверьте аккаунт и аудитории, подтвердите, что у вас есть разрешение отправлять письма этим контактам, а затем нажмите **Начать синхронизацию**. Первый импорт сразу будет поставлен в очередь. Последующие синхронизации выполняются каждый час.
  </Step>
</Steps>

Во время настройки можно нажать **Сохранить и выйти**, а затем вернуться позже. Если вы измените выбранную аудиторию или сопоставление столбцов, перед запуском потребуется новый предварительный просмотр.

Nudgen сохраняет существующие значения профиля контакта и теги, когда это применимо. Известные отписки, возвраты и другие ограничения на отправку писем остаются защищенными. Наличие контакта в исходной аудитории не означает, что он автоматически может получать кампанию.

## Управление подключением

Откройте **Подключенные приложения** → **Управление**, чтобы просмотреть выбранные аудитории, время последней и следующей синхронизации и последние запуски. Для каждого запуска отображается количество импортированных, обновленных и пропущенных контактов. Можно выбрать **Просмотреть контакты**, **Изменить аудитории** или **Синхронизировать сейчас**. Повторная ручная синхронизация доступна через 15 минут, а во время ожидающего запуска эта кнопка недоступна. Если аккаунту снова требуется авторизация, нажмите **Подключить повторно**.

Нажмите **Отключить**, чтобы остановить последующие синхронизации. Уже импортированные в Nudgen контакты останутся в рабочем пространстве. Перед переключением источника на Composio может потребоваться отключить прежнее нативное подключение; в таком случае это будет указано на странице настройки.

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

<AccordionGroup>
  <Accordion title="Аудитории не отображаются">
    Попробуйте другой поисковый запрос, нажмите **Загрузить другие аудитории**, если эта кнопка доступна, и убедитесь, что ваш аккаунт у провайдера может читать нужные списки или сегменты.
  </Accordion>

  <Accordion title="Срок предварительного просмотра истек или выбор изменился">
    Вернитесь к шагу **Выбор контактов**, обновите предварительный просмотр и проверьте его еще раз. Для noCRM повторно проверьте сопоставление столбцов, если столбцы в источнике изменились.
  </Accordion>

  <Accordion title="Синхронизация заблокирована из-за лимита">
    Выберите аудитории меньшего размера, если выбор превышает 10 000 уникальных исходных контактов. Если рабочее пространство достигло лимита контактов, уменьшите выбор или проверьте тарифный план.
  </Accordion>

  <Accordion title="Синхронизация приостановлена или требует внимания">
    Проверьте сообщение запуска. Если срок авторизации истек, подключитесь повторно. При временном ограничении запросов со стороны провайдера или Nudgen подождите перед повторной попыткой. Если активное рабочее пространство изменилось, перезагрузите страницу.
  </Accordion>
</AccordionGroup>

## Связанные документы

* [Контакты Shopify и «Все контакты»](/ru/integrations/shopify)
* [Обзор контактов](/ru/contacts/overview)
* [События пожизненных кампаний](/ru/integrations/lifetime-events)