📡 Visión General de Canales

Un canal en PulseHub representa una única cuenta de mensajería conectada. Puedes tener múltiples canales del mismo tipo — por ejemplo, dos números de WhatsApp para diferentes departamentos, o tres bandejas de email para ventas/soporte/facturación.

---

Cómo Funcionan los Canales

Proveedor (WhatsApp, Twilio, etc.)
           │
           │  HTTP POST (webhook)
           ▼
/webhooks/{type}/{channel_id}
           │
           ▼
WebhookController
  1. Verifica la firma
  2. Normaliza el payload
  3. Busca/crea contacto
  4. Busca/crea conversación
  5. Guarda el mensaje
  6. Dispara eventos de automatización

Cada canal tiene:

• Un ID único (UUID) — este es el {channel_id} en la URL del webhook
• Un tipo — uno de los 8 tipos de canal soportados
• Una configuración — blob JSON con las credenciales específicas para ese tipo de canal
• Un token de webhook — un token aleatorio de 32 caracteres hexadecimales generado al momento de la creación
• Un flag activo — los canales inactivos rechazan webhooks entrantes y no envían mensajes salientes

---

Agregar un Canal

1. Ve a Canales en la barra lateral
2. Haz clic en Agregar Canal
3. Elige el tipo de canal del menú desplegable
4. Completa las credenciales específicas del tipo (consulta la guía de cada canal)
5. Haz clic en Guardar Canal

Después de guardar, la tarjeta del canal muestra la URL del Webhook. Copia esta URL y pégala en el panel de desarrollador de tu proveedor.

---

Formato de URL del Webhook

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

---

Canales Soportados

Canal	Dirección	Verificación de Firma	Notas
WhatsApp	Ambas	✅ HMAC-SHA256	Requiere cuenta Meta Business
SMS / Twilio	Ambas	Parcial	Requiere cuenta Twilio
Email	Ambas	N/A	Sondeo IMAP para entrada
Telegram	Ambas	—	Bot API, sin firma
Viber	Ambas	✅ HMAC-SHA256	Requiere cuenta Viber Partners
Instagram	Ambas	✅ HMAC-SHA256	Vía Meta Graph API
Facebook Messenger	Ambas	✅ HMAC-SHA256	Vía Meta Graph API
Widget de Chat Web	Ambas	Token	Fragmento JS embebido