Skip to content

Instalar el Webchat en el sitio web ​

Acceso

Ruta: ¡Hola! Store → Webchat → Instalar

Visión general ​

El Webchat te permite poner una ventana de chat en el sitio web de tu empresa y recibir las conversaciones de los visitantes en ¡Hola! Suite. Así, quien accede al sitio habla con tu equipo sin salir de la página, y la atención entra en la misma fila de los demás canales, pudiendo pasar por el agente virtual y por el flujo de comunicación.

Para funcionar, ¡Hola! Suite genera un script que debe pegarse en el encabezado del sitio. También eliges cómo se identifica el visitante: sin inicio de sesión, con la cuenta de Google o con la cuenta de Facebook. No hay cobro por mensaje: el costo es el de la licencia de la app.

Si tu empresa tiene una aplicación propia y quiere conectar su chat a ¡Hola! Suite, sin la ventana del sitio, consulta Integrar una aplicación propia al Webchat (modo API).

Requisitos previos ​

  • Licencia de la app Webchat contratada. Sin licencia, la página de la app muestra el botón Obtener, que abre una conversación con el equipo comercial. Cada Webchat instalado usa una licencia.
  • Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
  • Agente virtual ya creado en ¡Hola! Suite. Será el responsable del canal.
  • Acceso al código del sitio (o a quien se encarga del sitio) para pegar el script en el encabezado.
  • Para inicio de sesión con Google: una cuenta de Google con acceso a Google Cloud Console.
  • Para inicio de sesión con Facebook: una cuenta en Meta for Developers.

Paso a paso ​

Instalar el Webchat y pegar el script ​

  1. Accede a ¡Hola! Store y abre la app Webchat.
  2. Haz clic en Instalar. Si ya existe un Webchat, haz clic en Acceder y después en Añadir nuevo.
  3. En la ventana Instalar Webchat, completa los campos:
    • Nombre: nombre para identificar el canal dentro de ¡Hola! Suite.
    • Agente virtual: el agente virtual que recibirá las conversaciones de este canal.
  4. Haz clic en Guardar. El sistema abre las configuraciones del canal. En la primera instalación, por el botón Instalar, aparece la ventana Agrega el script a tu sitio web.
  5. Haz clic en Copiar y cerrar. Si la ventana no aparece (por ejemplo, al usar Añadir nuevo), haz clic en Copiar código, en la sección Script.
  6. Envía el script a quien se encarga del sitio y pide que lo pegue en el encabezado (Header) de todas las páginas en las que debe aparecer el chat.
  7. Abre el sitio y verifica si aparece la ventana del chat.

El Webchat se instala con Permitir acceso sin inicio de sesión activo. Para copiar el script de nuevo después, accede al registro del canal y haz clic en Copiar código, en la sección Script.

¿Cambiaste el inicio de sesión? Copia el script de nuevo

Las formas de inicio de sesión y los tokens forman parte del script. Siempre que cambies la sección Formatos de inicio de sesión, copia el script otra vez y reemplaza el antiguo en el sitio. Sin eso, el sitio sigue con la configuración anterior.

Configurar el inicio de sesión con Google ​

El inicio de sesión con Google necesita dos datos creados en Google Cloud Console: un ID de cliente OAuth y una Clave de API. El botón de Google solo aparece en el chat con los dos campos completados. Los nombres de los menús de Google pueden cambiar; en caso de duda, consulta la documentación de Google sobre credenciales OAuth.

  1. Accede a Google Cloud Console con la cuenta de Google de la empresa.
  2. Crea un proyecto nuevo o selecciona uno existente.
  3. Accede a APIs y servicios → Pantalla de consentimiento de OAuth y completa los datos de la aplicación, como nombre, correo electrónico de soporte, política de privacidad y dominio del sitio.
  4. Accede a APIs y servicios → Credenciales → Crear credenciales → ID de cliente de OAuth.
  5. En Tipo de aplicación, elige Aplicación web y dale un nombre.
  6. En Orígenes JavaScript autorizados, agrega la dirección del sitio, sin la barra al final (ej.: https://www.suaempresa.com.br). Si el chat está en más de un dominio, agrégalos todos.
  7. Crea la credencial y copia el ID del cliente.
  8. En el mismo proyecto, accede a Credenciales → Crear credenciales → Clave de API y copia la clave generada.
  9. En ¡Hola! Suite, abre el registro del Webchat y haz clic en Editar información en la sección Formatos de inicio de sesión.
  10. Activa Permitir inicio de sesión con Google.
  11. Pega el ID del cliente en Token Google OAuth y la clave de API en Token Google.
  12. Guarda y copia el script de nuevo al sitio.

Configurar el inicio de sesión con Facebook ​

El inicio de sesión con Facebook usa el ID de la Aplicación (App ID) de una app creada en Meta for Developers.

  1. Accede a Meta for Developers con la cuenta que administra la página de la empresa.
  2. En Mis apps → Crear app, sigue los pasos de Meta.
  3. Agrega el producto Inicio de sesión con Facebook a la app, activa el inicio de sesión con el SDK de JavaScript e informa el dominio del sitio en Dominios permitidos para el SDK de JavaScript. Los nombres de los menús de Meta pueden cambiar; en caso de duda, consulta la documentación de Meta sobre el Inicio de sesión con Facebook para la Web.
  4. Copia el ID de la Aplicación, que aparece en el panel de la app.
  5. En ¡Hola! Suite, abre el registro del Webchat y haz clic en Editar información en la sección Formatos de inicio de sesión.
  6. Activa Permitir inicio de sesión con Facebook y pega el ID de la aplicación en Token Facebook.
  7. Guarda y copia el script de nuevo al sitio.

Resultado esperado ​

La app aparece como instalada y el botón Acceder pasa a abrir la lista de canales del Webchat, con las columnas Nombre, Estado, Agente Virtual y Flujo de comunicación.

La ventana del chat aparece en el sitio. Cuando el visitante envía el primer mensaje, la atención llega a ¡Hola! Suite y sigue el agente virtual y el flujo de comunicación configurados.

Configuraciones disponibles ​

Para ajustar el canal, accede a ¡Hola! Store → Webchat → Acceder y haz clic en el registro. En cada sección, haz clic en Editar información, haz los cambios y guarda.

Datos de registro ​

CampoQué hace
NombreNombre de identificación del canal.
EstadoActivo o Inactivo. Para activarlo, necesitas tener una licencia de Webchat libre.
Agente virtualAgente virtual responsable del canal.

Script ​

Muestra el código que va en el encabezado del sitio. Haz clic en Copiar código para copiarlo.

Formatos de inicio de sesión ​

Define si el visitante necesita identificarse para conversar y con qué cuentas.

CampoQué hace
Permitir acceso sin inicio de sesiónEl visitante conversa sin identificarse.
Permitir inicio de sesión con GoogleMuestra la opción de entrar con la cuenta de Google. El nombre, el correo electrónico y la foto de la cuenta van al contacto. Exige Token Google OAuth y Token Google.
Permitir inicio de sesión con FacebookMuestra la opción de entrar con la cuenta de Facebook. Exige Token Facebook.

Integrar aplicación propia ​

Conecta el Webchat a una aplicación de tu empresa, sin la ventana de chat del sitio. Consulta Integrar una aplicación propia al Webchat (modo API).

Preferencias ​

CampoQué hace
Prioridad de atención en la filaOrden del canal en la fila: Muy alta, Alta, Media, Baja o Muy baja. Los canales con mayor prioridad aparecen primero.
Mostrar el nombre del agente en el encabezado de los mensajesMuestra al visitante el nombre del agente en la parte superior de los mensajes.
Verificar si el contacto es humanoConfirma que quien escribe es una persona antes de abrir la atención.

Con Verificar si el contacto es humano activo, el agente virtual pregunta "¿Eres humano?" antes de abrir la primera atención del contacto, con las opciones Sí y No en orden aleatorio. La atención solo se abre si la persona responde Sí. Después de eso, la pregunta no se repite para ese contacto. Si la respuesta es No, no se abre ninguna atención y la pregunta vuelve en el próximo mensaje.

Aviso de posición en la fila

El aviso automático de posición en la fila no se configura en el canal. Está en el departamento, en Avisar posición en la fila.

Desinstalar la app ​

  1. Accede a ¡Hola! Store → Webchat → Acceder y abre el registro.
  2. Haz clic en Desinstalar app.
  3. Escribe el Nombre del Canal exactamente como está registrado. El botón Desinstalar solo se habilita cuando el nombre coincide.
  4. Haz clic en Desinstalar.
  5. Elimina el script del encabezado del sitio.
Las atenciones en curso se interrumpen

Al desinstalar, se deshace la conexión con el Webchat. Las atenciones en curso se interrumpen, y las atenciones ya finalizadas pierden el vínculo con el canal, lo que puede afectar las métricas.

Problemas comunes ​

SíntomaQué verificar
La ventana del chat no aparece en el sitioVerifica si el script se pegó en el encabezado (Header) de todas las páginas.
El botón de inicio de sesión con Google no apareceLos campos Token Google OAuth y Token Google deben estar completados, y el script debe haberse copiado de nuevo después de guardar.
El inicio de sesión con Google da errorVerifica si la dirección del sitio está en Orígenes JavaScript autorizados en Google Cloud Console, sin barra al final.
El inicio de sesión con Facebook no funcionaVerifica si el campo Token Facebook tiene el ID de la Aplicación (no un token de acceso) y si el dominio del sitio está configurado en la app de Meta.
Aparece el botón Obtener aun con la app contratadaUsa Sincronizar licencia en Configuraciones → Acerca de. Si continúa, habla con el equipo comercial.

Buenas prácticas ​

  • Mantén Permitir acceso sin inicio de sesión activo si el objetivo es captar contactos rápidos. Usa los inicios de sesión sociales cuando sea importante identificar quién está hablando.
  • Ofrece solo las formas de inicio de sesión que vas a mantener configuradas.
  • Siempre que cambies el inicio de sesión, copia el script de nuevo y actualiza el sitio.
  • Usa un Nombre que identifique el sitio (ej.: "Webchat - Sitio institucional"), principalmente si la empresa tiene más de uno.

Contenidos relacionados ​