# Передать в SDK Firebase-токен

Создайте новый kotlin класс с названием MindboxFirebaseMessagingService.  
Сделайте этот класс наследником от FirebaseMessagingService(), если в приложении уже есть наследник FirebaseMessagingService, то новый создавать не нужно, а все последующие изменения нужно добавить в существующий класс наследник FirebaseMessagingService.  
Реализуйте метод onNewToken.

# Укажите, какие адреса могут приходить в push-уведомлении и как они соотносятся с активити приложения

В каждом push-уведомлении приходит ссылка, которую настроили в административном разделе. Также в push-уведомлениях может быть до 3 кнопок, у каждой своя ссылка.
Чтобы корректно обработать открытие приложения и открыть ту активити, которую задумывалось, сформируйте Map. Укажите в нем ссылки и активити, которые они должны открывать.
Для реализации базового отображения push-уведомлений мы предоставляем готовый метод Mindbox.handleRemoteMessage. Этот метод обработает получение push-уведомления, скачает картинку и отобразит push-уведомление.
При формировании Map activities для описания ссылок вы можете использовать маску с символом `_`. Например,`https://mindbox.ru/push/_` будет соответствовать:

https://mindbox.ru/push/,  
https://mindbox.ru/push/1,  
https://mindbox.ru/push/foo,  
https://mindbox.ru/push/foo?product=123.

Push-уведомления и кнопки с таким URL будут открываться в одной активити, которую вы указали.

# Укажите, какая активити должна вызываться по умолчанию

Эта активити будет отображена, если в push-уведомлении пришла ссылка, которой нет в списке

# Придумайте id, название и описание канала для push-уведомлений

При первом push-уведомлении мы создадим собственный канал для уведомлений. Для него нужно придумать вместе с маркетологом название и описание. Подробнее про каналы уведомлений на Android можно прочитать тут.
Идентификатор может быть любой уникальной для вашего приложения строкой.

# Отрисовка уведомдения

Для отрисовки push-уведомлений можно использовать встроенный функционал. Для этого необходимо вызвать метод  Mindbox.handleRemoteMessage() и передать ему соответствующие параметры.
Метод возвращает TRUE, если push-уведомление успешно обработано и отображено, и FALSE, если push-уведомлений не обработано. На этот статус вы можете завязать логику обработки push-уведомления другими методами.
  
  ```kotlin
  import cloud.mindbox.mobile_sdk.Mindbox
  import com.google.firebase.messaging.*

  class MindboxFirebaseMessagingService: FirebaseMessagingService() {
      override fun onNewToken(token: String) {
          // Передача токена в Mindbox SDK
          Mindbox.updatePushToken(applicationContext, token, MindboxFirebase)
      }

      override fun onMessageReceived(remoteMessage: RemoteMessage) {
          // Активити поумолчанию. Откроется, если пришла ссылка, которой нет в перечислении
          val defaultActivity = MainActivity::class.java

          val channelId = "< ИДЕНТИФИКАТОР КАНАЛА >"      // "my_android_app_channel"
          val channelName = "< НАЗВАНИЕ КАНАЛА >"         // "Рекламные рассылки"
          val channelDescription = "< ОПИСАНИЕ КАНАЛА >"  // "Рассылки, которые содержат рекламу"
          val pushSmallIcon = R.mipmap.ic_launcher
          
          // Перечисление ссылок и активити, которые должны открываться по разным ссылкам
          val activities = mapOf(
              "https://mindbox.ru/" to defaultActivity,
          )

          // Метод возвращает boolen, чтобы можно было сделать фолбек для обработки push-уведомлений
          val messageWasHandled = Mindbox.handleRemoteMessage(
              context = applicationContext,
              message = remoteMessage,
              activities = activities,
              channelId = channelId, // Идентификатор канала для уведомлений, отправленных из Mindbox
              channelName = channelName,
              pushSmallIcon = pushSmallIcon, // Маленькая иконка для уведомлений
              defaultActivity = defaultActivity,
              channelDescription = channelDescription
          )

          if (!messageWasHandled) {
              // Если push-уведомление было не от Mindbox или в нем некорректные данные, то можно написать фолбек для его обработки
          }
      }
  }
  ```

  ```json title="Пример ответа"
  {"success":true}
  ```
