Disparador: Contacto creado

Qué es

Se dispara cada vez que se crea un contacto nuevo en Omnifox, sin importar si fue manual, por API, importación masiva, un mensaje entrante o el widget de webchat.

Cuándo usarlo

• Secuencias de bienvenida automáticas para leads nuevos.
• Etiquetar contactos y luego revisar el origen real desde la ficha del contacto.
• Sincronizar el contacto con un CRM externo vía webhook saliente.

Requisitos

• Al menos un canal o formulario que genere contactos.
• Módulo Workflows habilitado.

Variables disponibles

• $contact.id, first_name, last_name, display_name, email, phone, company, job_title, city, country, tags
• $contact.source — ⚠️ hoy solo puede valer user, system, api o customer_reply; no toma los valores manual, import, whatsapp_incoming, webchat_signup ni contact_merge aunque el filtro los ofrezca como opción. En la práctica, un contacto creado por un mensaje entrante de WhatsApp normalmente llega como system (no whatsapp_incoming). El origen real y detallado del contacto (WhatsApp, importación, API, etc.) queda guardado en la ficha del contacto, pero no viaja en esta variable.
• $contact.source_channel_id — canal que lo creó
• $contact.created_at

Configuración (filtros)

• Origen: el selector muestra manual, API, importación masiva, mensaje entrante de WhatsApp, widget de webchat, fusión de contactos — pero como $contact.source solo puede valer user/system/api/customer_reply, elegir cualquiera de esas otras opciones hace que el filtro nunca coincida y el workflow no se dispare.
• Tipo de canal de origen.

Cómo configurarlo

1. Andá a Workflows → creá un workflow nuevo.
2. Abrí la categoría "Contactos" en el panel de disparadores.
3. Arrastrá "Contacto creado" al canvas.
4. Si vas a usar el filtro de Origen, elegí solo entre user, system, api o customer_reply (los otros valores del selector no coinciden con nada hoy).
5. Conectá acciones: agregar etiqueta, enviar mensaje de bienvenida, crear tarea.
6. Guardá y activá el workflow.

Ejemplo

Alguien escribe por primera vez a tu WhatsApp. Se crea el contacto automáticamente (en la práctica $contact.source llega como system, no como whatsapp_incoming), el workflow le agrega la etiqueta "Lead nuevo" y responde con una plantilla de bienvenida usando $contact.first_name, sin filtrar por Origen.

Consejos

No uses el filtro de Origen para distinguir "WhatsApp" de "importación masiva" — hoy no funciona así. Si necesitás separar esos casos, filtrá por otra señal disponible (por ejemplo, el canal de origen) o esperá a que se corrija esta variable.

Solución de problemas

• Si el workflow nunca se dispara con un filtro de Origen distinto de user/system/api/customer_reply: es un problema conocido, esos valores nunca se producen hoy.
• Si el workflow no corre al importar contactos en lote, probá sin filtro de Origen — el valor "import" no llega a generarse.