# Notifications

Notifications (push and in-app) are the most direct channel with the user. They must be actionable, specific, and respectful of time.

## Principles

- **Actionable from the title.** The user knows what to do without opening it.
- **No ellipses or cut-off phrases.**
- **Body is optional:** expand context if needed, without repeating the title.
- **Never clickbait.**

## Push notifications

**Structure:** Actionable title (max 60 characters) + optional body.

### Approvals and requests
✅ "Tienes una solicitud de vacaciones pendiente de aprobación"
✅ "[Nombre] aprobó tu solicitud de licencia"
✅ "Tu solicitud fue rechazada. Revisa los detalles"
❌ "Notificación de solicitud pendiente..."
❌ "Se ha recibido una nueva solicitud en el sistema"

### Announcements and news
✅ "Nuevo comunicado de Dirección. Léelo antes del viernes"
✅ "Actualizamos la política de home office. Revisa los cambios"
✅ "Esta semana: beneficios nuevos disponibles para ti"
❌ "Hay un nuevo comunicado disponible en la plataforma"
❌ "Información importante para todos los empleados"

### Reminders
✅ "Tu evaluación de desempeño vence el viernes. Complétala hoy"
✅ "Faltan 2 días para cerrar la encuesta de clima"
✅ "Completa tu perfil para que tu equipo pueda encontrarte"
❌ "Recordatorio: evaluación pendiente"
❌ "Por favor complete su encuesta antes de la fecha límite"

### Recognitions
✅ "[Nombre] te reconoció por tu trabajo esta semana"
✅ "Recibiste 3 reconocimientos este mes"
❌ "Tiene nuevas notificaciones de reconocimiento"

### Errors or problems
✅ "No pudimos sincronizar tus datos. Abre la app para resolver"
✅ "Hubo un problema al enviar tu solicitud. Inténtalo de nuevo"
❌ "Error del sistema"
❌ "Se produjo un error inesperado"

## In-app notifications

**Structure:** [Who or what] + [What happened] + [Optional action]. Max 120 chars.

✅ "María López aprobó tu solicitud de vacaciones."
✅ "Tienes 3 encuestas pendientes. Complétalas antes del viernes."
✅ "Tu recibo de sueldo de enero ya está disponible."
❌ "Se ha registrado una nueva actividad en el sistema."
❌ "Notificación nueva."

## What to avoid

| ❌ Avoid | Why |
|---|---|
| Ellipses in the title | Truncate information too early |
| Repeating the title in the body | Wastes the body's space |
| "Información importante" | Says nothing concrete |
| Passive phrases | "Se ha recibido" → "Recibiste" |
| Generic titles | "Notificación nueva" generates no action |
