Plantillas en Echobell

Las plantillas en Echobell te permiten crear notificaciones dinámicas y ricas en contexto incorporando variables en los títulos y cuerpos de tus notificaciones. Esta poderosa función permite alertas personalizadas e informativas que se adaptan según los datos del disparador, transformando notificaciones genéricas en inteligencia procesable.

Sintaxis Básica de Plantillas

En las plantillas de Echobell, puedes usar variables envolviéndolas en llaves dobles:

{{nombreVariable}}

Cuando se activa un canal, estas variables se reemplazan con valores reales pasados a través del disparador. Por ejemplo, si tu plantilla de título es Has recibido ${{cantidad}} y activas el canal con un valor de cantidad de 100, la notificación resultante se mostrará como Has recibido $100.

Expresiones Avanzadas de Plantillas

Las plantillas de Echobell admiten diversas expresiones para escenarios más complejos:

• Acceder a Propiedades de Objetos

{{usuario.nombre}}
{{datos["valor"]}}

• Acceder a Elementos de Arreglos

{{elementos[0]}}

• Usar Operadores de Comparación

{{estado == "activo"}}
{{edad > 18}}

• Operadores Lógicos

{{estaSuscrito && !estaPausado}}
{{esUrgente || esAltaPrioridad}}

Todos los operadores estándar son compatibles: ==, !=, <, >, <=, >=, &&, ||, y !.

Variables de Plantilla de Diferentes Disparadores

Disparadores de Webhook

Al disparar a través de webhook, puedes proporcionar variables a través de:

1. Parámetros de cadena de consulta:

   GET https://hook.echobell.one/t/tu-id-de-canal?cantidad=100&estado=completado

2. Cuerpo JSON (para peticiones POST):

   POST https://hook.echobell.one/t/tu-id-de-canal
   Content-Type: application/json
   
   {
     "cantidad": 100,
     "estado": "completado",
     "usuario": {
       "nombre": "Juan",
       "id": 12345
     }
   }

3. Variables especiales:

   • externalLink: Proporciona un enlace clickeable en los registros de notificación
   • bodyAsText: El contenido de texto plano del cuerpo de la solicitud si Content-Type es text/plain
   • header: Da acceso a los encabezados de la petición HTTP (p.ej., {{header["content-type"]}})

Disparadores de Email

Cuando un canal se dispara por email, las siguientes variables están disponibles automáticamente:

• from: La dirección de correo del remitente
• to: La dirección de correo del destinatario
• subject: La línea de asunto del correo
• text: El contenido de texto plano del correo
• html: El contenido HTML del correo

Casos de Uso de Plantillas

Contenido Condicional

Puedes usar plantillas para mostrar diferentes contenidos basados en condiciones:

Recibido pago {{cantidad > 1000 ? "grande" : "estándar"}}: ${{cantidad}}

Condiciones de Canal

Además de usar plantillas en el contenido de las notificaciones, puedes establecer Condiciones en la configuración avanzada del canal que determinan si las notificaciones deben enviarse o no. Estas condiciones utilizan la misma sintaxis de expresión (sin las llaves).

Por ejemplo, para enviar notificaciones solo para cantidades mayores a un umbral:

cantidad > 100

Plantillas de Enlaces

Configura una plantilla de enlace personalizada en la configuración avanzada del canal para crear enlaces clickeables en los registros de notificación:

https://dashboard.example.com/ordenes/{{idOrden}}

Si no se establece ninguna plantilla de enlace, se usará por defecto el valor de la variable externalLink.

Variables de tiempo del sistema (UTC)

Estas variables están siempre disponibles para las plantillas (y condiciones) y se calculan en UTC:

• timezone: Siempre "UTC"
• now / iso: Marca de tiempo ISO‑8601 (p. ej., 2025-05-06T12:34:56.789Z)
• epochMs, epochSeconds: Tiempo actual desde el Unix epoch (número)
• year, month (1–12), monthName
• dayOfMonth, dayOfWeek (0–6, domingo = 0), dayOfWeekName
• hour (0–23), minute, second
• date (YYYY-MM-DD), time (HH:mm:ss)

Ejemplos:

Enviado a las {{date}} {{time}} {{timezone}}
Hoy es {{dayOfWeekName}}, {{monthName}} {{dayOfMonth}}, {{year}}
Época: {{epochSeconds}}

Mejores Prácticas

1. Valores Predeterminados: Considera proporcionar valores predeterminados para variables opcionales:

   {{nombreUsuario || "Usuario Anónimo"}}

2. Plantillas Informativas: Incluye información clave en tus plantillas para hacer que las notificaciones sean accionables:

   {{servicio}}: {{estado}} - {{mensaje}}

3. Mantén las Plantillas Concisas: Las notificaciones se muestran mejor cuando los títulos y cuerpos son claros y directos.

4. Pruebas: Prueba tus plantillas con diferentes combinaciones de variables para asegurarte de que se rendericen como se espera.

Las plantillas son una forma poderosa de crear notificaciones dinámicas e informativas que proporcionan a los usuarios exactamente la información que necesitan, cuando la necesitan.