> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Notifications
> Publique en temas y entregue notificaciones a suscripciones de email, webhook y cola.
Notifications distribuye mensajes de un tema a sus suscripciones. Use email para personas, webhooks para integraciones HTTP y colas para consumidores que procesan a su propio ritmo.
El servicio es regional. El endpoint de São Paulo es `https://notifications.sa-saopaulo-1.basaltic.sh`. Las llamadas autenticadas usan bearer token y el identificador de la cuenta en `X-Account-Id`; consulte [Autenticación](/es/authentication).
## Temas y suscripciones
Administre suscripciones en `/v1/topics/{topic_id}/subscriptions`. La ruta selecciona el tema; las solicitudes y respuestas no lo repiten. La consola lista las suscripciones en la pestaña **Subscriptions** del tema.
Las entregas incluyen referencias `message` y `subscription`, con `id` y `crn`; los recursos con nombre incluyen `name`. Liste mensajes en `/v1/topics/{topic_id}/messages` y consulte uno en `/v1/topics/{topic_id}/messages/{message_id}`. Las entregas también pertenecen al tema. La consola abre la lista de temas, cada uno con pestañas **Subscriptions**, **Messages**, **Deliveries** y **Metrics**. Las respuestas anidadas omiten el padre conocido.
`redrive_policy.dead_letter_queue` es una referencia en las respuestas; las solicitudes aceptan UUID, nombre o CRN de la cola. Eliminar el destino conserva su ID y CRN en la referencia y omite el nombre.
Los enlaces de confirmación y cancelación pertenecen al propietario del destino. Son independientes de la API autenticada de administración, que permite eliminar suscripciones y reenviar confirmaciones.
El tema tiene un nombre inmutable. La publicación selecciona suscripciones confirmadas cuyo filtro coincide con el mensaje. El protocolo determina la interpretación del destino:
| Protocolo | Destino | Confirmación |
| - | - | - |
| `email` | Dirección del destinatario | El destinatario confirma mediante el enlace recibido. |
| `http` o `https` | URL pública de webhook | El destino confirma el token de la solicitud inicial. |
| `queue` | UUID, nombre o CRN de la cola en la misma cuenta y región | Confirmada tras resolver y autorizar la cola. |
Los destinos de cola y las colas de fallos exigen `queue:SendMessage` en la cola, además de la acción de Notifications. Consulte [Permisos de Notifications](/es/notifications/permissions).
## Aceptación y entrega
Publicar devuelve HTTP `202` tras encolar de forma duradera. Esto no significa recepción por los suscriptores. Consulte el registro del mensaje para seguir la distribución y los registros de entrega para los resultados individuales.
Los webhooks incluyen firma HMAC. El secreto tiene permisos separados de lectura y rotación; consultar la suscripción no concede acceso al secreto.
## Métricas
Abra **Metrics** en el tema para seguir publicaciones, resultados, tasa de éxito, latencia y pendientes. Los gráficos usan los controles de tiempo y la API Telemetry de las métricas de instancia. Use **Deliveries** para investigar fallos individuales; las métricas no contienen URL de destino ni cuerpos.
Las series se muestrean cada 30 segundos. Filtre por `topic_id` y `region` en [Telemetry](/es/telemetry#metrics). Las series de entrega también incluyen `protocol` (`email`, `https`, `http` o `queue`). La lectura exige `telemetry:ReadMetrics` en la cuenta y región seleccionadas.
| Métrica | Tipo | Significado |
| - | - | - |
| `basaltic_notifications_messages_published_total` | Contador | Notificaciones aceptadas. |
| `basaltic_notifications_bytes_published_total` | Contador | Bytes de cuerpo aceptados. |
| `basaltic_notifications_messages_pending_fanout` | Gauge | Mensajes pendientes de distribución en entregas. |
| `basaltic_notifications_deliveries_pending` | Gauge | Entregas pendientes de resultado definitivo. |
| `basaltic_notifications_delivery_attempts_total` | Contador | Intentos persistidos, incluidos reintentos. |
| `basaltic_notifications_deliveries_delivered_total` | Contador | Resultados definitivos correctos. |
| `basaltic_notifications_deliveries_failed_total` | Contador | Fallos definitivos. |
| `basaltic_notifications_delivery_retries_total` | Contador | Intentos fallidos con presupuesto para reintentar. |
| `basaltic_notifications_delivery_terminal_total` | Contador | Resultados definitivos de éxito o fallo. |
| `basaltic_notifications_delivery_attempt_duration_seconds_sum` | Contador | Duración total de los intentos persistidos. |
| `basaltic_notifications_delivery_attempt_duration_seconds_count` | Contador | Cantidad de intentos medidos. |
Use `rate` en contadores. La tasa de éxito divide entregas correctas por resultados definitivos. La latencia media divide la tasa de la suma de duración por la tasa del recuento. No hay valor cuando el denominador es cero. Los contadores empiezan al desplegar las métricas y persisten tras retirar el historial. No hay relleno retroactivo. Las muestras ausentes representan falta de observación, no actividad cero.
Name a publishing destination and choose delivery defaults.
Connect email, webhooks, and queues.
Match attributes with worked examples and operator rules.
Send attributed events and follow fan-out.
Verify webhooks, configure retries, and retain failed deliveries.
IAM actions and cross-service grants.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.