CRM
Actualizar una oportunidad
Actualiza una oportunidad (envía solo los campos que cambian).
crm:writeResultado
generado desde el esquema
version es OBLIGATORIA: cópiala de la lectura anterior. Si alguien la movió entre tu lectura y tu escritura, la petición se rechaza en lugar de sobrescribir su cambio. Para cambiar de etapa o cerrar, usa sus propios endpoints.
Argumentos
Identificador de la oportunidad.
Límites: longitud mín. 1
Nombre corto.
Límites: longitud mín. 1, longitud máx. 200
Descripción en texto libre.
Importe como cadena decimal, con un máximo de dos decimales. P. ej.: "12500.00".
Límites: patrón ^\d+(\.\d{1,2})?$
Código ISO 4217 en mayúsculas. Ej.: "EUR".
Límites: patrón ^[A-Z]{3}$
Probabilidad propia, como porcentaje.
Límites: mín. 0, máx. 100
Fecha de cierre prevista, en ISO 8601 con desplazamiento.
Contacto (persona).
Contacto (empresa).
Responsable comercial.
Canal de origen del lead: inbound_email, website_form, referral, cold_outreach, event, social, existing_customer, partner u other.
Opciones disponibles: inbound_email, website_form, referral, cold_outreach, event, social, existing_customer, partner, other
Detalle en texto libre del canal.
Límites: longitud máx. 200
Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red.
Límites: longitud mín. 1, longitud máx. 255
Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones.
Límites: longitud mín. 1
Resultado
En un éxito el resultado lleva structuredContent con data y meta. Estos son los atributos de data.
Ver los atributos de data
Opciones disponibles: open, won, lost
Opciones disponibles: open, won, lost
Opciones disponibles: inbound_email, website_form, referral, cold_outreach, event, social, existing_customer, partner, other
Límites: mín. 1
Mostrar atributos hijosOcultar atributos hijos
Un error es un resultado con isError: true y el problema en content[0].; no hay structuredContent. Consulta Errores.
La misma operación por REST
Esta herramienta ejecuta PATCH /api/v1/crm/opportunities/{opportunityId}.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasCRM
Actualizar una oportunidad
Actualiza una oportunidad (envía solo los campos que cambian).
Guías
Escrituras seguras
Un asistente que puede escribir también puede escribir lo equivocado. Decide qué herramientas necesitan a una persona, reintenta sin duplicar y sabe qué pone en marcha una escritura.
Guías
Errores
Un error de herramienta es un resultado con
isError: truey el problema en el primer bloque de texto. Ramifica por sucode.
¿Te ha resultado útil esta página?