Supervisar entregas y resolver errores
Summit Notify entrega correo y WhatsApp de forma asíncrona. Después de crear una notificación debes observar su estado cuando el proceso consumidor necesite conocer el resultado.
Interpretar los estados
Sección titulada «Interpretar los estados»| Estado | Significado | Acción recomendada |
|---|---|---|
pending |
Está esperando su primer intento o un reintento programado. | Espera y vuelve a consultar. |
processing |
Un worker reclamó la notificación y está intentando enviarla. | No crees un duplicado. |
submitted |
AWS aceptó la solicitud WhatsApp. | Espera los eventos SNS posteriores. |
sent |
SMTP aceptó el correo o WhatsApp informó el envío. | Considera terminado el envío técnico. |
failed |
Se agotaron los intentos disponibles. | Revisa last_error, corrige la causa y reintenta. |
Para correo, sent no confirma lectura ni entrega final al buzón. Para WhatsApp, SNS conserva las fechas de los eventos delivered y read, pero el estado público permanece en sent.
Usar el dashboard
Sección titulada «Usar el dashboard»El dashboard resume:
- notificaciones pendientes, enviadas y fallidas;
- tasa de éxito;
- actividad por rango de fechas;
- resultados agrupados por cuenta SMTP o WhatsApp;
- envíos recientes;
- causas de fallo más frecuentes.
En Notificaciones puedes ver el destinatario principal, las cantidades de CC/CCO, intentos y último error. Las direcciones CCO no se muestran directamente en el listado.
Consultar desde una integración
Sección titulada «Consultar desde una integración»Guarda el id devuelto por POST /api/v1/notifications y consulta:
curl https://notify.summitexplorerjd.ec/api/v1/notifications/NOTIFICATION_ID \ -H "Authorization: Bearer $SUMMIT_NOTIFY_API_KEY"Evita consultar en un bucle sin pausa. Usa intervalos crecientes y detente cuando el estado llegue a sent o failed. El endpoint público actual no devuelve las fechas de entrega o lectura de WhatsApp.
Reintentar una notificación fallida
Sección titulada «Reintentar una notificación fallida»Antes de reintentar, corrige la causa: credenciales, configuración TLS, disponibilidad SMTP, cuenta WhatsApp inactiva, plantilla no aprobada o permisos AWS. Después, abre Notificaciones y pulsa el botón de reintento en la fila fallida.
El reintento restablece los intentos y vuelve a colocar la misma notificación en la cola. Conserva destinatarios, CC/CCO, remitente, asunto, cuerpo y cuenta seleccionada.
Errores frecuentes
Sección titulada «Errores frecuentes»Credencial inválida o ausente
Sección titulada «Credencial inválida o ausente»Un 401 Unauthorized al crear o consultar notificaciones indica que la API key falta, fue eliminada o no es válida. Genera una nueva key y actualiza el secreto de la aplicación.
Origen no permitido
Sección titulada «Origen no permitido»Un 403 Forbidden puede indicar que el host de Origin o Referer no pertenece a api_allowed_domains. Corrige la lista de la cuenta o realiza la petición desde un origen autorizado.
Destinatario rechazado antes de encolar
Sección titulada «Destinatario rechazado antes de encolar»Un 400 Bad Request puede deberse a una dirección inválida, más de 50 destinatarios o incumplimiento de trusted_domains. La notificación no se crea en estos casos.
Error de conexión SMTP
Sección titulada «Error de conexión SMTP»Revisa host, puerto, cifrado, firewall y disponibilidad del proveedor. Verifica primero la cuenta con el botón de correo de prueba.
Autenticación SMTP rechazada
Sección titulada «Autenticación SMTP rechazada»Confirma el usuario, vuelve a guardar la contraseña y revisa si el proveedor exige una contraseña de aplicación o habilitar SMTP.
Proveedor HTTP (no habilitado)
Sección titulada «Proveedor HTTP (no habilitado)»La entrega mediante proveedores HTTP no está habilitada actualmente. Configura una cuenta SMTP para enviar correo.
Consulta también la referencia de estados y errores.