API JavaScript del chat web

Con el chat web en tu web, tus páginas tienen un objeto window.KW. Úsalo para pasar al agente lo que tu web ya sabe y para que el agente pueda llevar al visitante por tu web.

Instalar el script

La página del chat web en Komplian te da esta etiqueta con tu propio ID de widget. Pégala en cada página donde quieras que aparezca el chat.

html

<script src="https://api.komplian.com/widget.js" data-widget-id="TU_ID_DE_WIDGET" async></script>

Atributo	Qué hace
`data-widget-id`	Tu chat web. Obligatorio. Cópialo de la página del chat web en Komplian.
`data-language`	Opcional. `es` o `en`. Fija el idioma de los textos del propio chat hasta que la conversación tiene idioma.
`async`	Carga el chat sin ralentizar tu página.

Métodos

Método	Qué hace
`KW.identify({...})`	Le dice al agente quién es el visitante.
`KW.setCapabilities({...})`	Lista las páginas de tu web a las que el agente puede llevar al visitante.
`KW.toggle()`	Abre el chat, o lo cierra si está abierto.

Identificar al visitante

Llama a KW.identify cuando el visitante haya iniciado sesión en tu web.

KW.identify({
  externalId: 'user_123',
  email: 'ana@example.com',
  name: 'Ana Pérez',
  phone: '+34600000000',
  plan: 'premium',
  accountId: 'acct_42',
  customFields: { orders: 7, vip: true }
});

Campo	Qué contiene
`externalId`	El ID del visitante en tu sistema.
`email`, `name`, `phone`	Sus datos de contacto.
`plan`	Su plan o nivel en tu producto.
`accountId`	La cuenta o empresa a la que pertenece en tu sistema.
`customFields`	Hasta 20 claves extra. Una clave usa letras, números, `_`, `.` o `-`. Cada valor es texto, un número o verdadero/falso.

Estos datos vienen de tu página, así que Komplian los trata como contexto no verificado. El agente los usa para responder, pero no prueban quién es el visitante.

Dejar que el agente use tu web

Llama a KW.setCapabilities para listar las páginas de tu web a las que el agente puede llevar al visitante.

KW.setCapabilities({
  navigate: ['/precios', '/cuenta/pedidos']
});

Clave	Qué contiene	Límite
`navigate`	Rutas de tu propia web, que empiezan por `/`. Cualquier otra dirección se ignora.	Hasta 40 rutas.

Cuando el agente sugiere una de estas páginas, el chat muestra un botón para abrirla. Cuando el visitante lo pulsa, el chat abre la página. Tu página recibe además un mensaje del navegador con source: 'komplian-widget', type: 'komplian-host-actions' y actions: [{ kind: 'navigate', path }].

Abrir el chat desde tu propio botón

html

<button onclick="KW.toggle()">Habla con nosotros</button>