> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custumu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Web Widget

Personaliza e integra el widget de chat en tu sitio web.

En la pestaña **Ajustes** puedes personalizar la experiencia de tu asistente en el sitio y obtener el código para integrarlo en tu página web. Puedes compartir un enlace, incrustar una burbuja de chat. Una vista previa en tiempo real, situada a la derecha, muestra cada cambio a medida que lo realizas, y permite alternar entre las vistas de Chat y Canales.

![Image](https://mintcdn.com/custumu/kc6Pedv542w0rAgG/images/image-4.png?fit=max\&auto=format\&n=kc6Pedv542w0rAgG\&q=85\&s=02cb1c6326c09fc41f0c77e0e5cfca4b)

## Activar o desactivar el widget

La tarjeta Web Widget, situada en la pestaña Canales, funciona como un interruptor. Un asistente nuevo comienza con esta opción desactivada, por lo que no se mostrará nada en su sitio hasta que la active. Solo los gestores del asistente pueden activarlo.

![Image](https://mintcdn.com/custumu/abDa16aJo-t-BpaI/images/image-2.png?fit=max\&auto=format\&n=abDa16aJo-t-BpaI\&q=85\&s=d1c4e1c5009a6c89db6d95c6922f5cfb)

## Métodos de inserción

La pestaña Instalación ofrece dos formas de implementar tu asistente:

### 1. Enlace alojado

Una URL compartible que abre tu asistente en una página independiente. No requiere código ni integración.

[https://www.chat.custumu.com/YOUR\_ASSISTANT\_ID](https://www.useinvent.com/e/YOUR_ASSISTANT_ID)

Copia el enlace y compártelo donde quieras: envíaselo a tus clientes, inclúyelo en correos electrónicos, úsalo para realizar pruebas o compártelo con los miembros de tu equipo. Cualquier persona que tenga el enlace podrá empezar a chatear con tu asistente mientras el widget esté activo.

### 2. Script de integración

Un fragmento de código HTML que se inserta en tu sitio web. Por defecto, añade una burbuja de chat flotante en una esquina de la página, sobre la que los clientes pueden hacer clic para iniciar una conversación. Los colores y el comportamiento se rigen por la configuración que hayas guardado para el widget, por lo que no necesitarás volver a modificar el código.

![Image](https://mintcdn.com/custumu/uaEQKHmjKHtaCu6r/images/image-7.png?fit=max\&auto=format\&n=uaEQKHmjKHtaCu6r\&q=85\&s=22695b5368e4fe6a10335ae9af91ddf4)

Copia el fragmento y pégalo antes de la etiqueta de cierre \</body> en tu sitio web. El globo aparecerá de inmediato.

## Personalización

Todos los métodos de incrustación comparten la misma configuración, agrupada en las categorías Apariencia, Conversación, Avance, Canales y Avanzado. Todos los cambios se reflejan en la vista previa en tiempo real y no se aplican hasta que se hace clic en Guardar.

### **Apariencia**

Controla el aspecto del widget en tu sitio.

* **Posición del botón de la burbuja:** la esquina donde aparece el lanzador, abajo a la derecha o abajo a la izquierda. Si el elemento incrustado trae un atributo `position`, ese valor sobreescribe esta opción en esa página.
* **Apariencia del tema:** los colores del chat. Automático sigue la preferencia del sistema del visitante, o puedes forzarlo a claro u oscuro.

### Conversación

Define lo primero que ven los visitantes al abrir el chat.

* **Mensaje de bienvenida:** el mensaje de bienvenida que aparece en la parte superior de una nueva conversación.
* **Mensajes sugeridos:** respuestas rápidas que los visitantes pueden pulsar para comenzar.
* **Dictado:** permita a los visitantes dictar mensajes mediante el micrófono.

### **Capacidades**

Gestiona el comportamiento automático de las conversaciones con tus visitantes.

* **Cerrar chats inactivos**: finaliza automáticamente las conversaciones cuando el visitante deja de responder.
* **Minutos sin respuesta**: tiempo de espera antes de finalizar la conversación (configurable de 1 a 60 minutos). Esta opción solo está visible cuando «Cerrar chats inactivos» se encuentra activado.

### **General**

Configura la información básica y la identidad de tu asistente.

* **Logo (URL)**: enlace a la imagen o logo que se muestra en el encabezado del chat y en la lista de conversaciones.
* **Nombre del asistente**: nombre público que verán los visitantes en el encabezado del chat y junto a los mensajes del bot.

### Canales

Ofrece a tus visitantes otras formas de contactarte desde un menú en el botón del widget. Si hay canales configurados, al tocarlo se abre primero ese menú, con un botón para empezar el chat.

* **Canales conectados:** los canales de mensajería que tengas conectados (WhatsApp, Messenger, Instagram, Telegram) se agregan solos y sus enlaces se mantienen al día. Quita uno para ocultarlo del menú.
* **Canales personalizados:** agrega un enlace, un correo o un teléfono para llevar a tus visitantes a otro lado.

Avanzada

* **Ocultar Con la tecnología de**: quita la marca **Con la tecnología de Custumu** del widget.

> [!NOTE]
>
> Quitar la marca «Con la tecnología de» requiere un plan Business o Enterprise.

* **Restablecer valores:** devuelve cada ajuste del widget a su valor inicial, incluidos los colores, el mensaje de invitación y los canales. Nada cambia hasta que guardes.

## Atributos del elemento

El elemento `<custumu-chat>` lee un conjunto fijo de atributos. Cualquier otro se ignora.

| Atributo | Valores | Descripción |
| - | - | - |
| `position` | `right`, `left` | Sobreescribe la **posición del botón de la burbuja** en esa página. |
| `theme-appearance` | `auto`, `light`, `dark` | Sobreescribe la **apariencia del tema** en esa página. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.