Tu cuenta en {{empresa}} ha sido creada exitosamente.
``` **En el request body (API pública v1):** ```json theme={null} { "template_id": "550e8400-e29b-41d4-a716-446655440000", "variables": { "nombre": "Carlos", "empresa": "TechStore" } } ``` **Resultado renderizado:** ```html theme={null}Tu cuenta en TechStore ha sido creada exitosamente.
``` En `/v1/send-template-email` (campo `variables`), además: * `{nombreVariable}` con llave simple es equivalente a `{{nombreVariable}}`. * Puedes definir un fallback con `{variable || "valor por defecto"}` para cuando la variable no existe. * Los valores se escapan como HTML por defecto; usa `{!variable}` para insertar HTML sin escapar. * Las variables sin valor (y sin fallback) se renderizan como cadena vacía. En la API avanzada (`/send-email`, campo `data`) usa siempre doble llave `{{variable}}`. La llave simple y los fallbacks `||` no están disponibles, y los valores se insertan sin escape HTML. *** ### Condicionales > Disponibles solo en la **API avanzada** (`POST /send-email`, campo `data`). `/v1/send-template-email` no soporta bloques `{{#if}}`. Usa `{{#if variable}}...{{/if}}` para mostrar contenido solo cuando una variable existe y es truthy. Usa `{{else}}` para el caso contrario. **En el template:** ```html theme={null} {{#if premium}}Gracias por ser miembro Premium. Tienes envío gratuito en todos tus pedidos.
{{else}}Actualiza a Premium para obtener envío gratuito.
{{/if}} ``` **En el request body:** ```json theme={null} { "data": { "premium": true } } ``` > **Nota:** Handlebars evalúa como falsy los valores `false`, `undefined`, `null`, `""`, `0` y arrays vacíos `[]`. *** ### Loops Usa `{{#each arreglo}}...{{/each}}` para iterar sobre una lista. Disponible en ambas APIs, con distinta sintaxis dentro del bloque. **En la API avanzada** (`/send-email`, campo `data`), `{{this}}` es el elemento actual. Accede a sus propiedades con `{{this.propiedad}}` y usa helpers: ```html theme={null}| Producto | Cantidad | Precio |
|---|---|---|
| {{this.nombre}} | {{this.cantidad}} | {{formatCurrency this.precio}} |
Total: {{formatCurrency total}}
``` Con `"total": 61970` produce: `$61,970.00` Para usar otra moneda: ```html theme={null}Total: {{formatCurrency total "CLP"}}
``` ### `multiply` Multiplica dos valores numéricos. El resultado se redondea a 2 decimales. ```html theme={null}Subtotal: {{formatCurrency (multiply cantidad precio)}}
``` ### `formatDate` Formatea una fecha ISO 8601 a un formato legible en español (`es-ES`). Acepta un segundo parámetro opcional para el formato. **Formato por defecto (`short`):** ```html theme={null}Fecha: {{formatDate fechaEntrega}}
``` Con `"fechaEntrega": "2025-03-15T00:00:00Z"` produce: `15/3/2025` **Formato largo (`long`):** ```html theme={null}Fecha: {{formatDate fechaEntrega "long"}}
``` Con `"fechaEntrega": "2025-03-15T00:00:00Z"` produce: `sábado, 15 de marzo de 2025` ### `default` Proporciona un valor por defecto cuando la variable es falsy (`undefined`, `null`, `""`, `0` o `false`). ```html theme={null}Hola, {{default nombre "Cliente"}}!
``` Si `nombre` no está definido en `data`, se renderiza como `Hola, Cliente!`. ### `json` Serializa un objeto a JSON con indentación. Útil para depurar o incluir datos estructurados en el correo. ```html theme={null}{{json datos}}
```
Con `"datos": {"clave": "valor"}` produce:
```json theme={null}
{
"clave": "valor"
}
```
También están disponibles los helpers de texto `capitalize`, `uppercase` y `lowercase` para transformar strings.
***
## Identificar un template
Puedes referenciar un template de dos formas en la API pública (`/v1/send-template-email`):
| Campo | Tipo | Descripción |
| ---------------------- | ------------- | ------------------------------------------- |
| `template_id` | string (UUID) | UUID único del template |
| `template_internal_id` | number | ID interno auto-incrementado (por proyecto) |
```json theme={null}
{
"template_id": "550e8400-e29b-41d4-a716-446655440000",
"recipient_email": "usuario@ejemplo.com",
"sender_email": "tienda@tudominio.com",
"variables": {
"nombre": "Ana",
"numeroPedido": "5021"
}
}
```
* Si el template no existe, la API retorna un error `404`.
* `template_internal_id` se resuelve dentro del proyecto asociado a la API key utilizada.
En la API avanzada (`/send-email`), el campo `templateId` acepta el UUID del template o su ID interno numérico, siempre dentro del proyecto asociado a la API key.
***
## El objeto `variables`
En `/v1/send-template-email`, el objeto `variables` es un JSON donde cada clave es una variable del template. Los valores se convierten a string al renderizar. Las variables que el template usa pero que no existen se renderizan como cadena vacía (o con su fallback `||` si está definido).
### Ejemplo completo
**Request:**
```bash theme={null}
curl -X POST https://api.reallyquickemails.com/v1/send-template-email \
-H "Authorization: Bearer sk_proj_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"template_id": "550e8400-e29b-41d4-a716-446655440000",
"recipient_email": "juan.perez@ejemplo.com",
"sender_email": "pedidos@mitienda.com",
"variables": {
"nombre": "Juan",
"numeroPedido": "3847",
"fechaCompra": "20 de febrero de 2026",
"productos": [
{ "producto": "Audifonos Bluetooth", "cantidad": 1, "precio": "$34.990" },
{ "producto": "Cable USB-C", "cantidad": 3, "precio": "$5.990" }
],
"total": "$52.960"
}
}'
```
**Template correspondiente (sintaxis v1):**
```html theme={null}
Pedido #{{numeroPedido}} - {{fechaCompra}}
| {{producto}} | x{{cantidad}} | {{precio}} |
Total: {{total}}
Atendido por: {vendedor || "nuestro equipo"}
``` Este motor no incluye helpers de formateo: envía precios y fechas ya formateados como strings. Para condicionales, helpers o propiedades anidadas, usa la API avanzada (`POST /send-email`) con `templateId` + `data`. *** ## Acceso a propiedades anidadas En la API avanzada (`/send-email`, campo `data`), usa notación de punto para acceder a objetos anidados: ```html theme={null}Ciudad: {{direccion.ciudad}}
Región: {{direccion.region}}
``` ```json theme={null} { "data": { "direccion": { "ciudad": "Santiago", "region": "Metropolitana" } } } ``` En `/v1/send-template-email` la notación de punto **no** está soportada: aplana las variables antes de enviarlas (por ejemplo `direccion_ciudad` en lugar de `direccion.ciudad`). *** ## Buenas practicas * **Define valores por defecto para variables opcionales:** en la API avanzada usa el helper `default`; en v1 usa fallbacks `{variable || "valor"}`. Así evitas espacios vacíos en el correo. * **Valida tus variables antes de enviar.** Las variables que el template espera pero no existen se renderizan como cadenas vacías, sin error. * **Guarda el `template_id` (UUID) en tu configuración**, o usa `template_internal_id` si prefieres IDs numéricos cortos por proyecto. * **Prueba tus templates** con datos de ejemplo antes de integrar. En la API avanzada usa `dry_run: true` para renderizar sin enviar — ver [Dry Run](/api-reference/send-email#dry-run).