Ir al contenido
Docs SummitExplorerJD

Summit Notify

Summit Notify recibe notificaciones, las guarda en una cola y las entrega por correo o WhatsApp. Puedes trabajar desde el panel web, responder conversaciones o integrar otro sistema mediante la API JSON.

Qué puedes hacer

Sección titulada «Qué puedes hacer»
  • Registrar varias cuentas SMTP y elegir una cuenta predeterminada.
  • Registrar números de WhatsApp administrados por Notify o propiedad del cliente.
  • Enviar plantillas aprobadas y mensajes libres dentro de la ventana de servicio de 24 horas.
  • Gestionar conversaciones con texto, imágenes, audio, video, documentos, ubicaciones y reacciones.
  • Proteger adjuntos entrantes mediante S3 y URLs firmadas de CloudFront.
  • Consultar el estado de la integración con proveedores HTTP, actualmente no habilitada.
  • Crear API keys independientes para tus aplicaciones.
  • Enviar texto o HTML, con destinatarios CC y CCO.
  • Cambiar el nombre del remitente en un envío específico.
  • Reutilizar asuntos y cuerpos mediante plantillas con variables.
  • Restringir los dominios de destinatarios y los sitios autorizados para usar una cuenta.
  • Consultar estados, errores e intentos, y reintentar entregas fallidas.

Ruta recomendada

Sección titulada «Ruta recomendada»

Si es tu primera integración, sigue las guías en este orden:

  1. Configura una cuenta SMTP o un canal de WhatsApp.
  2. Crea una API key para tu aplicación.
  3. Envía una notificación y consulta su estado.
  4. Integra el SDK JavaScript y TypeScript si prefieres un cliente tipado en lugar de llamadas HTTP manuales.
  5. Crea y usa plantillas para correo, o registra plantillas de WhatsApp desde el menú Plantillas.
  6. Gestiona conversaciones de WhatsApp.
  7. Supervisa entregas y resuelve errores.

La integración mediante API HTTP no está habilitada actualmente. Consulta Proveedor HTTP (no habilitado) para conocer esta limitación.

Panel y API

Sección titulada «Panel y API»

El panel está disponible en notify.summitexplorerjd.ec/admin/login. Desde ahí puedes administrar cuentas SMTP y WhatsApp, API keys, plantillas, notificaciones y conversaciones.

La URL base de la API es:

https://notify.summitexplorerjd.ec/api/v1

Los endpoints administrativos de cuentas y plantillas usan un token OpenID Connect. Los endpoints de notificaciones usan una API key creada en el panel. Consulta Autenticación de Summit Notify para distinguir ambas credenciales.

Conceptos importantes

Sección titulada «Conceptos importantes»

Una solicitud aceptada no implica que el correo ya haya sido entregado. La API responde 202 Accepted, crea una notificación en estado pending y el worker la procesa de forma asíncrona.

pending -> processing -> sent
                      -> submitted -> sent
                      -> failed

En WhatsApp, los eventos delivered y read se conservan como marcas de entrega y lectura; no son valores independientes del campo status.

Los intentos fallidos se reprograman automáticamente hasta alcanzar el máximo configurado. El estado sent indica que el proveedor aceptó el mensaje; no confirma que el destinatario lo haya leído ni que no exista un rebote posterior.

Referencia rápida

Sección titulada «Referencia rápida»