Enviar una notificación

Esta guía muestra el ciclo completo de una notificación: crearla, guardar su identificador y consultar el resultado asíncrono.

Requisitos

• Una cuenta SMTP configurada y probada.
• Una API key.
• Una terminal con curl o un cliente HTTP equivalente.

Enviar un correo básico

Guarda la API key en SUMMIT_NOTIFY_API_KEY y ejecuta:

curl -X POST https://notify.summitexplorerjd.ec/api/v1/notifications \
  -H "Authorization: Bearer $SUMMIT_NOTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "destinatario@example.com",
    "subject": "Bienvenido",
    "body": "Gracias por registrarte."
  }'

channel puede omitirse porque actualmente su valor predeterminado es email. Si tampoco envías smtp_account_id, Summit Notify usa tu cuenta predeterminada.

Interpretar la respuesta

Una solicitud válida devuelve 202 Accepted:

{
  "id": "8f2c1a10-4b3e-4a7a-9c3d-1e2f3a4b5c6d",
  "channel": "email",
  "status": "pending",
  "attempts": 0,
  "max_attempts": 5,
  "created_at": "2026-08-03T14:00:00Z",
  "updated_at": "2026-08-03T14:00:00Z"
}

Guarda id: es el identificador que usarás para consultar el estado. 202 confirma que la notificación entró en la cola, no que el proveedor ya aceptó el correo.

Enviar CC, CCO y un remitente personalizado

curl -X POST https://notify.summitexplorerjd.ec/api/v1/notifications \
  -H "Authorization: Bearer $SUMMIT_NOTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "cliente@example.com",
    "cc": ["supervisor@example.com"],
    "bcc": ["auditoria@example.com"],
    "from_name": "Equipo de soporte",
    "subject": "Actualización del caso",
    "body": "Tu solicitud fue actualizada."
  }'

• cc contiene copias visibles.
• bcc contiene copias ocultas (CCO).
• from_name reemplaza el nombre guardado en la cuenta solo para este envío.

Se admiten como máximo 50 destinatarios totales. Summit Notify valida las direcciones, elimina duplicados y aplica trusted_domains al destinatario principal, CC y CCO.

Enviar HTML

Indica body_type: "html" y envía un cuerpo HTML completo o un fragmento válido:

{
  "recipient": "destinatario@example.com",
  "subject": "Tu resumen semanal",
  "body_type": "html",
  "body": "<h1>Resumen</h1><p>Tienes <strong>3 novedades</strong>.</p>"
}

El contenido se envía como HTML; Summit Notify no transforma texto plano en HTML. Construye el mensaje pensando en clientes de correo y evita depender de JavaScript.

Elegir una cuenta concreta

Desde Cuentas SMTP, pulsa Ver ID y copia el identificador. Envíalo como:

{
  "smtp_account_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "recipient": "destinatario@example.com",
  "subject": "Mensaje",
  "body": "Enviado con una cuenta específica."
}

La cuenta debe pertenecer al mismo usuario que creó la API key. Un identificador inexistente o ajeno se rechaza sin revelar información de otros usuarios.

Consultar el resultado

curl https://notify.summitexplorerjd.ec/api/v1/notifications/8f2c1a10-4b3e-4a7a-9c3d-1e2f3a4b5c6d \
  -H "Authorization: Bearer $SUMMIT_NOTIFY_API_KEY"

El estado avanza de pending a processing y termina en sent o failed. Cuando falla, la respuesta incluye last_error; consulta Supervisar entregas para decidir cómo actuar.

Para mensajes reutilizables, continúa con Crear y usar plantillas.