API de vista previa de correo.

Renderiza tu correo real en más de 50 clientes de correo y dispositivos reales mediante REST: crea una prueba antispam, envía el mensaje y recupera vistas previas con precisión de píxel en formato JSON, cada una capturada desde un cliente en vivo en modo claro y oscuro. Los mismos renderizados se exponen como herramientas MCP, para que los agentes de IA puedan ejecutar una prueba de renderizado de correo en lenguaje natural.

GET /ext/v2/spam-check/{id}/client-previews
curl -X POST https://api.unspam.email/ext/v2/spam-check \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (201)
{
  "id": "2Bl8rzTFN6VV",
  "inbox_address": "test-xyz@check.unspam.email"
}

# send your email to inbox_address,
# then read the previews per device.
curl https://api.unspam.email/ext/v2/spam-check/2Bl8rzTFN6VV/client-previews \
  -H "Authorization: Bearer $UNSPAM_TOKEN"

# response (200)
{
  "status": "completed",
  "previews": [
    {
      "device_key": "aol_chrome",
      "device_name": "AOL (Chrome)",
      "status": "completed",
      "original": "https://…/original.png",
      "thumbnail": "https://…/thumb.png"
    }
    // one entry per device, 50+ in total
  ]
}

Dos endpoints de vista previa. Toda la suite con una sola clave.

La API de vista previa de correo comparte token, límites de peticiones y facturación con las API de prueba antispam y de ubicación en bandeja de entrada, así que el renderizado se integra en el mismo flujo que ya utilizas.

Vistas previas en clientes

GET /spam-check/{id}/client-previewsTu correo renderizado en más de 50 clientes y dispositivos reales, en modo claro y oscuro, como PNG alojados en CDN.

Catálogo de dispositivos

GET /client-preview-devicesTodos los clientes renderizables con su clave y categoría, para construir el filtro devices.

Pruebas antispam

POST /spam-checkLa prueba que lleva las vistas previas: puntuación de spam, análisis forense del remitente y desglose comprobación a comprobación en el mismo resultado.

Herramientas MCP

get_spam_check_client_previewsLos endpoints de vista previa como herramientas MCP para Claude, Cursor, ChatGPT y cualquier cliente MCP remoto.

Por qué los equipos integran las vistas previas en su pipeline.

Capturas reales del cliente, no simulaciones.

Cada vista previa es tu correo abierto en una copia real del cliente y del dispositivo, y luego capturado en pantalla. Sin transformaciones de CSS ni emulación de navegador: el PNG que recibes es exactamente lo que ve un suscriptor en ese cliente.

Modo claro y oscuro en cada cliente.

Cada uno de los más de 50 clientes se renderiza en ambos modos, así que una sola llamada devuelve más de 100 imágenes y el logotipo invertido o el texto ilegible en modo oscuro aparece en tu pipeline, no en producción.

Acota los renders con el parámetro <code>devices</code>.

Pasa devices con claves del catálogo para renderizar solo los clientes que te interesan (solo iOS Mail, solo todos los Outlook), u omítelo para el conjunto completo. Los dispositivos recién solicitados vuelven como pending; sondea hasta que cada uno esté completed.

Herramientas MCP para agentes de IA.

Los endpoints de vista previa se ofrecen como herramientas MCP (get_spam_check_client_previews, list_client_preview_devices) en el servidor MCP de Unspam, de modo que Claude, Cursor o cualquier cliente MCP puede obtener renders reales del cliente en plena conversación.

Qué devuelven los endpoints de vista previa.

Capturas de clientes reales en formato JSON: una entrada por dispositivo, cada una capturada desde un cliente en vivo en modo claro y oscuro.

01

Vistas previas con precisión de píxel como subrecurso de la comprobación de spam.

GET /spam-check/{id}/client-previews devuelve un status de nivel superior y un array previews[] con una entrada por dispositivo: device_key, device_name, un status por dispositivo y URL del CDN para los renders original y thumbnail.

original y thumbnail permanecen como null hasta que ese dispositivo pasa a completed, así que un simple bucle de sondeo vacía todo el conjunto. La mayoría de los dispositivos llegan en torno a un minuto.

gmail · claro
outlook · oscuro
iphone
02

Un catálogo de dispositivos que puedes filtrar.

GET /client-preview-devices enumera cada cliente renderizable con su device_key, su nombre visible y su categoría (DESKTOP, MOBILE, WEB). Guárdalo en caché, muéstralo en tu propia interfaz o úsalo para construir el filtro devices de la llamada de renderizado.

El filtrado importa para la cuota: renderizar tres versiones de Outlook en lugar del conjunto completo gasta tus vistas previas de dispositivo de forma deliberada, que es justo lo que quieres en un trabajo de CI que se ejecuta con cada cambio de plantilla.

  • AOL (Chrome) category: WEB
  • Outlook 2019 category: DESKTOP
  • Apple Mail category: DESKTOP
  • iOS Mail category: MOBILE
  • Android category: MOBILE
03

Las mismas vistas previas, invocables por agentes de IA a través de MCP.

Conecta el servidor MCP de Unspam mediante OAuth y tu asistente obtiene las herramientas de vista previa junto a las pruebas antispam y la ubicación en bandeja de entrada. Pídele que renderice la campaña y señale cualquier fallo en el modo oscuro de Outlook, y él mismo encadena las llamadas.

Hoy ningún otro servicio de vista previa de correo expone renderizados de clientes reales a agentes de IA: la compatibilidad con MCP significa que tus flujos de trabajo con agentes pueden hacer QA de renderizado sin que nadie abra un panel.

  • Renderiza esta campaña get_spam_check_client_previews
  • ¿Qué clientes puedes renderizar? list_client_preview_devices
  • Ejecuta la comprobación completa start_spam_check

Cómo funciona la API de vista previa de correo en cuatro pasos.

Las vistas previas se apoyan en el flujo de la prueba antispam: crea una prueba, envía tu correo a la dirección de bandeja de entrada que te devolvemos y consulta los renderizados de cada dispositivo.

  1. 01

    Crea una prueba antispam

    POST /ext/v2/spam-check con tu bearer token. La respuesta 201 te devuelve un id de prueba y una inbox_address única.

  2. 02

    Envía tu correo a la dirección de la bandeja de entrada

    Desde tu flujo transaccional, tu plataforma de marketing o un paso de CI. Lo que se renderiza es el mensaje exacto que recibiría tu audiencia.

  3. 03

    Lee las vistas previas de clientes

    GET /ext/v2/spam-check/{id}/client-previews devuelve los renderizados por dispositivo. Sondea con un back-off mientras los dispositivos están en pending; las URL aparecen a medida que cada uno se completa.

  4. 04

    Filtra los dispositivos cuando lo necesites (opcional)

    Obtén el catálogo con GET /ext/v2/client-preview-devices y pasa devices para renderizar un subconjunto. La misma prueba también sirve /screenshots y /heatmap si quieres los extras visuales.

Preguntas frecuentes sobre la API.

Integración, filtrado por dispositivo, acceso MCP para agentes de IA y cómo se comportan los endpoints de vista previa.

¿Cómo consigo acceso a la API?
El acceso a la API se incluye en nuestro plan White Label, totalmente a medida: los límites de pruebas antispam, pruebas de ubicación en bandeja de entrada y vistas previas de dispositivos se ajustan a tu cuenta. Habla con ventas indicando el volumen que esperas y definiremos la opción que encaje.
¿Cómo funciona el flujo de vista previa de correo?
Las vistas previas son un subrecurso de una prueba antispam. POST /ext/v2/spam-check devuelve un inbox_address; envías el correo real a esa dirección; luego GET /ext/v2/spam-check/{id}/client-previews devuelve una entrada por dispositivo, con status por dispositivo y las URL de las imágenes. Los dispositivos se completan de forma independiente, así que sondea hasta que el conjunto que necesitas esté completed.
¿Puedo renderizar solo clientes concretos?
Sí. Pasa el parámetro de consulta devices con claves de GET /ext/v2/client-preview-devices para renderizar un subconjunto, por ejemplo solo iOS Mail o solo la familia Outlook. Acotar el renderizado también acota lo que cuesta contra tu cuota de vistas previas en clientes.
¿Las vistas previas son clientes reales o simulaciones?
Clientes reales. Cada renderizado es tu correo abierto en una copia real del cliente y del dispositivo, capturado como una captura de pantalla, tanto en modo claro como oscuro. Esa es la diferencia entre una API de renderizado de correo construida sobre clientes reales y las simulaciones por transformación de CSS que devuelven la mayoría de las herramientas de vista previa gratuitas.
¿Puedo usarla para QA de renderizado en CI?
Ese es el caso de uso principal. Pasa un cambio de plantilla por el flujo en un paso de CI, recoge los renderizados de tus clientes críticos y adjúntalos como artefactos de build o compáralos con la ejecución anterior. La misma prueba devuelve la puntuación de spam, así que un solo trabajo cubre el renderizado y la entregabilidad a la vez.
¿Pueden los agentes de IA ejecutar vistas previas de correo?
Sí. Los endpoints de vista previa se exponen como herramientas en el servidor MCP de Unspam: get_spam_check_client_previews y list_client_preview_devices, junto a las herramientas de prueba antispam y de ubicación en bandeja de entrada. Conecta Claude, Cursor o ChatGPT mediante OAuth y pide renderizados en lenguaje natural; sin claves que pegar.
¿En qué se diferencia esto del endpoint de capturas de pantalla?
/spam-check/{id}/screenshots devuelve tres renderizados de viewport (escritorio, tablet, móvil) del mensaje. /spam-check/{id}/client-previews renderiza el correo dentro de más de 50 aplicaciones cliente reales, cada una en modo claro y oscuro, de modo que detecta fallos específicos de cada cliente, como el motor Word de Outlook o la inversión de un logo en modo oscuro.
¿Cuáles son los límites de frecuencia?
El límite público es de 100 solicitudes por minuto por IP o por cuenta autenticada. El sondeo de vistas previas encaja cómodamente dentro de él con un back-off normal. Si necesitas más capacidad de ráfaga, abre el chat con el rendimiento que esperas.

¿Listo para renderizar correos desde tu propio stack?

El acceso a la API está incluido en el plan White Label. Precios en la página pública, límites personalizados por chat.

Ver precios