Para qué sirve#
Muestra cómo va cada difusión: cuántos mensajes salieron, cuántos se entregaron o se leyeron, cuántos faltan y cuántos fallaron, y a quién le pasó qué.
Quién puede usarlo y cómo llegar#
- Ver: cualquier usuario con sesión. Ruta: Difusiones y formularios → Difusiones (
/difusiones). - Acciones (pausar, cancelar, marcar llamadas…): solo quienes pueden crear difusiones.
La tabla de difusiones#
Arriba hay pestañas con un contador:
| Pestaña | Qué incluye |
|---|---|
| Todos | Todas las difusiones no eliminadas |
| En ejecución | En ejecución y Pausadas |
| Programados | Programadas, Pendientes de aprobación y «Aprobada · falta fecha» |
| Completados | Completadas |
| Cancelados | Canceladas y Rechazadas |
| Eliminados | Las que eliminaste (se pueden restaurar) |
Si hay un envío en curso aparece el indicador En vivo: las cifras se actualizan solas. La pantalla consulta cada 3 segundos mientras hay envíos en curso y cada 15 segundos si no; además recibe avisos en tiempo real cuando termina cada lote o cambia un estado. La fila que cambia se resalta un momento.
Columnas#
| Columna | Qué muestra |
|---|---|
| (flecha) | Despliega el detalle por canal (un renglón por paso). La flecha de la cabecera expande o contrae todas |
| Difusión | Nombre, fecha de creación y quién la creó |
| Canales (icono de avión) | Iconos de los canales; «alt» indica alternativa y «+» indica «además» |
| Estado (icono de señal) | Icono con el estado (pasa el cursor para ver el nombre) |
| Programación | Inicio (cuándo inició o cuándo está programada) y Término (con la duración). Según el estado muestra además una nota: el motivo del rechazo con quien rechazó, el motivo por el que espera aprobación, o el motivo de una pausa |
| Contactos | Contactos de la audiencia |
| Envíos | Mensajes, correos y llamadas enviados o realizados (suma de todos los canales), con una barra verde (enviados) y roja (errores) |
| Entregados | Con recibo de entrega (WhatsApp y redes) |
| Leídos | Mensajes leídos (WhatsApp) más correos abiertos |
| Pendiente | Lo que falta por enviar o por hacer |
| Errores | Envíos que fallaron o no se pudieron hacer |
Al pasar el cursor por Errores de un renglón de canal se ve la causa: «N sin dato», «N sin autorización o de baja», «N fallos de envío». Hay otras dos columnas (Sin alcanzar y Costo WhatsApp) que existen pero están ocultas por ahora.
En el renglón de cada canal, Entregados aparece como «—» para correo y llamada, y Leídos como «—» para canales sin recibo de lectura.
El detalle de una difusión#
El botón Ver destinatarios (ojo; o el icono de lista en un canal concreto) abre una ventana grande con:
- Resumen por paso: por cada canal, pestañas Contactos, Enviados, Pendientes y Errores (con su cifra) que filtran la tabla, y a la derecha las causas de los errores.
- Tabla de destinatarios (20 por página, con paginador «Mostrando 1–20 de N»):
| Columna | Qué muestra |
|---|---|
| Contacto | Nombre |
| Destino | Icono del canal y el teléfono, correo o identificador al que se envió |
| Estado | Pendiente, Enviando, Enviado, Con problema, Cancelado u Omitido |
| Detalle | El motivo cuando hay un problema |
| (acciones) | Realizada y Con problema, solo en llamadas (ver abajo) |
Los problemas aparecen primero en la lista. La columna Entrega (leído, entregado, correo abierto) existe pero está oculta por ahora; esos datos sí salen en el Excel.
Motivos de error más comunes#
| Mensaje | Causa |
|---|---|
| «El contacto no tiene un número de WhatsApp válido.» / «…un correo válido.» / «…teléfono.» | Falta el dato del canal |
| «El contacto no ha escrito por Messenger en las últimas 24 horas (ventana de respuesta de Meta).» (igual para Instagram) | Fuera de la ventana de 24 horas |
| «El contacto no tiene una conversación de Telegram con este bot.» | Nunca habló con el bot |
| «El contacto no ha autorizado mensajes por este canal (o se dio de baja).» | Sin consentimiento |
| «El contacto está bloqueado.» | Bloqueo vigente |
| «El envío se interrumpió; verifica antes de reintentar.» | Se cortó el envío |
| El mensaje que devuelve el canal (por ejemplo Meta) | Falló el envío |
Llamadas#
Para los renglones de llamada de una difusión en ejecución o pausada, cada fila tiene Realizada y Con problema (este último pregunta «¿Qué pasó? (opcional)»). El asesor también puede registrar el resultado en su lista del Call center; ambos caminos se reflejan aquí. Una llamada «Realizada» cuenta como enviada.
Crear una lista con los contactos de una pestaña#
En las pestañas Enviados, Pendientes y Errores de un paso aparece en el encabezado del detalle un botón que dice Crear lista con Enviados, Crear lista con Pendientes o Crear lista con Errores, según la pestaña. En la pestaña Contactos no aparece. Te pide el nombre (el botón «Crear lista» se activa cuando lo escribes) y crea una lista temporal con todos los contactos de esa pestaña, de todas las páginas y sin repetir. Sirve, por ejemplo, para volver a intentar a quienes fallaron, para insistir a los pendientes o para dirigirte solo a quienes ya recibieron: la eliges como audiencia en una difusión nueva.
- Pendientes incluye también a los que están en pleno envío.
- La lista aparece en Listas de distribución con una descripción que indica de qué difusión, paso y pestaña viene; cuando ya no la necesites, la eliminas desde allí.
- No se puede repetir el nombre de una lista que ya existe, y si la pestaña no tiene contactos no se crea nada.
- Los contactos fusionados en otro no se incluyen.
Exportar a Excel#
El botón Exportar a Excel descarga los destinatarios del filtro actual (de todas las páginas, no solo la visible) en un archivo destinatarios_<nombre>_<fecha>.xlsx con dos hojas:
- Destinatarios: Contacto, Canal, Paso, Destino, Estado, Detalle, Entrega (Leído o Entregado), Correo abierto (fecha), Veces abierto, Enviado (fecha).
- Resumen: nombre y estado de la difusión, filtro aplicado, registros exportados y fecha de exportación.
Aperturas de correo#
Cada correo lleva un píxel invisible. Cuando el programa de correo del destinatario lo carga, se registra la primera apertura y el número de veces; varias cargas en menos de 5 segundos cuentan como una sola. Solo cuenta en correos ya enviados.
Reglas y comportamientos#
- Los contadores por difusión cuentan contactos: en una difusión multicanal, un contacto cuenta como «enviado» si recibió por algún canal; como «con problemas» solo si no se pudo alcanzar por ninguno.
- Los números del renglón de cada canal cuentan los envíos de ese paso.
- Si la difusión sigue Programada, el detalle dice «Sin destinatarios todavía: se calculan cuando llega la hora de envío.»
<!-- Fuente: tenant-app/public/difusiones/index.php, tenant-app/public/api/difusiones.php, shared/src/Core/Difusiones.php, shared/src/Core/Difusion2.php, tenant-app/public/api/difusion_pixel.php, shared/src/Core/DifusionCorreo.php -->