CRM
Cerrar una oportunidad
Cierra la oportunidad como ganada o perdida.
crm:writeResultado
generado desde el esquema
Si omites toStageId pasa a la primera etapa del tipo correspondiente del embudo. Al perderla, el motivo va ESTRUCTURADO (lostReason): es lo que permite analizar el embudo después.
Argumentos
Identificador de la oportunidad.
Límites: longitud mín. 1
Resultado del cierre.
Opciones disponibles: won, lost
Fase de destino. Si se omite, la primera fase del tipo correspondiente.
Motivo, cuando el resultado es "won".
Límites: longitud máx. 500
Motivo estructurado, cuando el resultado es "lost".
Opciones disponibles: price, timing, no_budget, no_decision, lost_to_competitor, no_response, duplicate, other
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 POST /api/v1/crm/opportunities/{opportunityId}/close.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasCRM
Cerrar una oportunidad
Cierra la oportunidad como ganada o perdida.
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?