Triggers
Trigger — Evento CRM
El trigger Evento CRM ejecuta el flujo cuando ocurre un evento en el CRM interno de Waiify. Es la base de la automatización de tu embudo: reaccionar automáticamente a lo que pasa con contactos y oportunidades.
Para qué sirve
Sección titulada «Para qué sirve»Es la base de la automatización de tu embudo: reaccionar cuando entra un contacto, cuando una oportunidad avanza de etapa o cuando se gana o se pierde un negocio. También reacciona a lo que hace la calificación de leads del asistente, porque esos cambios pasan por los mismos servicios del CRM.
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 CRM. 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 aparece Evento 1 con su Tipo de evento (por ejemplo Contacto creado). Cámbialo por el que necesites.
- Si el evento es de oportunidad, elige el pipeline (en Oportunidad creada es obligatorio) y, si quieres, las etapas de origen o destino. Para reaccionar a varios eventos, pulsa Agregar otro evento: se combinan con O.
- El recuadro Variables disponibles muestra lo que recibirás. Conecta los nodos siguientes y úsalas, por ejemplo
{{trigger.contact.name}}. - Pulsa Guardar y luego Publicar (arriba a la derecha). Solo un flujo publicado arranca solo.
- Para probar sin esperar un evento real, pulsa Probar flujo abajo del lienzo: simula un evento con datos de ejemplo. La prueba real se revisa en Ejecuciones.
Eventos disponibles
Sección titulada «Eventos disponibles»| Evento | Se dispara cuando… |
|---|---|
contact.created | Se crea un contacto |
contact.updated | Se actualiza un contacto |
opportunity.created | Se crea una oportunidad |
opportunity.updated | Se actualiza una oportunidad |
opportunity.stage_changed | Una oportunidad cambia de etapa |
opportunity.won | Una oportunidad se marca como ganada |
opportunity.lost | Una oportunidad se marca como perdida |
Filtros
Sección titulada «Filtros»Puedes definir varios grupos de eventos (se combinan con OR) y, dentro de cada uno, condiciones para acotar cuándo dispara:
| Filtro | Aplica a | Ejemplo |
|---|---|---|
| Pipeline | Eventos de oportunidad | Solo el pipeline “Ventas” |
| Etapa de origen / destino | opportunity.stage_changed, opportunity.won, opportunity.lost | Solo cuando pasa de “Propuesta” a “Cierre”, o cuando se ganó/perdió desde una etapa concreta |
Salidas
Sección titulada «Salidas»Según el evento, el flujo recibe en trigger (por ejemplo, {{trigger.campo}}):
| Evento | Campos disponibles |
|---|---|
| Contacto | contactId, contact.name, contact.phone, contact.email |
| Oportunidad | opportunityId, pipelineId, stageName |
| Cambio de etapa | opportunityId, fromStage, toStage |
En contact.updated llegan además changedFields (qué campos cambiaron), previous (sus valores anteriores) y changeSource (qué cambió: fields, tags, notes o customProperties).
Distinguir lo que hace el asistente
Sección titulada «Distinguir lo que hace el asistente»Los eventos de contacto traen origin cuando el cambio no lo hizo una persona desde el CRM:
origin | Cuándo |
|---|---|
assistant | Un asistente guardó datos del lead o, en modo automático, cambió su temperatura (Frío, Tibio, Caliente) |
user | Una persona aplicó o revirtió una calificación propuesta desde Analítica |
| (sin valor) | Edición normal desde el CRM |
Con una condición sobre {{trigger.origin}} puedes hacer, por ejemplo, que un flujo avise al vendedor solo cuando el asistente marca a un contacto como Caliente. Los eventos de oportunidad todavía no traen origin, así que no se distinguen por esa vía.
Ejemplo
Sección titulada «Ejemplo»Automatizar el onboarding: trigger Oportunidad ganada (filtrada al pipeline “Ventas”) → enviar WhatsApp de bienvenida → crear una tarea de seguimiento.
Protección contra bucles
Sección titulada «Protección contra bucles»Un flujo que reacciona a contact.updated y termina actualizando el contacto se dispararía a sí mismo para siempre. Para evitarlo, cada flujo que nace de un evento suma 1 a una profundidad compartida con los triggers de Evento de conversación (se abre en una pestaña nueva) y Evento de cita (se abre en una pestaña nueva), y el tope es 3. Al llegar al tope, ese evento no dispara más flujos y la cadena se corta sola.
Problemas comunes
Sección titulada «Problemas comunes»- No dispara — verifica que el evento y los filtros coincidan con lo que realmente ocurre (pipeline y etapas correctos).
- Dispara de más — agrega condiciones para acotar; sin filtros, cualquier evento de ese tipo lo activa.
