Saltar al contenido
Documentación
Documentación
Flujos

Disparadores de un flujo

Qué hace que un flujo arranque: el primer mensaje, una palabra, una etiqueta, un hecho, un rato sin respuesta, a mano o por la API. Con la prioridad, el descanso y el freno contra los bucles.

Un flujo encendido arranca sólo cuando coincide uno de sus disparadores. Se configuran en la pestaña Disparadores con Agregar disparador, y cada uno tiene su propio interruptor: apagado, se guarda pero no arranca nada.

La pestaña Disparadores de un flujo
Los disparadores de un flujo: qué lo arranca, en qué orden se revisan y cuánto descansan.

Qué puede arrancar un flujo

  1. El primer mensaje

    Arranca cuando alguien escribe por primera vez. Ideal para dar la bienvenida.

  2. Una palabra

    Arranca si el mensaje contiene esa palabra completa: «menu» no dispara con «menudo». La puntuación separa palabras.

  3. Una etiqueta del hilo

    Arranca con el próximo mensaje de una conversación que ya tiene esa etiqueta.

  4. Cuando se pone una etiqueta

    Arranca en el momento en que alguien —o un flujo— le pone esa etiqueta a la conversación o al contacto. Sirve para «etiquetá a quien quieras encuestar».

  5. Cuando pasa algo

    Arranca con un hecho de la plataforma sobre una persona: una cita agendada, una cita que no se pudo agendar o un contacto nuevo. Con Filtros (opcional) arranca sólo si el hecho trae exactamente ese valor, por ejemplo el asistente que agendó.

  6. Cuando la persona deja de contestar

    Arranca cuando pasa un tiempo (Después de, entre 1 minuto y 30 días) sin respuesta de la persona. Con Sólo si atiende el asistente, no se mete si una persona del equipo tomó la conversación. Se revisa cada 5 minutos, así que puede llegar hasta 5 minutos después.

  7. Un contacto nuevo

    Arranca cuando se da de alta un contacto, desde el canal que elijas en De dónde viene.

  8. A mano, desde la bandeja

    No arranca solo: alguien del equipo lo lanza desde la conversación con Lanzar un flujo….

  9. Por la API

    Lo arranca otro sistema con POST /flows/:id/start, indicando el contacto o la conversación y las variables que el flujo necesita (llegan como disparo_<nombre>). Hace falta el permiso Flujos · operar.

Hay un camino más, que no se configura acá: un número de WhatsApp con Atiende de entrada: Un flujo arranca ese flujo en cada conversación nueva sin mirar sus disparadores (guía Flujos).

Encendido y sin disparadores no alcanza
Un flujo publicado y encendido que no tiene disparadores —o que los tiene todos apagados— no arranca nunca, y no hay ningún error que lo delate. La pestaña te avisa en los dos casos, y también cuando sólo arranca a mano o por la API.

Qué dispara primero: la prioridad

Si dos disparadores coinciden con lo mismo, gana el de Prioridad más baja: Antes que los demás · 10, Normal · 100 o Después de los demás · 500. La prioridad vale entre todos los flujos de tu organización, no sólo dentro de uno: así decidís que la palabra «baja» le gane a la bienvenida. Cada tarjeta dice en qué lugar se revisa.

Una conversación tiene un solo flujo a la vez, y una persona no puede estar dos veces en el mismo flujo: si ya está adentro, el disparador no arranca otra corrida.

El descanso

Descanso evita que un flujo arranque de más. Aparece sólo en los disparadores que lo usan, y depende del tipo:

  • En Cuando la persona deja de contestar es por conversación: el mismo recordatorio no le vuelve a llegar a la misma persona antes de ese tiempo.
  • En Cuando se pone una etiqueta, Cuando pasa algo y Un contacto nuevo es por disparador: después de arrancar el flujo, no vuelve a arrancarlo para nadie hasta que pase ese tiempo.
  • El primer mensaje, Una palabra, Una etiqueta del hilo, A mano, desde la bandeja y Por la API no tienen descanso: los frena que una persona no puede estar dos veces en el mismo flujo.

Por defecto es Sin descanso. Cada tarjeta muestra cuándo arrancó el flujo por última vez, con cualquier disparador.

El freno contra los bucles

Un flujo puede arrancar otro —con Ir a otro flujo, o porque pone una etiqueta o agenda algo que dispara otro flujo—. Para que eso no se vuelva una cadena infinita, se permiten hasta tres saltos encadenados a partir del flujo que arrancó una persona, un proveedor o tu sistema: el cuarto no arranca. Un flujo que arranca por algo que hizo una persona siempre empieza de cero.

Mientras el flujo corre

Debajo de los disparadores, Mientras el flujo corre define qué pasa si la persona escribe durante una espera, el canal de entrada y las palabras para salir. Están explicados en la guía Flujos.

¿Por qué no arrancó mi flujo con una palabra?

Revisá que el flujo esté publicado y encendido, que el disparador esté encendido, que la palabra aparezca completa en el mensaje y que otro disparador de prioridad más baja no le haya ganado. También puede ser que la persona ya esté en ese flujo.

¿Un disparador por etiqueta arranca al ponerla?

Depende: Una etiqueta del hilo espera al próximo mensaje de la persona; Cuando se pone una etiqueta arranca en el momento.