As credenciais e as URLs de webhook são criptografadas antes de serem armazenadas. Restrinja as credenciais dos canais à entrega de notificações e rotacione-as se forem expostas.
Adicionar um destino
1
Crie o destino
Abra Configurações → Notificações, selecione Adicionar destino, informe um nome e escolha um ou mais canais. Adicione os detalhes do destino e as menções que quiser.
2
Teste cada canal
Selecione Enviar teste em cada canal e crie os destinos depois que todos os testes tiverem sucesso.
3
Guarde o segredo de assinatura
Um webhook personalizado recebe um segredo de assinatura quando você o cria. Copie-o da caixa de diálogo que se abre; ele é exibido só uma vez.
POST /v1/notifications/destinations, teste-o com POST /v1/notifications/destinations/{id}/test e depois escolha quais alertas ele recebe com PUT /v1/notifications/routes/{eventKind}, usando uma chave de gerenciamento.
Use menções com moderação: envie alertas de alto volume para um canal monitorado em vez de acionar um grupo grande.
Ativar alertas de produto
A página de notificações lista os tipos de alerta disponíveis para o seu espaço de trabalho. Os destinos recebem um alerta além dos destinatários integrados mostrados no painel. Alertas de descontinuação de modelos avisam antes que um modelo usado pelo espaço de trabalho seja aposentado. Avisos de modelo substituto são enviados quando o roteamento de modelos aposentados está ativado e um modelo substituto responde às solicitações do espaço de trabalho para um modelo que nenhum provedor atende mais. Um aviso é enviado por modelo e substituto, na primeira vez que um substituto responde com sucesso. O proprietário do espaço de trabalho sempre recebe um e-mail; escolha destinos para enviar o aviso também à sua equipe.Relatórios de gastos
Os proprietários do espaço de trabalho recebem um e-mail com o relatório de gastos toda segunda-feira às 09:00, no fuso horário de faturamento do espaço de trabalho, cobrindo a semana anterior, de segunda a domingo. Altere isso em Alertas de gastos → Configurações de gastos do espaço de trabalho, na página de notificações: diário (às 09:00, sobre o dia anterior), semanal, mensal (no dia 1º, sobre o mês anterior) ou desativado, e se os administradores também o recebem. Períodos sem gastos são pulados. Cada relatório mostra os gastos e a variação em relação ao período anterior, as principais chaves, modelos, membros e departamentos, a previsão deste mês, a autonomia do saldo e os alertas e bloqueios por gastos do período. Quem recebe o relatório pode cancelar a inscrição pelo link no e-mail; isso interrompe só a própria cópia do relatório daquele espaço de trabalho. Os destinos encaminhados para Relatórios de gastos recebem um resumo por relatório. As mesmas configurações sãospend.report_cadence e spend.report_include_admins na API de configurações de notificações.
Para alertas sobre gastos, orçamentos, previsões, picos e saldo baixo, e para bloquear solicitações quando os gastos passam de um limite, veja Alertas de gastos.
Os e-mails de relatório de gastos estão sendo liberados aos poucos. Até serem ativados, a sua escolha é salva, mas nenhum relatório é enviado.
Manter os destinos funcionando
Use Enviar teste ao lado de um destino existente depois de rotacionar as credenciais ou mudar o canal dele. Remova os destinos que ninguém monitora, para que os alertas não pareçam entregues quando caem em um canal abandonado. Um receptor de webhook personalizado deve verificar cada solicitação antes de processá-la, retornar uma resposta de sucesso rapidamente e passar o trabalho mais lento para uma tarefa em segundo plano.Verificar assinaturas de webhook
O Phaseo assina todas as entregas de webhooks personalizados, incluindo os testes enviados de um destino salvo, com o mesmo esquema dos webhooks de vídeo e de lote. Cada solicitação traz estes cabeçalhos:x-phaseo-signature é o HMAC-SHA256 hexadecimal do valor de x-phaseo-timestamp, de um ponto literal (.) e do corpo da solicitação sem alterações, com o segredo de assinatura do destino (whsec_…) como chave. x-phaseo-timestamp está em segundos Unix.
Para verificar uma entrega:
- Leia o corpo bruto da solicitação antes de interpretá-lo como JSON.
- Calcule a assinatura de novo e compare-a em tempo constante.
- Rejeite horários com mais de cinco minutos de diferença do seu relógio.
- Elimine duplicatas pelo
x-phaseo-event-id. As entregas que falham são tentadas de novo, e cada tentativa é assinada outra vez com um novo horário.
Gerar ou rotacionar um segredo
O segredo é exibido uma vez, quando o destino é criado. Para substituí-lo, selecione Rotacionar segredo ao lado do destino em Configurações → Notificações, ou chamePOST /v1/notifications/destinations/{id}/rotate-secret. A próxima entrega é assinada com o novo segredo e o antigo deixa de funcionar, então atualize o seu receptor na hora.
Os webhooks personalizados criados antes de a assinatura existir não têm segredo e continuam sendo entregues sem assinatura. Eles aparecem como Sem assinatura nas configurações. Selecione Gerar segredo, adicione o segredo ao seu receptor e depois envie um teste para conferir a verificação. Os testes enviados pelo painel Adicionar destino, antes de o destino ser salvo, não são assinados porque ainda não existe segredo.
Os destinos de e-mail, Slack, Discord e Microsoft Teams não são assinados: esses serviços autenticam a URL do webhook ou o token do bot por conta própria.