CRM

Listar oportunidades

Devuelve las oportunidades de venta con su embudo, su etapa y su importe ponderado por la probabilidad de la etapa.

Herramienta
filmo_crm_opportunities_list
Acceso: Lectura
  • crm:read
  • 120/min
  • Puede requerir un add-on
  • Anotación del servidor: Solo lectura
  • Anotación del servidor: Idempotente

Resultado

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_crm_opportunities_list",
    "arguments": {
      "limit": 20
    }
  }
}

generado desde el esquema

Por defecto solo las abiertas: pasa status=won, lost o all para el resto. Pagina con un cursor propio del servicio de CRM.

Argumentos

limitintegerpredeterminado:50

Tamaño de página (1-500). Por defecto es 50.

Límites: mín. 1, máx. 500

cursorstring

Cursor opaco de la página que se devuelve. Pasa el valor de pagination.nextCursor de la respuesta anterior; trátalo como opaco.

Límites: longitud máx. 200

sortstring

Orden: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: createdAt, updatedAt, name, identifier, status, amount, expectedCloseDate. Por defecto, "-createdAt". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió.

Límites: longitud máx. 200

pipelineIdstring

Devuelve solo las oportunidades de este embudo.

stageIdstring

Devuelve solo las oportunidades de esta etapa.

statusstring

Estado comercial: open (el valor por defecto), won, lost o all.

Opciones disponibles: open, won, lost, all

contactIdstring

Devuelve solo las oportunidades de este contacto.

qstring

Búsqueda de texto libre en el nombre y el identificador.

expectedCloseFromstring

Fecha de cierre prevista desde esta fecha (ISO 8601).

expectedCloseTostring

Fecha de cierre prevista hasta esta fecha (ISO 8601).

includeTotalbooleanpredeterminado:false

Ponlo en true para incluir pagination.total, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto.

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>

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 GET /api/v1/crm/opportunities.

  • CRM

    Listar oportunidades

    Devuelve las oportunidades de venta con su embudo, su etapa y su importe ponderado por la probabilidad de la etapa.

  • 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.