Actividad de correo
Durante la beta, consulta los envíos individuales y sus eventos mediante la API. El dashboard no incluye un listado global de actividad ni una pantalla de detalle de correo.
Crea las credenciales en Configuración → Desarrolladores. Usa GET /v1/workspaces/{workspaceId}/emails para listar envíos y GET /v1/workspaces/{workspaceId}/emails/{id} para consultar uno, con el permiso emails:read. El listado admite los filtros purpose, contactId y submissionStatus.
Para consultar los eventos registrados, usa GET /v1/workspaces/{workspaceId}/emails/{id}/events con emails:read y events:read. Consulta Envío de correos para el contrato de la API, Autenticación para las credenciales de las solicitudes y Convenciones de la API para la paginación.
Lee el estado del envío
El campo submission.status de la API y los eventos de entrega representan momentos distintos.
| Estado | Qué significa |
|---|---|
queued |
Sendiro aceptó el correo para procesarlo. |
sending |
Se está intentando enviarlo al transporte. |
retry_scheduled |
Hay otro intento de envío programado. |
submitted |
El transporte aceptó el envío; aún no demuestra entrega al destinatario. |
submission_unknown |
No se pudo establecer con certeza el resultado del intento. |
failed |
Se registró un fallo del envío. |
suppressed |
Se bloqueó el envío por una comprobación aplicable. |
Un correo aceptado por Sendiro no equivale a uno entregado, y un evento de entrega no acredita que el destinatario lo haya leído.
Consulta el detalle y los eventos
La respuesta del correo incluye remitente, destinatario, estado de presentación y fecha de aceptación. La propiedad delivery conserva las observaciones de entrega disponibles; un envío fallido incluye un error depurado.
El endpoint de eventos devuelve las entregas, rebotes, reportes de spam y otros resultados registrados. Las fechas de la API usan UTC.
Los eventos dependen del transporte disponible. En las pruebas locales pueden ser simulados y no demuestran recepción real en un buzón.
Investiga antes de repetir
Si el estado es submission_unknown, no repitas el envío como si hubiera fallado: el transporte podría haberlo aceptado aunque no se haya recibido su respuesta.
Comprueba el detalle, los eventos y el resultado de la operación original. Para investigar con tu equipo, conserva el identificador del envío, el workspace y la hora UTC. No compartas claves de API ni datos completos de destinatarios si no son necesarios.
Si el correo fue suprimido o falló, revisa los remitentes, el producto y la capacidad disponible. En Marketing también aplican las comprobaciones de consentimiento y baja.
Envía un correo transaccional
Usa POST /v1/workspaces/{workspaceId}/emails desde tu backend como se describe en Envío de correos. Conserva el identificador del correo aceptado para consultar su estado y eventos.
El envío requiere los permisos correspondientes, capacidad del producto y un remitente autorizado. En el entorno simulado prueba el recorrido dentro de Sendiro, no la entrega real.