🌐 Widget de Chat Web

O Widget de Chat Web e uma bolha de chat JavaScript incorporavel que pode ser adicionada a qualquer site. Quando visitantes enviam uma mensagem atraves do widget, ela aparece na caixa de entrada do PulseHub como qualquer outro canal.

---

Adicionando o Widget ao Seu Site

1. Adicionar um Canal de Chat Web no PulseHub

1. Va ate Channels → Add Channel
2. Selecione Web Chat Widget
3. Insira um nome e saudacao/cor opcionais
4. Clique em Save Channel
5. Anote o Channel ID do cartao

2. Incorporar o Script

<script
  src="https://yourdomain.com/public/js/webchat-widget.js"
  data-channel="YOUR_CHANNEL_ID"
  data-greeting="Hi! How can we help you today?"
  data-color="#10b981">
</script>

---

Opcoes de Configuracao do Widget

Atributo	Padrao	Descricao
data-channel	obrigatorio	O UUID do canal do PulseHub
data-greeting	Hi! How can we help you?	Mensagem exibida quando o chat abre pela primeira vez
data-color	#10b981	Cor hexadecimal para o botao e mensagens enviadas

---

Como Funcionam as Sessoes

O widget armazena dois valores no localStorage:

• ph_contact_{channel_id} — o UUID do contato
• ph_conv_{channel_id} — o UUID da conversa

Isso significa que visitantes que fecham a aba e retornam continuam a mesma conversa.

---

Requisicoes Cross-Origin

Se o PulseHub estiver em um dominio diferente do seu site, adicione cabeçalhos CORS:

<IfModule mod_headers.c>
    Header set Access-Control-Allow-Origin "https://yourwebsite.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 Seguranca

Os endpoints da API de Chat Web aceitam requisicoes de usuarios nao autenticados quando o cabeçalho X-Webchat-Channel esta presente. Garanta a limitacao de taxa no nivel do servidor web ou firewall.