Nodo Contacto CRM

El nodo Contacto CRM opera sobre los contactos del CRM interno. No requiere credencial: trabaja sobre el workspace activo.

Operaciones

Operación	Qué hace
Buscar contacto	Busca por ID, teléfono o email — found: false si no existe, sin error
Crear contacto	Crea un contacto; si el teléfono ya existe, retorna el existente sin error
Actualizar campos por ID	Cambia uno o varios campos a la vez (nombre, email, estado, responsable…)
Obtener campos por ID	Lee el valor de campos concretos, sin traer el objeto completo
Obtener contactos	Lista contactos del workspace con filtros y orden
Agregar etiquetas	Suma etiquetas al contacto (aditivo, no duplica)
Quitar etiquetas	Quita etiquetas del contacto (no las elimina del workspace)
Agregar nota	Suma una nota al historial (acumulativo, nunca sobrescribe)

No hay operaciones separadas de “Asignar” o “Cambiar estado”: ambas se hacen con Actualizar campos por ID, fijando assignedUserId o status.

Salidas por operación

• Buscar / Obtener campos: found, contactId, contact u fields/values.
• Crear: contactId, created, alreadyExisted, contact, tagsAdded, noteAdded.
• Actualizar campos: contactId, updated, fields, values, contact.
• Obtener contactos: contacts, returned, total, totalWorkspace, hasMore, appliedFilters, sort.
• Agregar/quitar etiquetas: added/removed, tagsAdded/tagsRemoved, tags (estado final).
• Agregar nota: noteId, content, createdAt, added.

Referéncialas con {{nodes.contacto.*}} (usa el nombre real del nodo en tu flujo).

Ejemplo

Al recibir un webhook de formulario, crear el contacto:

• Operación: Crear contacto
• phone: {{telefono}}, name: {{nombre}}, email: {{email}}

Luego usas {{nodes.contacto.contactId}} para crear una oportunidad.

Problemas comunes

• Crea duplicados — usa Buscar contacto por teléfono/email antes, o confía en alreadyExisted de la salida de Crear.
• “Usuario no válido” al asignar — assignedUserId debe ser un miembro del workspace.