Plazbot Help Center · Help Center

Introducción

Este documento menciona como se puede agregar acciones al Agente de IA, como por ejemplo:

Habilitar el widget.
Cambiar el tema del widget.
Cambiar el nombre del widget.
Mostrar el widget inicialmente abierto.
Controlar el widget desde JavaScript.

Para habilitar el widget tienes que ir al tab de Widget y activar el switch.

Dentro de la Habilitación del Widget se generan la posiblilidad de poder configurar tu Widget a la medida, colocando dos opciones adicionales que son:

Colocar un Botón de Whatsapp directo.
Colocando un Formulario de Registro antes de poder conversar con el Agente

Para cambiar el tema del widget tienes que ir al tab de Widget y activar el switch de Dark Mode.

Tip: ✅ Recuerda que en el Chat en línea cuando el agente humano Activa o desactiva el Bot, podrá conversar con el contacto directo. Aprovecha las Acciones del agente de IA para alertar a los agentes humanos.

Para cambiar el icono del widget tienes que ir al tab de Widget y cambiar el icono del widget.

Para cambiar la URL del widget tienes que ir al tab de Widget y cambiar la URL del widget.

script

01<script id="id-widget-agent-plz" type="module" defer src="https://storagelaplazbot.z13.web.core.windows.net/widget.js?Id={{idAgent}}&zone={{zone}}&workspaceId={{workspaceId}}"></script>

Funciones JavaScript

El widget expone una API publica a traves del objeto global PlzWidget, que permite controlar el widget programaticamente desde cualquier evento de tu sitio web.

Metodos disponibles

Metodo	Descripcion
`PlzWidget.open()`	Abre el widget. Si ya esta abierto, no hace nada.
`PlzWidget.close()`	Cierra el widget. Si ya esta cerrado, no hace nada.
`PlzWidget.toggle()`	Alterna el estado del widget: si esta cerrado lo abre, si esta abierto lo cierra.

Ejemplo: Abrir el widget desde un boton personalizado

html

01<button onclick="PlzWidget.open()">Hablar con el asistente</button>

Ejemplo: Abrir el widget desde un evento JavaScript

javascript

01document.getElementById('mi-boton').addEventListener('click', function() {
02  PlzWidget.open();
03});

Ejemplo: Abrir el widget automaticamente despues de 5 segundos

javascript

01setTimeout(function() {
02  PlzWidget.open();
03}, 5000);

Cambios en Agent.config.json

Recuerda que todas las modificaciones que se realizan se reflejan en el agent.config.json:

Configuracion basica

enableWidget: Booleano que indica si el widget está activo o no.
typeWidget: Tipo de widget: widget (chat lateral) o search (buscador centrado).
nameWidget: String que indica el nombre del widget.
question: Pregunta principal que aparece en la pantalla de inicio.
iconWidget: String con el ícono del widget (robot, message, support, qa, chat, smile, voice, uservoice).
initialShowWidget: Booleano que indica si el widget aparece inicialmente abierto.

Tema visual

colorWidget: Tema visual (white | dark | green | blue | gray). white y dark tiñen todo el widget; green, blue y gray tiñen solo la cabecera. Si es null se aplica el fallback legacy darkWidget.
darkWidget: Booleano legacy; se usa solo cuando colorWidget no está definido.

Comportamiento

multianswerWidget: Si está activo, la respuesta del agente IA se divide en varios mensajes consecutivos para una conversación más natural.
formWidget: Muestra un formulario de registro (nombre, apellido, correo, WhatsApp) antes de iniciar el chat.
fUseAutomationFlowWidget: Prioriza los flujos de automatización sobre el agente IA.
enablePoweredBy: Muestra el pie de página "Powered by Plazbot" en el widget. Solo editable para administradores de Plazbot; para marcas blancas queda en false.

Canal WhatsApp

enableWhatsappWidget: Muestra botón de acceso directo a WhatsApp.
urlWhatsappWidget: URL completa tipo https://wa.me/1234567890.

Preguntas de ejemplo

examples: Lista de botones de pregunta sugerida. Cada entrada tiene value (texto) y color (orange | blue | green | gray | white).

json

01{
02  "enableWidget": true,
03  "typeWidget": "widget",
04  "nameWidget": "Plazbot",
05  "question": "En que puedo ayudarte?",
06  "colorWidget": "blue",
07  "darkWidget": false,
08  "iconWidget": "robot",
09  "initialShowWidget": true,
10  "multianswerWidget": true,
11  "formWidget": false,
12  "fUseAutomationFlowWidget": false,
13  "enablePoweredBy": true,
14  "enableWhatsappWidget": false,
15  "urlWhatsappWidget": null,
16  "examples": [
17    { "value": "Cuales son sus horarios?", "color": "blue" },
18    { "value": "Como puedo contactar a soporte?", "color": "green" }
19  ]
20}

Widget del Agente IA

Introducción

Habilitar el widget

Cambiar el tema del widget

Cambiar el Icon del widget

URL del widget

Funciones JavaScript

Cambios en Agent.config.json

Was this article helpful?

Related articles