---
title: "Poner el chat en tu sitio web"
description: "Crea el chat o el formulario de tu sitio web en Sitios y formularios, elige el agente que responde, ajústalo, publícalo e instálalo en tu página, y encuentra lo que llega."
---
> Documentation Index
> Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Poner el chat en tu sitio web
El chat web es un botón en tu sitio web que abre una conversación con uno de tus agentes de mensajería. También puede ser un formulario, o un formulario seguido de un chat. Créalo cuando quieras que los visitantes de tu página resuelvan dudas o pidan una cita sin llamar.
## Antes de empezar
- Necesitas un rol que pueda **Conectar canales: teléfono, WhatsApp y chat web**, como **Administración** o **Propietario**.
- Necesitas un agente de mensajería activo (ver [Crear un agente](/raiz/create-an-agent/)).
- Para instalarlo en tu página, necesitas a quien administra tu sitio web. Si no lo tienes a mano, puedes compartir el chat con un enlace público.
## Qué vive el visitante
Con el botón flotante o el enlace público.
Bienvenida, preguntas sugeridas y consentimiento.
Si lo pides: unos datos antes de empezar.
Con tu agente, por escrito o con audios.
Antes de empezar, el visitante pasa una verificación antirrobots. Si cierra o recarga la página, la conversación sigue mientras dure la sesión. Cuando la sesión vence, puede leer su historial e iniciar otra.
## Crear el chat
1. En el menú, haz clic en **Sitios y formularios** y luego en **Crear nuevo**.
2. En **¿Qué quieres crear?** tienes dos caminos:
- Describe lo que necesitas y deja que **Arbi**, el asistente, lo arme. Por ejemplo: "Un chat para nuestro sitio que responda preguntas frecuentes con nuestra base de conocimiento, en azul y blanco". Arbi te pide confirmar antes de crearlo y antes de publicarlo.
- Haz clic en **Crear manualmente** para armarlo tú. Los pasos siguientes siguen este camino.
3. En **Nuevo sitio o formulario**, escribe el **Nombre del widget**: es el que ven los visitantes en la cabecera del chat.
4. En **Experiencia**, elige:
- **Chat**: una conversación con el agente desde la primera pregunta.
- **Formulario y chat**: primero unos datos, luego la conversación.
- **Formulario**: solo recoge información; nadie conversa.
5. Elige el agente de mensajería que responde y haz clic en **Crear**. El chat queda creado, sin publicar.
## Ajustarlo
El editor muestra a la derecha una vista previa en **Escritorio** o en **Teléfono**. Arriba puedes cambiar entre **Arbi**, para pedir cambios en tus palabras, y **Ajustes**, para hacerlos tú. En **Ajustes** hay seis secciones:
| Sección | Qué ajustas |
| --- | --- |
| **General** | El agente que responde, si está **Publicado**, el **Idioma predeterminado** y, si quieres, **Agentes adicionales** para que el visitante elija con quién hablar en la pantalla de inicio. |
| **Apariencia** | **Paletas** y colores, tipografía, forma, logo (PNG, JPEG o WebP de hasta 256 KB) y el **Botón flotante**: su texto, su icono, su **Posición** y cómo se abre **En móvil**. |
| **Bienvenida y formulario** | La experiencia, la **Pantalla de inicio** (**Título de bienvenida**, **Texto de bienvenida** y hasta seis **Preguntas sugeridas**), los datos que pides y el **Consentimiento**, con el **Enlace a la política de privacidad**. |
| **Conversación** | Lo que el visitante puede enviar y cómo ve las respuestas. |
| **Acceso y límites** | En qué sitios puede aparecer y cuánto puede usarse. |
| **Instalación** | El código para tu página y el enlace público. |
Haz clic en **Guardar cambios** cuando termines. La vista previa muestra la última versión guardada, y lo que escribas en ella abre una conversación real con el agente.
### El formulario
En **Bienvenida y formulario › Datos del formulario**, haz clic en **Añadir campo** para cada dato que quieras pedir. Cada campo tiene una etiqueta, un tipo (**Texto**, **Texto largo**, **Correo**, **Teléfono**, **Número**, **Fecha**, **Lista de opciones**, **Opción única**, **Casilla** o **Dirección web**), si es **Obligatorio** y su ancho. Arrástralos para cambiar el orden.
- Lo que el visitante escribe le llega al agente como contexto de la conversación. No verifica su identidad: no le pidas al agente que comparta información sensible por haber recibido un nombre o un documento en el formulario.
- Con **Pedir el primer mensaje**, el visitante escribe su consulta en el formulario y con eso empieza la conversación.
- En la experiencia **Formulario**, al enviar ve tu **Mensaje de agradecimiento** y un comprobante.
Ejemplo: para pedir citas, un formulario con Nombre, Documento, Servicio (lista de opciones) y Fecha preferida, seguido de un chat.
### Lo que el visitante puede enviar
En **Conversación**:
| Ajuste | Qué hace |
| --- | --- |
| **Permitir archivos adjuntos** | Un archivo de hasta 512 KB por mensaje, de los formatos que marques: PNG, JPEG, PDF o texto. |
| **Mensajes de voz** | El visitante graba un audio; Raíz lo transcribe y el agente responde a lo que dijo. Necesita el permiso del micrófono del navegador. |
| **Ofrecer dictado** | El visitante puede dictar su mensaje en lugar de escribirlo. |
| **Ofrecer lectura de respuestas** | El visitante puede escuchar en voz alta las respuestas del agente. |
| **Mostrar las respuestas mientras llegan** | La respuesta aparece palabra por palabra, en lugar de esperar el texto completo. |
| **Personalizar textos por idioma** | Los textos del chat en otro idioma. Lo que dejes vacío usa el texto principal. |
### Los límites
En **Acceso y límites › Límites de uso**:
| Límite | Qué es | Si no lo cambias |
| --- | --- | --- |
| **Duración de sesión (minutos)** | Cuánto puede durar una conversación desde que empieza, de 5 a 60. | 30 |
| **Mensajes por sesión** | Cuántos mensajes puede enviar un visitante en una conversación, de 1 a 100. | 30 |
| **Sesiones por día** | Conversaciones nuevas que el chat acepta al día. | 100 |
| **Mensajes por día** | Mensajes que el chat procesa al día entre todas sus conversaciones. | 1000 |
Los días se cuentan desde las 00:00 en hora universal (UTC). Además se aplica la lista de bloqueos de tu organización (ver [Personas y bloqueos](/raiz/contacts/)).
> **Herramientas en un chat público**
>
> En **Acceso y límites**, **Permitir herramientas del agente** deja que visitantes anónimos ejecuten acciones reales con las herramientas del agente, como agendar. Actívalo solo si esas acciones son apropiadas para un chat público.
## Decir dónde aparece
1. Abre **Acceso y límites**.
2. En **Sitios autorizados**, escribe la dirección de tu sitio, una por línea, con `https://` y sin rutas. Ejemplo: `https://www.clinicaejemplo.com`.
3. Si quieres compartir el chat como una página propia, por ejemplo en una campaña o en tu perfil de redes sociales, activa **Permitir enlace de chat público**.
4. Haz clic en **Guardar cambios**.
## Publicarlo e instalarlo
1. Haz clic en **Publicar**. Verás el aviso "Publicado: ya recibe visitantes".
2. Abre **Instalación**. En **Código de instalación** verás dos líneas como estas, con el identificador de tu chat y su dirección ya escritos:
```html
```
3. Haz clic en **Copiar código** y envíaselo a quien administra tu sitio web. Debe pegarlo antes del cierre de la etiqueta `body` en cada página de un sitio autorizado. Funciona con cualquier plataforma web.
4. Si activaste el enlace público, en **Enlace público** usa **Copiar enlace** o **Abrir chat público**. También puedes copiarlo con **Copiar el enlace** desde la tarjeta del chat.
En **Instalación** también está la **API JavaScript**: código para que quien desarrolla tu sitio abra o cierre el chat desde sus propios botones.
## Qué ves cuando terminas
La tarjeta del chat en **Sitios y formularios** dice **Publicado** y dónde aparece: el enlace público y los sitios autorizados.
Lo que llega lo encuentras en **Conversaciones**, filtrando por **Canal › Chat**:
- Cada conversación del chat, con su transcripción, su resumen y su resultado, como cualquier otra (ver [Seguir las conversaciones](/raiz/conversations/)).
- Cada envío de un **Formulario** queda como una conversación ya cerrada.
- Si el formulario pide nombre, correo o teléfono, Raíz crea con esos datos una persona en **Personas**. No la une sola a una persona que ya existe: si es la misma, puedes fusionarlas (ver [Personas y bloqueos](/raiz/contacts/)).
Una conversación del chat se cierra después de 30 minutos sin mensajes, salvo que cambies el **Cierre por inactividad** del agente (ver [Ajustes de un agente](/raiz/agent-settings/)).
Para dejar de recibir visitantes, abre el chat y haz clic en **Pausar**. Las conversaciones abiertas se cierran.
## Problemas frecuentes
La tarjeta del chat te dice qué le falta:
- **Sin agente**: asigna un agente en **General** para publicarlo.
- **Agente en pausa**: su agente está en pausa; actívalo en **Trabajadores**.
- **Sin enlace ni sitio**: activa el enlace público o agrega el sitio web donde irá.
- **En pausa**: haz clic en **Publicar**.
No tienes agentes de mensajería activos.
**Qué hacer:** crea uno o actívalo (ver [Crear un agente](/raiz/create-an-agent/)).
Falta alguna de las tres condiciones para que aparezca.
**Qué hacer:** revisa que el chat esté **Publicado**, que la dirección exacta de tu sitio esté en **Sitios autorizados** y que el código esté pegado en esa página. Si tu sitio tiene una política de seguridad de contenido, quien lo administra debe permitir el chat: las indicaciones están en **Instalación**.
Cambiar los agentes, el acceso, el formulario, el consentimiento, los adjuntos o los límites por sesión cierra las sesiones abiertas. Los cambios de diseño y de los demás textos no.
**Qué hacer:** haz esos cambios en un momento de poco movimiento en tu sitio.
Llegó a un límite: los mensajes de su sesión, la duración de la sesión o los límites del día.
**Qué hacer:** revisa **Límites de uso** en **Acceso y límites** y súbelos si hace falta. Si la sesión venció, el visitante puede iniciar otra.
Source: https://docs.getarbol.com/raiz/web-chat/index.mdx