🌐 Виджет веб-чата

Виджет веб-чата — это встраиваемый JavaScript-пузырёк чата, который можно добавить на любой сайт. Когда посетители отправляют сообщение через виджет, оно появляется в папке входящих PulseHub, как и в любом другом канале.

---

Добавление виджета на ваш сайт

1. Добавьте канал веб-чата в PulseHub

1. Перейдите в Channels → Add Channel
2. Выберите Web Chat Widget
3. Введите имя и необязательное приветствие/цвет
4. Нажмите Save Channel
5. Запишите Channel ID с карточки

2. Встройте скрипт

<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>

---

Параметры конфигурации виджета

Атрибут	По умолчанию	Описание
data-channel	обязательно	UUID канала из PulseHub
data-greeting	Hi! How can we help you?	Сообщение при первом открытии чата
data-color	#10b981	Hex-цвет кнопки и отправленных сообщений

---

Как работают сессии

Виджет сохраняет два значения в localStorage:

• ph_contact_{channel_id} — UUID контакта
• ph_conv_{channel_id} — UUID беседы

Это означает, что посетители, закрывшие вкладку и вернувшиеся, продолжат тот же разговор.

---

Кросс-доменные запросы

Если PulseHub находится на другом домене, добавьте 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>

---

Примечание по безопасности

Эндпоинты API веб-чата принимают запросы от неаутентифицированных пользователей при наличии заголовка X-Webchat-Channel. Обеспечьте ограничение частоты запросов на уровне веб-сервера или фаервола.