Guía completa del Webchat (chat para tu sitio web)

El Webchat a fondo, en 32 capítulos: instalarlo, apariencia, idiomas, formulario, departamentos, horario, disparadores, IA, la bandeja, identificación segura y API de JavaScript, con un sitio real de punta a punta.

Nov 02, 2026

Esta es la guía completa del Webchat de Omnifox, con 32 capítulos: crear el canal e instalarlo en tu sitio, la apariencia y el botón, los idiomas y la traducción con IA, el formulario pre-chat y los departamentos, el horario, los disparadores, la IA, lo que puede hacer el visitante, cómo se atiende desde la bandeja, la identificación segura de usuarios y la API de JavaScript. El manual en PDF tiene los mismos capítulos con capturas y pasos.

1. Qué es el Webchat

El Webchat es un botón de chat que aparece en tu sitio. El visitante hace clic, escribe, y su mensaje llega al instante a tu bandeja de Omnifox, donde lo atiende una persona de tu equipo o un agente de inteligencia artificial.

Detrás de ese botón hay mucho más: puedes pedir datos antes de chatear, dejar que el visitante elija el departamento, saludar solo en ciertas páginas, responder fuera de horario y reconocer a tus clientes que ya iniciaron sesión. El Webchat está incluido en todos los planes.

2. Crear el canal

Para crearlo ve a Configuración, Canales, y haz clic en Conectar nuevo canal. Aparecen todas las plataformas que puedes conectar; elige Webchat.

Ponle un nombre al canal, que es como lo verás tú dentro de Omnifox, por ejemplo con el dominio de tu web. Después, el nombre del widget, que es el título que verá el visitante en el chat; el color principal de tu marca; y un mensaje de bienvenida.

Abajo, en Idioma del widget, eliges en qué idioma verá el visitante los textos del chat y en cuál escribe tu equipo; la traducción automática con IA se activa después, en la pestaña Idiomas. Haz clic en Guardar y obtener código.

3. Instalarlo en tu sitio

Omnifox te da el código de inserción: una sola línea. Cópiala con el botón. Va en todas las páginas de tu sitio, justo antes de la etiqueta de cierre del body.

Esta es la tienda de Volcán Outdoor, todavía sin chat. Su panel tiene una sección para agregar código a todas las páginas; pegamos la línea y guardamos. En WordPress, Shopify, Wix o cualquier otra plataforma, busca la opción para insertar código en el pie de página o una extensión que lo permita; si usas Google Tag Manager, también funciona como una etiqueta de HTML personalizado.

Recargamos la tienda y ahí está el botón del chat. Volvemos a Omnifox, hacemos clic en Verificar instalación, y Omnifox confirma que detectó el widget en nuestro dominio. El canal ya está activo.

4. El canal en la lista

En la lista de canales, el Webchat tiene su tarjeta con el estado y el último chequeo. Sus botones son: el chequeo de salud, Editar, que abre el mismo asistente de la creación, y Código de inserción, que lleva al editor completo del widget, donde vamos a pasar casi toda esta guía.

También tienes el botón de Inteligencia Artificial, con un punto verde cuando la IA responde en este canal, pausar el canal, y eliminarlo.

Pausar es útil si quieres apagar el chat un tiempo sin perder nada: el widget deja de mostrarse y Omnifox deja de vigilar el canal; al reactivarlo vuelve tal como estaba. Eliminar, en cambio, borra el canal y su configuración, y te pide confirmación.

5. Código de integración e instalaciones

El editor del widget tiene ocho pestañas. Empecemos por Código de integración: aquí está siempre tu línea de código para copiarla de nuevo, y debajo, Instalaciones detectadas.

Omnifox anota en qué dominios se cargó tu widget y cuándo fue la última vez. Si lo pusiste en varias webs, las verás todas, con la más reciente marcada. Es la forma más rápida de comprobar que el código sigue instalado.

Un detalle importante: el código es el mismo para siempre. Puedes cambiar colores, textos, horarios o disparadores cuantas veces quieras sin volver a tocar tu sitio, porque el widget lee la configuración desde Omnifox cada vez que se carga una página.

6. Nombre, color, tipografía y posición

Pasemos a Apariencia. A la izquierda, el editor de tema; a la derecha, la vista previa en vivo, que cambia con cada ajuste.

El nombre del widget es el título del chat. El color principal pinta el botón, la cabecera y los mensajes del visitante; el texto encima se pone blanco o negro solo, para que siempre se lea. Elige la tipografía y la posición, abajo a la derecha o a la izquierda.

El subtítulo es la línea pequeña debajo del nombre; si lo dejas vacío dice Suelen responder en minutos. Guardamos la apariencia, recargamos la tienda, y el chat ya luce como Volcán Outdoor.

7. Mensaje de bienvenida y avatar

El mensaje de bienvenida es lo primero que ve el visitante al abrir el chat, como si se lo escribiera tu equipo. Se muestra una vez por visitante: si vuelve otro día, no se le repite.

El avatar del encabezado es la foto o el logo redondo de la cabecera: lo subes, en PNG, JPG o WebP, y Omnifox lo optimiza. Y con Mostrar quién responde en el encabezado, cuando alguien contesta, la cabecera cambia a la foto y el nombre de esa persona o del agente de IA.

Guardamos, y un visitante nuevo que entra a la tienda ya ve la bienvenida, con el logo de Volcán Outdoor en la cabecera.

8. Tema y marca

El modo de tema puede ser claro, oscuro o automático, que sigue lo que tenga elegido el visitante en su dispositivo. La forma de los mensajes elige entre burbujas redondeadas o más cuadradas.

Y el interruptor Mostrar Powered by Omnifox controla el pie con nuestra marca dentro del chat.

Cada pestaña del editor tiene su propio botón de guardar: si cambias algo en Apariencia y te vas a otra pestaña sin guardar, ese cambio se pierde. Guarda siempre antes de salir de la pestaña.

9. El botón del chat

Ahora el botón flotante. Con Tamaño de la burbuja eliges su diámetro, de cuarenta a setenta y dos píxeles.

Mostrar texto junto al botón lo convierte en una píldora con un texto al lado del ícono, como Escríbenos. Eliges si el texto va a la derecha o a la izquierda, si se ve en computadora, en celular o en ambos, y si el visitante puede minimizarlo con una pequeña equis.

La animación de atención hace que el botón pulse, rebote, se sacuda o haga un latido cada cierto tiempo. Y puedes usar la foto del asesor como ícono del botón. Guardamos y miramos el resultado en la tienda.

10. Idioma del widget

En la pestaña Idiomas eliges el idioma del widget: español, inglés o portugués. Con la detección automática encendida, cada visitante lo ve en el idioma de su navegador, y si no es uno de esos tres, en el que elegiste.

También puedes mostrar un selector de idioma en la cabecera del chat, para que el visitante lo cambie. Y si tu sitio tiene varias versiones, cada página puede forzar el idioma con el atributo data locale en el código.

El idioma cambia todos los textos del widget: el formulario, los botones, los avisos y el mensaje de fuera de horario. Lo que tú escribes, como la bienvenida, se muestra tal cual, así que escríbelo en el idioma de tus clientes.

11. Traducción bidireccional con IA

La traducción bidireccional hace que el visitante y tu agente conversen cada uno en su idioma: la IA traduce los mensajes en ambas direcciones, en tiempo real. Está disponible desde el plan Crece.

Eliges el idioma de tu agente y el idioma del visitante por defecto, y puedes mostrar el aviso Traducido por IA dentro del chat. Aquí también ves el consumo de traducciones del mes.

Probémoslo. Una visitante escribe en inglés. En la bandeja, Valeria lo lee en español, responde en español, y la visitante recibe la respuesta en inglés.

12. Formulario pre-chat

En Pre-chat, el formulario pide datos antes de empezar a chatear. Viene apagado; al activarlo, agregas hasta diez campos.

Cada campo puede ser un dato estándar del contacto, como el nombre, el correo o el teléfono; uno de tus campos personalizados; u otra pregunta libre, de tipo texto, área de texto, número, correo, teléfono o una lista de opciones. Y lo marcas como obligatorio si no se puede saltar.

Los datos estándar y personalizados se guardan directo en la ficha del contacto; las preguntas libres quedan en la conversación. Así lo ve el visitante: primero el formulario, y después el chat.

Con el formulario apagado, el widget igual se comporta bien: la conversación empieza con el primer mensaje, y el contacto aparece como Visitante seguido de un código hasta que conozcas su nombre.

13. Selector de departamentos

El selector de departamentos deja que el visitante elija con qué equipo quiere hablar. Los departamentos son tus equipos del espacio de trabajo: marcas cuáles mostrar, y a cada uno le puedes dar un nombre para el visitante, un color y un ícono. Los ordenas arrastrando.

Si la selección es obligatoria, el visitante no puede saltarla; si no, aparece Continuar sin elegir. Va después del formulario: primero los datos, después el departamento, y luego el chat.

El visitante elige Soporte postventa, escribe, y la conversación entra asignada a ese equipo, repartida según la estrategia del equipo. Aquí le tocó a Diego.

Si no tienes equipos todavía, el selector te lo dice: créalos primero en Configuración, Equipos, con sus integrantes y su forma de repartir.

14. Horario de atención y fuera de horario

En Disponibilidad defines tu horario: la zona horaria y, por cada día, si atiendes y de qué hora a qué hora. También acepta horarios que cruzan la medianoche. Si no activas ningún día, el chat se muestra disponible siempre.

Fuera de ese horario, el visitante ve tu mensaje de ausencia. Y si activas Capturar nombre y correo, antes de escribir deja sus datos, así ningún contacto se pierde aunque nadie esté conectado.

Para verlo, pongamos que hoy ya cerramos. En la tienda, el chat avisa que estamos fuera de horario y pide nombre y correo. La conversación llega igual a la bandeja, para responderla al día siguiente.

15. Sonido y notificaciones del visitante

Arriba, en la misma pestaña, están los avisos para el visitante. Reproducir un sonido suena cuando tu equipo responde y el chat está minimizado o la pestaña está en segundo plano.

Y las notificaciones del navegador hacen parpadear el título de la pestaña y, si el visitante lo permite, muestran un aviso de escritorio. Además, el botón del chat muestra un contador rojo con los mensajes sin leer.

Si el visitante cerró el chat y tu agente le responde, el chat se vuelve a abrir solo con el mensaje nuevo, para que no se le pase. Probémoslo: el visitante pregunta algo y minimiza el chat; Valeria responde desde la bandeja, y en la tienda el chat se vuelve a abrir solo, con su respuesta.

16. Apertura automática

La pestaña Disparadores empieza con cuatro comportamientos listos, todos apagados por defecto. Abrir automáticamente tras un retraso abre el chat solo después de unos segundos. La burbuja de saludo proactivo muestra un mensaje junto al botón, en español, inglés y portugués, sin abrir el chat.

Abrir automáticamente en estas páginas lo abre solo en las rutas que escribas, una por línea, como el carrito. Y Abrir al detectar intención de salida lo abre cuando el cursor se va hacia arriba, a punto de cerrar la pestaña; eso solo pasa en computadora.

Dos reglas para que no moleste: si el visitante cierra el chat, no se vuelve a abrir solo en treinta segundos, y en el celular nunca se abre solo. Activamos la apertura en el carrito y lo comprobamos.

17. Burbuja proactiva y foto del asesor

En Apariencia, el bloque Burbuja proactiva y atención decide cómo se ven esos saludos. Le pones la foto y el nombre de un asesor, y el punto verde de en línea, para que el saludo se sienta de una persona real.

Eliges la animación de entrada, si las burbujas se apilan o se reemplazan una a otra, y un sonido sutil al aparecer.

La foto del asesor también puede reemplazar el ícono del botón, como vimos antes. Si no subes una foto aquí, se usa el avatar del encabezado.

18. Disparadores: el primero paso a paso

Debajo están los disparadores de comportamiento: reglas que tú armas. Cada una tiene un Cuándo, con una o varias condiciones, y un Entonces, con la acción. Creemos una: cuando alguien lleva diez segundos mirando la página de carpas.

Agregamos la condición La URL contiene carpas, y otra de tiempo en la página: diez segundos. Con la lógica Todas las condiciones, tienen que cumplirse las dos.

La acción: mostrar una burbuja de saludo, dividida en una secuencia de dos mensajes. Y cuando el visitante abra el chat, iniciamos una conversación con Vela, nuestra agente de IA, con el objetivo de ayudarle a elegir su carpa.

Guardamos y vamos a la tienda. Entramos a carpas, esperamos, y aparecen las dos burbujas. Al abrir el chat, Vela ya está escribiendo, y sabe en qué página está el visitante.

19. Todas las condiciones y la lógica Y/O

Estas son todas las condiciones: tiempo en la página, cuánto bajó por la página, en porcentaje o en píxeles, intención de salida, la dirección de la página, inactividad, el dispositivo, sea computadora, celular o tableta, y El visitante abre el chat.

Para la dirección tienes cuatro operadores: contiene, es exactamente, empieza con y no contiene. Por ejemplo, solo la portada es la ruta barra con Es exactamente. Y con Cualquier condición, basta que se cumpla una. Cada disparador admite hasta diez condiciones, y puedes tener treinta disparadores.

Inactividad se cumple cuando el visitante deja de mover el mouse, hacer scroll o escribir durante los segundos que indiques, desde cinco. Y El visitante abre el chat sirve para acciones que deben pasar solo cuando la persona ya mostró interés.

20. Todas las acciones, frecuencia y ocultar

En el Entonces puedes abrir el widget, mostrar una burbuja, ocultar el widget, enviar un mensaje automático y luego asignar la conversación, iniciar una conversación con IA, asignar a una persona, un equipo o un agente de IA, ejecutar un flujo de trabajo, o mostrar el selector de departamentos o el formulario.

La frecuencia decide cada cuánto se repite: una vez por sesión, en cada carga de página, cada vez que se cumpla, una vez por día, o una sola vez por visitante. Y Ocultar burbujas automáticamente las retira después de unos segundos si nadie las toca.

Las acciones del servidor, como enviar un mensaje, asignar o ejecutar un flujo, se hacen una sola vez por conversación, aunque el visitante recargue. Y en Mostrar una burbuja puedes agregar, en Cuando el visitante abra el chat, varias acciones que corren en orden.

21. Saludo contextual con IA

En la pestaña IA está el saludo contextual: cuando el visitante abre el chat, la IA lee la página en la que está y escribe una bienvenida a la medida. No necesitas crear ningún agente: usa el motor de la plataforma.

El tiempo de espera decide cada cuánto saluda a la misma persona; una vez por sesión es lo recomendado, porque cada saludo consume IA. Lo activamos y abrimos el chat en la página de envíos: el saludo habla justamente de envíos. Si el visitante responde, ese saludo queda guardado en la conversación.

Si tienes el saludo con IA y además un disparador que inicia una conversación con IA al abrir el chat, el visitante recibiría dos saludos: usa uno de los dos en cada página.

22. El agente de IA del canal

Para que un agente de IA responda los mensajes, ve a la pantalla de Inteligencia Artificial del canal. Elige el agente, aquí Vela, y la estrategia de respuesta: Deshabilitado, Siempre, o Solo conversaciones nuevas.

Desde ahora Vela contesta. Un visitante pregunta por el envío a Cuenca y Vela responde con los datos reales de la tienda. Cuando pide hablar con una persona para comprar, Vela le pasa la conversación al equipo de Ventas: en la bandeja llega asignada, con un resumen de la IA, y Vela queda en pausa para que conteste una persona. Cómo crear y entrenar al agente lo tienes en la guía completa de Agentes de IA.

Con Siempre, Vela responde mientras la conversación esté a su cargo; en cuanto una persona la toma o la transfiere a un equipo, Vela deja de contestar. Con Solo conversaciones nuevas, toma las que empiezan desde ese momento y deja en paz las que ya existían.

23. Lo que puede hacer el visitante

Del lado del visitante, el chat tiene todo lo que espera de una mensajería moderna. Con el clip adjunta fotos, PDF, audio o video, de hasta veinte megas; las imágenes se ven en miniatura y se amplían con un clic.

Tiene su propio panel de emojis, y con el micrófono graba una nota de voz de hasta tres minutos. Los enlaces se vuelven clicables, y tus mensajes pueden llevar negrita y listas.

Mientras tu agente escribe, el visitante ve el aviso de escribiendo, y tu agente también ve cuando el visitante escribe. Y cada mensaje marca cuándo se entregó y cuándo se leyó.

24. Atender desde la bandeja

En la bandeja, las conversaciones del Webchat llevan el ícono del chat web. El punto verde indica que el visitante está en línea ahora mismo, con el sitio abierto.

En el panel del contacto, Visitante web muestra la página desde la que escribió, de dónde llegó, las páginas desde las que ha escrito y su navegador y dispositivo. Y si llenó el formulario, sus respuestas están en Pre-chat.

Respondes como en cualquier canal: con respuestas rápidas, como barra envío, notas internas para tu equipo, o asignando a un compañero. Todo llega al visitante al instante.

Si el visitante cierra la pestaña, el punto se apaga y la cabecera muestra cuándo se le vio por última vez. Tu respuesta le llega igual: la verá en cuanto vuelva a tu sitio en ese navegador.

25. Resolver, encuesta y transcripción

Cuando el caso termina, marcas la conversación como resuelta. El visitante ve el aviso de que la conversación fue resuelta y, si tu encuesta de satisfacción está activa, califica la atención ahí mismo, con estrellas y un comentario.

La calificación llega a la conversación y a tus reportes. Si la transcripción por email está activa, el visitante puede pedir que le llegue una copia del chat a su correo. Y con Iniciar nueva conversación empieza otra cuando quiera.

26. El visitante que vuelve

El Webchat recuerda al visitante en ese navegador. Si recarga, cambia de página o vuelve más tarde, ve su conversación tal como la dejó.

Si escribe de nuevo poco después de resolverse, la misma conversación se reabre, y en tu bandeja sigue siendo el mismo contacto, con todo su historial.

Por eso, cuando un cliente comparte computadora o cambia de cuenta en tu sitio, conviene llamar a Omnifox.logout al cerrar sesión: el widget olvida al visitante anterior y el siguiente empieza de cero.

27. En el celular

En el celular, el chat se abre en pantalla completa y se acomoda al teclado. Abajo tiene un botón grande, Volver al sitio web, para que nadie se quede atrapado si lo abrió sin querer; también funciona el botón de atrás del teléfono.

El texto junto al botón puede mostrarse solo en celular o solo en computadora, y en el celular el chat nunca se abre solo: las burbujas sí aparecen, y el visitante decide si las toca.

La vista previa del editor muestra el chat de computadora, así que, después de cambios grandes, ábrelo también desde tu teléfono para ver cómo queda.

28. Identificación segura de usuarios

Si tu sitio tiene clientes que inician sesión, la pestaña Identificación de usuarios te permite reconocerlos de forma segura. Tu servidor firma el identificador del usuario con esta clave secreta, y tu página le pasa al widget ese identificador, la firma y sus datos.

Aquí están los ejemplos en PHP, Node y Python, y la llamada Omnifox.identify. La clave nunca va en el navegador, y si la regeneras, las firmas anteriores dejan de valer al instante.

En la tienda, Martina inicia sesión y abre su cuenta; el sitio la identifica con su firma. Escribe, y en la bandeja la conversación llega a nombre de Martina Gómez, con su correo, unida a su ficha de cliente aunque cambie de computadora.

29. API de JavaScript y atributos

Para desarrolladores, el widget tiene una pequeña API. Omnifox.open abre el chat, close lo cierra, toggle alterna, isOpen dice si está abierto, y logout borra la sesión del visitante, por ejemplo cuando tu cliente cierra sesión.

En la tienda, el botón Hablar con un asesor abre el chat con Omnifox.open. Y el código de inserción acepta atributos para cambiar en una página el color, la posición, el nombre, el saludo, el idioma o una burbuja personalizada.

Además, el widget envía eventos a tu Google Analytics o Tag Manager: se cargó, se abrió, empezó una conversación y envió un mensaje. Así mides cuántas ventas empiezan en el chat.

Un consejo: como el código se carga de forma asíncrona, si llamas a la API apenas carga la página, espera al evento load del navegador, o usa la cola de comandos que muestra la pestaña Identificación.

30. Co-browse

Las conversaciones del Webchat tienen además el botón de Co-browse, para ver la pantalla del visitante y guiarlo dentro de tu sitio, con su permiso. Es un complemento, y tiene su propia guía completa: el enlace está en la descripción.

31. Buenas prácticas

Algunas buenas prácticas: usa un saludo corto y concreto, y dispáralo solo donde ayuda, como en el carrito o en páginas de precios. No pidas en el formulario más datos de los necesarios. Define tu horario y un mensaje de ausencia honesto.

Conecta un agente de IA para responder al instante y transferir a una persona lo que importa. Y revisa de vez en cuando Instalaciones detectadas, para saber dónde está tu chat.

32. Solución de problemas

Si el chat no aparece, revisa que el código esté en todas las páginas, que el canal no esté pausado, y prueba en una ventana de incógnito, sin extensiones que bloqueen scripts. Si un cambio no se ve, recarga la página: el widget lee tu configuración en cada carga.

Si el formulario o los departamentos no vuelven a salir, es a propósito: el widget no le pregunta dos veces a quien ya tiene una conversación abierta. Prueba en incógnito. Y si la nota de voz no graba, el visitante tiene que permitir el micrófono en su navegador.

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp