# Widget WhatsApp

> Muestra u oculta el botón de WhatsApp en el widget web de un agente.

Fuente: https://developers.plazbot.com/whatsapp/cli/widget/

### Widget WhatsApp

Activa o desactiva el botón de click-to-chat de WhatsApp en el widget web de un agente. Solo cambian los campos del widget; el resto de la configuración del agente se mantiene.

```bash
plazbot whatsapp widget enable <agentId> (-p <número> | -u <url>) [opciones]
plazbot whatsapp widget disable <agentId> [opciones]
```

## widget enable

Activa el botón. Pasa el número (`-p`) para que el botón abra `https://wa.me/<número>`, o una URL propia (`-u`), por ejemplo con un mensaje precargado. Usa uno de los dos, no ambos.

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Agente | `<agentId>` (argumento) | Sí | ID del agente, por ejemplo `age_AbcDef123` |
| Teléfono | `-p, --phone <number>` | Uno de los dos | Número que abre el botón, en formato internacional. Construye `https://wa.me/<número>` |
| URL | `-u, --url <url>` | Uno de los dos | URL de click-to-chat propia en lugar de `--phone` (ej: `https://wa.me/51912345678?text=Hi`) |
| JSON | `--json` | No | Imprime solo JSON en stdout |

### Ejemplos

```bash
# Botón que abre un chat con tu número
plazbot whatsapp widget enable age_AbcDef123 -p +51912345678

# Link propio con un mensaje precargado
plazbot whatsapp widget enable age_AbcDef123 -u "https://wa.me/51912345678?text=Hola"

# Salida JSON
plazbot whatsapp widget enable age_AbcDef123 -p +51912345678 --json
```

### Resultado

```text
✔ WhatsApp button enabled
URL: https://wa.me/51912345678
```

### Salida JSON

```json
{
"id": "age_AbcDef123",
"enableWhatsappWidget": true,
"url": "https://wa.me/51912345678"
}
```

### Errores comunes

| Mensaje | Causa | Solución |
|---------|-------|----------|
| `Missing WhatsApp number.` | No pasaste `-p` ni `-u` | Pasa `--phone +51912345678` o `--url <url>` |
| `Use either --phone or --url, not both.` | Pasaste los dos | Usa solo uno |
| `Invalid URL "..."` | La URL no empieza con http(s) | Usa una URL completa, por ejemplo `https://wa.me/51912345678` |
| `Agent age_AbcDef123 not found in the active workspace.` | ID incorrecto o de otro workspace | Revisa el ID con [`plazbot agent list`](https://developers.plazbot.com/cli/agent/list) |

## widget disable

Oculta el botón de WhatsApp del widget.

### Parámetros

| Parámetro | Flag | Requerido | Descripción |
|-----------|------|-----------|-------------|
| Agente | `<agentId>` (argumento) | Sí | ID del agente, por ejemplo `age_AbcDef123` |
| JSON | `--json` | No | Imprime solo JSON en stdout |

### Ejemplos

```bash
# Ocultar el botón de WhatsApp
plazbot whatsapp widget disable age_AbcDef123

# Salida JSON
plazbot whatsapp widget disable age_AbcDef123 --json
```

### Resultado

```text
✔ WhatsApp button disabled
```

### Salida JSON

```json
{
"id": "age_AbcDef123",
"enableWhatsappWidget": false
}
```