Alertas personalizados de Canvas
Os alertas personalizados de Canvas avisam quando algo em um Canvas não está saindo como planejado, para que você possa identificar uma jornada parada ou uma queda inesperada antes que isso afete seus clientes.
Defina um limite de volume ou porcentagem para entradas de usuários ou mensagens enviadas, e a Braze notifica você por e-mail ou webhook se esse limite for ultrapassado. Você pode criar até dois alertas para o mesmo Canvas — por exemplo, um alerta para entradas de usuários e outro para mensagens enviadas.
Não sabe por onde começar? O Operator pode orientar você sobre como configurar um alerta personalizado de Canvas.
Etapa 1: Criar um alerta
Os alertas são definidos no nível do Canvas, e você pode configurá-los tanto para Canvas ativos quanto para rascunhos. Para abrir a página Manage Alerts de um Canvas, faça uma das seguintes opções:
- Acessar Messaging > Canvas e selecionar Manage alerts no menu de contexto de um Canvas individual
- Para Canvas ativos, abrir Canvas Analytics e selecionar Manage alerts.
Na página Manage Alerts, selecione Configure alert para criar um novo alerta.
Etapa 2: Nomeie seu alerta e selecione um Canvas
Dê um nome ao seu alerta e confirme o Canvas ao qual ele se aplica.
Etapa 3: Definir regras de alerta
As regras de alerta definem o limite que dispara uma notificação. Você pode criar regras usando duas métricas:
- Entradas de usuários: Número de usuários que entraram no Canvas
- Mensagens enviadas: Número de mensagens enviadas a partir do Canvas
Para cada regra, escolha uma comparação (menor que, maior que, menor ou igual a, maior ou igual a, ou igual a), uma unidade e um limite.
- Volume: Compara a contagem absoluta na janela de verificação atual. Por exemplo, “Entradas de usuários menor que 3.000” sinaliza um Canvas que normalmente alcança milhares de usuários, mas parou repentinamente — um sinal de problema no público upstream ou na entrada que vale a pena investigar.
- Porcentagem: Compara a contagem atual com uma linha de base para esse Canvas. A linha de base é a média da mesma janela de tempo nos 7 dias anteriores. Por exemplo, se o alerta verifica a cada 3 horas, uma verificação das 14h às 17h compara com a média das sete janelas anteriores de 14h às 17h. Uma regra para “Mensagens enviadas menor que 50%” sinaliza uma queda para menos da metade desse volume habitual.
Os limites são números inteiros. Para regras de porcentagem com menor que ou menor ou igual a, insira um valor de 1 a 100. Para maior que, maior ou igual a ou igual a, a porcentagem pode ser 0 ou maior, incluindo valores acima de 100, para que você possa alertar sobre um pico em relação à linha de base.
Você pode agrupar várias regras juntas — incluindo a combinação de regras de volume e porcentagem — e combinar grupos de regras com lógica AND ou OR para criar condições de alerta mais específicas.
Etapa 4: Definir o cronograma de alertas
Defina a frequência com que suas regras de alerta são verificadas. Você pode configurar a frequência de verificação entre 3 e 12 horas (em incrementos de 1 hora), ou a cada 24 horas. Depois de ativado, um alerta continua verificando nesse cronograma enquanto o alerta e o Canvas associado estiverem ativos.
Etapa 5: Configurar notificações
Escolha quem deve ser notificado quando uma regra de alerta for atendida e como será notificado:
- E-mail: Adicione um ou mais endereços de e-mail de destinatários
- Webhook: Insira a URL do webhook para notificação e, opcionalmente, adicione cabeçalhos de solicitação personalizados exigidos pelo destino do seu webhook
Você pode ativar um ou ambos os métodos de notificação para um único alerta.
Os alertas de webhook são úteis para direcionar notificações a plataformas externas. Cada notificação de webhook envia uma carga útil JSON com o nome do alerta, a janela de avaliação e as condições que dispararam o alerta. Cada condição inclui um threshold_unit de volume ou percentage. Condições de porcentagem também incluem percentage_metric_value (a contagem observada como uma porcentagem de número inteiro em relação à linha de base). metric_value é sempre a contagem absoluta.
Webhooks de entrada do Slack ainda não são compatíveis com alertas personalizados de Canvas.
Exemplo de carga útil de webhook
A seguir, um exemplo da carga útil JSON enviada em uma solicitação POST para o endpoint do seu webhook quando um alerta é disparado. A primeira condição é uma regra de volume. A segunda é uma regra de porcentagem: 51.235 mensagens enviadas, o que representa 57% da linha de base da mesma janela de 7 dias, contra um limite de mais de 55%.
{
"alert": {
"name": "Canvas Alert - August 6, 2026",
"target_type": "CANVAS"
},
"evaluation_window_start": "2026-08-06T10:28:01Z",
"evaluation_window_end": "2026-08-06T13:28:01Z",
"conditions": [
{
"subject": "user_entries",
"operator": "lt",
"threshold_value": 500,
"metric_value": 0.0,
"group_index": 0,
"threshold_unit": "volume"
},
{
"subject": "messages_sent",
"operator": "gt",
"threshold_value": 55,
"metric_value": 51235.0,
"group_index": 0,
"threshold_unit": "percentage",
"percentage_metric_value": 57
}
]
}
Etapa 6: salvar o alerta
Revise as regras do alerta, o cronograma e as configurações de notificação no painel de resumo e selecione Save alert.
Etapa 7: Ativar o alerta
Salvar um alerta não o ativa. Para ativá-lo, acesse a página Gerenciar alertas e use o botão Status do seu alerta. Um alerta permanece ativo até que você o desative ou até que o Canvas associado a ele não esteja mais ativo. A coluna Alertas configurados na página do Canvas exibe um ícone de sino para qualquer Canvas com pelo menos um alerta salvo.
Considerações
- Limite de alertas: Você pode criar até dois alertas personalizados por Canvas.
- Canvas em rascunho: Você pode configurar um alerta personalizado para um Canvas que ainda está em rascunho, mas o alerta não começará a verificar suas regras até que o Canvas seja lançado.
- Linha de base de porcentagem: As regras de porcentagem precisam de sete dias completos anteriores com a mesma janela após o lançamento do Canvas. Até que essas janelas existam, ou quando a média da linha de base for zero (nenhuma atividade nessas janelas anteriores), as regras de porcentagem não disparam uma notificação.
Perguntas frequentes
Os alertas personalizados contam para o uso de webhooks?
Não. Os alertas personalizados do Canvas não contam para os limites de frequência de webhooks nem para as métricas de uso.