CRM

Vincular un documento a una oportunidad

Vincula a la oportunidad el presupuesto, el pedido o el proyecto que salió de ella.

Herramienta
filmo_crm_opportunities_link
Acceso: Escritura

Resultado

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_crm_opportunities_link",
    "arguments": {
      "opportunityId": "oppo_8f2a1c",
      "kind": "quote"
    }
  }
}

generado desde el esquema

Con kind: "quote" e isPrimary: true, ese presupuesto pasa a ser el principal y los demás se degradan. meta.created distingue un vínculo nuevo de uno que ya existía, que es lo que necesita saber un reintento. Devuelve la oportunidad completa, la misma proyección que su GET. El vínculo en sí —kind, linkedEntityId, created— va en meta.

Argumentos

opportunityIdstringObligatorio

Identificador de la oportunidad.

Límites: longitud mín. 1

kindstringObligatorio

Lo que está vinculado a la oportunidad.

Opciones disponibles: quote, order, project

quoteIdstring

Presupuesto. Obligatorio con kind="quote".

orderIdstring

Pedido. Obligatorio con kind="order".

projectIdstring

Proyecto. Obligatorio con kind="project".

isPrimaryboolean

Solo con kind="quote": marca este presupuesto como el principal.

idempotencyKeystring

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

ifMatchstring

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
opportunityIdstring

identifierstring

namestring

statusstring

Opciones disponibles: open, won, lost

amountstring

currencystring

pipelineIdstring

pipelineNamestring

stageIdstring

stageNamestring

stageTypestring

Opciones disponibles: open, won, lost

effectiveProbabilitynumber

weightedAmountstring

daysInStageinteger

expectedCloseDatestring<date-time>

contactNamestring

companyNamestring

ownerNamestring

sourcestring

Opciones disponibles: inbound_email, website_form, referral, cold_outreach, event, social, existing_customer, partner, other

createdAtstring<date-time>

updatedAtstring<date-time>

descriptionstring

versioninteger

Límites: mín. 1

collaboratorStaffIdsstring[]

quoteIdsstring[]

stageHistoryobject[]

Mostrar atributos hijos
stageHistory.fromStageIdstring

stageHistory.toStageIdstring

stageHistory.toStatusstring

stageHistory.daysInPrevStageinteger

stageHistory.movedAtstring<date-time>

stageHistory.notestring

Un error es un resultado con isError: true y el problema en content[0].text; no hay structuredContent. Consulta Errores.

La misma operación por REST

Esta herramienta ejecuta POST /api/v1/crm/opportunities/{opportunityId}/links.

  • CRM

    Vincular un documento a una oportunidad

    Vincula a la oportunidad el presupuesto, el pedido o el proyecto que salió de ella.

  • 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: true y el problema en el primer bloque de texto. Ramifica por su code.

¿Te ha resultado útil esta página?