Migração de outro provedor

Quem já usa outro serviço de web push não perde a base ao trocar para o Pushwi, mas também não leva as inscrições prontas. A inscrição de push é ligada à chave VAPID de quem a criou, então os assinantes do provedor antigo só passam a receber do Pushwi quando voltam ao site com o SDK novo instalado.

O que o SDK faz

Na hora da inscrição, o SDK procura service workers de outros provedores registrados no mesmo site. Quando encontra, cancela a inscrição de push deles, remove o worker e cria uma inscrição nova com a chave do Pushwi. Se a permissão do navegador já estava concedida para o site, isso acontece sem nenhum pedido novo: o visitante nem percebe.

A inscrição chega à API com migration.from indicando de onde veio. Esse valor fica no dispositivo e pode ser usado em segmentos com a regra migrated_from, por exemplo para mandar uma mensagem de boas-vindas só para quem veio do provedor antigo.

Provedores reconhecidos

O SDK identifica o provedor pelo endereço do service worker ou por variáveis globais na página:

aimtell, airship, braze, clevertap, frizbit, gravitec, izooto, moengage, notix, onesignal, pushalert, pushcrew, pushengage, pushnews, pushwoosh, sendpulse, subscribers, truepush, webpushr e wonderpush.

Quando o navegador tinha uma inscrição de push que não é de nenhum desses, o valor enviado é native.

Assumir todo o push

Por padrão, só os workers dos provedores da lista perdem o push. O worker de um PWA, de um chat ou das notificações do próprio site fica intacto.

A opção Assumir todo o push deste site, em Widget no painel, muda isso: o SDK cancela a inscrição de push de qualquer outro service worker do site. Ligue só se o Pushwi vai substituir tudo. Notificações próprias, como "pedido enviado" ou "nova mensagem no chat", deixam de chegar.

Passo a passo

1. Instale o snippet e o pushwi-sw.js do Pushwi.
2. Remova o script do provedor antigo das páginas. Se ele continuar carregando, vai recriar o worker dele a cada visita.
3. Acompanhe em Assinantes os dispositivos com origem de migração. A base volta conforme os visitantes retornam ao site, então o ritmo acompanha a frequência de visitas.
4. Mantenha a conta no provedor antigo enquanto houver gente que ainda não voltou ao site: as inscrições antigas continuam valendo lá até a pessoa visitar o site de novo.