> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/channels/chat-widget.md).

# Widget de chat

### 1. Modos disponibles

El **Webchat widget** se publica mediante un script y ofrece:

* **Solo flotante**: burbuja y panel flotante.
* **Híbrido inline + flotante**: chat integrado en un contenedor y versión flotante según scroll o visibilidad.

En móvil, el panel flotante ocupa todo el viewport hasta 640 px, bloquea el scroll de la página anfitriona y mantiene cabecera, cierre y compositor visibles. El modo inline no se convierte en pantalla completa.

### 2. Configuración básica

| Ajuste                               | Función                                                             |
| ------------------------------------ | ------------------------------------------------------------------- |
| Título y texto del botón             | Textos visibles del widget.                                         |
| Abrir por defecto                    | Abre el panel al cargar.                                            |
| Recuperar última conversación        | Continúa la sesión anterior del visitante.                          |
| Adjuntos                             | Permite subir archivos desde el widget cuando el runtime lo admite. |
| Dominios/URLs permitidos             | Lista cerrada de orígenes autorizados para incrustar.               |
| Selector inline                      | Selector CSS del contenedor anfitrión.                              |
| Umbral de scroll                     | Entre 0 y 3000 px.                                                  |
| Mostrar flotante al ocultarse inline | Activa el panel flotante cuando el inline sale del viewport.        |

Para el híbrido, añade a tu web un contenedor que coincida exactamente con el selector configurado.

### 3. Fallback a WhatsApp

Puedes activar un botón de continuidad por WhatsApp con:

* Número internacional.
* Texto de botón localizado.
* Mensaje prellenado localizado.

Úsalo cuando quieras ofrecer un canal alternativo desde el widget.

### 4. Posición y tamaño

Configura izquierda/derecha, offsets X/Y, ancho y alto del panel, ancho inline y radio de esquina. La interfaz limita los valores a rangos seguros.

### 5. Lanzador y tarjeta de bienvenida

El lanzador permite:

* Mostrar u ocultar la tarjeta.
* Volver a mostrarla tras cerrar el panel con **Mostrar siempre al cerrar**.
* Usar URL o archivo de icono y ajustar su tamaño.
* Editar mensaje por idioma.
* Ajustar separación, degradado, texto, ancho de 360 a 420 px, retardo, tamaño y alineación.

La tarjeta usa el logo del bot, el mensaje localizado y hasta tres **Botones iniciales** de Action Buttons. Al pulsar una acción, abre el panel y la envía como primer mensaje.

### 6. Colores

Widget e inline tienen configuración independiente:

* Modo **Paleta**, **Autogenerado** cuando existe una paleta de la web, o **Custom**.
* Fondo, marco, cabecera primaria/secundaria, texto, burbujas y compositor.
* Inline hereda por defecto los colores del widget; puede cambiar a paleta o personalizado.

Las cabeceras usan los colores primario y secundario como degradado. Las configuraciones antiguas reutilizan el primario como fallback.

### 7. Preview

Los botones de visibilidad de las tarjetas de color abren una preview del runtime real en un iframe. El borrador viaja solo a esa preview y no se guarda hasta pulsar **Guardar**. La preview de colores abre el panel; el lanzador no dispone de una preview independiente.

### 8. Inserción

Copia el script correspondiente a **flotante** o **inline + flotante** y colócalo en la web autorizada. En híbrido, añade también el contenedor inline. Si el dominio no coincide con la lista permitida, el widget bloquea la carga.