🌐 Widget de Chat Web

El Widget de Chat Web es una burbuja de chat JavaScript embebible que se puede agregar a cualquier sitio web. Cuando los visitantes envían un mensaje a través del widget, aparece en la bandeja de PulseHub como cualquier otro canal.

---

Agregar el Widget a Tu Sitio Web

1. Agregar un Canal de Chat Web en PulseHub

1. Ve a Canales → Agregar Canal
2. Selecciona Widget de Chat Web
3. Ingresa un nombre y saludo/color opcionales
4. Haz clic en Guardar Canal
5. Anota el ID del Canal de la tarjeta

2. Embeber el Script

<script
  src="https://tudominio.com/public/js/webchat-widget.js"
  data-channel="TU_ID_DE_CANAL"
  data-greeting="¡Hola! ¿Cómo podemos ayudarte hoy?"
  data-color="#10b981">
</script>

---

Opciones de Configuración del Widget

Atributo	Predeterminado	Descripción
data-channel	requerido	El UUID del canal de PulseHub
data-greeting	Hi! How can we help you?	Mensaje mostrado cuando el chat se abre por primera vez
data-color	#10b981	Color hexadecimal para el botón y los mensajes enviados

---

Cómo Funcionan las Sesiones

El widget almacena dos valores en localStorage:

• ph_contact_{channel_id} — el UUID del contacto
• ph_conv_{channel_id} — el UUID de la conversación

Esto significa que los visitantes que cierran la pestaña y regresan continúan la misma conversación.

---

Solicitudes Cross-Origin

Si PulseHub está en un dominio diferente al de tu sitio web, agrega headers CORS:

<IfModule mod_headers.c>
    Header set Access-Control-Allow-Origin "https://tusitio.com"
    Header set Access-Control-Allow-Methods "GET, POST, PATCH, DELETE, OPTIONS"
    Header set Access-Control-Allow-Headers "Content-Type, X-Webchat-Channel"
</IfModule>

---

Nota de Seguridad

Los endpoints de la API de Chat Web aceptan solicitudes de usuarios no autenticados cuando el header X-Webchat-Channel está presente. Asegura la limitación de tasa a nivel de servidor web o firewall.