Canales

Un canal es el puente entre GCM y un proveedor de mensajería — WAHA para WhatsApp, Twilio para SMS, Resend para correo, web push para navegadores, in-app para la campana de notificaciones. La página Canales (barra lateral → Canales, también accesible desde Configuración) lista cada categoría de canal, te permite elegir un proveedor por categoría y almacena las credenciales necesarias para enviar.

Este es territorio de administradores — la configuración del canal afecta la bandeja de entrada de cada miembro, así que la página está protegida por isAdmin.

Abre la página de canales

Haz clic en Canales en la barra lateral. Verás una tarjeta por categoría de canal — WhatsApp, SMS, Correo, Push, In-app. Cada tarjeta muestra:

• El nombre del canal y un ícono.
• Una insignia Configurado / No configurado.
• Un conmutador Activado — actívalo una vez que hayas guardado las credenciales.
• Un botón Configurar que expande el formulario de credenciales en línea.

Configurar un canal

Haz clic en Configurar en el canal que quieres conectar. La tarjeta se expande para mostrar un selector de proveedor (si hay más de un proveedor para esta categoría) y un formulario de credenciales.

Selector de proveedor

Cada categoría de canal soporta uno o más proveedores:

Canal	Opciones de proveedor
WhatsApp	WAHA (recomendado) · WhatsApp Cloud API (Meta)
SMS	Twilio · smsmobileapi
Correo	Resend · SMTP · Predeterminado de la plataforma
Push	Web Push (nativo del navegador, sin terceros)
In-app	Integrado (sin terceros)

El proveedor predeterminado está marcado con "(predeterminado)" en el desplegable. Puedes cambiar de proveedor más tarde reabriendo el formulario de configuración y eligiendo uno diferente — las credenciales se almacenan por proveedor así que cambiar de vuelta no pierde tu configuración.

Formulario de credenciales

El formulario se construye dinámicamente desde el config_schema del proveedor. Cada proveedor declara qué campos necesita (clave de API, endpoint, ID de remitente, etc.) y el formulario muestra las entradas correspondientes. Los campos requeridos están marcados con un asterisco rojo.

Algunos patrones comunes:

WhatsApp respaldado por WAHA:

• URL de sesión — https://your-waha.example.com
• Token de API
• Un paso de escaneo de QR en el primer guardado para emparejar la cuenta de WhatsApp

WhatsApp Cloud API:

• ID del número de teléfono (de Meta)
• Token de acceso permanente
• ID de cuenta empresarial
• Token de verificación de webhook

Twilio SMS:

• SID de cuenta
• Token de autenticación
• Remitente — un número de teléfono de Twilio o un ID alfanumérico de remitente donde sea compatible

smsmobileapi:

• Clave de API
• Etiqueta de remitente

Resend (para correo):

• Clave de API
• Anulación opcional de dominio "from"

SMTP (para correo):

• Host, puerto, usuario, contraseña
• Conmutador TLS/SSL

Los campos de contraseña y token están enmascarados por defecto. Haz clic en el ícono de ojo para revelar mientras pegas, luego ciérralo antes de guardar.

Guardar configuración

Haz clic en Guardar configuración. Las credenciales se escriben en org_channel_config (una fila por organización, por canal con clave (organization_id, channel_id)) y el toast confirma. La columna de credenciales es jsonb; los valores se almacenan cifrados en reposo en Supabase. Nunca aparecen en el navegador después de guardar — la próxima vez que abras el formulario, los campos sensibles se muestran como •••• hasta que hagas clic en revelar.

Activar el canal

Guardar las credenciales no enciende el canal automáticamente. Activa el conmutador Activado en la cabecera de la tarjeta para que el canal sea seleccionable en el compositor de mensajería, nodos de flujo de trabajo y configuración de recordatorios.

TIP

Puedes configurar un canal sin activarlo — útil para configurar una configuración de staging que activarás más tarde. Los canales desactivados no aparecen en ningún otro lugar de la aplicación.

Cómo se usan los canales aguas abajo

Una vez que un canal está configurado y activado, aparece en:

• Enviar mensaje — el selector de canal en el compositor.
• Flujos de trabajo — el nodo de acción "Enviar notificación".
• Recordatorios — la lista de casillas de canales para recordatorios de eventos.
• Correos del sistema — restablecimientos de contraseña, enlaces mágicos, correos de bienvenida (solo canales de correo).

Si un canal está desactivado, el compositor lo oculta; los nodos de flujo de trabajo que lo referencian pausan con un error "canal no disponible" en lugar de fallar silenciosamente.

Múltiples proveedores por categoría

Puedes tener más de un proveedor configurado por categoría — por ejemplo, dos proveedores de SMS (doméstico vía Twilio, internacional vía smsmobileapi). La edge function de envío de mensajes elige el primer proveedor que soporte el país del destinatario; también puedes anular por envío eligiendo el proveedor manualmente en el compositor.

Límites del plan

Los niveles de plan limitan a cuántos destinatarios puedes enviar en un mensaje masivo:

Plan	Máx. destinatarios por envío masivo
Starter	100
Growth	1,000
Network	10,000
Unlimited	sin límite

Los límites de velocidad por segundo se aplican a nivel de proveedor — consulta la descripción general de canales de mensajería para los detalles sobre cómo WACRM distribuye automáticamente los envíos masivos a lo largo de días cuando superas las cuotas diarias del proveedor.

Qué se guarda dónde

• channels — catálogo a nivel de plataforma de categorías de canal (solo lectura para organizaciones).
• channel_providers — catálogo a nivel de plataforma de proveedores por canal, con config_schema.
• org_channel_config — filas por organización: (organization_id, channel_id, provider_id, credentials, is_enabled). RLS limita el alcance por current_org_id().

Probar un canal

El formulario de configuración no incluye un remitente de prueba integrado (aún). Para verificar, envía un mensaje de prueba desde la página Enviar mensaje — elige el canal, dirígelo a tu propio teléfono o correo y verifica la entrega. Si algo falla, los registros de mensajería (Configuración → Registros de datos → Mensajería) muestran la respuesta exacta del proveedor.

Errores comunes

"WhatsApp dice Configurado pero los mensajes nunca se entregan." Tu sesión WAHA probablemente expiró. Vuelve a escanear el QR desde el panel de WAHA. Las sesiones mueren cuando WhatsApp Web rota la autenticación, lo que puede ocurrir cada pocas semanas.

"Twilio rechaza todos mis envíos." Twilio requiere ya sea un número de remitente verificado o un ID alfanumérico registrado para el país de destino. Verifica la consola de Twilio por errores de remitente no registrado — esos no aparecen en los registros de GCM tan claramente.

"Configuré Resend pero los correos siguen pasando por el Predeterminado de la plataforma." El selector de proveedor en Configuración → Correo está separado de la página de Canales para correo. El correo tiene una configuración dedicada porque algunas organizaciones ejecutan el correo a través de su propio SMTP mientras los otros canales permanecen predeterminados. Establece el proveedor de correo en Configuración → Correo.

Próximos pasos

• Correo + notificaciones — el proveedor de correo vive en su propia pestaña.
• Recordatorios — elige qué canales envían recordatorios de eventos.
• Descripción general de mensajería — envía mensajes realmente una vez que los canales estén conectados.