Triggers
Trigger: Evento de conversación
El trigger Evento de conversación ejecuta el flujo cuando algo cambia en una conversación de la bandeja (se abre en una pestaña nueva). Sirve para avisar al equipo, registrar resultados o pedir una calificación sin que nadie lo haga a mano.
Para qué sirve
Sección titulada «Para qué sirve»Reaccionar a lo que pasa en la bandeja sin que nadie lo haga a mano: avisar al equipo cuando un cliente pide hablar con una persona, registrar cómo terminó una conversación o enviar una encuesta de seguimiento.
Cómo configurarlo paso a paso
Sección titulada «Cómo configurarlo paso a paso»- Entra a Flow studio y pulsa Crear flujo (o abre uno que ya tengas).
- En la barra de la izquierda del lienzo pulsa Agregar nodo, abre Triggers y elige Evento de conversación. Si el flujo ya tenía un disparador, el editor pregunta si lo reemplaza: solo puede haber uno por flujo.
- Haz clic en el nodo. En el panel de la derecha, bajo Eventos que disparan este flujo, marca uno o varios: Conversación creada, Conversación resuelta o Paso a una persona. Si no marcas ninguno, el nodo muestra una advertencia y el flujo no arranca. En Canales eliges de qué canales arrancan: WhatsApp, Widget web y, si tienes Facebook e Instagram (se abre en una pestaña nueva) conectados, Messenger e Instagram. Por defecto vienen WhatsApp y Widget web.
- Debajo, Datos que recibe el flujo lista lo que podrás usar. Agrega y conecta los nodos siguientes y escribe esos datos como
{{trigger.contactName}}(el selector de variables los ofrece bajo Trigger). - Pulsa Guardar y luego Publicar (arriba a la derecha). Solo un flujo publicado arranca solo: sin publicar, el disparador no hace nada.
- Prueba con un caso real y revisa el resultado en Ejecuciones, en la barra de la izquierda. Por ejemplo: escribe al número de WhatsApp conectado desde un celular para crear una conversación, o resuelve una desde la bandeja.
Eventos disponibles
Sección titulada «Eventos disponibles»Eliges uno o varios eventos en el panel del trigger. Sin ninguno elegido, el flujo no arranca nunca y el editor lo marca como incompleto.
| Evento | Se dispara cuando… |
|---|---|
| Conversación creada | Llega el primer mensaje de un contacto y se abre una conversación nueva |
| Conversación resuelta | Se marca como resuelta o cerrada, también por inactividad o porque el asistente la finaliza |
| Paso a una persona | Un asistente o un flujo la pasa a alguien del equipo, o la deja en la fila de espera |
Si el cliente escribe en una conversación cerrada hace menos de 7 días, se reabre la misma (se abre en una pestaña nueva) y no cuenta como conversación creada.
Salidas
Sección titulada «Salidas»Todos los eventos entregan estos datos en trigger (por ejemplo, {{trigger.campo}}):
| Campo | Descripción |
|---|---|
event | Evento que disparó el flujo (por ejemplo conversation.created) |
timestamp | Momento del evento |
conversationId | ID de la conversación |
channel | Canal: WHATSAPP, WEB_WIDGET, MESSENGER o INSTAGRAM |
contactId | ID del contacto |
contactName | Nombre del contacto |
phone | Teléfono del contacto, si lo tiene |
whatsappAddress | Dirección de WhatsApp (teléfono o nombre de usuario) |
agentId | Asistente que la atendía |
Según el evento, se suman estos:
| Evento | Campo extra | Descripción |
|---|---|---|
| Conversación resuelta | resolvedBy | Quién la resolvió: user, agent, flow o system |
| Paso a una persona | assignedTo | ID de la persona asignada. Vacío si quedó en espera |
| Paso a una persona | reason | Motivo del paso |
Referéncialos como {{trigger.contactName}}, {{trigger.reason}}, etc.
Ejemplos
Sección titulada «Ejemplos»- Aviso al equipo: trigger con Paso a una persona → Slack (se abre en una pestaña nueva) con
{{trigger.contactName}}y{{trigger.reason}}. - Seguimiento tras cerrar: trigger con Conversación resuelta → Condición (se abre en una pestaña nueva) sobre
{{trigger.resolvedBy}}→ WhatsApp (se abre en una pestaña nueva) de agradecimiento solo si la resolvió una persona.
Protección contra bucles
Sección titulada «Protección contra bucles»Un flujo disparado por un evento puede provocar otro evento: por ejemplo, crear una conversación o una cita desde el propio flujo. Para que eso no se encadene sin fin, este trigger comparte con el Evento CRM (se abre en una pestaña nueva) y el Evento de cita (se abre en una pestaña nueva) un mismo contador de profundidad. Cada flujo que nace de otro evento suma uno, y el tope es 3. Al llegar al tope, el evento no dispara ningún flujo más y la cadena se corta sola. El resto de tu operación sigue igual.
Qué no hace
Sección titulada «Qué no hace»Este trigger inicia flujos. Un flujo todavía no puede invocar a un asistente como un paso: la relación va al revés, el asistente es quien ejecuta flujos mediante sus herramientas (se abre en una pestaña nueva).
Problemas comunes
Sección titulada «Problemas comunes»- No dispara — confirma que el flujo esté activo y que el evento esté elegido en el trigger.
- Se detiene en una cadena larga — es el tope de profundidad. Revisa que el flujo no cree conversaciones o citas que a su vez lo vuelvan a disparar.
