Notificações push — setup e gatilhos

Push é o canal pelo qual você (dono) recebe alertas em tempo real da Kontato — novo agendamento, pagamento, cliente sumiu, backlog pendente, etc. 27 gatilhos distintos cobrem todo o ciclo operacional.

Push é pro DONO. WhatsApp é pro CLIENTE. A Kontato nunca manda push pro cliente final — ele recebe via WhatsApp/Telegram normalmente. Push é canal exclusivo de notificação operacional pra você.

Como ativar pela primeira vez

Desktop (Chrome/Edge/Firefox/Safari)

Faça login na Kontato (https://kontato.themagicbox.app)
Browser pode pedir permissão automaticamente OU você precisa clicar no ícone 🔔 (sino) no AppHeader
Aparece popup: "Kontato quer enviar notificações"
Click "Permitir"
Pronto — primeira notificação de teste deveria chegar em segundos

Se você clicou "Bloquear" sem querer, abra: ícone cadeado da URL → "Permissões do site" → mudar Notificações pra "Permitir" → recarregar página.

Mobile (iPhone/Android)

Push em mobile exige PWA instalado — não funciona em browser comum.

Acesse https://kontato.themagicbox.app no Safari (iPhone) ou Chrome (Android)
Instalar PWA:
- iPhone Safari: botão Compartilhar → "Adicionar à Tela de Início"
- Android Chrome: menu ⋮ → "Instalar app" ou "Adicionar à tela inicial"
Abrir o ícone da Kontato instalado (não o browser)
Login dentro do PWA
Permitir notificações quando aparecer popup
Pronto — push agora chega como notificação nativa do celular

iOS: push em PWA só funciona no iOS 16.4+ (lançado em março 2023). Versões anteriores não suportam.

Multi-dispositivo

Você pode ter o mesmo login ativo em vários dispositivos (laptop + celular + tablet). Como funciona:

Cada dispositivo registra individualmente sua chave de push (VAPID subscription)
Toda notificação dispara em TODOS os dispositivos logados
Exemplo: você está no laptop com push ON e celular com PWA instalado → recebe nos 2

Quando isso atrapalha

Você quer parar de receber no laptop quando sair do trabalho → desative push pelo browser (ícone cadeado URL → bloquear)
Você quer receber só no celular → desinstale PWA do laptop ou use modo anônimo lá

Os 27 gatilhos (P01-P27)

Cada notificação push tem um código identificando o tipo. Você pode ligar/desligar individualmente em Notificações.

Categorias

🤖 Bot e atendimento

P01 — Novo atendimento iniciado pelo cliente
P02 — Bot não soube responder (fallback → backlog)
P03 — Cliente pediu atendimento humano
P23 — Bot detectou inconsistência na base
P24 — Bot precisa de informação faltante
P25 — Lembrete de backlog pendente (24h sem resposta)
P27 — Conversa pausada por intervenção humana

📅 Agendamento

P04 — Novo agendamento (via bot)
P05 — Agendamento cancelado pelo cliente
P06 — Agendamento reagendado pelo cliente
P07 — Lembrete de agenda do dia (manhã)
P17 — Bloqueio criado com remarcações pendentes
P18 — Cliente remarcou (pós-bloqueio)
P19 — Cliente não respondeu (3 tentativas esgotadas)
P20 — Todos os afetados foram remarcados
P21 — Cliente remarcou via bot (espontâneo)
P22 — Cliente cancelou via bot (espontâneo)

👥 Clientes

P16 — Novo cliente cadastrado automaticamente
P26 — Cliente atingiu prazo de recorrência (sumiu)

💎 Fidelidade

P08 — Cliente resgatou benefício fidelidade

💰 Cobranças

P09 — Pagamento recebido
P10 — Pagamento vencido/não pago

💳 Billing Kontato

P11 — Isenção total atingida no mês
P12 — Projeção de isenção próxima
P13 — Fatura gerada (dia 2)
P14 — Fim do trial se aproximando (3 dias)
P15 — Trial encerrado

P11/P12/P13/P14/P15 são notificações sobre a SUA assinatura Kontato (TMB cobrando você), não cliente final pagando você.

Toggle individual (F90)

Em Configurações → Notificações você desliga gatilhos específicos. Útil quando:

Push está chegando demais (escolha quais manter)
Operação noturna não quer P09 (pagamento) batendo às 3am
Multi-dono — cada dono pode preferir gatilhos diferentes

Toggles são por dono, não por negócio. Se 2 sócios usam o mesmo Kontato, cada um configura seus próprios.

Push vs WhatsApp — quando o sistema escolhe um

Situação	Canal
Cliente fala com o bot	WhatsApp (cliente recebe) + Push (dono fica sabendo)
Cliente paga via Pix	WhatsApp (confirma pro cliente) + Push (avisa o dono)
Backlog precisa de atenção	Apenas Push (dono — cliente não tem o que ver)
Lembrete D-1 ao cliente	Apenas WhatsApp (cliente — dono já sabe)
Trial vai expirar	Apenas Push (dono — cliente não tem trial)

Regra simples:

Cliente sempre via WhatsApp
Dono geralmente via Push (operação) + WhatsApp em casos críticos (cobranças vencidas)

Notificações que NÃO existem

Pra evitar expectativa errada:

❌ Push pro cliente — cliente final nunca recebe push da Kontato
❌ Email transacional pro dono — só Resend pra emails da TMB (recovery senha, etc)
❌ SMS — não suportado
❌ Som customizado por gatilho — usa som padrão do dispositivo

Edge cases

Push não chega mesmo com permissão "Permitir"

Ver Push não chega — checklist completo.

Trocou de celular

Push antigo continua registrado no servidor mas não chega (dispositivo offline). Faça login no celular novo e permita push — sistema vai começar a enviar pro novo. Antigo cai em "expired" automaticamente após X dias sem resposta.

Notificação chegou mas você não estava online

Push é fire-and-forget com persistência APENAS no aparelho. Se você não viu na hora, vai aparecer na "central de notificações" do dispositivo até você descartar. Sem fila no servidor — não há "ver últimas push perdidas" na Kontato.

Modo "Não perturbe" do celular

Sistema operacional pode silenciar notificações. Push da Kontato respeita isso — não há prioridade de emergência.

Push em modo anônimo do browser

Funciona enquanto a aba está aberta. Ao fechar, registro some. Use modo normal pra push persistente.

Privacy

Push contém apenas o texto da notificação (ex: "Pagamento de R$150 recebido de João")
Não inclui dados sensíveis (CPF, telefone completo, valor de outras cobranças)
Notificação clicada abre o app na tela relevante (ex: P09 abre /pagamentos)

Próximos artigos

Notificações (todos os toggles) — controle granular
Push não chega (troubleshooting) — checklist