Cómo migrar de la API transaccional de Mailchimp a SendGrid

En 2016, Mandrill, ahora conocida como API transaccional de Mailchimp, se convirtió en un servicio adicional exclusivo para Mailchimp. Esto significaba que solo los miembros mensuales de Mailchimp podían acceder a las funciones de transacción de correo electrónico de Mandrill. Para otros usuarios, tenían que elegir otra plataforma u optar por pagar una cuenta de Mailchimp que no siempre necesitarían.

Entendimos entonces que muchos clientes buscarían un proveedor alternativo que pudiera enviar correos electrónicos de manera eficiente. Twilio SendGrid quería ayudar a que ese proceso fuera lo más fluido posible.

Migración de la API transaccional de Mailchimp a SendGrid

Como estrictamente un complemento, la API transaccional de Mailchimp no está configurada para entregar correo electrónico de manera confiable a la escala que necesita para su negocio. Pero aquí en Twilio SendGrid, somos los líderes en la entrega segura y confiable de correos electrónicos, procesando más de 100 mil millones de correos electrónicos por mes para nuestros principales remitentes, incluidos Uber, Airbnb y Spotify.

En este tutorial, veremos las principales ventajas que puede esperar al enviar correos electrónicos con Twilio SendGrid. Nuestra guía de migración paso a paso garantizará una transición fluida y optimizada.

La documentación de Twilio SendGrid es el mejor recurso para aquellos que buscan una respuesta a todas las consultas relacionadas con SMTP, API y correo electrónico. Es un excelente lugar para comenzar antes de sumergirse en los detalles más esenciales de mover el correo y hacer llamadas a la API.

Pero primero, si está buscando el equivalente Twilio SendGrid de cierta funcionalidad API transaccional de Mailchimp, la siguiente tabla puede ayudar:

Obtener una clave API

Para comenzar, necesita una cuenta de Twilio SendGrid. Luego, querrá crear una clave API que usará para enviar. Vaya a Configuración → Claves API o use este enlace si ha iniciado sesión en su cuenta. Es una buena práctica de seguridad usar una clave de API diferente para cada una de sus diferentes aplicaciones. También puede definir permisos para claves de API habilitando o deshabilitando el acceso de lectura o escritura para puntos finales individuales. Por ahora, solo necesitará uno que tenga acceso completo a Mail Send. (Nota: debe aprobar el aprovisionamiento antes de poder crear una clave de API).

Bibliotecas de API

Tenemos una serie de bibliotecas de API compatibles oficialmente que optimizan aún más el proceso de envío de correo electrónico. Si está reescribiendo algún código o refactorizando la forma en que se comunica con su proveedor de servicios de correo electrónico (ESP) como parte de su migración, ahora es un buen momento para utilizar una de estas bibliotecas para acelerar su integración:

• sendgrid-csharp – Biblioteca oficial de C#
• sendgrid-go – Biblioteca oficial de Go
• sendgrid-java – Biblioteca oficial de Java
• sendgrid-nodejs – Biblioteca oficial de Node.js
• sendgrid-perl – Biblioteca oficial de Perl
• sendgrid-php – Biblioteca oficial de PHP
• sendgrid-python – Biblioteca oficial de Python
• sendgrid-ruby – Biblioteca oficial de Ruby
• ti.sendgrid : envoltorio oficial de titanio

SMTP

Si no está utilizando una de nuestras bibliotecas y está enviando a través del Protocolo simple de transferencia de correo o SMTP, existen algunas diferencias que debe conocer. Para autenticarse al enviar a través de SMTP, proporcione la cadena "apikey" como nombre de usuario de SMTP y use su clave de API como contraseña. Luego, apunte su nombre de host a smtp.sendgrid.net.

Puede conectarse usando SMTP a través de TLS o sin cifrar en los puertos 25, 2525 y 587. O también puede conectarse a través de SSL en el puerto 465. En general, recomendamos el puerto 587, ya que tiende a generar la menor cantidad de problemas con los proveedores de alojamiento. .

El mecanismo para personalizar el correo electrónico enviado a través de SMTP es nuestro encabezado X-SMTPAPI . Este encabezado le permitirá definir sustituciones, enviar solicitudes de estilo de combinación de correo por lotes y controlar los filtros (como el seguimiento de clics) que están activos para su envío.

HTTP

El punto final principal para enviar correo electrónico es el punto final mail.send . Puede autenticar las solicitudes a este punto final a través de un encabezado de autorización con su clave de API presentada como un token de portador. Encuentre un ejemplo más detallado en nuestros documentos.

Las personalizaciones le permiten definir destinatarios y metadatos para cada mensaje, como valores de sustitución para personalizar contenido o custom_args para asociar mensajes con ID de usuario o números de pedido. Hay varios ejemplos de personalizaciones para casos de uso común. También puede encontrar llamadas de ejemplo cURL .

Las funciones, como el seguimiento de clics, se pueden configurar a través de los parámetros tracking_settings y mail_settings .

Para los archivos adjuntos enviados a través de HTTP, manéjelos de manera similar a la API transaccional de Mailchimp, donde el contenido se codifica como Base64 y se incrusta directamente en la carga JSON junto con las extensiones de correo de Internet multipropósito o la información MIME, así .

Tenga en cuenta que el punto final mail.send de Twilio SendGrid es totalmente asíncrono. Aceptaremos la solicitud, siempre que esté bien formada, e intentaremos procesar su envío por correo lo antes posible. La API transaccional de Mailchimp permite que las solicitudes de menos de 10 correos electrónicos se ejecuten sincrónicamente. Sin embargo, Twilio SendGrid no ofrece el modo síncrono.

También puede programar envíos con hasta 72 horas de anticipación utilizando el parámetro "send_at".

Webhooks

Twilio SendGrid proporciona dos webhooks: el webhook de eventos para publicar eventos en tiempo real y el webhook de análisis de correo electrónico entrante para recibir correos electrónicos y responderlos mediante programación. Las formas de datos y las cargas útiles son un poco diferentes de lo que ofrece la API transaccional de Mailchimp: Twilio SendGrid no tiene un equivalente al webhook de "sincronización".

Puntos finales de la API que no son de correo electrónico

Para puntos finales de API que no envían correo electrónico, consulte la descripción general de API v3 . Usamos métodos HTTP intuitivos y códigos de respuesta, en la mayoría de los casos, y aplicamos límites de frecuencia para las llamadas. A pesar de que no hay una línea de tiempo para dejar de admitirlo, API v2 todavía está disponible mínimamente. Sin embargo, todas las integraciones nuevas deberían inclinarse hacia v3. Se puede acceder a la autenticación API v3 a través de un encabezado de autenticación con un token de portador .

Preguntas frecuentes sobre la migración a Twilio SendGrid

P: ¿Admite plantillas para correos electrónicos transaccionales?

R: Sí, ¡y las plantillas son dinámicas! Las plantillas transaccionales de Twilio SendGrid cuentan con soporte nativo para la sintaxis de Handlebars. Además del reemplazo y las sustituciones básicas, puede usar enumeraciones/iterar sobre listas, aprovechar las condicionales y más. Para obtener más información sobre nuestras plantillas, haga clic aquí .

P: ¿Puedo probar mis correos electrónicos sin tener que enviarlos?

R: Puede habilitar el modo de espacio aislado al enviar correos electrónicos a través de HTTP. También hay una dirección de "sumidero" que puede usar con fines de prueba.

P: ¿Es posible transferir mi dirección IP/reputación de remitente a Twilio SendGrid?

R: No podemos migrar una IP o una reputación, pero podemos ayudarlo a preparar una nueva IP automáticamente .

P: ¿Twilio SendGrid admite TLS obligatorio?

R: Absolutamente. Nuestros servidores de recepción admiten TLS y eliminan los mensajes salientes que no cumplen.

P: ¿Puedo permitir que mis destinatarios definan los tipos de correos electrónicos que desean recibir?

R: ¡Sí! Dar a sus destinatarios más control le permite enviar correos electrónicos a suscriptores que realmente los desean, lo que es mejor para todos a largo plazo. Consulte nuestros grupos de cancelación de suscripción para obtener más información.

P: ¿Puede enviar correos electrónicos a varios destinatarios por solicitud?

R: Sí. Los clientes de API v3 que utilizan personalizaciones pueden incluir hasta 1000 destinatarios por solicitud. Los usuarios de SMTP pueden incluir hasta 10 000 destinatarios por mensaje, pero a menudo recomendamos que vaya con 1000 destinatarios por solicitud.

Obtenga más información sobre cómo cambiar de la API transaccional de Mailchimp a Twilio SendGrid