Product
Nueva Events API, seguimiento detallado de emails y búsqueda
Nos complace anunciar el lanzamiento de nuestra nueva API para facilitar la vida al equipo de desarrollo. Nuestra Events API, completamente renovada, hace que sea rápido y fácil determinar exactamente qué ha pasado con todos y cada uno de tus emails. Al igual que Fedex te da un número de seguimiento que te permite seguir todo el proceso de envío, nuestra Events API te permite hacer un seguimiento de cada evento asociado a tu email, incluso los que se producen después de la entrega.
También hemos actualizado la Logs pestaña del panel de control para usar la Events API, de modo que allí también verás información más detallada. Ahora verás los eventos que se producen después de la entrega del email, como las aperturas y los clics. También puedes realizar búsquedas más exhaustivas; por ejemplo, buscar todos los eventos que han afectado a un mensaje concreto mediante una búsqueda por message-id.
Estos registros detallados están disponibles sin coste adicional para los clientes de Mailgun. Los clientes con una cuenta de prueba gratuita dispondrán de al menos dos días de almacenamiento de eventos, y los clientes con una cuenta de pago dispondrán de al menos 30 días.
Ahora, pasemos a los detalles de por qué nos entusiasma tanto la nueva API:
Potente
Los clientes de Mailgun envían millones de emails al mes, por lo que encontrar el estado de un email específico puede ser como buscar una aguja en un pajar. Para ayudarte con esto, hemos añadido un montón de parámetros de filtrado y te permitimos combinar filtros para crear consultas complejas. También hemos mejorado el método de sondeo de la API. Anteriormente, nuestra Events API solo contaba con unos sencillos parámetros de omisión y límite para especificar qué partes de los registros querías recuperar. Esto resultaba engorroso y el rendimiento era deficiente. Con la nueva Events API, hemos proporcionado parámetros que te permiten indicar un periodo de tiempo, además de la posibilidad de especificar un orden ascendente o descendente. También incluimos URL en la respuesta para recuperar la página siguiente y la anterior, lo que te permite recorrer fácilmente los datos del registro, independientemente de la cantidad de registros que se devuelvan. Si no se especifica la fecha de finalización del intervalo de tiempo y el recorrido es ascendente (hacia adelante en el tiempo), acabarás recibiendo una página vacía (es decir, el final del conjunto de datos). Puedes utilizar la misma URL más adelante y el resultado contendrá las entradas del registro que se hayan escrito desde la solicitud anterior.
Rendimiento
Hemos creado la API para que ofrezca un gran rendimiento, incluso con decenas de millones de entradas de registro. Para ello, hemos desarrollado la API sobre ElasticSearch, un marco de trabajo de código abierto para crear búsquedas y analíticas en tiempo real. Publicaremos un artículo de seguimiento sobre los detalles arquitectónicos.
A continuación se indican los parámetros y algunos ejemplos de cómo utilizar la API.
Parámetros de la API
Parámetros de campo de filtrado
Puedes crear consultas complejas combinando parámetros:
Aquí tienes algunos ejemplos: el asunto es “¡Solo queda un día para ahorrar!” Y el destinatario es “customer@example.com” O “paul@example.com”
curl -s --user api:key-3ax6xnjp29jd6fds4gc373sgvjxteol0 -G rnhttps://api.mailgun.net/v2/samples.mailgun.org/events rn --data-urlencode "subject"="Only one day left to save!" rn --data-urlencode "recipient"="customer@example.com OR paul@example.com"rn
El tamaño del mensaje es superior a 25 MB Y el nombre del adjunto es “design-final.pdf” (nota: el tamaño del mensaje se indica en bytes)
curl -s --user api:key-3ax6xnjp29jd6fds4gc373sgvjxteol0 -G rnhttps://api.mailgun.net/v2/samples.mailgun.org/events rn --data-urlencode "attachment"="design-final.pdf"rn --data-urlencode "size"=">26214400"rn
¡Conoce todos los eventos!
Anteriormente, solo registrábamos la información de lo que le ocurría a tu email hasta que el servidor de correo de los destinatarios lo aceptaba o lo descartaba. La Events API te permite consultar todos los eventos, incluidos los que se producen después de la entrega del email. La lista completa de eventos aparece a continuación:
¿Cuándo usaría la Events API?
Para sustituir o ampliar nuestros webhooks de eventos
Si te preguntas algo como “¿qué le ha pasado a mi email?”, Mailgun siempre ha proporcionado una forma sencilla de responder a eso: webhooks. Simplemente configurabas un webhook para el tipo de evento que te interesaba (p. ej., entregado, abierto, clic, etc.) y esperabas a recibir los eventos. Cada vez que hay un email, activamos un webhook. Sin embargo, esto requiere que almacenes muchos datos por tu parte. Además, aunque volvemos a intentar enviar la mayoría de webhooks fallidos, las interrupciones prolongadas de tu sistema podrían provocar la pérdida de datos. Por último, si envías muchos emails, eso significa muchas peticiones a tus puntos de conexión, lo que puede saturar tu servidor.
Nuestra nueva API de registros te permite responder a la pregunta “¿qué le ha pasado a mi email?” mediante un método de extracción (sondeo de la Events API) en lugar del método de inserción de los webhooks.
Proporcionar el estado de un email concreto
Muchos de nuestros clientes utilizan el email para notificaciones de carácter urgente. Ya hemos hablado en nuestro blog sobre cómo el servicio de Rackspace Cloud Monitoring utiliza Mailgun para avisar a los clientes cuando hay problemas con su sitio web o aplicación. PagerDuty y Seguimiento de errores de Exceptional son otros clientes conocidos de Mailgun donde entrega de emails y la capacidad de hacer un seguimiento de esa entrega es vital. En estos casos, no es raro que los usuarios finales digan: “No he recibido el email”. Pues bien, ahora puedes simplemente buscar en la Events API por message-ID y obtener el estado de cada mensaje. Te indicaremos claramente si el mensaje se ha entregado y podrás proporcionar este estado a tu cliente bajo demanda, o incluso integrarlo en tu propia interfaz de usuario. Se acabaron las suposiciones. Solo datos objetivos.
¡Eso es la Events API en pocas palabras! No dudes en consultar la documentación completa para obtener más información.
¡Feliz envío!
El equipo de Mailgun
