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

# Credenciais iOS (Apple)

> Como criar a chave na Apple e colar as informações no painel da Notifique.

<Tip>
  A Apple exige um **crachá oficial** para mandar avisos no iPhone. Você cria esse crachá no site da Apple e cola os dados na Notifique, como entregar a chave do porteiro para quem vai tocar o interfone.
</Tip>

## Em poucas palavras

1. Tenha uma **conta de desenvolvedor Apple** (paga, anual)
2. Crie o registro do app e uma **chave de notificação**
3. Anote quatro informações e cole no painel **⚙️ Configurações → iOS**

## O que você vai colar na Notifique

| No painel Notifique | Onde achar na Apple                                          |
| ------------------- | ------------------------------------------------------------ |
| **Key ID**          | Depois de criar a chave, código de 10 letras/números         |
| **Team ID**         | Menu **Membership**, código da sua equipe                    |
| **Bundle ID**       | O “nome de registro” do app (ex.: `com.suaempresa.app`)      |
| **Chave .p8**       | Arquivo que você baixa ao criar a chave (só baixa uma vez!)  |
| **Produção**        | Ligado para app publicado; desligado só para testes internos |

<Note>
  O **Bundle ID** tem que ser igual no site da Apple, no Xcode e na Notifique, como o CPF do app no iPhone.
</Note>

## Passo 1: Conta Apple Developer

1. Acesse [developer.apple.com](https://developer.apple.com)
2. Entre com seu Apple ID
3. Se ainda não tiver, inscreva-se no **Apple Developer Program** (assinatura anual)
4. Aguarde a aprovação da Apple

## Passo 2: Anotar o Team ID

1. No portal, abra **Membership** (Associação)
2. Copie o **Team ID**, são 10 caracteres (ex.: `AB12CD34EF`)

Guarde num bloco de notas, você vai colar na Notifique.

## Passo 3: Registrar o app na Apple

1. Vá em **Certificates, Identifiers & Profiles**
2. **Identifiers** → botão **+**
3. Escolha **App IDs** → Continue
4. Tipo **App** → Continue
5. Dê um nome (ex.: “Meu App Loja”)
6. Em **Bundle ID**, escolha **Explicit** e digite ex.: `com.suaempresa.app`
7. Marque **Push Notifications** na lista de recursos
8. Registre

## Passo 4: Criar a chave de notificação

1. No mesmo portal: **Keys** → **+**
2. Nome da chave (ex.: “Notifique avisos”)
3. Marque **Apple Push Notifications service (APNs)**
4. Continue → Register
5. **Baixe o arquivo `.p8` agora**, a Apple não deixa baixar de novo
6. Anote o **Key ID** que aparece na tela

<Warning>
  Perdeu o `.p8`? Crie uma chave nova na Apple e atualize na Notifique.
</Warning>

## Passo 5: Ajustar o app no Xcode (seu desenvolvedor)

Peça para quem cuida do app iPhone:

1. Abrir o projeto no Xcode
2. Confirmar que o **Bundle Identifier** é o mesmo do passo 3
3. Adicionar **Push Notifications**
4. Adicionar **Background Modes** → marcar **Remote notifications**

Teste em **iPhone de verdade**, no simulador o aviso quase não funciona.

## Passo 6: Colar na Notifique

1. Abra [app.notifique.dev](https://app.notifique.dev) → **Push** → seu app
2. Clique em **⚙️**
3. Desça até **iOS**
4. Preencha Key ID, Team ID e Bundle ID
5. Abra o arquivo `.p8` no Bloco de Notas (ou similar) e cole **tudo**, incluindo as linhas `BEGIN` e `END`
6. **Produção**: deixe ligado se o app já está na App Store ou TestFlight; desligue só para testes de desenvolvimento
7. **Salvar alterações**

## Passo 7: Testar

1. Tela do Push App → aba **iOS** → copie o código
2. Rode o app em um iPhone real e aceite “Permitir notificações”
3. Envie um aviso de teste pelo painel

## Deu errado?

| O que aconteceu        | O que conferir                                                             |
| ---------------------- | -------------------------------------------------------------------------- |
| Bundle não configurado | Bundle ID vazio ou diferente do Xcode                                      |
| Aviso não chega        | iPhone real (não simulador); notificações permitidas; chave Produção certa |
| Chave rejeitada        | Cole o `.p8` inteiro; Key ID e Team ID corretos                            |

## Próximos passos

* [Colocar o código no app iPhone](/push-api/integracao/ios)
* [Ver todos os guias](/push-api/integracao/index)