Skip to main content

Documentation Index

Fetch the complete documentation index at: https://wiki.vivla.com/llms.txt

Use this file to discover all available pages before exploring further.

Email

El modulo de Email gestiona el envio de correos electronicos transaccionales usando Resend como proveedor. Incluye 8 templates HTML profesionales con soporte para variables dinamicas.

Proveedor

Resend — servicio de email API-first. Configurado via RESEND_API_KEY.

Templates disponibles

TemplateUsoVariables
welcomeOnboarding de usuariofirstName, lastName, loginUrl
password-resetRecuperacion de passwordfirstName, resetUrl, expiresIn
subscription-confirmationSuscripcion completadafirstName, planName, amount, currency, nextBillingDate, billingPortalUrl
subscription-cancelledCancelacion de suscripcionfirstName, planName, cancellationDate, accessUntil
payment-failedFallo de pagofirstName, planName, amount, currency, retryDate, updatePaymentUrl
invoiceEnvio de facturafirstName, invoiceNumber, amount, currency, dueDate, downloadUrl
trial-endingAviso fin de trialfirstName, trialEndDate, upgradeUrl
subscription-renewalRenovacion confirmadafirstName, planName, renewalDate, amount, currency
Cada template incluye version HTML (responsive con CSS inline) y version texto plano.

API Endpoints

Todos los endpoints requieren rol admin.
MetodoEndpointDescripcion
GET/email/templatesListar templates disponibles
GET/email/templates/:nameDetalle de un template
POST/email/testEnviar email de prueba con variables custom
POST/email/welcomeEnviar email de bienvenida a usuario

Opciones de envio

{
  to: string          // destinatario
  subject: string     // asunto
  html: string        // contenido HTML
  text?: string       // texto plano (fallback)
  from?: string       // remitente
  replyTo?: string    // reply-to
  cc?: string[]       // copia
  bcc?: string[]      // copia oculta
  attachments?: []    // adjuntos
  tags?: string[]     // categorizacion
}

Estructura de modulo

apps/backend/src/email/
  email.module.ts
  email.controller.ts
  email.service.ts
  templates/           # Templates HTML