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

# Configurar no site (Web)

> Passo a passo para colocar push no seu site: domínios, script e arquivo sw.js na Notifique.

<Tip>
  É como **instalar o interfone do prédio no seu site**: você diz quais endereços podem usar, cola um trecho de código na página e o visitante passa a receber avisos no navegador.
</Tip>

## Em poucas palavras

1. Crie o **Push App** na Notifique e copie o **appId**
2. Em **⚙️ Configurações → Web**, liste os **domínios** do seu site
3. Baixe o arquivo **sw\.js** (sw-loader) e coloque na raiz do site
4. Cole o **script** no `<head>` do site, o mesmo que aparece no painel
5. Abra o site, aceite notificações e teste pelo painel

## O que você vai fazer no painel

| Onde                           | O que é                                              |
| ------------------------------ | ---------------------------------------------------- |
| Tela do Push App → aba **Web** | Copiar o código pronto (script)                      |
| **⚙️ Configurações → Web**     | Lista de domínios permitidos (ex.: `meusite.com.br`) |
| Botão **Baixar sw-loader**     | Arquivo que vira `sw.js` no seu site                 |

<Note>
  O **appId** já está dentro do script, você só cola. Não precisa de chave de API no site.
</Note>

## Passo 1: Criar o Push App

1. Abra [app.notifique.dev](https://app.notifique.dev) → **Push** → **Novo app**
2. Dê um nome (ex.: “Site da loja”)
3. Anote o **appId**, aparece na tela do app

## Passo 2: Domínios permitidos

1. Na tela do app, clique em **⚙️** (configurações)
2. Expanda a seção **Web**
3. No campo de domínios, coloque **um endereço por linha**, sem `https://`:
   * `meusite.com.br`
   * `www.meusite.com.br`
   * `app.meusite.com.br` (se usar subdomínio)
4. Clique em **Salvar alterações**

Se deixar vazio, qualquer site com seu appId poderia registrar, **recomendamos sempre listar os seus domínios**.

## Passo 3: Arquivo sw\.js (recomendado)

O navegador precisa de um arquivo pequeno na raiz do site para entregar os avisos com o nome do seu domínio.

1. Na aba **Web** do Push App, clique em **Baixar sw-loader**
2. Salve o arquivo como **`sw.js`** no projeto do site
3. Ele precisa abrir em `https://seusite.com/sw.js` (ex.: pasta `public/sw.js` em muitos projetos)

Esse arquivo é uma linha que aponta para a Notifique, **não precisa editar** depois.

## Passo 4: Colar o script no site

1. Na aba **Web**, copie o código da seção **Cole este código** (modo com Service Worker / sw\.js)
2. Cole no **`<head>`** do site, antes do `</head>`
3. O trecho já traz o `appId` e a linha `swPath: '/sw.js'`

Exemplo do que você vai colar (o `appId` será o seu):

```html theme={null}
<script src="https://api.notifique.dev/v1/push/scripts/notifique-push.js"></script>
<script>
  NotifiquePush.init({ appId: 'SEU_APP_ID', swPath: '/sw.js' });
</script>
```

Publique o site com o `sw.js` e o script no ar.

## Passo 5: Testar

1. Abra o site no navegador (Chrome, Firefox ou Edge)
2. O site pode pedir **Permitir notificações**, aceite
3. No painel Notifique, envie um push de teste para esse app
4. O aviso deve aparecer no computador ou celular

## Não consigo colocar o sw\.js? (Wix, Shopify, etc.)

Alguns construtores de site **não deixam** subir arquivo na raiz. Nesse caso:

1. Na aba **Web**, use o modo **sem hospedar arquivo** (fallback)
2. Cole só o script **sem** `swPath`
3. Funciona, mas o aviso pode aparecer com o nome da Notifique em vez do seu site

Para a melhor experiência, prefira sempre o **sw\.js** no seu domínio.

## Deu errado?

| O que aconteceu     | O que conferir                                                      |
| ------------------- | ------------------------------------------------------------------- |
| Nada pede permissão | Script no `<head>`? Console do navegador sem erro?                  |
| Permissão negada    | Usuário bloqueou, teste em aba anônima ou outro navegador           |
| Push não chega      | Domínio do site está na lista em ⚙️ Web? `sw.js` abre no navegador? |
| Erro de domínio     | URL do site tem que bater com um domínio listado (com ou sem `www`) |

## Próximos passos

* [Integrar apps](/push-api/integracao/index), visão geral
* [Quick Start API](/push-api/como-funciona/quick-start), para desenvolvedores que enviam pelo backend
