Broadcasts
Broadcasts permite a un administrador redactar un mensaje una vez y entregarlo a muchas personas
a la vez como mensajes directos de Microsoft Teams, enviados por uno de sus agentes de IA. Está
pensado para anuncios que necesitan llegar a un grupo definido — una ventana de mantenimiento, un
cambio de política, una interrupción del servicio — sin que nadie tenga que ensamblar manualmente
una lista de destinatarios.
Dentro de la aplicación web Beak AI Runtime, Broadcasts aparece en la navegación del lado izquierdo
bajo Engagement — el grupo de superficies desde las que la plataforma se dirige hacia las
personas. Esa es la dirección opuesta a la página Notifications del Runtime, que es la bandeja de
entrada de los mensajes que han llegado a usted.
Acceso
Broadcasts se basa en permisos. Los permisos relevantes son:
| Permiso | Permite |
|---|---|
broadcasts:read | Ver la página de Broadcasts y su historial |
broadcasts:create | Redactar un borrador, buscar grupos en el directorio, previsualizar una audiencia |
broadcasts:update | Editar un borrador existente |
broadcasts:send | Enviar un mensaje de prueba y programar un broadcast |
broadcasts:delete | Eliminar un borrador o cancelar un broadcast programado |
Ninguno de estos permisos pertenece a los roles predeterminados user o viewer, por lo que, de
fábrica, solo los administradores pueden acceder a la página. Para permitir que un grupo más amplio
realice broadcasts, conceda los permisos relevantes a un rol desde Settings → authorization.
Dado que los permisos son independientes, puede conceder a un equipo la capacidad de redactar y
previsualizar (broadcasts:read + broadcasts:create) mientras reserva la capacidad de enviar
realmente (broadcasts:send) para un grupo más reducido.
Las búsquedas en el directorio se realizan con un principal de servicio, por lo que la plataforma
debe estar configurada con GRAPH_TENANT_ID, GRAPH_CLIENT_ID y GRAPH_CLIENT_SECRET para que la
construcción de audiencias funcione. Sin ellos, las pestañas de audiencia devuelven un error de
configuración.
Composición de un Broadcast
Seleccione New broadcast para abrir el compositor.
- Title — Opcional. Etiqueta interna utilizada para identificar el broadcast en la lista de historial. No se muestra a los destinatarios.
- Message — El cuerpo del mensaje, escrito en Markdown. Esto es lo que reciben los destinatarios.
- Target agent — El agente que entrega el mensaje. Los destinatarios ven el broadcast como un mensaje directo de ese agente, en la misma conversación que ya utilizan con él.
Elección de una Audiencia
El constructor de audiencias ofrece tres formas de definir quién recibe el broadcast.
- Attribute filter — Construya una o más condiciones sobre atributos de usuario de Microsoft
Entra ID, como
department equals FinanceojobTitle startsWith Engineer. Varias condiciones se combinan con and, por lo que todas deben coincidir para que un usuario sea incluido. - Group — Busque grupos de Entra por nombre y seleccione uno. La búsqueda predictiva devuelve
hasta veinte coincidencias, y la coincidencia se realiza por tokens, por lo que escribir
financeencontraráCorporate Finance Team. - CSV — Pegue o cargue una lista explícita de direcciones de correo electrónico. Las direcciones se validan, se convierten a minúsculas y se eliminan los duplicados.
Vista Previa de la Audiencia
Seleccione Preview audience antes de enviar. La vista previa resuelve la audiencia contra el
directorio e informa cuántas personas coinciden actualmente, junto con una muestra de los primeros
nombres.
La resolución ocurre cuando realiza la vista previa y de nuevo cuando programa — no cuando se guarda el borrador. Por lo tanto, para una audiencia basada en filtros o en grupos, alguien que se una al departamento después de guardar el borrador aún será incluido, siempre que coincida en el momento en que programe. La programación es el punto de corte: vea más abajo.
Envío de una Prueba
Send test entrega el mensaje redactado solo a usted, como mensaje directo del agente seleccionado.
La prueba es una entrega real a través del mismo camino que utiliza un broadcast, por lo que es la
forma fiable de confirmar el formato y que la conexión del agente con Teams está funcionando antes
de comprometerse con la audiencia completa.
Programación
Schedule bloquea el broadcast para su entrega en una fecha y hora elegidas, que deben estar en
el futuro.
La programación es el punto en el que la audiencia queda congelada: la lista de destinatarios
se resuelve una vez, se registra, y el broadcast pasa de draft a scheduled, con el contenido y
la audiencia en modo de solo lectura a partir de entonces.
Esto significa que la entrega utiliza esa lista almacenada, no una nueva consulta al directorio — alguien que se una al departamento correspondiente después de programar no recibirá el broadcast, y alguien que lo abandone sí lo recibirá. Esto es deliberado: una vez que un broadcast está programado, lo que se enviará y quién lo recibirá son ambos fijos y auditables. Para incorporar cambios en el directorio, cancele el broadcast, edite el borrador y prográmelo de nuevo.
Un despachador en segundo plano detecta los broadcasts cuya hora programada ha llegado y los entrega destinatario por destinatario, registrando el resultado de cada uno.
Historial de Broadcasts
La lista de historial muestra todos los broadcasts de su tenant, los más recientes primero.
Búsqueda de un Broadcast
- Search — Coincide con el título, el cuerpo del mensaje y el autor, en todos los broadcasts del tenant y no solo en la página visible en pantalla.
- Status y Time range — Reduzca la lista a estados particulares, o a broadcasts creados en las últimas 24 horas, 7, 30 o 90 días.
- Column filters — La fila de cuadros debajo de los encabezados refina lo que está cargado actualmente, lo que es útil para un análisis rápido dentro de una página que ya ha reducido.
- Sorting — Seleccione el encabezado de una columna para ordenar por ella; selecciónelo de nuevo para invertir el orden.
- Columns — Muestre u oculte columnas. Su selección se recuerda entre visitas.
- Refresh — Elija con qué frecuencia se actualiza la lista (desactivado, 15s, 30s, 1 minuto, 5
minutos), o actualice inmediatamente. Útil mientras un broadcast avanza por
scheduled→sending→sent.
El conteo sobre la tabla indica "Showing X of N", donde N es el número de broadcasts que coinciden con su búsqueda y filtros — no el número en la página actual.
Exportación
Export CSV y Export PDF descargan los broadcasts que coinciden con su búsqueda y filtros
actuales, no solo la página visible, utilizando las columnas que haya elegido mostrar. El PDF
también registra qué filtros se aplicaron, por lo que un informe exportado es autodescriptivo.
Cada fila muestra su estado y estadísticas de entrega.
| Estado | Significado |
|---|---|
draft | Redactado pero no programado. Editable y eliminable. |
scheduled | Bloqueado con una hora de entrega establecida. Puede cancelarse antes de que comience. |
sending | Actualmente siendo entregado a los destinatarios. |
sent | Entrega finalizada. |
cancelled | Cancelado por un administrador antes de que comenzara la entrega. |
failed | La entrega no pudo completarse. |
Las estadísticas de entrega se desglosan por destinatario en sent, failed, skipped y
pending, por lo que un broadcast parcialmente exitoso muestra exactamente cuántas personas lo
recibieron.
Destinatarios Omitidos
Un destinatario se marca como skipped cuando la plataforma no tiene ninguna conversación de Teams
existente con él para el agente seleccionado. Teams no permite que un bot inicie una conversación
con alguien que nunca ha interactuado con él, por lo que un broadcast solo puede llegar a personas
que hayan enviado un mensaje a ese agente al menos una vez.
En la práctica, esto significa que un agente completamente nuevo llegará a muy pocas personas en su
primer broadcast. Si está desplegando un agente y tiene intención de usar broadcasts con él, fomente
una interacción inicial primero. Revise el conteo de skipped en los primeros broadcasts para ver
qué parte de su audiencia prevista es realmente alcanzable.
Edición, Cancelación y Eliminación
- Edit — Disponible mientras un broadcast está en
draft. Una vez programado, la edición se rechaza para que la audiencia y el contenido registrados no puedan diferir de lo que se entregará. - Cancel — Disponible mientras un broadcast está
scheduledy no ha comenzado a enviarse. El broadcast pasa acancelledy nunca se entrega. - Delete — Elimina un borrador, junto con cualquier registro de destinatarios asociado a él.
Mejores Prácticas
- Envíe una prueba antes del envío real —
Send testutiliza el mismo camino de entrega que un broadcast real, por lo que detecta un error de formato o una conexión de Teams rota antes de que el mensaje llegue a una audiencia de la que no puede retirarlo. - Lea el conteo de audiencia en la vista previa — Un filtro que coincide con muchas más o muchas menos personas de lo esperado generalmente significa que un atributo del directorio está escrito o poblado de forma diferente a lo que se asumía.
- Observe el conteo de
skippeden los primeros broadcasts — Le indica qué parte de su audiencia prevista el agente puede realmente alcanzar; un conteo alto en un agente recién desplegado es esperado y no un fallo. - Programe en lugar de enviar a ciegas — La programación congela la lista de destinatarios, lo que le proporciona un registro auditable de exactamente a quién se dirigió un mensaje.
- Mantenga los permisos de broadcast limitados — Dado que los permisos son independientes, un
equipo puede tener
broadcasts:readybroadcasts:createpara redactar y previsualizar sin tenerbroadcasts:send.