Chat en vivo en su sitio web
Actualizado 21 de octubre de 2026
El fragmento de código de la pestaña Código widget del canal es todo lo que un sitio web necesita: péguelo una vez y el botón de chat, el mensaje de bienvenida y el formulario de contacto aparecen en todas las páginas. Este artículo es para los sitios que quieren más: abrir el chat desde sus propios botones, seguirlo en su analítica, ahorrar el formulario a los clientes que ya han iniciado sesión, o limitar dónde aparece el widget. Todo lo que se describe aquí es opcional; un sitio que no cambia nada sigue funcionando como hasta ahora.
Antes de empezar
- Un canal de chat en vivo con su fragmento ya en el sitio; consulte Canal de chat en vivo.
- Alguien que pueda editar el HTML del sitio web. Ahorrar el formulario a los clientes con sesión iniciada exige además un pequeño cambio en su propio servidor.
- Configuración de cuenta en Completo, o ser el propietario de la cuenta, para abrir la pestaña Código widget del canal.
Dónde encontrarlo
Ajustes → Canales → el icono de edición de la fila Live-chat → pestaña Código widget, o vaya a https://app.pluspoint.io/account-settings/channels.
Abrir el chat desde su propio botón
Copie el fragmento de la pestaña Código widget. Además de cargar el widget, define una función pluspoint que su página puede llamar desde cualquier punto, incluso antes de que el widget haya terminado de cargarse: las llamadas tempranas se ejecutan en cuanto está listo. Con el identificador de su canal en lugar de las X, tiene este aspecto:
<!-- Pluspoint script -->
<script>window.pluspoint=window.pluspoint||function(){(window.pluspoint.q=window.pluspoint.q||[]).push(arguments)};"loading"!==document.readyState?init():document.addEventListener("DOMContentLoaded",init);function init(){var t=document.createElement("script");t.id="pl-chat-widget",t.dataset.channelid="XXXXXXXXXX",t.src="https://app.pluspoint.io/widget/pl.widget.chat.min.js",document.getElementsByTagName("body")[0].appendChild(t)}</script>
<!-- End of Pluspoint script -->
Un fragmento copiado antes de que existiera la parte window.pluspoint= sigue mostrando el chat, pero pluspoint(...) no está definido en esa página. Cópielo de nuevo una sola vez.
Después llame a pluspoint('open') desde cualquier elemento de la página:
<button onclick="pluspoint('open')">Chatee con nosotros</button>
| Comando | Qué hace |
|---|---|
pluspoint('open') | Abre la ventana del chat. |
pluspoint('close') | Cierra la ventana del chat; el botón de chat se queda. |
pluspoint('setLocation', '123') | Asigna la conversación a esa localización y omite la pregunta de localización. Use el mismo ID que acepta el enlace del chat en ?locationId=. |
pluspoint('setLanguage', 'ES') | Cambia el chat a ese idioma: GB, UA, PT, ES, PL, DE, BR, FR, RU o MX. El mensaje de bienvenida y el mensaje offline salen de la pestaña Mensajes del canal, así que añada ese idioma allí también. |
pluspoint('identify', {…}) | Entrega los datos de un cliente con sesión iniciada para que pueda saltarse el formulario; véase más abajo. |
pluspoint('forget') | Descarta esos datos y la conversación en ese navegador; véase más abajo. |
setLocation e identify determinan la siguiente conversación. Una conversación ya abierta en ese navegador conserva su localización y su contacto; para probar, use una página en la que todavía no haya chateado o una ventana privada del navegador.
Seguir el chat en su analítica
Registre un manejador con pluspoint('on', evento, manejador). Recibe un único argumento, por ejemplo { type: 'opened' }, así que un mismo manejador puede atender varios eventos:
<script>
pluspoint('on', 'firstMessageSent', function (event) {
gtag('event', 'live_chat_' + event.type);
});
</script>
| Evento | Cuándo se emite |
|---|---|
opened | Se abre la ventana del chat, desde el botón de chat o desde pluspoint('open'). |
closed | Se cierra la ventana del chat. |
firstMessageSent | El primer mensaje del visitante ha llegado y la conversación ya existe en su bandeja de entrada. |
conversationResolved | La conversación se resuelve mientras el visitante todavía tiene la página abierta. |
Los eventos no llevan datos de contacto ni texto de mensajes: solo el tipo de evento. pluspoint('off', 'firstMessageSent', manejador) detiene un manejador que haya registrado.
Ahorrar el formulario a los clientes con sesión iniciada
Cuando su sitio ya sabe quién es el visitante, puede entregar sus datos al chat. El visitante entonces escribe y la conversación empieza, sin formulario, siempre que se hayan entregado todos los datos que el canal exige. Cuando falta algo, por ejemplo si el chat exige un teléfono y su sitio solo conoce el correo, el formulario muestra únicamente los campos que faltan. El sexo y la fecha de nacimiento no se pueden entregar, así que un chat que los exige los pide. Cuando entrega un ID de cliente, un correo o un teléfono, solo los pide la primera vez en cada navegador. Los datos entregados nunca se muestran al visitante, y la bandeja de entrada los presenta exactamente como si el visitante los hubiera escrito; no hay ninguna marca de verificación.
-
En la pestaña Código widget, en Clientes con sesión iniciada, copie el secreto. Cualquier persona que pueda editar el canal puede copiarlo o reemplazarlo. Guárdelo en su servidor y nunca lo ponga en la página.
-
En su servidor, al servir una página a un cliente con sesión iniciada, una los datos del cliente en una sola cadena (
customerId,name,email,phoneytimestamp, en ese orden, separados por saltos de línea, con una línea vacía para cada dato que no envíe) y fírmela con HMAC-SHA256 usando el secreto, en hexadecimal. Eltimestampes la hora actual en segundos unix, y la firma vale durante 15 minutos, así que genérela al servir la página, no al compilar el sitio ni desde una caché.const crypto = require('crypto'); function signChatVisitor(customer) { const timestamp = Math.floor(Date.now() / 1000); const details = { customerId: customer.id, name: customer.fullName, email: customer.email, phone: customer.phone, }; const canonical = [details.customerId, details.name, details.email, details.phone, timestamp] .map((value) => value ?? '') .join('\n'); const signature = crypto .createHmac('sha256', process.env.PLUSPOINT_CHAT_SECRET) .update(canonical) .digest('hex'); return { ...details, timestamp, signature }; } -
Ponga el resultado en la página y entréguelo:
<script> pluspoint('identify', { customerId: '48213', name: 'Ana Souza', email: 'ana@example.com', phone: '+34600000000', timestamp: 1792540800, signature: '3b9f2c…' }); </script> -
Cuando el cliente cierre sesión, llame a
pluspoint('forget'). Descarta los datos entregados y la conversación guardada en ese navegador, de modo que la siguiente persona en un ordenador compartido empieza de cero. Llámelo solo al cerrar sesión, no en cada carga de página.
Envíe las cadenas exactamente como las firmó: un nombre recortado o un teléfono con otro formato invalida la firma. Todos los datos son opcionales, pero al menos uno debe estar presente. customerId es su propio identificador estable del cliente, para que todos sus chats acaben en un único contacto. Los teléfonos van en formato internacional, como +34600000000.
Para saludar por su nombre a un cliente entregado con name, escriba [name|cliente] en el mensaje de bienvenida de la pestaña Mensajes del canal. Los visitantes sin un nombre entregado leen cliente.
Una conversación ya abierta en ese navegador no cambia con identify: conserva el contacto con el que empezó, y los datos se aplican a la siguiente. Cuando identify entrega un cliente distinto del último de ese navegador, la conversación guardada allí se descarta antes, como con forget.
Seleccione Reemplazar secreto cuando el secreto pueda haberse filtrado o cuando alguien que lo tenía deje la empresa. Las firmas hechas con el secreto anterior dejan de valer de inmediato: las páginas que sigan firmando con él vuelven a mostrar el formulario hasta que su servidor use el nuevo.
Limitar los sitios en los que aparece su chat
En la pestaña Código widget, en Sitios permitidos, introduzca los dominios en los que el widget puede aparecer, hasta 50. example.com cubre example.com y todos sus subdominios, como www.example.com y shop.example.com; www.example.com cubre solo ese host. Con la lista vacía, el widget aparece en cualquier sitio que lleve su fragmento, como hasta ahora.
Sus micrositios y el enlace del chat funcionan siempre, diga lo que diga la lista. En cualquier otro sitio el widget no muestra nada en absoluto (ni botón de chat ni error), que es también lo que verá al probar desde un dominio de pruebas o un archivo local que no haya incluido en la lista.
Resolución de problemas
| Síntoma | Causa | Solución |
|---|---|---|
Su botón no hace nada, o la consola del navegador dice pluspoint is not defined | Falta el fragmento en esa página, se copió antes de que existiera la parte window.pluspoint=, o su llamada se ejecuta desde un script colocado antes del fragmento. | Copie el fragmento de nuevo desde la pestaña Código widget y póngalo antes de cualquier script que llame a pluspoint. |
| El formulario sigue pidiendo datos que usted entregó | La firma tiene más de 15 minutos (una página en caché, o un reloj del servidor desajustado), se hizo con otro secreto, o un dato se envió sin firmarlo. Una conversación ya abierta en ese navegador conserva además su propio contacto. | Genere la firma al servir la página, revise el reloj del servidor, copie el secreto de nuevo y firme exactamente las cadenas que envía. Pruebe en una ventana privada del navegador; un identify rechazado se indica en la consola del navegador. |
| El widget es invisible en uno de sus sitios | Ese sitio no está en Sitios permitidos. | Añada su dominio, o vacíe la lista para permitir cualquier sitio. |
setLocation o setLanguage no tienen efecto visible | Ya hay una conversación abierta en ese navegador, así que se conserva la localización; o el código de idioma no está en la lista anterior, lo que la consola del navegador indica. | Pruebe en una ventana privada del navegador y revise la consola. |
Tras setLanguage, los botones cambian de idioma pero el mensaje de bienvenida no | La pestaña Mensajes del canal no tiene textos en ese idioma. | Añada el idioma en la pestaña Mensajes. |