Cómo migrar de SparkPost a SendGrid
Publicado: 2017-08-22Como pioneros del correo electrónico transaccional basado en la nube, hemos visto muchos cambios y nuevas empresas en el espacio. La tendencia que hemos visto con estas empresas es que primero nos imitan, luego nos atacan, luego nos imitan un poco más. Además de proporcionar una guía de migración detallada a continuación, queremos brindar algunas ideas sobre el valor que nuestros clientes obtienen de SendGrid.
En primer lugar, cada uno de nuestros clientes, incluidos aquellos que utilizan nuestro plan gratuito, reciben soporte de nuestro equipo de soporte altamente experimentado. Para los clientes de nuestro plan gratuito, este soporte continúa incluso si no actualizan a un plan pago. Y para todos los clientes, el soporte está disponible las 24 horas del día, todos los días del año, para cada región donde se encuentran nuestros clientes. Nuestras ofertas de soporte son parte de nuestro compromiso de hacer que todos los usuarios de la plataforma SendGrid tengan éxito al estar ahí para ellos en cualquier momento.
A continuación, desde las empresas emergentes más pequeñas hasta las empresas más grandes, el correo electrónico programático basado en API no es la única forma en que estas empresas usan el correo electrónico para llegar a los clientes. También envían boletines, anuncios y campañas para aumentar la participación de los clientes e impulsar las compras. En SendGrid, nos dedicamos a satisfacer todas las necesidades de comunicación de los clientes, con la habilitación de un equipo completo para marketing y promoción, así como para programación. Nuestro producto Campañas de marketing le permite involucrar a sus clientes utilizando nuestra interfaz de usuario intuitiva con herramientas avanzadas de segmentación, análisis y diseño.
Finalmente, hay una razón por la que tenemos más de 55 000 clientes que pagan procesando más de mil millones de correos electrónicos por día. La razón es que utilizamos nuestra pasión por las comunicaciones con los clientes y nuestra profunda experiencia en correo electrónico para ayudar a nuestros clientes a hacer crecer su negocio. Cada día que trabajan con nosotros, nuestros clientes sienten nuestra cultura y nuestro compromiso con su éxito.
Cómo migrar a SendGrid desde Sparkpost
Nota: El siguiente plan de migración ha sido proporcionado por cortesía de nuestro equipo de desarrollo comunitario. Este tutorial resaltará algunas diferencias entre enviar correos electrónicos a través de SparkPost y enviar correos electrónicos a través de SendGrid para ayudar a que la migración sea lo más fácil posible.
Si desea echar un vistazo antes de ponerse en marcha, consulte la documentación de SendGrid. Classroom es un excelente lugar para comenzar a aprender sobre el correo electrónico antes de profundizar en la referencia y los detalles de la API.
Terminología
Si está buscando el equivalente de SendGrid de cierta funcionalidad de SparkPost, la siguiente tabla lo ayudará:
Término de SendGrid | Término de SparkPost |
sustituciones/secciones | datos de sustitución |
categorías | etiquetas |
argumentos_únicos | metadatos |
subusuario | Sub-cuenta |
supresiones | lista de supresión |
X-SMTPAPI | X-MSYS-API |
Webhook de análisis entrante | Dominios entrantes |
Campañas de marketing | Sin equivalente |
Obtener una clave API
Primero necesitará una cuenta de SendGrid. A continuación, debe crear una clave API que usará para enviar. Vaya a Configuración -> Claves API , o use este enlace. Una práctica recomendada de seguridad y SendGrid es usar una clave de API diferente para cada una de sus diferentes aplicaciones. Las claves API tienen permisos granulares, por lo que puede habilitar o deshabilitar el acceso de lectura o escritura para puntos finales individuales. Asegúrese de que la clave API que cree tenga acceso total a Mail Send . (Nota: su cuenta debe pasar el aprovisionamiento antes de que pueda crear una clave de API).
Bibliotecas de API
Tenemos una serie de bibliotecas de API admitidas oficialmente para facilitar la integración a nuestros clientes. Si está reescribiendo algún código o refactorizando la forma en que se comunica con su ESP como parte de su migración, ahora es un buen momento para evaluar estas bibliotecas:
- sendgrid-csharp – Biblioteca oficial de C#
- sendgrid-go – Biblioteca oficial de Go
- sendgrid-java – Biblioteca oficial de Java
- sendgrid-nodejs – Biblioteca oficial de NodeJS
- sendgrid-php – Biblioteca PHP oficial
- sendgrid-python – Biblioteca oficial de Python
- sendgrid-ruby – Biblioteca oficial de Ruby
SMTP
Si está enviando a través de SMTP, hay algunas diferencias que debe tener en cuenta. Para autenticarse, proporcione la cadena 'apikey' como nombre de usuario SMTP y use su clave API como contraseña. Luego apunte su nombre de host a smtp.sendgrid.net .
Puede conectarse mediante SMTP a través de TLS o sin cifrar en los puertos 25, 2525 y 587. También puede conectarse mediante 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 de Correo. Las solicitudes a este punto final se autentican a través de un encabezado de autorización con su clave API presentada como un token de portador. Puede encontrar 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 una serie de 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 configuran a través de los parámetros tracking_settings y mail_settings. También puede programar envíos con hasta 72 horas de anticipación utilizando el parámetro "send_at".
Los archivos adjuntos enviados a través de HTTP se manejan de manera similar a SparkPost, donde el contenido se codifica como Base64 y se integra directamente en la carga JSON junto con la información MIME. Puedes leer más sobre la inclusión de archivos adjuntos en la siguiente sección de nuestro Aula de Documentación.
Webhooks
SendGrid proporciona dos webhooks: el webhook de eventos para publicar eventos en tiempo real y el webhook de análisis 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 proporciona SparkPost.
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. API v2 está en desuso, aunque no hay una línea de tiempo para dejar de admitirlo. Todas las nuevas integraciones deberían preferir v3. La autenticación API v3 se logra mediante un encabezado de autenticación con un token de portador.
Campañas de marketing
Tenemos una plataforma con todas las funciones para administrar listas de contactos, crear y diseñar plantillas, realizar pruebas A/B de diferentes plantillas y programar campañas. Todo esto está envuelto en una interfaz de usuario que es fácil de usar para los que no son desarrolladores. Y, por supuesto, también puede acceder a todas estas funciones a través de nuestra API de campañas de marketing.
Algunas preguntas frecuentes
P: ¿Admite plantillas para correos electrónicos transaccionales?
R: Sí, ¡y son dinámicos! Las plantillas transaccionales de 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, haga clic aquí.
P: ¿ Existe una zona de pruebas o una forma de probar mis correos electrónicos sin enviarlos?
R: Puede habilitar el modo sandbox al enviar a través de HTTP. También hay una dirección de "receptor" que puede usar para realizar pruebas.
P: ¿Es posible transferir mi dirección IP/reputación de remitente a SendGrid?
R: No podemos migrar una IP o una reputación, pero podemos ayudarlo a preparar una nueva IP automáticamente.
P: ¿SendGrid admite TLS obligatorio ?
R: Absolutamente. Puede exigir que los servidores de recepción admitan TLS y descartar los mensajes que van a los servidores 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 de su correo electrónico le permite enviar el correo electrónico que la gente quiere, lo que es mejor para todos. Consulte los grupos de cancelación de suscripción para obtener más información.
Si está interesado en migrar a SendGrid, puede encontrar más información en sendgrid.com/pricing.