Documentación / Difusiones

Difusiones y segmentos

Una difusión envía un mensaje a muchos suscriptores a la vez, opcionalmente filtrado a un segmento y, opcionalmente, en un momento futuro. Abre un bot en la consola y elige Difusiones.

Segmentos

Un segmento es un filtro guardado sobre la audiencia de un bot, creado a partir de atributos que recopilan tus flujos (mediante los nodos Establecer atributo y Pregunta), fechas de suscripción y actividad. Los segmentos son reutilizables: créalos una vez, utilízalos en todas las campañas, y la pertenencia se recalcula a medida que cambian los suscriptores.

Los segmentos también impulsan el nodo Segmento en los flujos, de modo que un suscriptor que entra en un segmento puede activar una automatización: una secuencia de bienvenida para nuevos registros, un flujo de recuperación para los inactivos.

¿Aún no tienes segmentos? Una difusión sin segmento simplemente llega a toda la audiencia de ese bot.

Redacción y programación

Una difusión consta de un nombre, un mensaje (texto con botones opcionales; un botón de URL funciona bien como llamada a la acción) y un segmento opcional. Envíala de inmediato o prográmala para un momento específico, útil para zonas horarias y lanzamientos. Las difusiones programadas permanecen en la lista con su hora prevista hasta que llega el momento.

Cada línea incluye una cuota mensual de difusiones (que se muestra en la página de precios y en tus medidores de uso de Facturación); los envíos que la superen se rechazan con un mensaje claro en lugar de fallar en silencio.

Cómo se regula la entrega

Telegram limita el envío masivo a aproximadamente 30 mensajes por segundo. Meshwire pone en cola una fila de entrega por destinatario y vacía la cola en pasadas en segundo plano a 25 mensajes por segundo, con margen de seguridad respecto al límite, gestionando como máximo 200 destinatarios por campaña y pasada, de modo que una campaña enorme no pueda dejar sin recursos a las demás. Cuando Telegram responde "más despacio", la pasada se detiene de inmediato y se reanuda en el siguiente ciclo justo donde se quedó: a nadie se le omite, a nadie se le envía por duplicado.

Cómo interpretar los resultados

ResultadoSignificado
EntregadoTelegram aceptó el mensaje para ese suscriptor.
BloqueadoEl suscriptor bloqueó al bot, eliminó su cuenta, o el chat ya no existe. Se excluye automáticamente de futuros envíos.
FallidoUn error temporal: se reintenta en pasadas posteriores. Si Telegram indica que la campaña va demasiado rápido, el envío se pausa y se reanuda a un ritmo seguro en lugar de omitir a nadie.

El estado de una difusión pasa de en cola a enviando a completada (o fallida si no se pudo entregar nada). Los contadores por pasada se actualizan a medida que avanza la entrega, y se dispara un evento broadcast.completed hacia tus webhooks con las estadísticas finales.

Ir más profundo

Segmentos, idiomas y entrega honesta

Las difusiones van a segmentos — etiquetas que tus flujos mantienen automáticamente (reservados, lista de espera, miembros de nivel, candidatos por rol) o filtros que defines. Cada uno del público recibe el mensaje en su idioma cuando la difusión trae traducciones, con tu texto base como respaldo.\nLos informes de entrega son honestos por destinatario: enviado, fallido con el motivo, u omitido porque el suscriptor bloqueó al bot — los que bloquean salen del conteo de audiencia para que envíos futuros no quemen cuota en gente que nunca recibirá nada.\nLa programación es de primera clase: agenda una difusión para el futuro y cancélala antes de que salga — esa es la diferencia entre un mensaje programado y un error con temporizador.