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
01plazbot 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
01# Activar el widget e imprimir el snippet <script>02plazbot agent enable-widget age_AbcDef1230304# Desactivar el widget05plazbot agent enable-widget age_AbcDef123 --disable0607# Guardar el snippet de instalación en un archivo08plazbot agent enable-widget age_AbcDef123 --json | jq -r '.script' > widget.html
Resultado
text
01✔ Widget enabled for "Sales Plazbot"0203 Installation04 ────────────────────────────────────────05 Paste this script inside the <head> tag of your website:0607<script src="..."></script>
Al desactivar:
text
01✔ Widget disabled for "Sales Plazbot"
Salida JSON
json
01{02 "id": "age_AbcDef123",03 "widgetEnabled": true,04 "script": "<script src=\"...\"></script>"05}
script solo aparece al activar el widget (y si la API lo devuelve).
Los agentes copiados con copy o 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. |