---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Push-Benachrichtigungen werden in eingerichtet iOSAnwendung

# Push-Benachrichtigungen werden in eingerichtet iOSAnwendung {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Zusätzlich zu den Aufgaben, die Sie für ausführen müssen ServiceNowInstanz um eine Push-Benachrichtigung zu konfigurieren, müssen Sie auch bestimmten Code in Ihrem einschließen iOSAnwendung.

## Erstellen Sie den NowSDK NowPushService {#mobsdk-ios-setup-push-app__section_hyb_zxp_prb}

Eine der ersten Schritte, die in Ihrer Anwendung ausgeführt werden müssen, ist die Erstellung eines `Now PushService `. Die `Jetzt veröffentlichen `SDK bietet eine Werksfunktion zum Erstellen dieses Service. Fügen Sie Code ähnlich dem folgenden Fragment früh in Ihrem Hauptcodetext hinzu.

    func setup(with instanceURL: URL) -> AnyPublisher<NowService, ConfigurationError> {
      NowPush.makePushService(instanceUrl: instanceURL)
        .mapError { .sdkError($0) }
        .map { $0 as NowService }
        .eraseToAnyPublisher()
    }

Für zusätzliche Informationen zu Now Push.makePushService() Methode, siehe [Now Push-API: IOS](https://servicenow-prod.fluidtopics.net/QCszipQJwEnVcmuM3mcFbg#NowPushiOSAPI "Die Jetzt veröffentlichen API ist eine globale API der obersten Ebene, mit der Anwender eine NowPush-Serviceinstanz instanziieren können.").

## Registrieren Sie das Push-Token {#mobsdk-ios-setup-push-app__section_kyr_4cq_prb}

Apple Stellt ein eindeutiges Push-Benachrichtigungstoken bereit, das das Gerät und die Anwendung identifiziert, um Push-Benachrichtigungen zu erhalten. Damit eine Anwendung eine Push-Benachrichtigung erhält, müssen Sie dieses Token mit registrieren `Now PushService `. Fügen Sie eine Funktion hinzu, die dem folgenden Codefragment in Ihrem ähnelt iOSAnwendung. Diese Anwendung muss bei registriert werden ServiceNowInstanz.

    func registerForPushNotifications(deviceToken: Data) {
      pushService.registerPushToken(deviceToken,
          pushAppName: "TestPushApp", // Modify this to be your iOS application name
          environment: environment) { [weak self] result in
        guard let self = self else { return }
        switch result {
        case .success:
          UserDefaults.standard.set(true, forKey: "pushNotificationsRegistered")
          self.pushRegistrationState = .registrationSuccess
        case .failure:
          UserDefaults.standard.set(false, forKey: "pushNotificationsRegistered")
          self.pushRegistrationState = .registrationFailed
        }
      }
    }

Für zusätzliche Informationen zu RegisterPushToken() Methode, siehe [NowPushService -- registerPushToken(_Token: Data, pushAppName: Zeichenfolge, Umgebung: NowPushEnvironment, Abschluss: @Escaping (Result\<Data, NowPushError\>) -\> Stornieren)](https://servicenow-prod.fluidtopics.net/GCrGhf7f256EPe~i7LHObg#NPushServ-registerPushToken_O_S_O_O "Registriert ein eindeutiges Token bei ServiceNowInstanz, die zum Identifizieren der Push-Benachrichtigungen für die aktuelle Instanz verwendet wird iOSGerät und angegebene Anwendung.").

## Heben Sie die Registrierung des Push-Tokens auf

Sie müssen die Registrierung eines Push-Tokens aufheben, wenn der Anwender Ihre Anwendung verlässt, z. B. wenn sich der Anwender abmeldet. Verwenden Sie Code, der dem folgenden Codefragment ähnelt, um die Registrierung eines Push-Tokens aufzuheben. Stellen Sie sicher, dass Sie sich ändern pushAppNameAn den Namen von iOSAnwendung.

    func unregisterFromPushNotifications(deviceToken: Data) {
      pushService.unregisterPushToken(deviceToken, pushAppName: "TestPushApp", environment: environment) { [weak self] result in
        guard let self = self else { return }
        switch result {
        case .success:
          UserDefaults.standard.set(false, forKey: "pushNotificationsRegistered")
          self.pushRegistrationState = .unregisterSuccess
        case .failure:
          self.pushRegistrationState = .unregisterFailed
        }
      }
    }

Für zusätzliche Informationen zu UnregisterPushToken() Methode, siehe [NowPushService -- unregisterPushToken(_Token: Data, pushAppName: Zeichenfolge, Umgebung: NowPushEnvironment, Abschluss: @Escaping (Result\<Data, NowPushError\>) -\> Stornieren)](https://servicenow-prod.fluidtopics.net/GCrGhf7f256EPe~i7LHObg#NPushServ-unregisterPushToken_O_S_O_O "Hebt die Registrierung eines zuvor registrierten Push-Tokens auf.").

## Analysieren Sie die Push-Nutzlast {#mobsdk-ios-setup-push-app__section_ofn_dlw_trb}

Sie müssen Nutzlasten der Push-Benachrichtigung in analysieren `Now PushPayload `Objekt zum Sammeln von Informationen und zur Verwendung der Daten in anderen Teilen der Anwendung. Derzeit ist dies nur für Push-Benachrichtigungen für Virtual Agent verfügbar. Verwenden Sie Code ähnlich dem folgenden

    func userNotificationCenter(_ center: UNUserNotificationCenter,
        didReceive response: UNNotificationResponse,
        withCompletionHandler completionHandler: @escaping () -> Void) {
      guard let pushService = pushService else {
        completionHandler()
        return
      }
      let userInfo = response.notification.request.content.userInfo
      _ = pushService.payloadFromUserInfo(userInfo)
        .flatMap(handleNowPushPayload)
    }

    func handleNowPushPayload(_ payload: NowPushPayload) -> Result<Void, NowPushError> {
      guard payload is NowPushVirtualAgent else {
        return .failure(NowPushError.unsupportedData)
      }
      launchVirtualAgent()
      return .success(())
    }


