---
title: "Como enviar um empurrão silencioso"
slug: "silent-push"
updated: 2026-06-12T10:30:51Z
published: 2026-06-12T10:30:51Z
canonical: "docs.xtremepush.com/silent-push"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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** .

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/19664f9ac6c30bdcb56123547153f339100ca61eed05c2ed7ee2fb629ced7716-Screenshot_2024-10-17_at_11.17.31(1).png?sv=2026-02-06&spr=https&st=2026-11-04T08%3A57%3A07Z&se=2026-11-04T09%3A57%3A07Z&sr=c&sp=r&sig=H4hZ2LbZRgcDGi3dWXZcsT%2Bq5Hzat0li%2FKMYKeIf%2Fbw%3D)

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**

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

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

**Swift**

```swift
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](/documentation/docs/pt-br/api-triggered-campaigns) e executando-a usando o endpoint [externo de execução da campanha](/ref:campaign-execute) . Defina a flag **de push_silent** para **1** na carga útil da mensagem.

> [!WARNING]
> 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](https://developer.apple.com/documentation/usernotifications/pushing-background-updates-to-your-app).

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

**Exemplo de iOS:**

**Exemplo para iOS**

```shell
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":""
          }
        ]
      }
    }
  }'
```

**Exemplo do Android**

```powershell
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":""
           }
        ]
     }
  }
}'
```