Listar oportunidades

Muestra las oportunidades (deals) del workspace, de la más reciente a la más antigua. Puedes filtrar por pipeline, por fase del pipeline, por contacto o aplicar los filtros de una vista guardada. También funciona como plazbot deals list.

bash

01plazbot opportunities list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Pipeline	`--pipeline <pipelineId>`	No	Solo las oportunidades de este pipeline. Los IDs salen de `plazbot workspace show pipelines`.
Fase	`--stage <stageId>`	No	Solo las oportunidades en esta fase del pipeline.
Contacto	`-c, --contact <contactId>`	No	Solo las oportunidades de un contacto.
Vista	`--view <viewId>`	No	Aplica los filtros de una vista guardada (`plazbot views list`).
Límite	`--limit <n>`	No	Se detiene al juntar al menos N elementos (páginas completas de la API). Por defecto `50`.
Cursor	`--cursor <token>`	No	Continúa desde el `nextCursor` de una llamada anterior.
Todo	`--all`	No	Trae todas las páginas, hasta 5000 elementos (ignora `--limit`).
Workspace	`-w, --workspace <id>`	No	Workspace donde se ejecuta. Por defecto, el activo.
Zona	`-z, --zone <zone>`	No	`LA` o `EU`. Por defecto, la zona de la sesión.
JSON	`--json`	No	Imprime el resultado como JSON.

Con --json la salida es siempre { "data": [...], "nextCursor": "..." | null }. Si nextCursor no es null, pásalo a --cursor para traer la página siguiente. Más detalles en Scripting y agentes de IA.

Ejemplos

bash

01# Últimas oportunidades
02plazbot opportunities list
03 
04# Todas las oportunidades de un pipeline, en JSON
05plazbot opportunities list --pipeline pip_AbcDef123 --all --json
06 
07# Oportunidades de un contacto
08plazbot opportunities list -c con_AbcDef123

Resultado

text

01  Opportunities (2)
02  ────────────────────────────────────────
03┌────────────────────────────┬──────────────────┬────────┬────────────────────────────┬────────────────────────────┬──────────┬──────────────────┐
04│ ID                         │ Name             │ Amount │ Contact                    │ Stage                      │ Win/loss │ Created          │
05├────────────────────────────┼──────────────────┼────────┼────────────────────────────┼────────────────────────────┼──────────┼──────────────────┤
06│ opp_AbcDef123              │ Plan anual ACME  │ 1500   │ con_AbcDef123              │ pst_AbcDef123              │ 0        │ 2026-08-30 12:45 │
07└────────────────────────────┴──────────────────┴────────┴────────────────────────────┴────────────────────────────┴──────────┴──────────────────┘

Columna	Descripción
ID	ID de la oportunidad (`opp_...`).
Name	Nombre de la oportunidad.
Amount	Monto estimado.
Contact	Contacto asociado (vacío si no tiene).
Stage	Fase del pipeline.
Win/loss	Estado de cierre (`winLossStatus`): `0` abierta.
Created	Fecha de creación (UTC).

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "opp_AbcDef123",
05      "name": "Plan anual ACME",
06      "opportCode": "OP000005",
07      "description": "",
08      "amount": 1500,
09      "contactId": "con_AbcDef123",
10      "assignedComercialId": "usr_AbcDef123",
11      "pipelineId": "pip_AbcDef123",
12      "stageId": "pst_AbcDef123",
13      "expirationDate": "2026-09-14T00:00:00",
14      "opportStatus": 1,
15      "winLossStatus": 0,
16      "finalAmount": 0,
17      "activities": [],
18      "files": [],
19      "creationDate": "2026-08-30T12:45:19.615Z"
20    }
21  ],
22  "nextCursor": null
23}

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.
`Invalid --limit "x".`	`--limit` no es un entero positivo.	Usa un número, o `--all`.