Suscriptores

Gestiona usuarios que reciben notificaciones sobre actualizaciones de estado.

Vista General

Los suscriptores son usuarios que quieren ser notificados sobre:

• Nuevos incidentes
• Actualizaciones y resoluciones de incidentes
• Mantenimientos programados
• Cambios de estado de componentes

Canales de Suscripción

Cómo se Suscriben los Usuarios

Formulario de Suscripción Pública

Los usuarios pueden suscribirse desde tu página de estado:

1. Hacen clic en "Suscribirse" en tu página de estado
2. Eligen su método de notificación
3. Ingresan información de contacto
4. Seleccionan componentes a seguir (opcional)
5. Confirman suscripción

Suscripciones Creadas por Admin

Crea suscripciones desde el dashboard:

1. Navega a Dashboard > Suscriptores
2. Haz clic en "Añadir Suscriptor"
3. Configura:

4. Haz clic en "Crear"

Suscriptores Email

Crear

curl -X POST http://localhost:3000/api/v1/subscribers \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "email",
    "email": "usuario@example.com",
    "componentIds": [],
    "events": ["incident.created", "incident.resolved"]
  }'

Branding de Email

Personaliza emails de notificación:

1. Navega a Configuración > Branding de Email
2. Configura:
   • Logo
   • Colores
   • Texto de header/footer
   • CSS personalizado

Vista Previa de Email

Prueba la apariencia del email:

1. Ve a Configuración > Branding de Email
2. Haz clic en "Vista Previa"
3. Selecciona tipo de plantilla
4. Ve el email renderizado

Suscriptores SMS

Crear

curl -X POST http://localhost:3000/api/v1/subscribers \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "sms",
    "phone": "+1234567890",
    "componentIds": []
  }'

Formato SMS

Los mensajes SMS son concisos:

[ReliaPulse] Incidente Mayor: API caída.
Ver: https://status.example.com/incidents/123

Suscriptores Webhook

Envía notificaciones a endpoints personalizados:

Crear

curl -X POST http://localhost:3000/api/v1/subscribers \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "webhook",
    "webhookUrl": "https://example.com/webhook",
    "webhookSecret": "secreto-opcional"
  }'

Payload del Webhook

{
  "event": "incident.created",
  "timestamp": "2026-01-22T10:30:00Z",
  "incident": {
    "id": "inc_123",
    "title": "Retrasos en Respuesta de API",
    "status": "investigating",
    "impact": "major",
    "components": ["API"]
  }
}

Seguridad del Webhook

Si webhookSecret está configurado:

• Firma incluida en header X-Signature-256
• Calculada como HMAC-SHA256 del payload

Verifica en tu endpoint:

const crypto = require('crypto');
const signature = crypto
  .createHmac('sha256', secret)
  .update(body)
  .digest('hex');
 
if (signature !== request.headers['x-signature-256']) {
  throw new Error('Firma inválida');
}

Importación CSV

Importa suscriptores en lote:

Preparar el CSV

type,email,phone,componentIds
email,usuario1@example.com,,
email,usuario2@example.com,,comp-1
sms,,+1234567890,
sms,,+0987654321,comp-1;comp-2

Importar

1. Navega a Dashboard > Suscriptores
2. Haz clic en "Importar"
3. Sube archivo CSV
4. Revisa vista previa
5. Confirma importación

Opciones de Importación

Feeds RSS/Atom/JSON

Feeds de autoservicio que no requieren suscripción:

Los usuarios pueden añadir estos a sus lectores de feeds.

Gestionar Suscriptores

Ver Suscriptores

1. Navega a Dashboard > Suscriptores
2. Filtra por tipo o busca
3. Ve detalles del suscriptor

Editar Preferencias

1. Haz clic en un suscriptor
2. Modifica:
   • Suscripciones de componentes
   • Preferencias de eventos
   • Información de contacto
3. Guarda cambios

Desuscribir

Autoservicio del usuario:

• Clic en enlace de desuscripción en email
• Texto STOP para SMS

Remoción por admin:

1. Encuentra el suscriptor
2. Haz clic en "Eliminar"
3. Confirma

Suscripciones por Componente

Los suscriptores pueden seguir componentes específicos:

Todos los Componentes

Deja la selección de componentes vacía para recibir todas las notificaciones.

Componentes Específicos

Selecciona componentes específicos:

• Solo notificado sobre esos componentes
• Nuevos componentes no se añaden automáticamente

Grupos de Componentes

Suscribirse a un componente padre para recibir notificaciones de todos los hijos.

Preferencias de Eventos

Controla qué eventos disparan notificaciones:

Acceso API

Listar Suscriptores

curl http://localhost:3000/api/v1/subscribers \
  -H "Authorization: Bearer sk_live_xxx"

Crear Suscriptor

curl -X POST http://localhost:3000/api/v1/subscribers \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "email",
    "email": "usuario@example.com"
  }'

Eliminar Suscriptor

curl -X DELETE http://localhost:3000/api/v1/subscribers/{id} \
  -H "Authorization: Bearer sk_live_xxx"

Importar Suscriptores

curl -X POST http://localhost:3000/api/v1/subscribers/import \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@suscriptores.csv"

Mejores Prácticas

Privacidad

• Recolecta solo información necesaria
• Proporciona desuscripción fácil
• Cumple con regulaciones de email (CAN-SPAM, GDPR)

Comunicación

• No sobre-notifiques
• Mantén mensajes relevantes
• Incluye solo información esencial

Mantenimiento

• Limpia emails rebotados
• Remueve suscriptores inactivos
• Revisa endpoints de webhook

Documentación Relacionada

• Notificaciones - Configuración de canales
• Incidentes - Qué dispara notificaciones
• Páginas de Estado - Formularios de suscripción