Ir para o conteúdo

Alertas personalizados de Canvas

Os alertas personalizados de Canvas avisam quando algo em um Canvas não está saindo como planejado. Assim, você consegue identificar uma jornada parada ou uma queda inesperada antes que isso afete seus clientes.

Defina um limite de volume ou de 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.

Para alertas padrão que se aplicam a todos os Canvas de um espaço de trabalho, consulte Alertas de Canvas do espaço de trabalho.

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 para Canvas ativos e em rascunho. Para abrir a página Gerenciar alertas de um Canvas, faça uma das seguintes ações:

  • Acesse Mensagens > Canvas e selecione Gerenciar alertas no menu de contexto de um Canvas específico.
  • Para Canvas ativos, abra a Análise de dados do Canvas e selecione Gerenciar alertas.

Na página Gerenciar alertas, selecione Configurar alerta para criar um novo alerta.

Etapa 2: Dê um nome ao alerta e selecione um Canvas

Dê um nome ao seu alerta e confirme o Canvas ao qual ele se aplica.

O painel Configurar alerta mostrando os campos de nome do alerta e nome do Canvas, um grupo de regras vazio e uma barra lateral de resumo com regras de alerta, cronograma e notificações.

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 pelo 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 de repente. Isso indica um possível problema de público ou de entrada que vale a pena investigar.
  • Porcentagem: Compara a contagem atual com uma linha de base deste 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 é comparada com a média das sete janelas anteriores das 14h às 17h. Uma regra de “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 mais, incluindo valores acima de 100. Assim, você pode receber alertas sobre um pico em relação à linha de base.

Você pode agrupar várias regras, inclusive misturando regras de volume e de porcentagem, e combinar grupos de regras com lógica AND ou OR para criar condições de alerta mais específicas.

Etapa 4: Defina o cronograma de alertas

Defina com que frequência suas regras de alerta são verificadas. Você pode definir a frequência de verificação entre 3 e 12 horas (em incrementos de 1 hora) ou a cada 24 horas. Depois de ativado, o alerta continua sendo verificado nesse cronograma enquanto o alerta e o Canvas associado a ele estiverem ativos.

Etapa 5: Configurar notificações

Escolha quem deve ser notificado quando uma regra de alerta for atendida e como essa notificação será feita:

  • E-mail: Adicione um ou mais endereços de e-mail de destinatários
  • Webhook: Insira o URL do webhook a ser notificado e, se quiser, adicione cabeçalhos de solicitação personalizados exigidos pelo destino do seu webhook
  • Slack: Insira o URL do webhook de entrada do Slack para publicar notificações em um canal do Slack. Para saber mais sobre a integração de alertas do Canvas com o Slack, consulte a documentação do Slack sobre Envio de mensagens usando webhooks de entrada.

Você pode ativar um, dois ou todos os três métodos de notificação para um único alerta.

Os alertas por webhook são úteis para direcionar notificações para plataformas externas. Cada notificação por 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. As condições de porcentagem também incluem percentage_metric_value (a contagem observada como uma porcentagem inteira da linha de base). O metric_value é sempre a contagem absoluta.

Exemplo de carga útil do webhook

Veja a seguir um exemplo da carga útil JSON enviada em uma solicitação POST para o seu endpoint de 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 corresponde a 57% da linha de base da mesma janela nos últimos 7 dias, em comparação com 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: Salve seu alerta

Revise as regras, o cronograma e as configurações de notificação do seu alerta no painel de resumo e, em seguida, selecione Salvar alerta.

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 de alternância Status do seu alerta. Um alerta permanece ativo até que você o desative ou até que o Canvas associado a ele deixe de estar ativo. A coluna Alertas configurados na página Canvas mostra 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 só começa a verificar suas regras quando o Canvas for lançado.
  • Linha de base percentual: As regras percentuais precisam de sete dias anteriores completos com a mesma janela depois que o Canvas é lançado. Enquanto essas janelas não existirem, ou quando a média da linha de base for zero (sem atividade nessas janelas anteriores), as regras percentuais 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 nem para as métricas de uso de webhooks.

New Stuff!