Webability
  1. Inicio
  2. /
  3. Documentación
  4. /
  5. SDKs
  6. /
  7. JavaScript
  8. /
  9. Mail

Docs / SDK / JavaScript / Mail

JavaScript — módulo Mail

🚧 En proceso de liberación  Todavía no implementado en el SDK de JavaScript. El contrato completo (entry points, tipos de datos, ejemplos que sí compilan) ya está fijado en el módulo equivalente de Go — úsalo como referencia mientras se completa este port.

Contrato ya fijado (stub)

El módulo mail.js ya existe en el repositorio con la misma forma que el SDK de Go — send() y status() lanzan un error todavía; la capa de transporte HTTP (index.js) ya está implementada (la usa el módulo DNS, que sí es real), solo falta conectar Mail a ella. 

import { Mail, QueueStatus } from "@webability/webability-js/mail";

const mail = new Mail(api);

const result = await mail.send({
  from: { email: "no-reply@tuempresa.com" },
  to: { email: "cliente@ejemplo.com", vars: { nombre: "Ana" } },
  subject: "Confirma tu compra",
  html: "Hola {{nombre}}",
  waitSend: true,
});
// result.queueStatus: QueueStatus.PENDING | .PROCESSING | .SENT | .ERROR

const status = await mail.status(result.queueKey);

// O con una plantilla ya registrada, en vez de subject/html/text:
const result2 = await mail.send({
  from: { email: "no-reply@tuempresa.com" },
  to: { email: "cliente@ejemplo.com", vars: { nombre: "Ana", codigo: "482913" } },
  template: "recuperacion",
});

El campo template (string, opcional) es el id de una plantilla ya registrada y activa — el servidor valida que exista antes de encolar el correo y responde con error (no un envío fallido en segundo plano) si no. Ver /documentacion/mail — Con plantilla registrada para el detalle completo.

¿Dónde se crean las plantillas?

Las plantillas no se crean por API en ningún SDK — se agregan y editan desde Consola → Correos → Plantillas. El SDK solo referencia el id que le pongas ahí.

Mientras tanto