# Widget web

> Activa o desactiva el widget de chat web de un agente.

Fuente: https://developers.plazbot.com/cli/agent/enable-widget/

### Activar o desactivar el widget

Activa el widget de chat web de un agente e imprime el `<script>` para instalarlo en tu sitio. Con `--disable` lo desactiva.

```bash
plazbot agent enable-widget <agentId> [options]
```

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| `agentId` | (posicional) | Sí | ID del agente. |
| Desactivar | `-d, --disable` | No | Desactiva el widget en lugar de activarlo. |
| JSON | `--json` | No | Imprime el resultado como JSON (`{"id","widgetEnabled","script"}`). Por defecto: `false`. |

### Ejemplos

```bash
# Activar el widget e imprimir el snippet <script>
plazbot agent enable-widget age_AbcDef123

# Desactivar el widget
plazbot agent enable-widget age_AbcDef123 --disable

# Guardar el snippet de instalación en un archivo
plazbot agent enable-widget age_AbcDef123 --json | jq -r '.script' > widget.html
```

### Resultado

```text
✔ Widget enabled for "Sales Plazbot"

Installation
────────────────────────────────────────
Paste this script inside the <head> tag of your website:

<script src="..."></script>
```

Al desactivar:

```text
✔ Widget disabled for "Sales Plazbot"
```

### Salida JSON

```json
{
"id": "age_AbcDef123",
"widgetEnabled": true,
"script": "<script src=\"...\"></script>"
}
```

`script` solo aparece al activar el widget (y si la API lo devuelve).

> **Nota:** Los agentes copiados con [`copy`](https://developers.plazbot.com/cli/agent/copy) o [`cross-copy`](https://developers.plazbot.com/cli/agent/cross-copy) empiezan con el widget desactivado.

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `The API rejected the request.` | La API respondió sin éxito y sin un mensaje propio. | Revisa el agente con `plazbot agent get age_AbcDef123`. |
| `Resource not found.` | El ID no existe en el workspace activo. | Revisa el ID con `plazbot agent list`. |
| `You are not signed in.` | No hay sesión activa. | Ejecuta [`plazbot login`](https://developers.plazbot.com/cli/login). |
