Este documento describe formas comunes en que nuestros clientes utilizan Bird para la integración general. Estas integraciones cubren temas esenciales como “¿cómo envío un correo electrónico?” y “¿cómo sé qué pasó con el correo electrónico?” Para organizaciones que mantienen configuraciones híbridas en las instalaciones y en la nube con requisitos de seguridad, nuestra guía de implementación de S/MIME para plataformas en las instalaciones cubre las configuraciones de PowerMTA y Momentum para la entrega segura de correos electrónicos. Si estás haciendo la transición desde Postfix, Sendmail o Exim, este documento debería explicar todo lo que necesitas saber sobre los conceptos básicos de envío e informe de correo electrónico.  El resto de este documento asume que tienes una cuenta existente de SparkPost.

¿Cómo envío un correo electrónico?

Bird aceptará correo para transferencia de un par de maneras. Con mucho, el más común es SMTP (Protocolo Simple de Transferencia de Correo) y Bird se presenta precisamente como cualquier otro agente de correo seguro en el puerto 587. Si actualmente tienes un generador o software de fusión de correo que crea un correo electrónico para la entrega, Bird lo aceptará como un mensaje SMTP estándar e intentará entregarlo. Necesitarás un sistema con un certificado TLS válido que pueda generar mensajes SMTP y enviarlos a través del puerto 587. Postfix, Sendmail y Exim tienen esta capacidad de forma nativa.

Ejemplo 1:

Tienes un servidor web que genera un mensaje combinado para la entrega de correo electrónico a través de Postfix.
· Ajusta el software de generación del servidor web para enviar el mensaje SMTP a tu servidor SparkPost asignado en lugar del servidor Postfix
· Sí, realmente es así de fácil

Ejemplo 2:

Tienes algún código de gestión que necesita usar la función "Mail" del servidor local.
· Si estás usando Sendmail, edita el archivo /etc/mail/sendmail.mc para agregar una definición de "smart-host".
IE: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Si estás usando Postfix, edita el archivo /etc/postfix/transport para agregar una definición de retransmisión smtp.
IE: * smtp:MyMessageBirdServer.com
· Asegúrate de habilitar TLS y configurar el puerto de salida a 587.
· Aplica los cambios y reinicia los servicios de correo locales
· Ejecuta el código de gestión y el correo se enviará a MessageBird para su entrega

¿Qué pasa con la inyección REST?

Para los clientes que usan HTTP(S) para transportar datos en sus redes, convertir un mensaje a SMTP puede ser engorroso. Bird tiene una API REST completa que puede aceptar una plantilla JSON, lista de destinatarios y datos de sustitución a través de HTTPS y luego convertir eso en correo electrónico generado (combinado) para ser enviado al mundo a través de SMTP estándar. Esto es particularmente útil para descargar el trabajo de generación de los servidores web al motor de correo.

Ejemplo:

Tus servidores generan un boletín para 50,000 destinatarios diariamente fusionando datos personales y luego se envía individualmente a través de Postfix.
· Crea objetos JSON para los destinatarios, datos de sustitución y plantilla de contenido.
· Usa la API REST para POST los objetos JSON a la API de Transmisión de Bird. Hacer esto descarga el proceso de generación a SparkPost para una entrega más rápida.
· Incluso puedes poner el JSON en un archivo y usar cURL:

curl -v -H "Content-Type: application/json" -X POST \ https://api.bird.com/api/v1transmissions -d@./newsletter.json

¿Cómo obtengo información de entrega?

Bird recopila abundante información de entrega y la pone a tu disposición en formato JSON que puede ser "enviado" como un webhook o "solicitado" con una llamada de API. Los datos para una entrega se ven algo así:

{      "campaign_id":"Welcome_Letter",    "customer_id":"108",    "delv_method":"esmtp",    "event_id":"84769964978165188",    "friendly_from":"bounce@sp-send.com",    "ip_address":"50.116.50.117",    "ip_pool":"default",    "message_id":"00046a82565a6d39451a",    "msg_from":"abc-bounces-108@sp-send..com",    "msg_size":"2164",    "num_retries":"0",    "queue_time":"1759",    "raw_rcpt_to":"fakespark+32@deadboltemail.com",    "rcpt_meta":{      },    "rcpt_tags":[      ],    "rcpt_to":"fakespark+32@deadboltemail.com",    "routing_domain":"deadboltemail.com",    "sending_ip":"52.38.47.118",    "subject":"Welcome Letter Template",    "tdate":"2018-01-10T21:15:24.000Z",    "template_id":"welcome-letter",    "template_version":"5",    "transmission_id":"84769964922735103",    "type":"delivery",    "timestamp":"2018-01-10T14:15:24.000-07:00" }

Esa es probablemente mucha más información de la que estás acostumbrado a ver en un registro de Postfix y ya está en un formato fácilmente consumible. Es relativamente trivial convertir esos datos JSON al formato de registro de Postfix si es necesario. Los datos de entrega, rebote, rechazo, queja de spam, apertura, clic y retraso se pueden leer de la misma manera.

Ejemplos:

1) Normalmente exportas los registros de Postfix a Excel para poder ordenarlos y analizarlos.
A) Ejecuta una llamada API de message_events y pasa los datos JSON resultantes por JSON2CSV.

2) Te gusta convertir tus registros de Postfix a JSON y luego pasarlos a un servicio web para lectura y análisis.
A) Usa la API de métricas de MessageBird para preguntar a SparkPost por los datos que necesitas, y se exporta automáticamente como JSON

3) Tienes un proceso separado que sigue y analiza los registros en tiempo real y actualiza una base de datos de destinatarios por separado.
A) SparkPost puede proporcionar un webhook en tiempo real que puede alimentar tu proceso quejas de spam y bajas específicamente para este propósito. La implementación es trivial.

-Tom