Descripción general de Email

Envía correo electrónico transaccional y de marketing a través de POST /v1/email/messages. Usa una clave bk_{region}_... con su host regional correspondiente: https://us1.platform.bird.com o https://eu1.platform.bird.com. Firmamos el mensaje con DKIM, lo entregamos e informamos del resultado de cada destinatario.

Si quieres enviar algo antes de seguir leyendo, el quickstart te lleva de una clave API a un mensaje entregado. Esta página cubre el modelo que asume el resto de esta sección e indica la guía de cada parte.

Un envío se acepta en una sola llamada y se entrega de forma asíncrona. POST /v1/email/messages valida el payload y el dominio de envío, y luego devuelve 202 Accepted con un ID de mensaje em_. Consulta el resultado de cada destinatario a través de eventos de webhook o los endpoints de mensaje. Enviar email cubre el payload, los límites de campo y la respuesta.

Dos consecuencias de ese modelo dan forma al resto de esta sección.

Un mensaje, muchos destinatarios, un ciclo de vida cada uno. Un mensaje a cinco direcciones produce cinco resultados independientes, y el estado a nivel de mensaje que consultas es un agregado de todos ellos. La supresión se evalúa de la misma forma: una dirección suprimida regresa como rejected mientras las otras cuatro se entregan.

Cada mensaje declara por qué lo envías. Una categoría de transactional o marketing decide qué supresiones le aplican. Alguien que canceló la suscripción a tu newsletter aún necesita recibir su restablecimiento de contraseña, y la categoría es lo que nos indica la diferencia.

Un envío también puede llegar por otra vía, o salir más tarde. SMTP acepta entregas desde cualquier sistema que hable el protocolo, y el envío programado retiene un mensaje hasta una hora que tú definas.

Email es uno de los canales en la barra lateral del dashboard. Sus páginas, en el orden en que aparecen:

Los destinatarios están fuera de la sección Email, en Contacts en la barra lateral: All contacts almacena personas con propiedades personalizadas tipadas (consulta Contactos), y Audiences los agrupa en las listas reutilizables a las que envía un broadcast (consulta Audiencias).

Envío. Enviar email es la primera guía que debes leer: contiene el payload del que toda otra vía de envío es una variación. A partir de ahí, las plantillas almacenan contenido que reutilizas, los archivos adjuntos agregan archivos, el envío por lotes envía hasta 100 mensajes en una sola solicitud, y los broadcasts envían un email a toda una audiencia.

Dominios y autenticación. Dominios de envío cubre cómo registrar un dominio y verificarlo. DKIM, SPF y DMARC explica qué demuestra cada registro ante un proveedor de buzón receptor, y BIMI muestra tu logotipo junto a tus mensajes en las aplicaciones de email que lo soporten.

Reputación. Supresiones es la lista de direcciones a las que dejamos de enviar, completada automáticamente a partir de rebotes duros y quejas; las cancelaciones de suscripción detienen la entrega de la misma forma, pero mediante una preferencia declarada en lugar de un registro de supresión. IPs dedicadas y pools y calentamiento de IP cubren el envío desde direcciones IP que solo usa tu organización. Entregabilidad de email conecta todo lo anterior.

Saber qué pasó. El registro de email muestra un mensaje y su línea de tiempo por destinatario. Métricas de email agrega tu tráfico. Eventos es el vocabulario de eventos y cómo los webhooks los entregan a tu propio endpoint.

Recepción. Recibir email cubre las dos formas de entrada: una dirección de reenvío que generamos y que no necesita DNS, o registros MX en un subdominio tuyo. Agent mailboxes amplía eso con bandejas de entrada desde las que tu código también envía, además de leer.

Pruebas. El mail sandbox ejercita tu integración de extremo a extremo sin entregar en ningún lado. Envía a bounce@messagebird.dev para generar un rebote duro a través del pipeline real de eventos y webhooks. La prueba no escribe nada en tu lista de supresiones.

Para migrar email en producción desde otro proveedor, sigue la guía de migración. Cubre mapeo de solicitudes, DNS, supresiones, webhooks, pruebas en sandbox y transición de tráfico.