Las credenciales y las URL de los webhooks se cifran antes de guardarse. Limita las credenciales de canal al envío de notificaciones y rótalas si quedan expuestas.
Añadir un destino
1
Créalo
Abre Ajustes → Notificaciones, selecciona Añadir destino, introduce un nombre y elige uno o varios canales. Añade los datos del destino y las menciones que quieras.
2
Prueba cada canal
Selecciona Enviar prueba para cada canal y crea los destinos cuando todas las pruebas se completen correctamente.
3
Guarda el secreto de firma
Un webhook personalizado recibe un secreto de firma al crearlo. Cópialo desde el cuadro de diálogo que se abre; solo se muestra una vez.
POST /v1/notifications/destinations, compruébalo con POST /v1/notifications/destinations/{id}/test y elige qué alertas recibe con PUT /v1/notifications/routes/{eventKind}, usando una clave de administración.
Usa las menciones con moderación: envía las alertas frecuentes a un canal supervisado en lugar de avisar a un grupo amplio.
Activar alertas de producto
La página de notificaciones muestra los tipos de alertas disponibles para tu espacio de trabajo. Los destinos reciben una alerta además de los destinatarios integrados que se muestran en el panel. Las Alertas de obsolescencia del modelo avisan antes de que se retire un modelo que usa el espacio de trabajo. Los Avisos de modelo sustituto se envían cuando el enrutamiento de modelos retirados está activado y un modelo sustituto responde a las solicitudes del espacio de trabajo para un modelo que ya no sirve ningún proveedor. Se envía un aviso por cada modelo y sustituto, la primera vez que un sustituto responde correctamente. Siempre se envía un correo electrónico al propietario del espacio de trabajo; elige destinos para enviar el aviso también a tu equipo.Informes de gasto
Los propietarios del espacio de trabajo reciben cada lunes a las 09:00, en la zona horaria de facturación del espacio de trabajo, un correo con el informe de gasto de la semana anterior, de lunes a domingo. Cámbialo en Alertas de gasto → Ajustes de gasto del espacio de trabajo en la página de notificaciones: diario (a las 09:00, del día anterior), semanal, mensual (el día 1, del mes anterior) o desactivado, y si también lo reciben los administradores. Los periodos sin gasto se omiten. Cada informe muestra el gasto y el cambio respecto al periodo anterior, las claves, modelos, miembros y departamentos principales, la previsión de este mes, la autonomía del saldo y las alertas y bloqueos de gasto del periodo. Quien lo recibe puede darse de baja desde el enlace del correo; eso solo detiene su copia del informe de ese espacio de trabajo. Los destinos asignados a Informes de gasto reciben un resumen por informe. Los mismos ajustes sonspend.report_cadence y spend.report_include_admins en la API de ajustes de notificaciones.
Para recibir alertas sobre gasto, presupuestos, previsiones, picos y saldo bajo, y para bloquear solicitudes cuando el gasto supera un límite, consulta Alertas de gasto.
Los correos con informes de gasto se están activando poco a poco. Hasta que se activen, tu elección se guarda, pero no se envía ningún informe.
Mantener los destinos en funcionamiento
Usa Enviar prueba junto a un destino existente después de rotar las credenciales o cambiar su canal. Elimina los destinos que nadie supervisa, para que las alertas no parezcan entregadas cuando llegan a un canal abandonado. Un receptor de webhook personalizado debe verificar cada solicitud antes de procesarla, devolver una respuesta correcta sin demora y trasladar las tareas más lentas a un proceso en segundo plano.Verificar las firmas de los webhooks
Phaseo firma cada entrega de webhook personalizado, incluidas las pruebas enviadas desde un destino guardado, con el mismo esquema que los webhooks de vídeo y lotes. Cada solicitud incluye estos encabezados:x-phaseo-signature es el HMAC-SHA256 en hexadecimal del valor de x-phaseo-timestamp, un punto literal (.) y el cuerpo de la solicitud sin modificar, con el secreto de firma del destino (whsec_…) como clave. x-phaseo-timestamp está en segundos Unix.
Para verificar una entrega:
- Lee el cuerpo sin procesar antes de analizarlo como JSON.
- Vuelve a calcular la firma y compárala en tiempo constante.
- Rechaza marcas de tiempo que difieran más de cinco minutos de tu reloj.
- Elimina duplicados por
x-phaseo-event-id. Las entregas fallidas se reintentan y cada intento se vuelve a firmar con una nueva marca de tiempo.
Generar o rotar un secreto
El secreto se muestra una sola vez, al crear el destino. Para sustituirlo, selecciona Rotar secreto junto al destino en Ajustes → Notificaciones, o llama aPOST /v1/notifications/destinations/{id}/rotate-secret. La siguiente entrega se firma con el nuevo secreto y el anterior deja de funcionar, así que actualiza tu receptor enseguida.
Los webhooks personalizados creados antes de que existiera la firma no tienen secreto y se siguen entregando sin firmar. En Ajustes aparecen como Sin firmar. Selecciona Generar secreto, añade el secreto a tu receptor y envía una prueba para comprobar la verificación. Las pruebas enviadas desde el panel Añadir destino, antes de guardar el destino, no van firmadas porque aún no existe ningún secreto.
Los destinos de correo electrónico, Slack, Discord y Microsoft Teams no se firman: esos servicios autentican por sí mismos la URL del webhook o el token del bot.