# Listar webhooks

> plazbot webhooks list: webhooks de Developer (eventos salientes) o webhooks entrantes del workspace.

Fuente: https://developers.plazbot.com/cli/webhooks/list/

### 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
plazbot 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
# Webhooks salientes
plazbot webhooks list

# Webhooks entrantes, en JSON
plazbot webhooks list --incoming --json
```

### Resultado

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

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

### Salida JSON

```json
{
"data": [
  {
    "id": "whe_AbcDef123",
    "name": "Mi CRM",
    "description": "",
    "url": "https://api.miempresa.com/hook",
    "secret": "whsec_****",
    "events": ["message.received", "contact.created"],
    "isActive": true,
    "createdAt": "2026-10-01T15:20:00Z",
    "updatedAt": null
  }
],
"nextCursor": null
}
```

Para ver si las entregas llegan bien usa [`plazbot webhooks deliveries`](https://developers.plazbot.com/cli/webhooks/deliveries).

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `You are not signed in.` | No hay sesión. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |