# Интеграция действий в приложении
:::warning{title=" Убедитесь, что эти шаги выполнены успешно:"}

 * [Настройка точек интеграции Android](https://developers.mindbox.ru/docs/add-android-integration)
 * [Настройка точек интеграции iOS](https://developers.mindbox.ru/docs/add-ios-integration)
 * [Добавление SDK в приложение](https://developers.mindbox.ru/docs/add-sdk-flutter)
 * [Инициализация SDK](https://developers.mindbox.ru/docs/sdk-initialization-flutter)
:::

Для передачи данных о действиях клиента нужно завести «операции». Подробно о них [в разделе «Операции и интеграции» на help.mindbox.ru](https://help.mindbox.ru/docs/%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8-v-%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D1%8B%D0%B5-%D1%81%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D1%8F).

Для вызова операций из мобильного приложение Mindbox SDK предлагает 2 метода:

* `executeAsyncOperation` — передача данных в систему;
* `executeSyncOperation` — получение данных из системы.

Для создания тела запроса при вызове операции нужно использовать конструктор `OperationBodyRequest`.

 :::info 
 [Пример вызова операций](https://github.com/mindbox-cloud/flutter-sdk/blob/develop/example/flutter_example/lib/view_model/view_model.dart#L12-L37)
:::

## Техническое задание на интеграцию

Эта страница — пример того, как вызывать API SDK для передачи данных.

Для передачи данных в Mindbox сначала надо настроить нужные методы API. Это делается индивидуально для каждого проекта.

Менеджер проекта со стороны Mindbox настраивает нужные методы и описывает их в специальном документе.

:::danger
  Не приступайте к этому разделу, если у вас нет документа с описанием всех нужных методов.
:::

Ниже приведены примеры того, как некоторые запросы могут быть интегрированы из мобильного приложения. **Если просто скопировать код из этих примеров, то интеграция не заработает.**

## Пример реализации вызовов по сценариями

### Авторизация в приложении (только для тестов)

```dart
Mindbox.instance.executeAsyncOperation(
  operationSystemName: "Mobile.CreateCustomer",
  operationBody: {
    "customer": {
      "mobilePhone": "<Мобильный телефон>",
    },
  },
);
```

### Передача действий просмотра продуктов и категорий

```dart
Mindbox.instance.executeAsyncOperation(
  operationSystemName: "CheckGuide.viewProduct",
  operationBody: {
    "product": {
      "ids": {
        "website": "<product ID in Website>",
      },
    },
  },
);

Mindbox.instance.executeAsyncOperation(
  operationSystemName: "CheckGuide.viewProduct",
  operationBody: {
    "viewProductCategory": {
      "productCategory": {
        "ids": {
          "website": "<Product Category ID in Website>",
        },
      },
    },
  },
);
```

### Передача действий добавления и установки списка продуктов

Для работы со списком продуктов Mindbox предлагает 2 варианта подхода:

* добавление/удаление по 1 шт;
* установка списка одним запросом.

Популярные списки продуктов: «корзина» и «избранное».

```dart
Mindbox.instance.executeAsyncOperation(
  operationSystemName: "CheckGuide.addProductToCart",
  operationBody: {
    "addProductToList": {
      "product": {
        "ids": {
          "website": "<Product ID in Website>",
        },
      },
      "pricePerItem": "<Price per item>",
    },
  },
);

Mindbox.instance.executeAsyncOperation(
  operationSystemName: "CheckGuide.addProductToCart",
  operationBody: {
    "productList": [
      {
        "product": {
          "ids": {
            "website": "<Product ID in Website>",
          },
        },
        "count": "<Number of products>",
        "priceOfLine": "<Price of line>",
      },
    ],
  },
);
```

### Пример проверки клиента в сегменте

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

```dart
Mindbox.instance.executeSyncOperation(
  operationSystemName: "CheckGuide.checkSegment",
  operationBody: {},
  onSuccess: (success) => print(success),
  onError: (error) => print(error),
);
```

### Пример получения персональных рекомендаций

Данный запрос возвращает список продуктов, подобранных клиенту на основе одного из настроенных алгоритмов продуктовых рекомендаций.

```dart
Mindbox.instance.executeSyncOperation(
  operationSystemName: "CheckGuide.getReco",
  operationBody: {
    "recommendation": {
      "limit": "3",
    },
  },
  onSuccess: (success) => print(success),
  onError: (error) => print(error),
);
```

import Mindboxsdkendsurvey from '/src/_Mindboxsdkendsurvey.mdx';

<Mindboxsdkendsurvey />

<br />
