Skip to content

Alertas de limite de Canvas

Os alertas de limite 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 para entradas de usuários ou mensagens enviadas, e a Braze notifica você por e-mail ou webhook se esse limite for ultrapassado. Você também pode criar vários 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 de limite 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 Gerenciar alertas de um Canvas, faça uma das seguintes opções:

  • Acesse Envio de mensagens > Canvas e selecione Gerenciar alertas no menu de contexto de um Canvas individual
  • Para Canvas ativos, abra Canvas Analytics e selecione Gerenciar alertas.

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

Etapa 2: Nomear o alerta e selecionar 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 para 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 a partir do Canvas

Para cada regra, escolha uma comparação (menor que ou maior que) e um limite de volume. Por exemplo, uma regra para “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 um problema de público ou entrada upstream que vale a pena investigar.

Você pode agrupar várias regras 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 do alerta

Defina com que frequência suas regras de alerta são verificadas. Você pode configurar a frequência de verificação de 3 a 12 horas (em incrementos de 1 hora) ou a cada 24 horas. Uma vez ativado, o 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.

A seção Notificações do painel Configurar alerta, mostrando os botões de alternância de e-mail e webhook, um campo de destinatários de e-mail, um campo de URL de webhook, uma nota sobre o conteúdo da carga útil e campos opcionais de cabeçalho da solicitação.

Os alertas por webhook são úteis para encaminhar notificações para plataformas externas, como um canal do Slack — para mais informações, consulte a documentação do Slack sobre envio de mensagens usando webhooks de entrada. Cada notificação por webhook inclui uma carga útil com o nome do Canvas, a métrica do alerta, a direção do limite, o valor que disparou o alerta e um link direto para o Canvas.

Etapa 6: Salvar o alerta

Revise suas regras de alerta, cronograma e configurações de notificação no painel de resumo e 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 não esteja mais ativo. A coluna Alertas configurados na página Canvas exibe um ícone de sino para qualquer Canvas com pelo menos um alerta salvo.

Considerações

  • Canvas em rascunho: Você pode configurar um alerta de limite 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.
New Stuff!