Visión general
El Envío masivo (pestaña Envíos masivos del Flow Builder) ejecuta un flujo publicado contra una audiencia entera, un sujeto a la vez, respetando la ventana de 24h/HSM de WhatsApp y un control de cadencia que evita el bloqueo del número.
Mientras una ejecución manual dispara el flujo para una conversación, un envío masivo:
- resuelve quién lo recibe (5 familias de público);
- resuelve automáticamente la conversación de cada contacto (reutiliza la existente o crea una nueva) para que todos los nodos funcionen — mensajes y acciones;
- gotea los envíos con un límite anti-bloqueo, horario de silencio y días hábiles;
- muestra un embudo por estado (iniciado / pendiente / omitido / fallido) y permite pausar, reanudar, cancelar y reintentar los fallidos.
Requisitos previos
- El módulo Flow Builder habilitado en la cuenta.
- Un flujo publicado (los borradores no se pueden disparar).
- Una bandeja de entrada de envío (normalmente WhatsApp).
- Rol de administrador para crear y lanzar envíos masivos (los agentes pueden ver y seguir).
Paso a paso
- Publica el flujo que quieres disparar.
- Abre el flujo en la lista y haz clic en Ejecutar en masa (icono de avión) — o ve a la pestaña Envíos masivos, haz clic en Nuevo envío masivo y elige el flujo publicado.
- Paso 1 — Público: elige la bandeja de envío y la familia de público:
- Contactos: todos, por etiqueta (aplicada al contacto) o por segmento guardado.
- Conversaciones: todas, por filtro guardado (una Carpeta) o por etiqueta de la conversación — tanto el modo todas como el por etiqueta permiten elegir el estado (todas, abiertas, pendientes, pospuestas, resueltas). También es la única familia que acepta un objetivo por conversación (ver más abajo).
- Negocios del CRM: un embudo y, opcionalmente, una etapa.
- Empresas: un segmento guardado de empresas o empresas específicas.
- Lista importada: pega números (uno por línea o coma/CSV) y haz clic en Importar números.
- Paso 2 — Conversación: elige cómo se resuelve la conversación (ver Configuración y opciones).
- Paso 3 — Cadencia: ajusta el límite anti-bloqueo, el goteo, el horario de silencio, los días hábiles y, si quieres, programa el inicio.
- Paso 4 — Revisión: revisa el conteo estimado y confirma. El envío empieza a gotear y sigues el embudo en la pestaña Envíos masivos; haz clic en un envío para inspeccionar los destinatarios.
Configuración y opciones
Público (paso 1):
- Etiqueta del contacto vs etiqueta de la conversación: son dos lugares distintos. Una etiqueta aplicada a una conversación no queda en el contacto; por eso la familia Conversaciones tiene el modo por etiqueta. Si el público dio cero usando una etiqueta en Contactos, casi siempre es por esto.
- Estado de la conversación: se aplica tanto al modo todas como al modo por etiqueta de la familia Conversaciones — en ambos se puede acotar por estado sin crear antes un filtro guardado. Todas es el valor por defecto.
- CRM: solo negocios abiertos: los ganados, perdidos y archivados nunca entran en el público.
- Empresas: todos, no solo el principal: incluye al contacto principal y a los demás vinculados por su participación en la empresa.
- Dónde se crea cada lista guardada: segmentos de contactos en Contactos → Filtrar → Guardar segmento; Carpetas de conversaciones en Conversaciones → Filtrar → guardar; segmentos de empresas en Empresas → filtro → guardar.
- Unión: las entradas distintas se suman y un contacto alcanzado por más de un criterio entra una sola vez.
Política de conversación (paso 2):
- Automática: reutiliza la conversación más reciente del contacto en la bandeja elegida o crea una nueva. Los nodos de mensaje y de acción funcionan. Recomendada para la mayoría de los casos.
- Solo reutilizar: solo dispara a contactos que ya tienen una conversación abierta; el resto se omite (aparecen como omitido en el embudo).
- Solo acciones: no se crea ninguna conversación. Los nodos de mensaje se omiten y solo se ejecutan los nodos de acción (ej.: agregar contacto, etiquetar, llamar a una API).
Cadencia (paso 3):
- Límite anti-bloqueo: un techo de envíos por segundo y por hora por bandeja. Déjalo en blanco para los valores seguros del proveedor (WhatsApp Cloud/Web). Al alcanzar el límite, el envío se pospone y reintenta — nunca pierde un destinatario.
- Goteo: N destinatarios por intervalo (en segundos), para espaciar aún más que el límite anti-bloqueo.
- Horario de silencio y días hábiles: fuera de la ventana permitida no se dispara nada; el siguiente tick se reanuda cuando la ventana vuelve a abrir.
- Programar inicio: comienza el envío en una fecha/hora futura — queda programado y la plataforma lo materializa y empieza a gotear sola a la hora marcada.
Acciones masivas en la lista (pestaña Envíos masivos): selecciona varios envíos a la vez y pausa, reanuda, cancela, reintenta los fallidos o elimínalos en lote — para operar muchos envíos sin abrirlos uno por uno.
Modo de objetivo y reutilización de conversación
Dos opciones del asistente deciden sobre qué se ejecuta el flujo. Son independientes de la política de conversación del paso 2: la política decide si se reutiliza o se crea una conversación; estas dos deciden cuál.
Modo de objetivo (paso 1, justo debajo del público):
- Un objetivo por contacto (predeterminado): cada persona recibe el flujo una vez, en la conversación que el envío masivo resuelva para ella. Es el comportamiento de siempre.
- Un objetivo por conversación: el flujo se ejecuta en cada conversación que coincidió con el filtro. Quien tiene tres conversaciones coincidentes es atendido en las tres, y cada ejecución actúa sobre la conversación que coincidió, no sobre "la conversación más reciente de esa persona". Es lo que quieres cuando el asunto vive en la conversación (una etiqueta de atención, una carpeta de pendientes) y no en la persona.
Un objetivo por conversación solo está disponible cuando todo el público viene de la familia Conversaciones. Contactos, negocios del CRM, empresas y listas importadas no traen una conversación coincidente donde ejecutar — allí la opción aparece deshabilitada, con el motivo al lado.
Reutilización de conversación (paso 2, debajo de la política):
- Preferir una conversación abierta (predeterminado): reutiliza la conversación abierta o pospuesta más reciente del contacto en esa bandeja. Si no hay ninguna, recurre a la más reciente de cualquier estado. Evita reabrir un asunto ya resuelto y enterrar el envío al final de un historial antiguo.
- Siempre la más reciente: reutiliza la última conversación del contacto en esa bandeja, aunque ya esté resuelta. Es el comportamiento anterior, mantenido para quien depende de él.
La reutilización solo decide qué conversación existente se reutiliza. Cuando el envío usa un objetivo por conversación, cada objetivo ya lleva la conversación que coincidió, así que la preferencia no se le aplica.
Todas las conversaciones con estado: el público Conversaciones → Todas ahora también se puede acotar por estado (todas, abiertas, pendientes, pospuestas, resueltas), sin crear antes un filtro guardado.
Ambas opciones aparecen en la revisión antes de confirmar y siguen visibles tras el lanzamiento: abre el envío en la pestaña Envíos masivos y quedan arriba, junto al embudo.
Lanzar desde una regla de automatización (run_flow_batch)
Además de lanzar manualmente, puedes disparar un borrador de envío ya preparado desde una regla de automatización — el análogo masivo de la acción "Iniciar flujo". Toda la configuración pesada (flujo, bandeja, público, cadencia) vive en el borrador; la acción solo dispara el lanzamiento.
Cómo usarlo:
- Crea el envío como siempre (flujo publicado, público, cadencia) pero déjalo como borrador — no lo lances.
- En Automatización, crea una regla y añade la acción Lanzar envío masivo, eligiendo el borrador.
- Cuando el disparador de la regla se active, el borrador se lanza y empieza a gotear como cualquier envío.
Protección anti-bucle: solo se lanza un envío en borrador, y el lanzamiento es de un solo sentido (borrador → programado). Así, aunque la regla dispare la acción varias veces (p. ej. un disparador por conversación), el envío se lanza exactamente una vez — las llamadas siguientes encuentran un envío ya lanzado y se ignoran de forma segura.
Casos de uso
- Corregir/actualizar contactos en masa con un flujo de acción (ej.: agregar un contacto en WhatsApp).
- Reenganchar un segmento guardado o una etiqueta con un mensaje de retorno.
- Calentar un embudo del CRM: disparar un flujo a todos los negocios abiertos de una etapa.
- Campaña desde una lista pegada (planilla/CSV) sin registrar cada contacto antes.
- Retomar a quien fue etiquetado en la atención: envía a la etiqueta aplicada a las conversaciones, opcionalmente solo a las resueltas.
- Hablar con un grupo de empresas: alcanza a todas las personas vinculadas a esas cuentas.
Consejos, límites y buenas prácticas
- Mantén el límite anti-bloqueo activado — WhatsApp bloquea números que envían demasiado rápido.
- Empieza con un envío pequeño en una bandeja de prueba antes de correr contra toda la base.
- Un contacto sin teléfono (en bandeja WhatsApp) se omite, no falla el lote.
- El envío es reanudable e idempotente: pausar/reanudar no duplica; un mismo contacto aparece una vez por envío.
- La audiencia tiene un tope de seguridad; audiencias muy grandes se truncan (registrado en el envío).
Solución de problemas
- "Flujo no publicado": publica el flujo antes de disparar.
- Muchos "omitidos": revisa la política de conversación (solo reutilizar omite a quien no tiene conversación) y si los contactos tienen teléfono.
- Conteo estimado 0 con etiqueta: probablemente elegiste Contactos → por etiqueta para una etiqueta que vive en las conversaciones. Cambia a Conversaciones → por etiqueta.
- El segmento no aparece: cada familia lee su propia lista guardada; las Carpetas de conversaciones nunca aparecen entre los segmentos de contactos, y viceversa.
- Muchos "fallidos": abre el envío, lee el motivo por destinatario y usa Reintentar fallidos tras corregir.
- Envío detenido: comprueba si está en horario de silencio o fuera de los días hábiles — se reanuda solo en la próxima ventana.