Integración web
Una línea de script coloca la ventana de chat en tu sitio web, junto con los métodos y las reglas de idioma que se pueden invocar desde la página.
El {API} que aparece a continuación es la dirección del servicio; la encontrarás en la página «Integración» del panel de administración.
<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
data-keyes la clave pública; cópiala en la página «Integración» del panel de administración.- En la página «Integración», registra los sitios web que pueden incrustar el widget (por ejemplo,
https://shop.example.com); otras webs que obtengan tu clave pública no podrán usarla. Es obligatorio rellenarlo antes de publicar. - Opcionalmente,
data-theme="dark"para usar el estilo oscuro. - Opcionalmente,
data-language="de": si tu sitio web es multilingüe, pasa el idioma de la página actual y el servicio de atención al cliente lo usará por defecto (el visitante aún puede cambiarlo). Los códigos de idioma admitidos están en la Descripción general de la API abierta. - Opcionalmente,
data-language="auto": toma el<html lang>de la página como idioma por defecto; después, cuando la página cambie de idioma (modificando el atributolang, sin necesidad de recargar en una aplicación de página única), la ventana de atención al cliente cambiará automáticamente.
En la página puedes llamar a:
| Método | Función |
|---|---|
AICS.open() / AICS.close() / AICS.toggle() | Abrir, cerrar la ventana de atención al cliente; por ejemplo, para asociarla a un botón «Contactar con atención al cliente» |
AICS.identify(userToken) | Indica al servicio de atención al cliente quién es el cliente después de iniciar sesión (ver Identificar a los clientes con sesión iniciada) |
AICS.setLanguage(code) | Se llama cuando el sitio web cambia de idioma; la ventana de atención al cliente y las respuestas posteriores cambiarán con él, por ejemplo AICS.setLanguage("ja"); también acepta formas como zh-Hans o pt-BR |
AICS.reset() | Se llama cuando el cliente cierra sesión: descarga la ventana de atención al cliente y descarta la sesión actual; al volver a cargar el script se crea una nueva ventana anónima y la siguiente persona no podrá ver la conversación anterior |
Idiomas
- La ventana de atención al cliente muestra el idioma correspondiente según la ubicación del visitante (IP), incluidos los textos de la interfaz y el mensaje de bienvenida; si se ha definido
data-language, se da prioridad al idioma de la página. Si no se puede determinar la ubicación, se usa el «idioma por defecto» configurado en el panel de administración. - La IA responde en el idioma que usa el cliente; si el contenido que envía el cliente no revela el idioma (emojis, número de pedido), se usa el idioma determinado como se indica arriba.
- El cliente puede cambiar el idioma en el menú de idiomas de la cabecera de la ventana, o decir directamente a la IA «responde en inglés». A partir de entonces, la IA seguirá usando ese idioma aunque el cliente escriba en otro.
- Cuando el sitio web cambia de idioma (
AICS.setLanguageo, condata-language="auto", al modificar<html lang>) también cuenta como elección del cliente; entre todas estas formas prevalece la última; el idioma por defecto que se carga al abrir la página no sobrescribe el idioma que haya elegido el cliente. - En «Configuración del bot → Idioma» del panel de administración puedes desactivar la detección por IP, cambiar el idioma por defecto y limitar qué idiomas están disponibles.
- Si se despliega detrás de un proxy inverso o una CDN, es necesario configurar
TRUSTED_PROXIESoCOUNTRY_HEADERen el servidor; de lo contrario, no se obtendrá la IP real del visitante.
¿Te ha resultado útil esta página?
Última actualización:
