Difusiones de Telegram: escribe a todas las personas que iniciaron tu bot
Envía un mensaje desde tu bot de Telegram a las personas que iniciaron un chat con él: formato, una foto y botones, la vista previa, la simulación, una prueba a tu propio Telegram, los límites de velocidad, los usuarios que bloquearon el bot y los resultados.
Difusiones de Telegram (Interactuar → Difusiones de Telegram, /app/telegram) envía un mensaje desde tu bot de Telegram a cada persona que inició un chat con él, en su chat privado con el bot. No es una publicación en tu canal de Telegram: las publicaciones en el canal se hacen desde Crear (Telegram).
Antes de empezar
- Conecta Telegram en Cuentas (un token de bot de @BotFather y tu canal; consulta Telegram). La difusión la envía ese bot. Sin él, la página dice Aún no hay canal de Telegram con Abrir Cuentas. Si la cuenta estaba conectada pero se desconectó (la plataforma ya no acepta su acceso), la página la nombra en su lugar en un recuadro rojo: [nombre] está desconectado, así que no puede enviar emisiones. Reconéctalo en Cuentas. con Abrir Cuentas, y Nueva difusión de Telegram queda oculto hasta que la reconectes.
- Telegram solo permite que un bot escriba a las personas que pulsaron Inicio en su chat (o que le escribieron). Todas ellas están en tu bandeja de entrada y en Contactos como contactos de Telegram; son las personas a las que puede llegar una difusión. Para ampliar la lista, comparte el enlace de tu bot (
https://t.me/<your bot>) en tu sitio web, en tu canal y en tus otros mensajes. - Crear, enviar, pausar y cancelar requiere el rol de Propietario, Administrador o Editor. Todos los demás pueden abrir la lista y los resultados. Abrir la nueva página de difusión por su dirección muestra Solo los Propietarios, Administradores y Editores crean difusiones en lugar del formulario, y una lista vacía dice Las difusiones aparecen aquí una vez que un Propietario, Administrador o Editor crea una. Cuando guarda dice Primero corrige los campos resaltados., la página se desplaza hasta el primer campo para corregir y coloca el cursor en él. Un mensaje por encima del límite de longitud se marca en rojo mientras escribes, con el conteo al lado.
Paso a paso: escribir y enviar
- Abre Interactuar → Difusiones de Telegram y pulsa Nueva difusión de Telegram. Se abre el editor (/app/telegram/new).
- Remitente: elige el canal en Enviar desde (el mensaje sale de su bot), escribe un Nombre de la difusión (solo lo ve tu equipo) y, si pertenece a una de tus campañas, elígela en Parte de una campaña (opcional).
- Mensaje: escribe el texto en Mensaje. Selecciona palabras y pulsa Negrita, Cursiva o Enlace para darles formato (Enlace escribe
<a href="https://">…</a>; pon tu dirección después de https://). Pulsa Insertar nombre de pila para añadir{{first_name}};{{name}}es el nombre completo. Da un valor alternativo para las personas sin nombre:{{first_name|there}}. El contador debajo del cuadro muestra la longitud: hasta 4.096 caracteres, o 1.024 cuando hay una foto. - Opcional: pega un Enlace de la foto (opcional): un enlace https:// público a un JPG o PNG (hasta 5 MB). Telegram lo descarga por su cuenta y muestra el texto como pie de foto.
- Botones (opcional): completa Texto del botón 1 y Enlace del botón 1 (hasta tres botones). Cada uno abre su enlace debajo del mensaje.
- Quién la recibe: de forma predeterminada, Todas las personas que iniciaron el bot. Acota a una lista o un segmento en Solo los contactos de (opcional), marca Solo las personas que aceptaron el marketing por Telegram para quedarte solo con las personas cuyo Consentimiento muestra Telegram: Aceptó, marca listas en Excluir a las personas de y escribe etiquetas en Excluir a las personas con la etiqueta (separadas por comas). Las personas que bloquearon el bot o retiraron su consentimiento de Telegram siempre quedan excluidas, y cada chat recibe un solo mensaje.
- Cuándo: Enviar ahora, Programar (luego elige Enviar el, en tu hora local) o Guardar como borrador.
- Seguimiento: Contar clics en los botones está activado (consulta Conviene saber).
- Revisa la Vista previa a la derecha: se ve como el chat en Telegram (el nombre del bot, la foto, el texto con formato, los botones). Cambia entre Escritorio y Teléfono (375 px). Muestra tu nombre en lugar del de cada persona.
- Pulsa Ejecutar simulación (ver abajo) y luego Enviar prueba a tu Telegram (primero vincula tu Telegram, ver abajo).
- Pulsa el botón de abajo: Enviar ahora pregunta ¿Enviar esta difusión ahora? con el número de personas; pulsa Enviar ahora (o Todavía no para conservarla como borrador). Programar la guarda como Programada; Guardar borrador la guarda como Borrador. Se abren los resultados de la difusión.
Vincular tu Telegram y enviar una prueba
Una prueba va a tu propio chat privado con el bot, nunca a nadie más. La primera vez, el editor muestra Vincula tu Telegram para recibir pruebas:
- Abrir el bot en Telegram (o envía al bot el mensaje que aparece después O envía ... este mensaje:, que empieza con /start y tu código personal; Copiar copia).
- Pulsa Inicio en el chat con el bot.
- Espera hasta un minuto a que el mensaje llegue a OmniBrand y pulsa Volver a comprobar. Si dice Aún no está vinculado. ¿Pulsaste Iniciar? Puede tardar un minuto., espera un poco y vuelve a comprobarlo.
Una vez vinculado, aparece Enviar prueba a tu Telegram con Se envía a tu propio chat con el bot: y tu nombre de Telegram. La prueba va marcada como [Test], sus botones abren los enlaces directamente (los clics no se cuentan) y puedes enviar 10 pruebas por hora; una prueba que no se envió no cuenta. Cuando se agotan las 10, Enviar prueba a tu Telegram queda desactivado y dice Puedes enviar 10 pruebas por hora. Enviar prueba vuelve a funcionar en [minutos] min. La vinculación es por bot: un segundo bot necesita su propio /start.
La simulación
Ejecutar simulación es un ensayo con las mismas reglas que el envío real; no se guarda ni se envía nada. Muestra:
- [n] la recibirían y [n] personas en la audiencia.
- [ahora] de inmediato · [después] más tarde, en su ventana de envío local — las personas que están fuera de la ventana de envío de Configuración → Reglas de mensajería (horas de silencio, pausa del viernes, ventana de Ramadán) esperan a que se abra.
- superan el límite de frecuencia (omitidos) — personas que ya recibieron tantos mensajes de marketing como permiten tus límites (todos los canales juntos).
- Excluidos, por motivo: están en Telegram pero nunca iniciaron un chat con este bot, sin Telegram, bloquearon el bot, retiraron su consentimiento de Telegram, duplicados.
- Cuánto tarda el envío, una advertencia cuando hay personas sin nombre para
{{first_name}}, y Algunos destinatarios con lo que recibe cada uno. Una persona que espera su ventana de envío muestra cuándo se abre, en su hora y en la tuya, por ejemplo Esperando hasta el 5 oct 2026, 9:00 su hora (Europe/Berlin) · 5 oct 2026, 8:00 tu hora. - Cuando nadie lo entendería (0 lo conseguiría), las razones de Exclusión van primero y no hay líneas de "enseguida · después" ni "Sobre ... min".
Si cambias la difusión después de una ejecución, dice Cambiaste la difusión desde la última ejecución.; pulsa Volver a ejecutar.
Los resultados
Haz clic en una difusión de la lista (en un teléfono se abre a pantalla completa; Todas las difusiones de Telegram vuelve atrás). Ves:
- El estado (Borrador, Programada, Enviando, En pausa, Enviada, Fallida, Cancelada), Del bot de el canal, y Parte de la campaña cuando pertenece a una.
- Destinatarios, Enviados, Entregados, Clics (con el porcentaje de los entregados; Sin seguimiento cuando no hay botones o el recuento está desactivado; la línea Seguimiento bajo el mensaje dice entonces Sin botones, así que sin clics que contar o No se cuentan los clics en botones), Bloquearon el bot, Fallidos, Omitidos y Por enviar (en cola, esperando una ventana de envío o un reintento, o saliendo en este momento: a quienes envía Reanudar; el recuadro de una difusión en pausa también lo indica, por ejemplo Aún no se ha enviado a 3 destinatarios.). Entregados cuenta los mensajes que Telegram aceptó; Telegram no le dice a un bot quién leyó un mensaje, así que no hay Leídos.
- Excluidos al crearla: los mismos motivos que en la simulación, fijados cuando la guardaste.
- Mensaje: el mensaje tal como se ve en Telegram (Escritorio o Teléfono (375 px)) y si se cuentan los clics en los botones.
- Destinatarios: filtra por estado (En cola, En espera, Enviando, Enviado, Bloqueó el bot, Fallido, Omitido) o por Hizo clic, busca por nombre o ID de chat, y Cargar más. Cada fila muestra el nombre y el chat de la persona (Chat 123456789; el ID de un grupo, como Chat -100123, conserva delante su signo menos, también en árabe), cuándo se envió, sus clics y una nota en tu idioma: Esperando hasta … su hora (…) · … tu hora (como en la simulación); mientras la difusión está en pausa, Espera a Reanudar: la difusión está en pausa; cualquier otra espera con su motivo y el próximo intento, por ejemplo Esperando: la plataforma pidió reducir la velocidad · próximo intento 5 oct 2026, 9:05 (tu hora) o Esperando: Telegram no responde · …; No enviado: la emisión fue cancelada; o por qué falló, por ejemplo No enviado: Telegram no encuentra este chat (la persona nunca inició el bot, o borró el chat), No enviado: el bot no puede escribir a esta persona, No enviado: este chat es un grupo o un canal, no una persona, No entregado: esta persona bloqueó al bot o No se vuelve a enviar: la respuesta se perdió, así que puede que haya llegado. No se vuelve a intentar, así que nadie la recibe dos veces. Las propias palabras de Telegram, si dio alguna, aparecen en una segunda línea después de Lo que dijo la plataforma:. Una persona para la que fallaron todos los intentos muestra No enviado: un error temporal se repitió; se abandonó tras 3 intentos.
- Una emisión pausada o fallida dice el motivo en una caja bajo su nombre, empezando por En pausa: o Falló: (ver Si algo sale mal). Cuando la solución es reconectar, termina con Abrir Cuentas, y las propias palabras de Telegram siguen en Lo que dijo la plataforma: Una vez que la cuenta se conecta de nuevo tras una pausa para una cuenta desconectada, la caja dice Pausada: Pausó porque la cuenta estaba desconectada. Está conectada de nuevo: pulsa Reanudar para enviar a las personas que quedan. Un Visor o Revisor no tiene Reanudar: su caja da la razón y luego quién puede actuar, por ejemplo Telegram ya no acepta el token del bot. Un editor o administrador puede reanudarla una vez que la cuenta se reconecte. En un borrador o emisión programada, la segunda frase es Un editor o administrador puede enviarlo una vez que la cuenta esté reconectada.
La página se actualiza cada pocos segundos mientras la emisión es un borrador, programada, enviada o pausada. También recibes una notificación cuando termina, pausa o falla.
La lista muestra las 200 difusiones más recientes. Si hay más, Mostrar campañas anteriores debajo de la lista carga las 200 siguientes.
Cambiar, pausar, cancelar, eliminar
- Enviar ahora inicia de inmediato una difusión en borrador o programada.
- Editar (solo antes de que empiece) vuelve a abrir el editor; Guardar cambios vuelve a comprobar la audiencia.
- Pausar detiene el envío. Reanudar pregunta primero ¿Reanudar el envío?, por ejemplo El envío continúa donde se detuvo, con los 3 destinatarios a los que aún no se ha enviado. y, cuando algunos ya lo recibieron, Los 4 destinatarios a los que ya se envió no reciben otro mensaje. (si es uno, El destinatario al que ya se envió no recibe otro mensaje.); pulsa Reanudar el envío para continuar donde se detuvo, o Todavía no. Una difusión en pausa a la que no le queda nadie por enviar (Por enviar 0) no tiene Reanudar: después del motivo de la pausa, su recuadro dice No queda nada por enviar: ningún destinatario de esta difusión sigue en cola, así que no hay nada que reanudar. Pulsa Cancelar difusión para cerrarla o crea una nueva difusión. (sin Reanudar no estará disponible ni Abrir Cuentas: reconectar no le daría a nadie a quien enviar), y Cancelar difusión es el botón principal; un Lector o Revisor lee No queda nada por enviar, así que no hay nada que reanudar. Un editor o administrador puede cancelarlo. Mientras la difusión está abierta, sus cifras y la primera página de Destinatarios se actualizan solas (una lista que ampliaste con Cargar más se queda como está). Después de Pausar, Reanudar o Cancelar difusión, esa primera página se vuelve a leer con el filtro de estado y la búsqueda que pusiste, y Actualizar, en la parte superior de la página, también vuelve a leer la difusión abierta, incluidas sus cifras y Destinatarios.
- Cancelar difusión pregunta ¿Cancelar esta difusión?: nadie más la recibe; quienes ya la recibieron siguen en los resultados.
- Eliminar solo aparece en una difusión que no envió nada.
Velocidad, bloqueos y fallos
- Los mensajes salen a un ritmo de hasta 25 por segundo por bot, y el chat de una persona recibe como máximo un mensaje por segundo (límites de Telegram). Si Telegram aun así pide al bot que vaya más despacio, el resto espera exactamente lo que indique Telegram y luego continúa; esa espera nunca cuenta como un intento fallido.
- Bloqueó el bot: Telegram lo rechazó porque la persona bloqueó el bot o eliminó su cuenta. Se marca como Detuvo todos los mensajes para Telegram en su historial de consentimiento, con el origen Bloqueó el bot de Telegram, y todas las difusiones posteriores la excluyen. Si desbloquea el bot y vuelve a pulsar Inicio (el bot recibe /start), vuelve a recibir tus difusiones; también puedes registrar su consentimiento con Registrar consentimiento en Contactos.
- Fallido con "chat not found" o "bot can't initiate conversation with a user": ese chat ya no existe para este bot, o la persona nunca pulsó Iniciar. Las demás personas no se ven afectadas.
- Un mensaje cuya respuesta nunca volvió (un corte de red después del envío) se marca como Fallido y nunca se vuelve a enviar, para que nadie lo reciba dos veces. Los problemas temporales en los que Telegram claramente no lo aceptó se reintentan después de 1, 4 y 16 minutos. Un mensaje que un reinicio del servidor interrumpió antes de llegar a Telegram simplemente se envía un poco más tarde.
- El consentimiento y los bloqueos se vuelven a comprobar justo antes de que salga cada mensaje. STOP: una persona que envía STOP al bot (o /stop, UNSUBSCRIBE, إيقاف, إلغاء الاشتراك …, o una de tus propias palabras de Configuración → Reglas de mensajería) en su chat privado con él queda marcada como Detuvo todos los mensajes para Telegram (origen Respondió con una palabra clave), se omite en todas las difusiones de Telegram que aún esperan salir hacia ella y recibe una respuesta breve en el idioma en que escribió (salvo que las confirmaciones estén desactivadas en Reglas de mensajería). Su mensaje sigue en la bandeja de entrada y tu equipo todavía puede responderlo. Si envía START, SUBSCRIBE, اشتراك o /start, vuelve a quedar suscrita.
- Los mensajes de Telegram cuentan para los límites de frecuencia de Configuración → Reglas de mensajería y respetan sus ventanas de envío.
Si algo va mal
- La barra inferior dice Nadie puede conseguirlo todavía. Mira la nota debajo de Cuándo. y una casilla bajo Cuándo dice Nadie en esta audiencia puede conseguirlo aún — un bot solo puede enviar mensajes a personas que pulsaron Inicio en un chat con él, y nadie en la audiencia lo ha hecho (o nadie en la lista elegida). Se muestra después de que Ejecutar simulación no encuentra a nadie, o cuando pulsas Programar: una emisión que nadie puede obtener no puede ser programada. Comparte un enlace a tu bot (t.me/ seguido del nombre de usuario del bot) para que la gente lo inicie. Guardar borrador (o Enviar ahora) sigue guardándolo como borrador, con el toast Guardada como borrador: nadie puede recibirla todavía; No se envía nada. Después, abre el borrador y Enviar ahora: la audiencia se revisa de nuevo y pasa a quien pueda recibirlo para entonces. Si aún así nadie puede, una casilla en la página de la emisión dice Aún así, nadie puede conseguirlo: nadie en esta audiencia ha pulsado Iniciar en un chat con tu bot todavía. Comparte un enlace a tu bot y luego pulsa Enviar ahora de nuevo. con Edítalo para ver quién queda fuera en la simulación, lo que abre la emisión en el compositor.
- Esa cuenta ya no está conectada a este espacio de trabajo. Elige otra o conéctala en Cuentas. — el canal de Telegram fue eliminado; elige otra en Enviar desde.
- Tu propio chat de Telegram aún no está vinculado. Sigue los pasos bajo Vincular tu Telegram para obtener pruebas y luego inténtalo de nuevo. — Enlaza tu Telegram (arriba).
- Bloqueaste al bot en Telegram. Desbloquearlo, pulsa Start en su chat y vuelve a intentarlo. — la prueba no pudo acceder a tu propio chat.
- Pausado: Telegram ya no acepta el token del bot. Crea un nuevo token con @BotFather, reconecta el bot en Cuentas y luego pulsa Reanudar. con Abrir Cuentas — el token fue revocado en @BotFather. No se envió nada más. Una prueba dice que Telegram ya no acepta el token de este bot. ...
- Pausado: Telegram rechazó el mensaje en sí, por lo que no se envió nada más. Cancela esta emisión y crea una corregida. — por ejemplo, el enlace de la foto no puede descargarse, o un enlace de botón no es válido (las palabras de Telegram se muestran bajo Lo que dijo la plataforma:). Reanudar solo sería rechazado de la misma manera, por lo que no se ofrece: el final de la caja «Reanudar» está desactivado: el envío se rechazaría de la misma manera. y Cancelar difusión es el botón principal. Pulsa y crea uno corregido (una emisión iniciada no puede ser editada).
- En pausa: La cuenta desde la que envía está desconectada. Reconéctala en Cuentas y luego pulsa Reanudar. — la cuenta se desconectó mientras se enviaba la difusión. Se pone en pausa (no se pierde nada) y continúa con las personas que no la han recibido cuando la reconectas en Cuentas y pulsas Reanudar. Mientras está desconectada, el recuadro dice En pausa: [nombre], la cuenta desde la que se envía, está desconectada. Reconéctala en Cuentas: Reanudar permanece desactivado hasta entonces. con Abrir Cuentas, y Reanudar está desactivado; cuando se reconecta, el recuadro dice Se pausó porque la cuenta estaba desconectada. Está conectada de nuevo: pulsa Reanudar para enviar a las personas que quedan. Un borrador desconectado muestra un recuadro rojo que nombra la cuenta, con Abrir Cuentas y Enviar ahora permanece desactivado hasta que la cuenta se vuelva a conectar.; si lo pulsas de todos modos, aparece [nombre] está desconectado. Reconéctalo en Cuentas y luego inténtalo de nuevo. Una difusión antigua que se detuvo así antes de que existiera la pausa muestra en su lugar Falló: La cuenta desde la que envió se desconectó, así que esta difusión se detuvo y no se puede reanudar. Reconecta la cuenta en Cuentas y luego crea una difusión nueva para las personas a las que no llegó.
- Editar un borrador cuya cuenta está desconectada muestra la caja roja y Este borrador permanece en solo lectura hasta que su cuenta se reconecta. Reconéctalo en Cuentas y luego vuelve para editarlo o enviarlo. Cuando otra cuenta está conectada, puedes seleccionarla en Enviar desde (la desconectada aparece como [nombre] (desconectado)).
- Alguien cambió esta emisión mientras tanto: ahora está Cancelada. La página muestra dónde está. (u otro estado) — un compañero la pausó, reanudó o canceló justo antes de que pulsaras un botón; la página ahora muestra su estado real y los botones. La página se actualiza cada pocos segundos mientras la emisión es un borrador, programado, enviado o pausado.
- Pausada: Tu cuenta está suspendida, por lo que no se envía nada. Una vez que esté activa de nuevo, pulsa Reanudar. o Pausada: Este espacio de trabajo está archivado, por lo que no se envía nada. Restauralo en Espacios de trabajo, luego pulsa Reanudar. — enviar espera hasta que la cuenta o espacio de trabajo vuelva a estar activo; luego pulsa Reanudar.
- Esta emisión empezó a enviarse mientras tanto, así que ya no se puede cambiar. Ábrela para ver cómo va. — se envió, o llegó su momento, mientras editabas.
- "Una etiqueta de formato no está cerrada, o se cierra en el orden incorrecto" — cada
<b>necesita su</b>, y se cierran en el orden inverso al que se abrieron. - Puedes enviar 10 pruebas por hora. Inténtalo de nuevo en [minutos] min. — se agotaron las pruebas de esta hora; Enviar prueba a tu Telegram vuelve a estar disponible solo.
- La prueba no se envió. Comprueba la cuenta que envía desde Cuentas y vuelve a intentarlo. — Telegram rechazó la prueba; no cuenta para los 10 por hora. Cuando Telegram dio una razón, sigue Lo que dijo la plataforma: en palabras del propio Telegram.
Conviene saber
- Clics de botón: cada botón pasa por una breve redirección en nuestro dominio API (por ejemplo 'api.omnibrand.app/email/c/...') que cuenta el clic y abre la página; cada persona cuenta una vez. Los enlaces dentro del texto se envían tal y como están escritos y no se cuentan. Cambiar Contar clics en los botones para enviar enlaces de botón tal como están escritos. Dejar al compositor con algo escrito que no está guardado - recargando, cerrando la pestaña o siguiendo un enlace - primero pregunta ¿Dejar esta página? Lo que escribiste aquí no se ha guardado y se perderá. Pulsa Cancelar para permanecer.
- Las respuestas a una difusión llegan a la Bandeja de entrada como cualquier mensaje al bot.
- El texto que escribes y que parece una etiqueta pero no es una de las de Telegram (por ejemplo
<3) se envía tal como lo escribiste. - Hasta 200.000 personas por difusión.
- Una difusión creada con Enviar por varios canales en la página de una campaña (su nombre termina en "- Telegram") no tiene Editar: sus personas las eligió ese envío, cada una en un canal (Campañas).