Broadcasts

Un broadcast envía un correo electrónico a toda una audiencia: un boletín, un anuncio o cualquier contenido individual que se envía a muchos destinatarios a la vez. Los miembros de la audiencia se resuelven en la lista de destinatarios cuando comienza el envío, de modo que el broadcast llega a quien sea miembro de la audiencia en ese momento.

Crea difusiones en Email > Broadcasts en el panel, a través de la API de difusiones, con bird email broadcasts, o a través del servidor MCP. Los SDK de TypeScript, Python, Go y PHP incluyen un recurso broadcasts para todo el ciclo de vida: crear un borrador, modificarlo mientras sigue siendo borrador, enviarlo de inmediato o en un momento posterior, listar las difusiones del espacio de trabajo, consultar una con sus contadores, cancelar una programada o en envío, eliminar una que aún esté en borrador, y consultar sus destinatarios, eventos, enlaces clicados, la cuota de envío que consumiría un envío y los conteos de audiencia contra los que se resuelve un envío. Para una lista de destinatarios de un solo uso, utiliza el envío por lotes o los envíos individuales.

Empieza desde la lista de Broadcasts con New broadcast. El compositor es una sola página: una barra de audiencia y remitente en la parte superior, el contenido del correo debajo y un control de configuración para categoría, seguimiento y etiquetas. No hay un paso de guardado aparte. Cada cambio se guarda automáticamente en cuanto el broadcast tiene una audiencia y un remitente, así que el borrador existe desde el momento en que ambos se configuran, y enviarlo después es una acción separada y explícita.

Usa el campo To para elegir una audiencia, o selecciona New para crear una sin salir del compositor.

Abre el control de configuración en el encabezado del compositor para tres cosas más:

Un broadcast se envía desde una dirección en un dominio de envío verificado. Combina una parte local con uno de tus dominios verificados y añade un nombre para mostrar si lo deseas. Añade una dirección Reply-To si quieres que las respuestas se dirijan a otro lugar. Seleccionar Review te avisa si el dominio no está verificado.

Un broadcast apunta a una de las plantillas de correo de tu espacio de trabajo, y la plantilla contiene el asunto y el cuerpo que el broadcast envía. Las propiedades de contacto de cada destinatario rellenan las variables de la plantilla cuando se ejecuta el envío, de modo que un broadcast personaliza su contenido por destinatario. Un broadcast solo puede rellenar propiedades de contacto, así que una variable de plantilla que haga referencia a otra cosa se rechaza al enviar, y el error indica qué variable es.

Escribe el contenido directamente en el lienzo debajo del asunto, o selecciona Choose a template para partir de una plantilla existente. Esa opción solo está disponible mientras el broadcast está en blanco, ya que elegir una plantilla después de haber escrito un asunto o un cuerpo lo sobrescribiría. Un broadcast envía la versión publicada de la plantilla, por lo que una plantilla que solo tiene un borrador no puede respaldar un envío.

Una plantilla con más de un idioma envía uno de ellos a toda la audiencia. Indícalo como template.language cuando crees o actualices el broadcast, y omítelo para enviar el idioma predeterminado de la plantilla. Cambiar solo el idioma mantiene el broadcast en la versión a la que está fijado, una vez que tiene una. Un broadcast se fija a una versión cuando se prepara para el envío, así que un broadcast programado envía la versión publicada en ese momento, cambies o no el idioma antes.

El envío es una acción separada y explícita, disponible desde el botón Revisar del compositor o desde la página de detalle del broadcast mediante Enviar o reprogramar. Ambos abren un diálogo que verifica que el broadcast esté completo, te advierte sobre cualquier cosa que pueda hacer fallar el envío y luego te permite elegir Enviar ahora o seleccionar una hora hasta un año en el futuro. Un broadcast programado sigue siendo editable y puedes reprogramarlo hasta que el envío comience.

El envío comprueba que la audiencia todavía tiene a alguien a quien llegar. Una audiencia en la que nadie tiene dirección de correo electrónico, o en la que todas las direcciones están suprimidas, se rechaza en ese momento en lugar de fallar después.

Se comprueban dos límites a nivel de organización cuando envías.

El primero es cuántos broadcasts puedes enviar en un período de facturación. Tu plan establece la cantidad. Los borradores guardados no cuentan para ese límite, y cancelar un broadcast no devuelve la cuota. Una vez que la hayas agotado, esperas al siguiente período de facturación o cambias a un plan con un límite mayor.

El segundo limita los broadcasts simultáneos. Si seleccionas Enviar ahora mientras el límite está alcanzado, la solicitud se rechaza. Un broadcast programado espera a que haya un espacio libre.

Busca en la lista por etiqueta o nombre de plantilla, o filtra por estado, audiencia o un rango de fechas. El rango de fechas filtra por la fecha de creación de cada broadcast, no por la de envío, así que un broadcast que programaste la semana pasada para un envío el mes que viene sigue apareciendo en "Last 7 days."

Exporta la vista actual como CSV desde el botón sobre la tabla, o llama a Exportar broadcasts como CSV, que acepta los mismos filtros. Por encima de 50.000 filas, la exportación se rechaza en lugar de recortarse silenciosamente. Reduce los filtros e inténtalo de nuevo.

Un broadcast siempre está en una de cuatro etapas, y el filtro de Estado en la lista usa esas cuatro:

La insignia de cada fila muestra el estado exacto dentro de su etapa. Ese mismo valor es lo que devuelve el campo status de API.

Cancela un broadcast programado o en envío desde su página de detalle, con bird email broadcasts cancel, o con Cancelar un broadcast y el método broadcasts.cancel SDK. Los destinatarios a los que aún no ha llegado se omiten, y cualquier mensaje que ya esté en camino no se puede retirar. Eliminar solo funciona con un borrador y es permanente, a través de las mismas tres vías: la página de detalle, bird email broadcasts delete, o Eliminar un broadcast.

Un broadcast fallido muestra el motivo en su página de detalle: la razón y luego una oración que nombra la causa exacta. A través de API, esos dos son los campos failure_reason y failure_detail. failure_detail es lo que te indica cuál de las varias causas de una razón es la que realmente ocurrió.

La configuración de envío de un broadcast se comprueba solo cuando el envío comienza. Si el dominio de envío estaba verificado al programar pero perdió la verificación antes del envío, el broadcast falla en ese momento. Verifica el dominio y envía el broadcast de nuevo.

Los broadcasts y los envíos individuales consumen la misma cuota de correo. La tarjeta del plan en la vista general de facturación de tu organización muestra cuánto has usado. Planes y precios detalla lo que incluye cada plan.

Una vez que el envío comienza, la pestaña Resumen del broadcast muestra los contadores de destinatarios y enviados, y luego las tasas y contadores de entrega, apertura, clics, rebotes y quejas. La pestaña Destinatarios lista cada destinatario junto con su estado de entrega, el motivo si no se entregó, cuándo se entregó y sus aperturas y clics. Su cuadro de búsqueda requiere una dirección de correo completa y válida; una dirección parcial o un dominio no pasa la validación, marca el cuadro como inválido y deja la tabla mostrando lo que mostraba antes. Un botón sobre la tabla exporta la pestaña como CSV, y Exportar destinatarios de un broadcast como CSV devuelve el mismo archivo a una clave API; ambos están limitados a 500.000 filas con el mismo comportamiento de rechazar en lugar de truncar que la exportación de la lista de broadcasts. La pestaña Eventos es el feed de eventos sin procesar del broadcast, con los tipos de evento descritos en eventos y webhooks.

Pon una dirección sandbox en la audiencia y ese contacto se simula en lugar de enviarse: delivered@messagebird.dev reporta entregado, bounce@messagebird.dev rebota, y cada uno produce los mismos eventos y webhooks que un destinatario real. Así es como pruebas una campaña, y el handler que lee sus eventos, sin enviar correo a nadie. Una audiencia puede mezclar contactos sandbox y reales; cada contacto obtiene su propio resultado. Un destinatario simulado sigue contando contra tu cuota de envío, así que el ensayo consume la misma cuota que el envío real.