Esta página ainda não foi traduzida: mostrando a versão em inglês.
Alertas e notificações
As notificações chegam aos seus próprios canais do Slack quando algo muda no seu projeto ou na plataforma. Você adiciona incoming webhooks do Slack e escolhe, para cada webhook, quais tipos de alerta ele recebe. Os webhooks são configurados por projeto e Environment em Project settings → Notifications: abra Projects, clique no ícone de configurações no card de um projeto e vá para a aba Notifications.
Sobre o que você pode ser alertado
Três tipos de alerta, cada um ativado ou desativado por webhook.
| Tipo | Enviado quando | O que a mensagem traz |
|---|---|---|
| Deployment | Uma Function recebe um deploy ou um novo Environment é criado no projeto. | A Function e o deploy dela, ou o novo Environment, o Environment do qual foi copiado e o estado dele. |
| Schema change | Uma migração de Schema é aplicada. | A migração e a versão do Schema que ela gerou. |
| Health status | A saúde geral da plataforma piora (para amarelo ou vermelho) e, de novo, quando se recupera. | O novo status, o anterior e quais sistemas estão em vermelho ou amarelo. |
Os alertas de Health status descrevem a plataforma PlayServ como um todo, não o seu projeto: todo webhook com esse tipo ativado recebe o mesmo alerta. Um alerta só é enviado quando o status piora, então um incidente longo gera uma única mensagem, e não uma por minuto. O alerta de recuperação vem depois que a plataforma informa estar saudável três vezes seguidas. O significado das cores está explicado na Página de status pública.
Adicionar um webhook
Crie o webhook no Slack
Crie um incoming webhook para o canal que deve receber os alertas e copie a URL dele.
Adicione-o ao projeto
Em Project settings → Notifications, clique em Add webhook. Dê a ele um Name, por exemplo o nome do canal, e cole a Webhook URL; ela precisa ser um endereço de incoming webhook do Slack (https://hooks.slack.com/…). Deixe Enabled marcado e clique em Add webhook.
Escolha o que ele recebe
Ative os tipos de alerta que este webhook deve receber.
A PlayServ guarda apenas a URL do webhook: não há app do Slack para instalar nem token do Slack para entregar. Qualquer pessoa com a URL pode postar no canal, então trate-a como um segredo.
Um webhook novo não envia nada até você ativar um tipo
O roteamento vem desativado por padrão. Enquanto nenhum tipo estiver ativado para um webhook, os alertas dele não são entregues e aparecem na fila como dropped.
| Ação | O que acontece |
|---|---|
| Test | Envia uma mensagem de teste e mostra o resultado na própria linha: entregue, com a latência, ou com falha, com o status HTTP e o erro. Um teste entregue comprova que a URL chega ao canal. |
| Edit | Renomeia o webhook ou substitui a URL dele. A URL salva nunca é mostrada de novo, só mascarada. |
| Enabled | Desativa o webhook sem excluí-lo. Um webhook desativado é mantido, mas não recebe nada; você pode anotar por que ele está desligado. |
| Delete | Remove o webhook. |
Notificações recentes
A fila de entrega mostra cada alerta que o projeto gerou e o que aconteceu com ele. Ela é somente leitura.
| Status | Significado |
|---|---|
| pending | Aguardando envio. Os alertas são enviados em cerca de um minuto. |
| sent | Entregue ao Slack. |
| failed | A entrega continuou falhando e as novas tentativas se esgotaram, depois de até cinco tentativas. |
| dropped | Nenhum webhook ativo tinha esse tipo ativado, então o alerta não foi enviado. |
Uma fila cheia de linhas dropped normalmente significa que o projeto ainda não tem webhook, ou que o webhook não tem esse tipo ativado.
Próximos passos
- Platform Health — o status da plataforma que os alertas de saúde informam
- Página de status pública — consulte a saúde da plataforma em vez de esperar por um alerta
- Functions — os deploys por trás dos alertas de Deployment
Atualizado em 14 de out. de 2026