Nodo Oportunidad CRM

El nodo Oportunidad CRM opera sobre las oportunidades de tus pipelines. No requiere credencial: trabaja sobre el workspace activo.

Operaciones

Operación	Qué hace
Buscar oportunidad	Busca por ID — found: false si no existe, sin error
Crear oportunidad	Crea una oportunidad en un pipeline/etapa, asociada a un contacto
Actualizar campos por ID	Cambia uno o varios campos (etapa, pipeline, presupuesto, responsable, estado…)
Obtener campos por ID	Lee el valor de campos concretos, sin traer el objeto completo
Obtener oportunidades	Lista oportunidades del workspace con filtros y orden
Agregar etiquetas	Suma etiquetas (aditivo, no duplica)
Quitar etiquetas	Quita etiquetas (no las elimina del workspace)
Agregar nota	Suma una nota al historial (acumulativo)

No hay operaciones separadas de “Cambiar etapa”, “Cambiar pipeline”, “Asignar” o “Marcar ganada/perdida”: todas se hacen con Actualizar campos por ID, fijando stageId, pipelineId, assignedUserId o status (OPEN/WON/LOST). Cambiar stageId a una etapa de otro pipeline mueve también la oportunidad de embudo.

Salidas por operación

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

Ejemplo

Cuando un lead califica, crear la oportunidad:

• Operación: Crear oportunidad
• contactId: {{triggerData.contactId}}
• stageId: la etapa inicial de tu pipeline
• title: Lead desde {{triggerData.contact.source}}
• budget: {{nodes.openai.data.presupuesto}}

Para cerrarla al ganar el trato: Actualizar campos por ID con status: WON.

Problemas comunes

• Falta la etapa — stageId es obligatorio al crear; toma el ID desde tu pipeline.
• No encuentra la oportunidad — en Obtener oportunidades, afina por pipelineId y status para acotar.