Saltar al contenido principal
Chat web agrega a un sitio un widget para conversaciones entrantes. Los visitantes pueden iniciar una conversación con el Agente, pero Chat web no está disponible como primer canal saliente de una cadencia.
Si tu rol no muestra los Ajustes del Agente, pide a un administrador de tu cuenta de Nexor que configure e instale el widget.

​
Abre los ajustes de Chat web

1

Abre los canales del agente

Elige el agente en la barra lateral. En el panel derecho, ve a Canales y elige Añadir. Se abre la ventana Canales.
2

Configura Chat web

En la fila Chat web (Widget del sitio web), elige Configurar. Nexor abre el editor de Chat web de ese agente.
3

Guarda antes de instalar

Configura el widget, selecciona Guardar cambios y luego prueba la instalación en un sitio permitido.
El editor reúne tres áreas de configuración: comportamiento, diseño e instalación.

​
Configura el comportamiento

Usa estos controles para definir la primera experiencia y el estilo de escritura del Agente:
  • Primer mensaje: el mensaje que aparece cuando el visitante abre el chat. Puede incluir {{first_name}}, {{last_name}}, {{full_name}}, {{email}} o {{phone}}.
  • Estilo del agente: reglas de texto libre sobre el tono, la redacción y lo que el Agente debe o no debe hacer.
  • Mensajes de ejemplo: respuestas de muestra que enseñan la voz, el largo y el formato preferidos.
  • Capturar datos del lead: solicita los campos de contacto elegidos antes de que el visitante pueda chatear.
La captura puede solicitar Nombre, Apellido, Correo y Teléfono. Selecciona solo los campos que el equipo necesita.
Mensajes de ejemplo enseñan al Agente cómo escribir. Preguntas sugeridas son opciones que el visitante puede seleccionar en la pantalla de inicio. Cumplen funciones distintas.

​
Configura el diseño

Los controles de diseño se agrupan en estas secciones visibles:
  • Identidad: nombre del Agente, avatar, título del chat y subtítulo.
  • Pantalla de inicio: saludo de dos líneas, título de la tarjeta de mensaje y hasta cuatro preguntas sugeridas.
  • Apariencia: color de acento y forma redondeada o cuadrada.
  • Vista previa en vivo: alterna entre Inicio y Chat para revisar el resultado antes de guardar.
El avatar acepta una URL pública o una imagen JPG, PNG o WebP de hasta 5 MB. El idioma del widget sigue el idioma configurado en el Agente.

​
Agrega dominios permitidos

Abre Instalación y agrega los dominios de producción donde debe ejecutarse el widget.
  • Ingresa un dominio como example.com, sin protocolo ni ruta.
  • Usa un comodín como *.example.com si el mismo widget debe funcionar en ese dominio y sus subdominios.
  • Puedes guardar hasta 50 entradas.
La clave de Chat web y su lista de Dominios permitidos pertenecen al espacio de trabajo. Cambiar la lista desde un Agente afecta a otros widgets que usan la misma clave del espacio de trabajo.
Agrega dominios explícitos antes de publicar el widget. Una lista vacía de Dominios permitidos no bloquea actualmente el widget estándar, aunque el estado vacío del panel diga lo contrario. No uses una lista vacía como interruptor de apagado. La lista se aplica al transporte normal del widget cuando el navegador informa el dominio de origen. No garantiza la autorización del flujo requestContact del SDK v0.1.44, que no está soportado en sitios públicos no confiables mientras se refuerza el backend.

​
Usa la clave correcta

La sección Instalación muestra Clave API, ID del agente e ID del cliente. La clave del widget empieza con nxr_pub_. Es visible en el navegador, no es secreta y está destinada a Chat web.
Nunca la reemplaces por una clave REST que empiece con nxr_live_. Una clave nxr_live_ es secreta y no debe quedar en HTML, JavaScript enviado al navegador, capturas ni repositorios públicos.

​
Elige un método de instalación

Ambos métodos usan la clave nxr_pub_ visible en el navegador y el ID del Agente que aparece en Instalación. No inicialices ninguno con una clave REST nxr_live_.

​
Instala el widget alojado

La instalación básica no necesita npm. En Fragmento de instalación, usa Copiar para obtener los valores generados para el Agente actual. El fragmento tiene esta forma:
1

Copia desde Nexor

Copia el Fragmento de instalación completo desde Instalación en el Agente. No reutilices IDs ni claves de otro espacio de trabajo.
2

Pégalo en el sitio

Agrega el script justo antes de la etiqueta de cierre </body> en cada página que debe mostrar el widget.
3

Publica y prueba

Publica el sitio, ábrelo en un dominio permitido e inicia una conversación real. Confirma el botón del chat, la pantalla de inicio, la captura de datos y la respuesta del Agente.
La URL alojada es una vía de distribución administrada, no una versión del paquete npm. Copia el fragmento actual desde Nexor y no deduzcas una versión del script a partir de su URL.

​
Instala con el paquete npm

Usa el paquete npm cuando el código de la aplicación necesite abrir o cerrar el widget, enviar un mensaje, actualizar prompts específicos de la página, leer el ID de sesión o reaccionar a eventos del ciclo de vida. El SDK incluye initChat, callbacks para apertura, cierre, mensajes, captura del lead y errores, además de un handle para controlarlo por código. Consulta la referencia del SDK de JavaScript para ver instalación, configuración, callbacks y métodos del handle.
El paquete npm y el script alojado son vías de distribución separadas. Fija y actualiza la dependencia npm mediante el proceso normal de releases de tu aplicación; la URL alojada no indica qué release de npm entrega.

​
Solución de problemas

​
No aparece el botón del chat

Confirma que el script esté en la página renderizada, que los valores de data-workflow y data-key provengan de la misma configuración del Agente y que la clave empiece con nxr_pub_. Confirma también que Chat web no esté desactivado para el Agente.

​
El sitio no está autorizado

Agrega el dominio exacto de producción en Dominios permitidos. No incluyas https://, puerto ni ruta. Agrega un comodín si los subdominios necesitan acceso.

​
Los cambios no aparecen en el widget

Selecciona Guardar cambios, recarga el sitio sin una página antigua en caché y abre una sesión nueva del widget. Usa Vista previa en vivo para confirmar que Nexor guardó el diseño esperado.

​
Nexor no puede cargar la clave de Chat web

Recarga los Ajustes del Agente e inténtalo de nuevo. No sustituyas la clave pública por una clave REST mientras la primera no esté disponible.

Revisa los Ajustes del Agente

Revisa cómo Chat web se relaciona con el idioma, el prompt y los demás canales del Agente.
Última modificación el 5 de octubre de 2026