Перейти к основному содержимому
Версия: Последняя

App Store: создание и настройка канала

Лицензия

Данный функционал доступен только при наличии модуля App Store.

Доступы

Для управления каналами пользователь должен находиться в группе с правами Администратор или Управление каналами.

Модуль App Store позволяет автоматически получать отзывы пользователей мобильного приложения из App Store, создавать по ним обращения в IQChannels и отвечать на отзывы непосредственно из интерфейса системы.

1. Предварительная подготовка​

Перед подключением канала необходимо подготовить приложение и учетную запись в App Store Connect.

1.1 Требования​

Необходимо:

  • иметь опубликованное приложение в App Store;
  • иметь учетную запись App Store Connect с правами администратора или достаточными правами для работы с API;
  • создать API-ключ App Store Connect;
  • получить:
    • Issuer ID;
    • Key ID;
    • приватный ключ (.p8);
  • определить App ID приложения, отзывы которого необходимо получать.

1.2 Создание API-ключа в App Store Connect​

Для подключения IQChannels необходимо создать API-ключ.

  1. Откройте App Store Connect.
  2. Перейдите в раздел Users and Access.
  3. Откройте вкладку Integrations.
  4. Перейдите в раздел App Store Connect API.
  5. Нажмите Generate API Key.
  6. Укажите:
    • название ключа;
    • необходимый уровень доступа.
  7. После создания сохраните:
    • Issuer ID;
    • Key ID.
  8. Скачайте приватный ключ в формате .p8.
Важно

После создания API-ключа файл .p8 можно скачать только один раз. Сохраните его в надежном месте.

1.3 Получение App ID​

Для подключения необходимо знать идентификатор приложения (App ID).

Его можно посмотреть:

  1. Войдите в App Store Connect.
  2. Перейдите в раздел Мои приложения (My Apps).
  3. Откройте нужное приложение.
  4. На странице приложения найдите идентификатор App ID.

Именно этот идентификатор необходимо указать в настройках канала IQChannels.

2. Создание App Store-канала​

  1. Перейдите в нужный проект.
  2. Откройте раздел «Каналы».
  3. Нажмите «Создать канал».
  4. Заполните форму:
  • Тип канала — App Store;
  • Название — отображаемое имя канала;
  • На английском — уникальное системное имя;
  • Описание — (необязательно).
  1. Нажмите «Создать канал».

После этого канал станет доступен для настройки.

3. Настройка канала​

  1. Откройте созданный канал.
  2. Перейдите во вкладку «Настройки».
  3. Заполните параметры подключения.

URL​

Адрес API App Store Connect.

По умолчанию поле уже заполнено и изменять его, как правило, не требуется.

Issuer ID​

Укажите Issuer ID, полученный при создании API-ключа в App Store Connect.

Key ID​

Укажите Key ID созданного API-ключа.

Private Key (.p8)​

Загрузите приватный ключ .p8, скачанный при создании API-ключа.

App ID​

Укажите идентификатор приложения, отзывы которого необходимо обрабатывать.

Интервал опроса​

Укажите период, с которым IQChannels будет проверять App Store на наличие новых отзывов.

Чем меньше значение, тем быстрее новые отзывы будут поступать в систему, однако возрастет количество запросов к API App Store Connect.

  1. Нажмите «Сохранить».

3.1 Автоматическая проверка настроек​

После сохранения система автоматически:

  • проверяет корректность параметров подключения;
  • выполняет авторизацию в App Store Connect;
  • проверяет доступность указанного приложения;
  • сохраняет настройки канала;
  • запускает периодический опрос новых отзывов.

4. Проверка работоспособности​

После успешного подключения:

  • новые отзывы пользователей автоматически поступают в IQChannels;
  • для каждого нового отзыва создается отдельное обращение;
  • повторная обработка уже полученных отзывов не выполняется;
  • оператор может ответить на отзыв непосредственно из карточки обращения;
  • после отправки ответ автоматически публикуется в App Store.

5. Работа операторов​

После поступления нового отзыва оператор получает стандартное обращение IQChannels.

В карточке обращения доступны:

  • текст отзыва;
  • оценка пользователя;
  • заголовок отзыва (при наличии);
  • имя автора;
  • дата публикации;
  • страна (регион);
  • история переписки;
  • поле для отправки ответа;
  • статус публикации ответа.

После отправки ответа он автоматически публикуется в App Store и отображается в истории обращения.

6. Диагностика (при проблемах)​

Если отзывы не поступают или ответы не публикуются:

  • убедитесь, что модуль AppStore активирован в лицензии;
  • проверьте корректность Issuer ID, Key ID и App ID;
  • убедитесь, что загружен корректный приватный ключ (.p8);
  • проверьте права учетной записи в App Store Connect;
  • убедитесь, что приложение опубликовано в App Store;
  • проверьте правильность указанного интервала опроса;
  • при необходимости сохраните настройки канала повторно для повторной проверки подключения.