📡 Обзор каналов

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

---

Как работают каналы

Провайдер (WhatsApp, Twilio и т.д.)
           │
           │  HTTP POST (webhook)
           ▼
/webhooks/{type}/{channel_id}
           │
           ▼
WebhookController
  1. Проверяет подпись
  2. Нормализует данные
  3. Находит/создаёт контакт
  4. Находит/создаёт беседу
  5. Сохраняет сообщение
  6. Запускает события автоматизации

Каждый канал имеет:

• Уникальный ID (UUID) — это {channel_id} в URL вебхука
• Тип — один из 8 поддерживаемых типов каналов
• Конфигурацию — JSON-объект с учётными данными, специфичными для данного типа канала
• Токен вебхука — случайный 32-символьный шестнадцатеричный токен, генерируемый при создании
• Флаг активности — неактивные каналы отклоняют входящие вебхуки и не отправляют исходящие сообщения

---

Добавление канала

1. Перейдите в Каналы на боковой панели
2. Нажмите Добавить канал
3. Выберите тип канала из выпадающего списка
4. Заполните учётные данные для конкретного типа (см. руководство каждого канала)
5. Нажмите Сохранить канал

После сохранения карточка канала отображает URL вебхука. Скопируйте этот URL и вставьте его в панель разработчика вашего провайдера.

---

Формат URL вебхука

https://yourdomain.com/webhooks/{type}/{channel_id}

---

Поддерживаемые каналы

Канал	Направление	Проверка подписи	Примечания
WhatsApp	Оба	✅ HMAC-SHA256	Требуется аккаунт Meta Business
SMS / Twilio	Оба	Частичная	Требуется аккаунт Twilio
Email	Оба	Н/Д	IMAP-опрос для входящих
Telegram	Оба	—	Bot API, без подписи
Viber	Оба	✅ HMAC-SHA256	Требуется аккаунт Viber Partners
Instagram	Оба	✅ HMAC-SHA256	Через Meta Graph API
Facebook Messenger	Оба	✅ HMAC-SHA256	Через Meta Graph API
Виджет веб-чата	Оба	Token	Встроенный JS-сниппет