Base de conocimiento de GetMyBot

Difusiones

Enviar una noticia o un recordatorio a un grupo de clientes: elegir contenido, canales y destinatarios, comprobar el envío y consultar los resultados.

En esta página

Una difusión envía un contenido preparado a muchas personas. Por ejemplo, una invitación a una clase para quienes tienen la etiqueta «Interés en el curso». Primero elige el contenido, el público y los canales; después revisa los destinatarios y confirma el envío.

Hay dos formas de hacerlo en GetMyBot:

  • La sección Difusiones (/app/broadcasts): editor completo con un documento de contenido, selección de canales y público, programación, comprobación previa e informe por canal. Es el método principal.
  • El botón Difusión de una reacción: envía una reacción ya preparada a los suscriptores activos. No tiene borrador ni comprobación previa; revisa el contenido de la reacción y su público antes de pulsarlo.

Ambos métodos requieren un plan que incluya difusiones y el permiso «Reacciones» sobre el bot. Sin la función en el plan, la creación devuelve un error de pago. Sin el permiso, la sección muestra una pantalla vacía con una explicación.

Editor de difusión

Abre Difusiones en el menú lateral. Crear difusión abre un editor con cuatro bloques.

Nombre y canales. Escribe un nombre de hasta 160 caracteres y elige uno o varios canales: Telegram, VK, WhatsApp, chat web, email, push del navegador, push móvil o presentación dentro de la aplicación. Una difusión puede combinar los mensajeros con el chat web, o el push del navegador con el móvil. Email y la presentación dentro de la aplicación se eligen por separado. Cada grupo necesita un tipo de documento distinto: Mensaje, Push, Email o En la aplicación. Como la difusión guarda una referencia a un único documento, elegir un canal de otro grupo quita los canales elegidos antes.

Contenido. Elige una versión publicada de un documento del tipo adecuado. La difusión guarda el ID del documento y su número de versión: publicar otra versión después no cambia esta difusión. Desde el editor puedes crear contenido nuevo o una copia editable del actual; al guardarla, la copia se publica y se selecciona para la difusión. Para mensajeros y chat web hay bloques de mensajes, incluidos mensajes de voz, GIF, vídeos circulares y carruseles. En VK, el carrusel se envía como una serie de mensajes.

Para mensajeros, chat web y email hay una vista previa por canal. Al seleccionar un destinatario de prueba, la vista previa usa sus datos y Enviar prueba entrega el contenido a ese contacto verificado. La prueba sigue las mismas cuotas y límites de frecuencia que el envío de prueba del Estudio de contenido: no altera la lista de destinatarios de la difusión, no permite introducir una dirección arbitraria y rechaza pruebas demasiado frecuentes. El push del navegador, el push móvil y la presentación dentro de la aplicación tienen una vista en un dispositivo de ejemplo, pero no permiten enviar una prueba desde este editor.

Público y experimento. Puedes elegir a todos los suscriptores del bot, un segmento ya preparado o el público bot_chats: chats y canales donde participa el bot, incluidos grupos, supergrupos y canales a los que se ha añadido. El registro se actualiza cuando se añade el bot o se le hace administrador. Para este público puedes marcar chats concretos; si no marcas ninguno, se envía a todos los chats donde el bot puede escribir. Solo funciona con Telegram, así que elegirlo desmarca otros canales. Los chats de los que se quitó el bot, en los que no puede publicar y los ID desconocidos se excluyen con bot_left, cannot_post o chat_unknown. En chats no se sustituyen datos personales del suscriptor como {{profile.*}} y {{event.*}}. También puedes vincular, de forma opcional, un experimento A/B que ya esté en marcha.

Programación. Configura la zona horaria de la difusión, cómo interpretar la hora, el momento de envío y la velocidad.

  • Enviar el es opcional: si está vacía, se enviará en cuanto confirmes.
  • Zona horaria del proyecto: todos reciben el mensaje en el mismo instante, calculado en la zona horaria de la difusión.
  • Según la hora local del destinatario: cada persona lo recibe a la misma hora de su propio reloj. Si no tiene zona horaria, no se reconoce o esa hora no existe ese día en su zona, se usa la hora de la difusión. En las campañas de email, por el contrario, ese destinatario se excluye.
  • El editor no acepta una hora inexistente por un cambio de horario de verano y muestra el problema debajo del campo.
  • Mensajes por minuto: de 1 a 10 000. El envío se reparte en lotes de ese tamaño. Si indicas 60, los primeros 60 mensajes se programan para la hora inicial, los siguientes 60 para un minuto después, etcétera.

Si el bot tiene activadas las difusiones de pago y seleccionas Telegram, aparece un interruptor para pagar con Estrellas de Telegram y otra casilla para confirmar el gasto. Sin esa confirmación, el borrador no se guarda. Si después se desactivan las difusiones de pago en el bot, el envío no falla: se realiza como difusión gratuita.

Comprobación antes del envío

Verificar destinatarios no envía nada. Calcula el público según el borrador actual, los canales y las reglas de consentimiento. Muestra cuántas personas recibirán el contenido por canal, cuántas se excluyen y por qué, además de los errores y avisos del contenido.

Motivos de exclusión:

  • no_identity: el suscriptor no tiene contacto en ese canal;
  • unverified: el contacto no está verificado;
  • blocked: el suscriptor bloqueó al bot;
  • channel_disabled: el canal no está conectado o está desactivado;
  • email_unsubscribed, email_bounced, email_complained, email_no_consent: el contacto no tiene un consentimiento de email válido;
  • wa_window_closed: no ha llegado un mensaje de esa persona por WhatsApp en las últimas 24 horas y no se puede enviar texto libre.

Errores que impiden iniciar la difusión:

  • content_not_published: la versión elegida no existe o no está publicada;
  • audience_not_ready: el segmento no existe o aún no se ha recalculado;
  • experiment_not_ready: el experimento vinculado no está en marcha o no distribuye por suscriptor;
  • empty_audience: nadie recibiría la difusión;
  • errores de validación del contenido para cada canal, con un campo como content:wa.

Los avisos del contenido aparecen junto a los errores, pero no bloquean el envío. El botón de inicio solo se activa si no hay errores y existe al menos un destinatario.

Inicio y control

Solo puedes iniciar un borrador, y solo desde el bloque de comprobación. El botón será Enviar ahora o Programar, según hayas indicado una hora. Debes confirmar expresamente la versión del borrador que aparece en pantalla.

Al iniciar, la plataforma fija a la vez la versión de contenido, los canales, el público, el experimento y la programación. Crea para cada destinatario apto un mensaje en cola con su hora de envío. Para cada excluido guarda el motivo, pero no crea un mensaje. Así, el informe distingue entre una exclusión y un intento de envío que falló.

Tras iniciarla, la difusión no se puede editar. El editor pasa a modo de solo lectura y ofrece crear otra difusión para hacer cambios.

Estados: Borrador, Programada, Enviando, En pausa, Completada, Cancelada, Fallida y Archivada. Acciones disponibles:

  • Pausar: desde Programada o Enviando. Los mensajes que aún no han empezado se detienen; los que ya están enviándose terminan.
  • Reanudar: desde En pausa, vuelve a Enviando.
  • Cancelar: desde Borrador, Programada, Enviando o En pausa. Lo que no se haya enviado se marca como cancelado.
  • Archivar: desde Completada, Cancelada o Fallida. Usa Mostrar difusiones archivadas para verlas.

Cada orden incluye la revisión esperada. Si dos operadores intentan cambiar la difusión a la vez, el segundo recibe un aviso de que se modificó en otro lugar, en lugar de sobrescribir la primera operación.

Informe y destinatarios

Pulsa una difusión de la lista para abrir sus resultados. Por canal se muestran los recuentos En cola, Enviado, Entregado, Error y Excluido. Mientras está programada, enviándose o en pausa, el informe se actualiza cada 15 segundos.

Para difusiones a chats y canales del bot, hay además una tabla By chat: muestra cada chat por nombre, su estado (en cola, enviado, error o cancelado) o el motivo de exclusión. Los contadores de Telegram representan chats, no suscriptores. Pausar, reanudar, cancelar y el límite de mensajes por minuto funcionan igual que en las difusiones a suscriptores.

Entregado permanece en cero en este informe: la plataforma sabe que envió el mensaje al canal, pero no recoge aquí confirmaciones de entrega. El detalle de email, incluidas aperturas, clics, devoluciones y quejas, está en campañas de email.

Blocked the bot after this broadcast cuenta los eventos en que alguien bloqueó al bot durante las 24 horas posteriores a la entrega de esa difusión. Si recibió varias en ese plazo, el bloqueo se atribuye a la última entregada. Son eventos de bloqueo, no suscriptores únicos. Para ver a esas personas, abre Personas → Blocked the bot → Export CSV; el archivo incluye blocked_at.

Destinatarios abre una lista paginada que solo muestra canal, estado (Pendiente, Excluido, En cola, Enviando, Enviado, Error, Cancelado) y motivo de exclusión. No hay una columna separada con la identidad del destinatario.

Ten presente este límite: si el contenido se convierte en varios mensajes para una persona, la difusión solo envía el primero. Se guarda una fila por cada pareja de destinatario y canal.

Difundir una reacción desde la lista de reacciones

El método anterior sigue disponible. En Reacciones, cada fila tiene un botón de envío con la indicación «Enviar reacción a suscriptores». Pulsarlo pone la difusión en cola inmediatamente: no hay borrador, comprobación previa ni informe por canal. El diálogo permite activar un envío de pago con Estrellas si el bot lo admite. El botón Difusión de Resumen lleva a la misma lista de reacciones.

Este envío llega a todos los suscriptores activos del bot. Solo puedes limitarlo por etiquetas mediante el parámetro labels de una solicitud API (consulta REST API y tokens); la interfaz no ofrece un selector de etiquetas.

Tiene estados propios y más breves: pendiente, en curso, terminado y cancelado, más una marca de pausa. Puedes pausar, reanudar o cancelar por API. También sobrevive a los reinicios: avanza por páginas y continúa desde el punto guardado.

Difusión programada

Una reacción con el disparador Por horario (fechas) se ejecuta en los momentos configurados y se difunde automáticamente a los suscriptores activos. Sirve para resúmenes periódicos y recordatorios sin lanzamiento manual. Un reintento tras un fallo puede duplicar el mensaje para algunas personas: en un anuncio programado se prefiere un duplicado ocasional a perder el envío sin aviso.

Qué sigue