Sistema de Notificaciones

Dokploy puede notificarte cuando ocurren eventos importantes: deployments exitosos o fallidos, backups completados, y alertas de health checks. Soporta multiples canales de notificacion que puedes configurar simultaneamente.

Eventos que Generan Notificaciones

Evento	Descripcion
Deploy Success	Un deployment se completo correctamente
Deploy Error	Un deployment fallo
Backup Success	Un backup de base de datos o volumen se completo
Backup Error	Un backup fallo
Health Check Failed	Un health check detecto un problema
Docker Cleanup	Limpieza automatica de imagenes/contenedores
Server Threshold	Uso de CPU/RAM/disco supera el umbral configurado

Acceder a la Configuracion

1. En el panel de Dokploy, ve a Settings
2. Selecciona Notifications
3. Elige el proveedor que deseas configurar

Puedes tener multiples proveedores activos al mismo tiempo. Por ejemplo, Slack para el equipo de desarrollo y Telegram para alertas personales.

Configurar Slack

Crear un webhook en Slack

1. Ve a api.slack.com/apps
2. Haz clic en Create New App > From scratch
3. Nombra la app (ej: “Dokploy Alerts”) y selecciona el workspace
4. En Features > Incoming Webhooks, activa los webhooks
5. Haz clic en Add New Webhook to Workspace
6. Selecciona el canal donde quieres recibir notificaciones
7. Copia la URL del webhook

Configurar en Dokploy

1. En Settings > Notifications, selecciona Slack
2. Pega la URL del webhook:

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

3. Haz clic en Test para enviar una notificacion de prueba
4. Si recibes el mensaje en Slack, haz clic en Save

Formato del mensaje

Dokploy envia mensajes estructurados con:

• Nombre de la aplicacion
• Estado del evento (exito/error)
• Timestamp
• Detalles del error (si aplica)

Configurar Discord

Crear un webhook en Discord

1. En tu servidor de Discord, ve al canal deseado
2. Editar canal > Integraciones > Webhooks
3. Haz clic en Nuevo webhook
4. Nombra el webhook y copia la URL

Configurar en Dokploy

1. En Settings > Notifications, selecciona Discord
2. Pega la URL del webhook:

https://discord.com/api/webhooks/000000000000000000/XXXXXXXXXXXXXXXXXXXXXXXXXXXX

3. Prueba y guarda

Discord muestra las notificaciones como embeds con colores:

• Verde para eventos exitosos
• Rojo para errores

Configurar Telegram

Crear un bot de Telegram

1. Abre Telegram y busca @BotFather
2. Envia /newbot
3. Sigue las instrucciones para nombrar tu bot
4. BotFather te dara un token:

123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Obtener el Chat ID

Para enviar mensajes a un chat, necesitas el Chat ID:

Para mensajes personales:

1. Busca @userinfobot en Telegram
2. Envialo un mensaje
3. Te respondera con tu Chat ID

Para un grupo:

1. Agrega tu bot al grupo
2. Envia un mensaje en el grupo
3. Visita en tu navegador:

https://api.telegram.org/bot<TU_TOKEN>/getUpdates

4. Busca el campo chat.id (sera un numero negativo para grupos)

Configurar en Dokploy

1. En Settings > Notifications, selecciona Telegram
2. Ingresa el Bot Token y el Chat ID
3. Prueba y guarda

Configurar Email

Dokploy puede enviar notificaciones por correo electronico usando cualquier servidor SMTP.

Configurar en Dokploy

1. En Settings > Notifications, selecciona Email
2. Completa los campos:

Campo	Ejemplo
SMTP Host	smtp.gmail.com
SMTP Port	587
Username	[email protected]
Password	app-password
From Email	[email protected]
To Email	[email protected]

3. Prueba y guarda

Usar Gmail como SMTP

Para Gmail necesitas una App Password (no tu password normal):

1. Ve a myaccount.google.com/apppasswords
2. Genera una password para “Mail”
3. Usa esa password de 16 caracteres en la configuracion

Alternativas SMTP

Si no quieres usar Gmail:

• Resend: smtp.resend.com, puerto 465
• Mailgun: smtp.mailgun.org, puerto 587
• SendGrid: smtp.sendgrid.net, puerto 587
• Amazon SES: varia segun la region

Microsoft Teams (v0.27+)

Desde la version 0.27, Dokploy soporta notificaciones a Microsoft Teams mediante webhooks.

Crear un webhook en Teams

1. En el canal de Teams, haz clic en los tres puntos > Connectors
2. Busca Incoming Webhook
3. Configura el nombre y el icono
4. Copia la URL generada

Configurar en Dokploy

1. En Settings > Notifications, selecciona Microsoft Teams
2. Pega la URL del webhook
3. Prueba y guarda

Las notificaciones se muestran como tarjetas adaptativas (Adaptive Cards) con informacion estructurada del evento.

Pushover (v0.26.7+)

Pushover es un servicio de notificaciones push para moviles y desktop. Disponible desde la version 0.26.7.

Requisitos

• Cuenta en pushover.net
• App de Pushover instalada en tu dispositivo
• Un Application Token de Pushover

Crear un Application Token

1. Inicia sesion en pushover.net
2. Ve a Your Applications > Create an Application/API Token
3. Nombra la aplicacion (ej: “Dokploy”)
4. Copia el API Token

Configurar en Dokploy

1. En Settings > Notifications, selecciona Pushover
2. Ingresa:
   • User Key: tu clave de usuario de Pushover (visible en el dashboard)
   • API Token: el token de la aplicacion que creaste
3. Prueba y guarda

Pushover permite configurar prioridades y sonidos por notificacion, y tiene un costo unico de $5 USD por plataforma (iOS, Android, Desktop).

Webhooks Genericos

Para integraciones no cubiertas por los proveedores anteriores, Dokploy soporta webhooks genericos que envian un POST con la informacion del evento en formato JSON.

Configurar en Dokploy

1. En Settings > Notifications, selecciona Webhook
2. Ingresa la URL de tu endpoint

Payload del webhook

El cuerpo del POST tiene esta estructura:

{
  "type": "deploy",
  "status": "success",
  "application": {
    "name": "mi-app",
    "id": "app-id-123"
  },
  "timestamp": "2026-02-28T15:30:00Z",
  "message": "Deployment completed successfully"
}

Puedes usar webhooks genericos para integrar con:

• Sistemas de ticketing (Jira, Linear)
• Dashboards personalizados
• Scripts de automatizacion propios
• Cualquier servicio que acepte webhooks

Notificaciones de Backups de Volumenes (v0.28+)

La version 0.28 agrego notificaciones especificas para backups de volumenes Docker. Anteriormente solo se notificaban backups de bases de datos.

Eventos de backup de volumenes:

• Backup de volumen completado
• Backup de volumen fallido
• Restauracion de volumen completada

Estas notificaciones se envian por todos los canales configurados, al igual que los demas eventos.

Recomendaciones

Separar canales por tipo de evento

Una buena practica es usar diferentes canales para diferentes tipos de alerta:

• Slack/Teams: deploy success/fail para todo el equipo
• Telegram: alertas criticas (health check failed, server threshold)
• Email: resumen diario o semanal de backups

No ignorar las notificaciones

Si recibes demasiadas notificaciones y empiezas a ignorarlas, ajusta:

• Reduce los eventos que notifican
• Usa canales separados por prioridad
• Configura horarios de silencio en el receptor (ej: DND en Slack)

Probar las notificaciones regularmente

Despues de configurar, verifica periodicamente que siguen funcionando. Los tokens de webhook pueden expirar o los canales pueden ser eliminados.

---

Siguiente: Tips para Produccion