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
01plazbot whatsapp widget enable <agentId> (-p <número> | -u <url>) [opciones]02plazbot 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
01# Botón que abre un chat con tu número02plazbot whatsapp widget enable age_AbcDef123 -p +519123456780304# Link propio con un mensaje precargado05plazbot whatsapp widget enable age_AbcDef123 -u "https://wa.me/51912345678?text=Hola"0607# Salida JSON08plazbot whatsapp widget enable age_AbcDef123 -p +51912345678 --json
Resultado
text
01✔ WhatsApp button enabled02 URL: https://wa.me/51912345678
Salida JSON
json
01{02 "id": "age_AbcDef123",03 "enableWhatsappWidget": true,04 "url": "https://wa.me/51912345678"05}
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 |
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
01# Ocultar el botón de WhatsApp02plazbot whatsapp widget disable age_AbcDef1230304# Salida JSON05plazbot whatsapp widget disable age_AbcDef123 --json
Resultado
text
01✔ WhatsApp button disabled
Salida JSON
json
01{02 "id": "age_AbcDef123",03 "enableWhatsappWidget": false04}