CRM

Crear una oportunidad

Pone un lead en el embudo.

Herramienta

filmo_crm_opportunities_create

Escrituracrm:write

crm:write
120/min
Puede requerir un add-on

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_crm_opportunities_create",
    "arguments": {
      "name": "Example"
    }
  }
}

{
  "structuredContent": {
    "data": {
      "opportunityId": "oppo_8f2a1c",
      "identifier": "<identifier>",
      "name": "Example",
      "status": "open",
      "amount": "1234.50",
      "currency": "EUR",
      "pipelineId": "pipe_8f2a1c",
      "pipelineName": "Example",
      "stageId": "stag_8f2a1c",
      "stageName": "Example",
      "stageType": "open",
      "effectiveProbability": 1,
      "weightedAmount": "1234.50",
      "daysInStage": 1,
      "expectedCloseDate": "2026-09-01T08:00:00Z",
      "contactName": "Example",
      "companyName": "Example",
      "ownerName": "Example",
      "source": "inbound_email",
      "createdAt": "2026-09-01T08:00:00Z",
      "updatedAt": "2026-09-01T08:00:00Z",
      "description": "<description>",
      "version": 1,
      "collaboratorStaffIds": [
        "coll_8f2a1c"
      ],
      "quoteIds": [
        "quot_8f2a1c"
      ],
      "stageHistory": [
        {
          "fromStageId": "from_8f2a1c",
          "toStageId": "tost_8f2a1c",
          "toStatus": "<toStatus>",
          "daysInPrevStage": 1,
          "movedAt": "2026-09-01T08:00:00Z",
          "note": "<note>"
        }
      ]
    },
    "meta": {
      "idempotencyKey": "<the key you sent, or the one the server generated>",
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}

generado desde el esquema

Si omites pipelineId, usa el embudo por defecto de la cuenta, y si omites stageId, la primera etapa de ese embudo. El importe va como cadena decimal para no perder céntimos por el redondeo de coma flotante. Devuelve la oportunidad creada con su probabilidad efectiva y su importe ponderado.

Argumentos

namestringObligatorio

Nombre corto de la oportunidad.

Límites: longitud mín. 1, longitud máx. 200

descriptionstring

Descripción en texto libre.

pipelineIdstring

Embudo. Si se omite, el embudo por defecto de la cuenta.

stageIdstring

Etapa inicial. Si se omite, la primera etapa del embudo.

amountstring

Importe como cadena decimal, con un máximo de dos decimales. P. ej.: "12500.00".

Límites: patrón ^\d+(\.\d{1,2})?$

currencystring

Código ISO 4217 en mayúsculas. Ej.: "EUR".

Límites: patrón ^[A-Z]{3}$

probabilityOverrideinteger

Probabilidad propia, como porcentaje. Si se omite, hereda la probabilidad de la etapa.

Límites: mín. 0, máx. 100

expectedCloseDatestring<date-time>

Fecha de cierre prevista, en ISO 8601 con desplazamiento.

contactIdstring

Contacto (persona) de la oportunidad.

companyIdstring

Contacto (empresa) de la oportunidad.

ownerStaffIdstring

Responsable comercial.

projectIdstring

Proyecto asociado.

sourcestring

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

sourceDetailstring

Detalle en texto libre del canal de origen.

Límites: longitud máx. 200

utmCampaignstring

Campaña de atribución.

Límites: longitud máx. 200

utmSourcestring

Fuente de atribución.

Límites: longitud máx. 200

utmMediumstring

Medio de atribución.

Límites: longitud máx. 200

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.

CRM
Crear una oportunidad
Pone un lead en el embudo.
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?

Resultado

Argumentos

Resultado

La misma operación por REST

Páginas relacionadas

Crear una oportunidad

Escrituras seguras

Errores