Se você usa o Chatwoot em uma VPS própria, provavelmente já percebeu que as notificações do navegador são extremamente úteis para não perder mensagens. O que muita gente não sabe é que o Chatwoot utiliza Web Push com VAPID Keys, e uma configuração incorreta faz com que o sino de notificações simplesmente não apareça.

Neste guia vamos configurar tudo do zero.

O que são notificações Push?

As notificações push permitem que o navegador (Chrome, Edge, Firefox, Safari) receba alertas mesmo quando a aba do Chatwoot não está aberta.

Exemplo:

• Novo atendimento chegou
• Cliente respondeu uma conversa
• Conversa foi atribuída a você

Tudo isso aparece como uma notificação nativa do sistema operacional.

O que são VAPID Keys?

VAPID significa:

Voluntary Application Server Identification

São duas chaves criptográficas:

• VAPID_PUBLIC_KEY
• VAPID_PRIVATE_KEY

Elas servem para autenticar o seu servidor perante os navegadores, permitindo o envio das notificações Web Push.

Como gerar as VAPID Keys

Opção 1 (Recomendada): via web-push

Instale:

npm install -g web-push

Depois execute:

web-push generate-vapid-keys

Resultado:

=======================================
Public Key:
BOzzMgOMwVyuziwHiI8Aw9sjs2jcxxC9ivxAGz2Qsue-Vty4lpqRDl6MWvGxJ5UTiNLrkYjHBYSKJCv4NYF1_0c

Private Key:
BNw7fc1ayj3-Az-OJ8DrOj3EDAHCORwO_r3SsrpwkzQ
=======================================

Guarde essas chaves em local seguro.

Configurando no Chatwoot

Edite seu .env

Adicione:

VAPID_PUBLIC_KEY=COLE_AQUI
VAPID_PRIVATE_KEY=COLE_AQUI

Exemplo:

VAPID_PUBLIC_KEY=BOzzMgOMwVyuziwHiI8Aw9sjs2jcxxC9ivxAGz2Qsue-Vty4lpqRDl6MWvGxJ5UTiNLrkYjHBYSKJCv4NYF1_0c

VAPID_PRIVATE_KEY=BNw7fc1ayj3-Az-OJ8DrOj3EDAHCORwO_r3SsrpwkzQ

Essas variáveis fazem parte da configuração oficial do Chatwoot.

Reinicie os containers

Docker Compose:

docker compose down
docker compose up -d

Ou:

docker restart chatwoot

Se estiver usando Portainer, basta reiniciar a stack.

Verifique se HTTPS está funcionando

As notificações Push só funcionam com HTTPS.

Seu domínio deve estar assim:

https://chat.suaempresa.com

Se estiver usando:

http://

as notificações não funcionarão.

Liberando notificações no navegador

Abra o Chatwoot.

Quando aparecer:

Permitir notificações?

Clique em:

Permitir

Caso não apareça:

Chrome

Clique no cadeado ao lado do domínio:

Notificações → Permitir

Ou vá em:

Configurações
→ Privacidade e Segurança
→ Configurações do Site
→ Notificações

e permita seu domínio.

Configurando as preferências do usuário

No Chatwoot:

Perfil
→ Configurações
→ Notifications

Ative:

• Browser notifications
• Audio notifications
• Assignment notifications
• Conversation notifications

As notificações são individuais por usuário.

Como testar

Abra o Chatwoot em um navegador.

Depois:

1. Abra uma aba anônima.
2. Inicie uma conversa.
3. Envie uma mensagem.
4. Feche a aba principal do Chatwoot.
5. Aguarde.

Se tudo estiver correto, uma notificação aparecerá no sistema operacional.

E as notificações do aplicativo oficial?

As notificações do app Android e iPhone funcionam através do Push Relay Server do Chatwoot.

Garanta que exista:

ENABLE_PUSH_RELAY_SERVER=true

Assim, as notificações do aplicativo oficial continuarão funcionando em instalações self-hosted.

Usando um aplicativo próprio (White Label)

Se você possui um app personalizado, precisará configurar Firebase.

No painel Super Admin:

Super Admin
→ App Config

Preencha:

FIREBASE_PROJECT_ID

Exemplo:

meu-app-12345

FIREBASE_CREDENTIALS

Cole todo o JSON da Service Account do Firebase.

A partir daí o Chatwoot enviará notificações diretamente pelo FCM v1.

Problemas comuns

Não aparece o pedido de permissão

Limpe os dados do site:

Chrome
→ Cadeado
→ Configurações do site
→ Limpar dados

Recarregue a página.

Não uso HTTPS

Web Push não funciona sem SSL.

Configure Cloudflare, Traefik ou Nginx com certificado válido.

As VAPID Keys mudaram

Se trocar as chaves, os navegadores precisarão se registrar novamente.

Às vezes é necessário:

• Limpar cache do navegador.
• Remover permissões.
• Autorizar novamente.

Estou atrás do Cloudflare

Certifique-se que o WebSocket e HTTPS estão funcionando normalmente.

O sino de notificações não aparece

Verifique:

VAPID_PUBLIC_KEY=
VAPID_PRIVATE_KEY=
FRONTEND_URL=https://seu-dominio.com

E reinicie os containers.

Conclusão

As notificações Push do Chatwoot dependem basicamente de quatro componentes:

✅ HTTPS funcionando

✅ VAPID_PUBLIC_KEY

✅ VAPID_PRIVATE_KEY

✅ Permissão do navegador

Quando tudo está configurado corretamente, o Chatwoot se comporta praticamente como um aplicativo nativo, permitindo que sua equipe responda clientes rapidamente sem precisar manter a aba aberta o tempo inteiro.

Se você utiliza Chatwoot self-hosted em produção, configurar o Web Push é uma das melhorias mais simples e que mais aumentam a velocidade de atendimento. 🚀