🌐 Widget de Chat Web

Le Widget de Chat Web est une bulle de chat JavaScript intégrable qui peut être ajoutée à n'importe quel site web. Quand les visiteurs envoient un message via le widget, il apparaît dans la boîte de réception PulseHub comme n'importe quel autre canal.

---

Ajouter le Widget à Votre Site Web

1. Ajouter un Canal Chat Web dans PulseHub

1. Allez dans Canaux → Ajouter un Canal
2. Sélectionnez Widget de Chat Web
3. Entrez un nom et un message d'accueil/couleur optionnels
4. Cliquez sur Enregistrer le Canal
5. Notez l'ID du Canal sur la carte

2. Intégrer le Script

<script
  src="https://votredomaine.com/public/js/webchat-widget.js"
  data-channel="VOTRE_ID_CANAL"
  data-greeting="Bonjour ! Comment pouvons-nous vous aider ?"
  data-color="#10b981">
</script>

---

Options de Configuration du Widget

Attribut	Par Défaut	Description
data-channel	requis	L'UUID du canal PulseHub
data-greeting	Hi! How can we help you?	Message affiché à la première ouverture du chat
data-color	#10b981	Couleur hexadécimale pour le bouton et les messages envoyés

---

Comment Fonctionnent les Sessions

Le widget stocke deux valeurs dans localStorage :

• ph_contact_{channel_id} — l'UUID du contact
• ph_conv_{channel_id} — l'UUID de la conversation

Cela signifie que les visiteurs qui ferment l'onglet et reviennent continuent la même conversation.

---

Requêtes Cross-Origin

Si PulseHub est sur un domaine différent de votre site web, ajoutez les en-têtes CORS :

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

---

Note de Sécurité

Les endpoints de l'API Chat Web acceptent les requêtes d'utilisateurs non authentifiés quand l'en-tête X-Webchat-Channel est présent. Assurez une limitation de débit au niveau du serveur web ou du pare-feu.