Listar webhooks

Muestra los webhooks de Developer del workspace: las URLs a las que Plazbot envía eventos (mensajes, contactos, etc.), con los eventos suscritos y su estado. Los secretos de firma no se muestran (vienen enmascarados de la API).

Con --incoming muestra en cambio los webhooks entrantes: las URLs de Plazbot que reciben datos de otros sistemas y disparan reglas.

bash

01plazbot webhooks list [options]

Parámetros

Parámetro	Flag	Requerido	Descripción
Entrantes	`--incoming`	No	Lista los webhooks entrantes en lugar de los salientes.
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 { "data": [...], "nextCursor": null }. Este listado no se pagina.

Ejemplos

bash

01# Webhooks salientes
02plazbot webhooks list
03 
04# Webhooks entrantes, en JSON
05plazbot webhooks list --incoming --json

Resultado

text

01  Webhooks (1)
02  ────────────────────────────────────────
03┌───────────────┬──────────┬────────────────────────────────┬────────────────────────────────┬────────┐
04│ ID            │ Name     │ URL                            │ Events                         │ Active │
05├───────────────┼──────────┼────────────────────────────────┼────────────────────────────────┼────────┤
06│ whe_AbcDef123 │ Mi CRM   │ https://api.miempresa.com/hook │ message.received, contact.cre… │ yes    │
07└───────────────┴──────────┴────────────────────────────────┴────────────────────────────────┴────────┘

Con --incoming las columnas son ID, Name, Active y Created.

Salida JSON

json

01{
02  "data": [
03    {
04      "id": "whe_AbcDef123",
05      "name": "Mi CRM",
06      "description": "",
07      "url": "https://api.miempresa.com/hook",
08      "secret": "whsec_****",
09      "events": ["message.received", "contact.created"],
10      "isActive": true,
11      "createdAt": "2026-10-01T15:20:00Z",
12      "updatedAt": null
13    }
14  ],
15  "nextCursor": null
16}

Para ver si las entregas llegan bien usa plazbot webhooks deliveries.

Errores comunes

Mensaje	Causa	Solución
`You are not signed in.`	No hay sesión.	Ejecuta `plazbot login`.