Você devia receber push quando bot agenda novo cliente, cobrança paga, etc. Não chega? 5 causas comuns.
Causa 1 — Permissão negada no navegador
A primeira vez que você abriu a Kontato, ele pediu permissão pra notificações. Se você clicou "Bloquear", push nunca chega.
Verificar:
Chrome desktop:
- Click no cadeado/ícone à esquerda da URL
- Notificações → deve estar como "Permitir"
- Se "Bloquear", muda pra "Permitir" → recarrega a página
Chrome mobile:
- Configurações do app → Notificações (do app Chrome) → permitir pra
kontato.themagicbox.app - Ou: Ajustes do Site → permitir notificações
Safari iOS:
- Ajustes do iPhone → Notificações → Kontato → permitir
- ⚠️ Safari aba NÃO suporta push — precisa PWA instalado (próxima causa)
Causa 2 — iOS sem PWA instalado
iOS 16.4+ suporta Web Push, mas SÓ em PWA instalado — não em Safari aba normal.
Fix:
Safari iOS → abre https://kontato.themagicbox.app.
Click no botão de compartilhar (quadrado com seta pra cima).
Scroll → "Adicionar à Tela de Início".
Confirma. Ícone Kontato aparece na tela inicial.
Abre pelo ícone (não pelo Safari).
Vai em Configurações → Notificações → Permitir push.
iOS pede permissão (popup). Aceita.
Pronto — próximas notifs chegam.
Causa 3 — Dispositivo não registrado
Permissão tá OK mas push não chega. Provavelmente registro do dispositivo no AG Push falhou.
Fix:
Em Configurações → Conta → Notificações.
Click no toggle "Push notifications" → desliga, espera 5s, liga de novo.
Sistema re-registra o dispositivo no AG Push (FCM token novo).
Click "Enviar push de teste". Deve chegar em ~5s.
Causa 4 — Modo de bateria / não perturbe / foco
Sistema operacional suprime push em alguns modos:
- Modo bateria baixa (iOS/Android) — atrasa ou bloqueia push de apps não essenciais
- Modo Não Perturbe — silencia tudo
- Modo Foco (iOS) — só apps autorizados notificam
Fix: desativa esses modos OU adiciona Kontato à whitelist do modo Foco.
Causa 5 — Service Worker não rodou (PWA)
Push depende do Service Worker rodando em background. Se SW falhou:
Sintoma: push de teste NÃO chega mesmo após re-registrar.
Fix:
Abre Kontato.
F12 (DevTools) → aba Application → Service Workers.
Verifica se SW está "activated and running".
Se não, click "Update" ou "Unregister" → recarrega a página.
Volta na aba e re-registra (Configurações → Notificações → toggle).
Push chega mas sem som
Browser pode estar configurado pra não tocar som em notificações:
- Chrome:
chrome://settings/content/sound - Mobile: configurações de notificação do app
Push notifs da Kontato respeitam configuração do sistema — não tem som customizado nosso.
Push chega atrasada (5min, 10min)
iOS especialmente prioriza push baseado em uso do app. Se você não abre a Kontato há horas, push pode demorar.
Fix: mantém PWA aberto em segundo plano.
⚠️ Não tem como forçar push imediato em iOS — limitação do OS.
Push pra você (dono) vs cliente
Lembra:
- Push pra dono (você) — chega no app Kontato, sobre eventos do sistema
- Mensagem WhatsApp pro cliente — não é "push", é WhatsApp normal
Esses são canais totalmente separados. Cliente nunca recebe "push da Kontato" — só você.