1. Documentação
  2. Primeiros passos
  3. Início rápido
Ir para Dashboard
  • Documentação do Pushwi
  • Início rápido
  • Instalação do SDK
  • Referência do SDK
  • Soft-ask
  • Migração de outro provedor
  • Identificação de usuários
  • Segmentos
  • Campanhas
  • Descadastro e LGPD
  • Webhooks

Início rápido

Instale o SDK, publique o service worker e envie a primeira campanha pela API.

Loading documentation…

Documentação do Pushwi< PreviousInstalação do SDKNext >

Powered by heyo

On this page

Próximos passos
  1. 1

    Cole o snippet no <head>

    Em Widget › Snippet, copie a tag abaixo, já com o ID do seu site, e cole antes de fechar o </head> em todas as páginas:

    html
    <script async src="https://sdk.pushwi.com/v1/pushwi.js" data-site="pub_XXXXXXXXXXXXXXXXXXXXXXXX"></script>
  2. 2

    Publique o pushwi-sw.js na raiz

    Crie ou baixe arquivo pushwi-sw.js com este conteúdo:

    js
    self.PUSHWI_API = self.PUSHWI_API || "https://api.pushwi.com";self.PUSHWI_SDK = self.PUSHWI_SDK || self.PUSHWI_CDN || "https://sdk.pushwi.com";importScripts(self.PUSHWI_SDK + "/v1/pushwi-sw-core.js");
  3. 3

    Confira as origens permitidas

    Em Widget › Origens ficam os endereços de onde o SDK pode chamar a API. O painel já cadastra https://seu-dominio.com.br e https://www.seu-dominio.com.br. Se o snippet também roda em homologação ou em outro subdomínio, inclua esses endereços também, ou a API recusa as chamadas com 403.

  4. 4

    Inscreva-se no seu próprio site

    Abra o site, aceite as notificações e veja o assinante aparecer em Assinantes no painel. A inscrição é processada e costuma aparecer em poucos segundos.

  5. 5

    Envie uma campanha pela Dashboard ou se preferir na API

    Em Desenvolvedor › Chaves de API, crie uma chave do tipo secret (sk_live_…). Ela aparece uma única vez, então guarde.

    bash
    curl https://api.pushwi.com/v1/campaigns \  -H "Authorization: Bearer sk_live_SUA_CHAVE" \  -H "Content-Type: application/json" \  -d '{    "action": "send",    "content": {      "title": "Funcionou!",      "body": "Primeira notificação enviada pela API do Pushwi.",      "url": "https://seu-dominio.com.br"    }  }'

    A resposta 201 traz o ID da campanha. Sem segment_id, ela vai para todos os assinantes ativos, que neste momento é só você.

Atenção!

A sk_live_ dá acesso total à API do site: cria campanhas e apaga assinantes. Guarde em variável de ambiente no servidor e nunca coloque no HTML ou no JavaScript da página.

Próximos passos

  • Conectar o assinante ao usuário logado com identificação de usuários.
  • Use tags e atributos para montar segmentos customizados.
  • Receba avisos de envio no seu sistema com webhooks.