---
title: "Caixa de entrada do iOS"
slug: "ios-inbox"
updated: 2026-06-12T10:30:57Z
published: 2026-06-12T10:30:57Z
canonical: "docs.xtremepush.com/ios-inbox"
---

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

# Caixa de entrada do iOS

Guia de integração para implementar uma caixa de entrada no seu app iOS

O canal [da caixa de entrada](/documentation/docs/pt-br/campaign-inbox) permite que você persista as notificações enviadas para um usuário em uma caixa de entrada dentro do app. Também permite enviar mensagens para usuários que não aderiram a notificações push, pois essas mensagens chegam à caixa de entrada como um feed quando o app é aberto. Você também não está limitado pelo formato de notificação push e pode usar um estilo mais rico nas mensagens da caixa de entrada.

![432](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/6884ab8-Screenshot_2021-04-14_at_17.15.51(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D)

Exemplo da caixa de entrada integrada em um app iOS.

Guias de integração para aplicativos baseados em Objective-C e Swift abaixo.

> [!NOTE]
> **Certifique-se de ter configurado a caixa de entrada na plataforma antes de começar, isso é um pré-requisito. Confira nosso** [**guia rápido inicial na caixa de entrada**](/documentation/docs/pt-br/quick-start-inbox) **para mais detalhes.**

## Configuração básica

### Ativando a Caixa de Entrada

Na integração padrão descrita no [guia de integração do iOS](/documentation/docs/pt-br/ios-sdk-integration) , a caixa de entrada está desligada. Ele pode ser ativado usando o `setInboxEnabled` método. No seu app iOS, onde você inicializou o Xtremepush no delegado do app, adicione:

**Swift**

```swift
XPush.setInboxEnabled(true)
```

**Objective-C**

```objectivec
[XPush setInboxEnabled:YES];
```

Antes

**Swift**

```swift
XPush.applicationDidFinishLaunchingWithOptions(launchOptions);
```

**Objective-C**

```objectivec
[XPush applicationDidFinishLaunchingWithOptions:launchOptions];
```

Como mostrado abaixo:

**Swift**

```swift
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
        // Override point for customization after application launch.
        //Start - Initialise XPush
        //...
        XPush.setInboxEnabled(true)
        XPush.registerForRemoteNotificationTypes(NotificationSettings.getNotificationSettings())
        XPush.applicationDidFinishLaunchingWithOptions(launchOptions)
        //End - Initialise XPush
```

**Objective-C**

```objectivec
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// ... 
[XPush setInboxEnabled:YES]; 
// ... 
[XPush applicationDidFinishLaunchingWithOptions:launchOptions]; return YES; }
```

Você também precisará adicionar um elemento de interface (um botão) para abrir a caixa de entrada. Quando apertado, esse botão abre a caixa de entrada. Você pode, por exemplo, usar um ícone de notificação como um sino na barra de menus.

![748](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/715800c-Inbox_Button(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D)

Onde quer que você esteja lidando com suas interações com esse botão, pode abrir a caixa de entrada pelo seguinte método:

**Swift**

```swift
XPush.openInbox();
```

**Objective-C**

```objectivec
[XPush openInbox];
```

### Adicionar emblemas

Se você quer que seu ícone exiba um distintivo quando um usuário tiver novas mensagens na caixa de entrada desde a última vez que foi aberta, veja abaixo, existe um tipo de botão Xtremepush que pode ser usado para isso `XPInboxButton`.

![750](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/0c6c0dc-Inbox_Badge_small(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D)

#### Objective-C

Para implementar a insígnia, basta transformar o botão de notificação em *um XPInboxButton,* por exemplo:

Crie seu elemento de botão:

```objectivec
XPInboxButton *button = [[XPInboxButton alloc] init];
```

Configure o botão. `XPInboxButton` herda do UIButton, então você pode lidar com isso como no UIButton.

Assim, pode definir o tamanho e a imagem:

```objectivec
[button setFrame:CGRectMake(0, 0, 24, 24)];
[button setImage:someImage forState:UIControlStateNormal];
```

`XPInboxButton` Tem alguns auxiliares para mudar rapidamente a cor do distintivo:

```objectivec
// set badge background color default is red
- (void)setBadgeColor:(UIColor *)color;

// set color of the text used for number on badge default is white
- (void)setBadgeTextColor:(UIColor *)color;
```

Você pode deixar o distintivo azul, por exemplo:

```objectivec
[button setBadgeColor: [UIColor redColor]];
```

Você também pode acessar o próprio elemento de distintivo, que é apenas um `UILabel` objeto:

```objectivec
[button.badge setAnyUILabelAttribute:...]
```

Quando estiver pronto, adicione o botão a uma vista. Por exemplo, como item na barra de navegação:

```objectivec
UIBarButtonItem *barButton = [[UIBarButtonItem alloc] initWithBarButtonSystemItem:UIBarButtonSystemItemCompose target:nil action:nil];
>barButton.customView = button;
self.navigationItem.leftBarButtonItem = barButton;
```

Ou de qualquer outra forma, como:

```objectivec
[someView addSubview: button];
```

#### Swift

Para implementar a insígnia, basta transformar o botão de notificação em *um XPInboxButton,* por exemplo:

Crie seu elemento de botão, por exemplo, se você usar um storyboard, pode definir a classe personalizada para `XPInboxButton`ser:

![514](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/4b4fa0a-XPInboxButton(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A53Z&se=2026-11-04T10%3A28%3A53Z&sr=c&sp=r&sig=jEmFd6Zh%2BPkFfkL%2Bbs3scpBF3nY1aH8hqzRvB9aiCMA%3D)

E quando adicionado ao seu código, vai parecer:

```swift
@IBOutlet weak var InboxButton: XPInboxButton!
```

Configure o botão para o visual `XPInboxButton` que você quer, herda do UIButton, assim você pode lidar com ele como no UIButton para definir o tamanho, a imagem etc.

`XPInboxButton` Também tem alguns ajudantes para mudar rapidamente a cor do distintivo:

```swift
// set badge background color default is red
// setting custom blue here:
InboxButton.setBadgeColor(UIColor.init(red: 0.114, green: 0.525, blue: 0.784, alpha: 1))
        
// set color of the text used for number on badge default is white
// setting dark grey here
InboxButton.setBadgeTextColor(UIColor.darkGrayColor())
```

Você também pode acessar o próprio elemento do distintivo, que é apenas um objeto do UILabel, e pode, por exemplo, mover o distintivo para que ele combine melhor com sua imagem

```swift
//For example move badge to be inset by 5px from top right of image
InboxButton.imageEdgeInsets = UIEdgeInsetsMake(5, 0, 0, 5)
```