Hemos lanzado un nuevo conjunto de puntos finales de la API de Warmy que proporciona a los desarrolladores y usuarios un control mayor sobre cómo gestionan los buzones, el comportamiento de calentamiento, las estadísticas y los datos de dominio dentro de Warmy.io.
Estas incorporaciones son relevantes para los clientes que integran Warmy en sus propias plataformas, crean herramientas de supervisión internas o automatizan operaciones de entrega a gran escala.
Este artículo ofrece un desglose completo de las novedades.
¿Qué hay de nuevo en la API v2 de Warmy?
1. Puntos de recepción de las cabeceras de correo
Hemos añadido una sección dedicada a los encabezados de buzón en la documentación de la API con los siguientes endpoints:
POST: Crear un nuevo encabezado personalizado para un buzón.
GET: Listar todos los encabezados personalizados configurados para un buzón.
GET: Obtener los detalles de un encabezado específico.
PUT: Actualizar el valor de un encabezado existente.
DELETE: Eliminar un encabezado de un buzón.
Una incorporación destacada es la compatibilidad con el encabezado Feedback-ID. Este encabezado se utiliza en el Feedback Loop (FBL) de Gmail, el cual permite a los remitentes de gran volumen identificar qué campañas o segmentos de tráfico están generando quejas por spam, para así responder de manera más rápida a los problemas de entregabilidad.
La documentación de Google sobre el Feedback-ID y cómo funciona con el FBL de Gmail está disponible aquí.
Estos endpoints están diseñados principalmente para remitentes de gran volumen que necesitan rastrear las quejas a nivel de campaña y actuar sobre esos datos de forma programática.
2. Temas de correo electrónico de calentamiento disponibles
Un nuevo endpoint te permite recuperar de forma programada todos los temas de correo electrónico de calentamiento disponibles: GET /api/v2/email_topics
Con esto podrás obtener la lista completa de temas disponibles y utilizarlos al configurar los ajustes de calentamiento del buzón a través de la API, sin tener que consultar manualmente el panel de control.
3. Estadísticas de calentamiento por proveedor
Ahora puedes extraer datos de rendimiento de calentamiento desglosados por fecha y proveedor de correo electrónico para cualquier buzón.
El punto final admite los siguientes períodos de tiempo:
- hoy.
- ayer.
- semana (últimos 7 días).
- mes (último mes).
- trimestre (últimos 3 meses).
- año (último año).
Con ello serás capaz de realizar un seguimiento de cómo varía el rendimiento del calentamiento entre los distintos proveedores a lo largo del tiempo e introducir esos datos directamente en tus propios paneles de control y herramientas de análisis.
4. Preferencias de calentamiento (equilibrio) a nivel de buzón
Un nuevo conjunto de puntos finales permite gestionar las preferencias de calentamiento por buzón:
- GET: Recuperar las preferencias de calentamiento actuales para un buzón.
- PUT: Actualizar las opciones de equilibrio de calentamiento para un buzón.
- GET: Listar los proveedores disponibles para las preferencias de calentamiento.
- GET: Listar los proveedores excluidos para un buzón.
El punto final de proveedores excluidos es muy útil, pues devuelve los proveedores que el sistema de Warmy ha eliminado automáticamente del calentamiento para un buzón específico debido a problemas de envío detectados o alertas.
Esto proporciona a los equipos un control preciso sobre cómo se distribuye el tráfico de calentamiento y facilita la respuesta a problemas específicos de los proveedores sin intervención manual dentro del panel de control.
La documentación completa sobre la configuración de las preferencias de equilibrio a nivel de remitente está disponible en la base de conocimientos de Warmy.
5. Estadísticas de plantillas de usuario
Dos nuevos endpoints proporcionan datos de rendimiento de calentamiento para tus plantillas de usuario:
- Estadísticas totales de todos los proveedores.
- Estadísticas desglosadas por proveedor (con filtrado opcional para plantillas específicas).
Así podrás comparar el rendimiento de diferentes plantillas durante el calentamiento y crear vistas de informes internos que realizan un seguimiento del rendimiento por plantilla y por proveedor a lo largo del tiempo.
6. Estadísticas de rendimiento de la lista semilla
Ahora puedes recuperar los datos de rendimiento de la lista de semillas a través de la API v2:
- Estadísticas totales de todos los proveedores y remitentes de la lista de semillas.
- Estadísticas filtradas para un remitente y un proveedor de la lista de semillas específicos.
Esto facilita la supervisión del rendimiento de la lista de semillas mediante programación, en lugar de tener que comprobar manualmente el panel de control.
7. Obtener la lista de dominios
Un nuevo endpoint devuelve una lista de todos tus dominios con las mismas estadísticas y métricas que se ven en la página de dominios del panel de control de Warmy, incluidos los datos actuales.
Así podrás mantener los sistemas externos sincronizados con los datos de tu dominio Warmy sin tener que iniciar sesión en la interfaz.
8. Obtener detalles del dominio
Un endpoint independiente devuelve información detallada de un dominio específico, incluyendo:
- Puntuaciones de salud del dominio.
- Registros DNS.
- Estadísticas del buzón.
- Resultados del verificador de ubicación.
- Datos de Google Postmaster.
Esto está diseñado para la supervisión automatizada de la capacidad de entrega a nivel de dominio y para herramientas internas que necesitan una fuente única y fiable de datos sobre la salud del dominio.
Qué significa en la práctica el lanzamiento de esta API
Estos puntos finales amplían la API de Warmy en dos direcciones específicas:
- Control más granular sobre el comportamiento del calentamiento (encabezados, proveedores, preferencias de calentamiento).
- Acceso a datos más completos (estadísticas de plantillas, listas de semillas y dominios).
Para los equipos que gestionan el calentamiento a gran escala o que crean plataformas internas basadas en Warmy, esta versión elimina varios obstáculos comunes: la necesidad de comprobar manualmente los proveedores excluidos, la imposibilidad de obtener el rendimiento del calentamiento por plantilla y la falta de datos programáticos sobre el estado del dominio.
¿Qué es lo siguiente?
Ya se está desarrollando el siguiente conjunto de adiciones a la API:
- Puntos finales para generar informes de entregabilidad a nivel de buzón y dominio en formatos XLSX y PDF.
- La capacidad de asignar temas de calentamiento específicos a buzones individuales a través de la API.
Comienza a crear con la API v2 de Warmy
Si estás integrando Warmy en tu propia plataforma o creando automatizaciones personalizadas, la documentación actualizada de la API cubre todos los nuevos puntos finales en detalle.
Comienza tu prueba gratuita de 7 días para obtener acceso. Y si deseas conocer las opciones de integración de manera detallada con nuestro equipo, te invitamos a reservar una demostración.
FAQ
¿Para quién están diseñados estos puntos finales de la API v2?
Están diseñados para desarrolladores, equipos técnicos y agencias que integran Warmy en sus propios sistemas o crean automatizaciones personalizadas.
Son relevantes para los remitentes de gran volumen que necesitan acceso programático a los datos y la configuración de calentamiento.
¿Qué es el encabezado Feedback-ID y por qué es importante?
Feedback-ID es un encabezado que se utiliza con el bucle de retroalimentación (FBL) de Gmail. Permite a los remitentes identificar qué campañas o segmentos de tráfico están generando quejas por spam y responder más rápidamente.
La API de Warmy ahora admite la creación y gestión de este encabezado a nivel de buzón.
¿Puedo utilizar la API para gestionar las preferencias de calentamiento sin entrar en el panel de control?
Sí. Los nuevos puntos finales de preferencias de calentamiento le permiten recuperar y actualizar las opciones de equilibrio de calentamiento por buzón de correo completamente a través de la API.
¿Dónde puedo encontrar la documentación de estos puntos finales?
La documentación actualizada de la API está disponible dentro de tu cuenta de Warmy.
También puedes consultar la guía de preferencias de equilibrio y la documentación de estadísticas de la lista de semillas en la base de conocimientos de Warmy.
¿En qué formatos estarán disponibles los informes de entregabilidad?
Los próximos puntos finales de generación de informes admitirán los formatos XLSX y PDF.
