Guía del panel

E-mails

La lista de correos enviados y programados, el detalle de cada uno y los eventos de entrega.

Para qué sirve

La pantalla Correos muestra todo lo que el equipo envió por la API y por SMTP, con el estado de entrega de cada mensaje. Desde aquí compruebas si un correo llegó, ves el contenido exacto que salió, lo reenvías, cancelas un envío programado y compartes un correo con quien no tiene cuenta.

Cuándo usarlo: Para responder "¿llegó el correo del cliente?", investigar rebotes y quejas, o probar una integración y ver el resultado al instante.

#Lista de correos

Dónde está: Correos › Correos. Dirección: app.postal.so/emails.

La lista empieza por los correos más recientes. Postal guarda los correos, los archivos adjuntos y el historial durante 30 días (los programados, hasta que salen); después de eso desaparecen de la lista. Para conservarlos más tiempo, usa los webhooks o el botón Exportar.

Barra de herramientas

Elemento	Qué hace
Buscar por destinatario, remitente, asunto o ID	Busca mientras escribes (espera una pausa). También sirve para pegar el ID de un correo que apareció en un registro o en un webhook.
Período	Atajos (Hoy, Ayer, Últimas 24 horas, Últimos 3 días, Últimos 7 días, Últimos 15 días y Últimos 30 días), más Elige días en el calendario para un intervalo libre y Todo el periodo para quitar el filtro. Las fechas siguen la zona horaria de tu navegador.
Filtros	Abre un panel con tres filtros: Estado (Todos los estados o uno de los estados de abajo), Dominio (Todos los dominios) y Clave de API (Todas las claves). El botón muestra cuántos filtros están activados. Consulta cómo funciona el botón.
Exportar	Genera un archivo CSV con los correos de la lista, respetando la búsqueda, el periodo y los filtros. El archivo se prepara en segundo plano; la descarga empieza desde la tarjeta de tareas en la esquina de la pantalla y se queda en Configuración › Exportaciones durante 7 días. Con la lista vacía, el botón queda desactivado (No hay nada que exportar con estos filtros.).
Ver código	El botón `</>` del encabezado muestra cómo Listar correos por la API (`GET /emails`).

Columnas

Columna	Qué muestra
Para	Los destinatarios, con un icono del estado a la izquierda. Al hacer clic se abre el detalle.
Estado	El estado más avanzado del correo (tabla de abajo).
Asunto	El asunto, cortado si es largo.
Enviado / Enviado el	Hace cuánto salió el correo (o cuándo saldrá, si está programado). Haz clic en el título de la columna, o en el propio valor, para alternar entre Enviado (relativo) y Enviado el (fecha completa). La elección se guarda en este navegador.
Menú de la fila	Ver detalles; Copiar ID; Reenviar (crea un correo nuevo con el mismo remitente, destinatarios, asunto y contenido, sin los adjuntos; no aparece en los programados); Cancelar el envío (solo en los programados).

Estado de un correo

El estado solo avanza: un correo Con clic no vuelve a Entregado, aunque los eventos lleguen desordenados.

Estado	Qué significa
En cola	Aceptado por Postal, saliendo en instantes.
Programado	Marcado para una fecha futura. Se puede reprogramar o cancelar hasta la hora del envío.
Enviado	Aceptado por el proveedor de envío.
Retrasado	El servidor del destinatario aplazó la entrega; los reintentos se hacen solos.
Entregado	Entregado al servidor del destinatario.
Abierto	El destinatario lo abrió (solo con el seguimiento de aperturas activado en el dominio).
Clic	Se hizo clic en un enlace (solo con el seguimiento de clics activado).
Rebote	Devuelto por el servidor del destinatario. Los rebotes permanentes ponen la dirección en la lista de supresión.
Spam	El destinatario lo marcó como spam. La dirección también pasa a la lista de supresión.
Falló	No se pudo enviar: dominio no verificado, envío en pausa, adjunto inaccesible y otros motivos.
Suprimido	Todos los destinatarios, o parte de ellos, estaban en la lista de supresión y no recibieron el correo.
Cancelado	Se canceló un envío programado.

Encontrarás más detalles de los eventos y del objeto correo en Estado de un correo en la referencia de la API.

Consejo

Para encontrar direcciones que no existen, filtra por Estado › Rebotado. La franja de envíos en pausa también lleva directo a esa lista. Para ver solo lo que envió una integración, filtra por la Clave de API que usa.

Cuando la lista está vacía

Si el equipo aún no tiene un dominio, la pantalla dice Aún no has enviado correos y te pide añadir un dominio primero; después hay que crear una clave de API y hacer un POST /emails. El paso a paso está en Primeros pasos.

#Detalle de un correo

Dónde está: Correos › Correos, haciendo clic en un correo. Dirección: app.postal.so/emails.

El detalle muestra un mensaje completo: de dónde vino, a quién fue, qué pasó con él y cómo quedó el contenido. El título es el asunto y, justo debajo, está el estado actual.

Botones del encabezado

Elemento	Qué hace
Línea de tiempo	Abre un panel lateral con cada evento del correo, del más antiguo al más reciente, con fecha y hora: creado en la cola, enviado, entregado, abierto, con clic, rebote y así sucesivamente. En un rebote, aparece si fue Rebote permanente o Rebote temporal y el mensaje del servidor, que ayuda a entender el motivo.
Análisis	Abre las comprobaciones de entregabilidad del correo: Versión en texto sin formato, Sin acortadores de enlaces, Enlaces HTTPS, Sin enlaces a direcciones IP, Imágenes con texto alternativo, Tamaño del HTML (Gmail recorta los mensajes de más de 102 KB), Equilibrio entre texto e imágenes, Un remitente que acepta respuestas, Asunto sin todo en mayúsculas, Opción para cancelar la suscripción y DMARC configurado. Lo que no pasó va primero, con la explicación. Si el asistente de IA está disponible, ¿Cómo lo arreglo? lo explica paso a paso (gasta 1 crédito de IA).
Ver código	Muestra cómo consultar este correo por la API (`GET /emails/{id}`).
Compartir	Crea un enlace público del correo, válido durante 48 horas, y lo copia al portapapeles (el botón se pone verde con Copiado). Quien abra el enlace ve el mensaje sin necesitar una cuenta. Los siguientes clics en Copiar enlace copian el mismo enlace.
Reenviar	Crea un correo nuevo con el mismo contenido y abre el nuevo detalle. Cuenta en la cuota de envíos como cualquier otro.
Reprogramar / Cancelar el envío	Solo en los correos programados. Reprogramar cambia la hora (consulta Programados); Cancelar el envío anula el envío.

Datos del correo

Campo	Qué muestra
De, Para, Cc, Cco, Responder a	Las direcciones tal como se enviaron. Cc, Cco y Responder a solo aparecen cuando existen.
ID	El identificador del correo, con botón de copiar. Es el que usan la API y los webhooks.
Creado el	Cuándo recibió Postal la solicitud de envío.
Origen	API o SMTP.
Solicitud	El enlace Ver registro de la solicitud lleva al registro de la llamada que creó el correo, con el cuerpo enviado y la respuesta.
Programado para	La fecha y hora del envío, en los correos programados.
Etiquetas	Pares de nombre y valor que enviaste en la API, útiles para filtrar y relacionar con tu sistema.

Contenido

Pestaña	Qué muestra
Vista	El correo renderizado, tal como lo ve el destinatario.
HTML	El código HTML enviado, con botón de copiar.
Texto	La versión en texto sin formato.
Original	El mensaje completo, con los encabezados (formato `.eml`). Es la mejor fuente para investigar problemas de entrega.

Si el correo tiene archivos adjuntos, la sección Archivos adjuntos lista cada archivo con tipo y tamaño y un enlace Descargar.

Mira también: GET /emails/{id} · Eventos del correo · Diagnóstico con la API.

#Programados

Dónde está: Marketing › Programados. Dirección: app.postal.so/scheduled.

Una única lista, por día, de todo lo que tiene hora definida: campañas programadas, correos programados por la API o desde el panel, y las activaciones y pausas definidas de las automatizaciones. Sirve para ver qué saldrá y cuándo, sin abrir cada pantalla.

Elemento	Qué hace
Filtros › Tipo	Muestra solo un tipo: Campaña, Correo, Activación o Pausa (Todos los tipos quita el filtro).
Horas en ...	Un recordatorio de la zona horaria en que aparecen las horas: la de tu navegador. Una campaña programada en otra zona horaria muestra también la hora elegida allí.
Día	Cada día tiene un título (Hoy y Mañana cuando corresponde) y la cantidad de elementos (N elementos).
Fila	La hora, el tipo (icono y etiqueta), el nombre del elemento (enlace que abre la campaña, el correo o la automatización) y una línea de detalle: Para el segmento o las direcciones o, en las automatizaciones, La automatización empieza a admitir contactos / La automatización deja de admitir contactos.
Menú de la fila	Abrir; Reprogramar (abre el selector de fecha y hora del tipo); Cancelar programación. Cancelar una campaña o un correo impide el envío; cancelar una activación o una pausa solo quita la marca y la automatización queda como está.

La pantalla muestra los 100 siguientes de cada tipo (Se muestran los próximos 100 de cada tipo.) y se actualiza sola. Los correos y las campañas se pueden programar con hasta 30 días de antelación.

Reprogramar un correo

Reprogramar abre Reprogramar correo: el contenido y los destinatarios siguen siendo los mismos, solo cambia la hora. Elige la Fecha, la Hora y la Zona horaria (Hora de Brasilia, UTC y otras), o usa uno de los Accesos directos: Mañana a las 9:00, El lunes a las 9:00 y En 1 hora. El resumen de abajo confirma la hora en la zona elegida. Si el correo ya salió o se canceló, el panel avisa de que ya no está programado.

Mira también: Reprogramar correo (API) · Campañas · Automatizaciones.

#Eventos

Dónde está: Marketing › Eventos. Dirección: app.postal.so/events.

Los eventos son lo que ocurre en tu producto y que envías a Postal: una compra, un registro, una cancelación. Quedan vinculados a un contacto, aparecen aquí y pueden iniciar automatizaciones y personalizar correos electrónicos. Postal guarda los eventos durante 90 días.

No los confundas con los eventos de un correo electrónico (entregado, abierto, con clic), que están en la línea de tiempo del correo, ni con los eventos de webhook.

Lista

Elemento	Qué hace
Contacto (correo o ID)	Campo de búsqueda para ver solo los eventos de una persona.
Filtros › Evento	Elige un nombre de evento entre los que ya llegaron (Todos los eventos lo borra).

Columna	Qué muestra
Evento	El nombre (por ejemplo, `order.paid`). Al hacer clic se abre el detalle.
Contacto	El correo del contacto, o un guion cuando el evento no tiene contacto.
Propiedades	Un resumen de los datos enviados con el evento.
Cuándo	Hace cuánto tiempo ocurrió; al pasar el puntero del ratón se ve la fecha completa.

Al hacer clic en un evento se abre una ventana con el nombre, el contacto y la fecha, las propiedades en JSON (con Copiar propiedades), el ID del evento y el enlace Ver contacto.

Enviar un evento

El panel de la derecha, Enviar un evento, trae el código listo en cURL, Node.js, PHP y Python (pestaña Lenguaje) con el botón de copiar. Sirve cualquier clave de API, incluidas las de solo envío. Los campos:

Campo	Qué es
name	Obligatorio. Letras, números y los símbolos `. _ : -` (como `order.paid`).
contact	Correo o ID del contacto. Si el correo no existe, se crea el contacto. Sin `contact`, el evento queda registrado, pero no inicia automatizaciones.
properties	Objeto libre de hasta 16 KB. Sirve en filtros, en condiciones de las automatizaciones y en los correos electrónicos, como `{{event.order_id}}`.
occurred_at	Opcional. Cuándo ocurrió (ISO 8601); por defecto, ahora.

Repite la solicitud con el mismo encabezado Idempotency-Key para no duplicar el evento.

Consejo

Antes de montar una automatización por evento, envía un evento de prueba y comprueba el nombre aquí: el nombre debe ser idéntico en el disparador de la automatización.

Mira también: Eventos (API) · Automatizaciones · Idempotencia.