Como enviar um empurrão silencioso

Notificações push podem ser silenciosas, ou seja, não contêm alerta ou som e são usadas principalmente para acionar ações em segundo plano do app ou atualizar o app com um payload.

Configurando notificações push silenciosas

iOS

Para utilizar notificações push silenciosas no iOS, você precisa configurar seu aplicativo para fazer isso mesmo quando estiver em segundo plano.

Para configurar isso, no XCode, adicione a capacidade de Modos em Segundo plano no painel de Assinatura e Capacidades ao alvo principal do app. Selecione a caixa de seleção Notificações Remotas .

Push silenciosos no iOS são entregues ao seu app via delegado de busca em segundo plano. Adicione o método ao seu AppDelegate e encaminhe as notificações XPush para o SDK:

Objective-C

Swift

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {

    if (userInfo[@"xpush"] != nil) {
        [XPush applicationDidReceiveRemoteNotification:userInfo
                               fetchCompletionHandler:completionHandler];
        return;
    }
    completionHandler(UIBackgroundFetchResultNoData);
}

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {

    if userInfo["xpush"] != nil {
        XPush.applicationDidReceiveRemoteNotification(userInfo,
                                                     fetchCompletionHandler: completionHandler)
        return
    }
    completionHandler(.noData)
}

Android

Não há requisitos para usar o Silent Push em aplicativos Android.

Enviando Notificações Push Silenciosas

É possível enviar um push silencioso criando uma campanha acionada pela API e executando-a usando o endpoint externo de execução da campanha . Defina a flag de push_silent para 1 na carga útil da mensagem.

Anexar o título e o corpo com push_silent definido em 1 não é recomendado, pois pode causar comportamentos indesejados. Para mais detalhes sobre iOS, consulte a documentação oficial da Apple sobre atualizações em segundo plano.

Um exemplo de payload de notificação push silenciosa pode ser visto abaixo:

Exemplo de iOS:

Exemplo para iOS

Exemplo do Android

curl --request POST \
  --url 'https://external-api.xtremepush.com/api/external/execute/campaign' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data-raw '{
    "id":"<campaign_id>",
    "apptoken":"<app_token>",
    "title":"Silent Push Notification",
    "android_push":0,
    "android_push_production":0,
    "ios_push":1,
    "ios_push_production":1,
    "ios_push_sandbox":1,
    "conditions":{
      "1":{
        "1":[
          "id",
          "=",
          "<device_id>"
        ],
        "operator":"AND"
      },
      "operator":"AND"
    },
    "broadcast":"0",
    "messages":{
      "1":{
        "push_silent":1,
        "payload_add":[
          {
              "key":"",
              "value":""
          },
          {
              "key":"",
              "value":""
          }
        ]
      }
    }
  }'

curl --request POST \
     --url https://external-api.xtremepush.com/api/external/execute/campaign \
     --header 'accept: application/json' \
     --header 'content-type: application/json'{
  "id":"",
  "apptoken":"",
  "title":"Silent Push Notification”,
  "android_push":1,
  "android_push_production":1,
  "ios_push":0,
  "ios_push_production":0,
  "ios_push_sandbox":0,
  "conditions":{
     "1":{
        "1":[
           "id",
           "=",
           "<device_id>"
        ],
        "operator":"AND"
     },
     "operator":"AND"
  },
  "broadcast":"0",
  "push_text":"sample text",
  "messages":{
     "1":{
        "push_silent":1,
        "payload_add":[
           {
              "key":"",
              "value":""
           },
           {
              "key":"",
              "value":""
           },
           {
              "key":"",
              "value":""
           }
        ]
     }
  }
}'