Integrar un Chat Web de wolkvox en tu sitio usando variables (sin formulario)
Table of Contents
Introducción
En wolkvox Manager puedes crear un Chat Web para integrarlo en tu sitio mediante un script. En el escenario estándar, el usuario completa un formulario (nombre, teléfono, email, etc.) y luego el chat se enruta a un skill para ser atendido por un agente o un bot.
Cuando tu sitio ya tiene esos datos (por ejemplo, usuario autenticado, formulario previo, CRM propio, checkout, etc.), puedes integrar el widget pasando los datos como variables para que el cliente no tenga que diligenciarlos de nuevo.
Importante: cada valor enviado en las variables debe ir en Base64.
Configuración
Ubica el Chat Web y abre el “Script de Integración”
- En wolkvox Manager, entra a “Configuración”.
- Ve a la sección “Omni Channel” y selecciona “Chat WEB”.
- En Configuración de widgets, ubica tu widget de chat web creado previamente.
- Haz clic en el ícono de script / integración (el botón con ícono ‘</>’).
- Se abrirá una ventana llamada “Script de Integración”, donde verás el script estándar y el botón “Copiar script”.


En esta ventana identificas el valor de prodId del script estándar, por ejemplo:
<!-- START CHATBOX WOLKVOX-->
<script id="prodId" type="text/javascript" src="https://widget01.wolkvox.com/chat/?prodId=a1a1a1a1" async=""></script>
<!-- END CHATBOX WOLKVOX-->
Conserva el prodId y construye el script con variables
Usa el mismo prodId y añade los parámetros txt1, txt2, etc. (según los campos que uses en tu operación). Plantilla:
<!-- START CHATBOX WOLKVOX (con variables) -->
<script id="prodId" type="text/javascript"
src="https://widget01.wolkvox.com/chat/?prodId={id}&txt1={nombre}&txt2={telefono}&txt3={email}&txt4={identificacion}&txt5={campo_extra}&txt6={comentario}"
async=""></script>
<!-- END CHATBOX WOLKVOX -->
Qué significa esto:
- {id} = el prodId real copiado desde el “Script de Integración”.
-
txt1…txt6 = valores que viajan como datos del cliente (nombre, teléfono, correo, etc.).
- El mapeo exacto de qué representa cada txt# depende de cómo tengas definidos los campos del chat / formulario (si tu operación usa txt1 para “Nombre”, perfecto; si lo usa para otro campo, debes respetar ese orden).
Codifica cada valor a Base64 (obligatorio):
Antes de insertarlos en el script, convierte cada valor a Base64.
Ejemplo rápido en JavaScript (navegador)
// Base64 seguro para textos con acentos/UTF-8
function toBase64(str) {
return btoa(unescape(encodeURIComponent(str)));
}
const nombre = toBase64("María Gómez");
const telefono = toBase64("573001112233");
const email = toBase64("maria@empresa.com");
const identificacion = toBase64("CC123456789");
const campoExtra = toBase64("Plan Premium");
const comentario = toBase64("Vengo desde la sección de facturación");
Luego construyes el src con esos valores ya codificados.
Inserta el script en tu sitio (HTML)
Ejemplo final (con valores ilustrativos; reemplaza por los tuyos ya en Base64):
<script id="prodId" type="text/javascript"
src="https://widget01.wolkvox.com/chat/?prodId=a1a1a1a1&txt1=TWFyw61hIEfDs21leg==&txt2=NTczMDAxMTEyMjMz&txt3=bWFyaWFAZW1wcmVzYS5jb20=&txt4=Q0MxMjM0NTY3ODk=&txt5=UGxhbiBQcmVtaXVt&txt6=VmluZ28gZGVzZGUgbGEgc2VjY2nDs24gZGUgZmFjdHVyYWNpw7Nu"
async=""></script>