Saltar al contenido principal

🎯 Primeros Pasos Después de la Instalación

Una vez que puedas iniciar sesión, sigue esta lista de verificación para que PulseHub esté listo para producción.

1. Agrega Tu Primer Canal​

Ve a Canales → Agregar Canal y selecciona el tipo que corresponda a tu caso de uso. Cada tipo de canal requiere diferentes credenciales de su proveedor:

Después de agregar un canal, su URL de webhook se muestra en la tarjeta. Deberás pegarla en el panel de desarrollador de tu proveedor.

2. Configura el Webhook en el Lado del Proveedor​

Cada proveedor de canal necesita saber dónde enviar los mensajes entrantes. El formato siempre es:

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

Consulta las guías específicas de cada canal para los pasos exactos sobre dónde pegar esta URL.

3. Configura las Tareas Cron​

Varias funciones solo funcionan cuando el ejecutor cron está activo:

FunciónSin CronCon Cron
Email entrante (IMAP)Nunca se sondeaSe verifica cada minuto
Reglas de automatizaciónSe ejecutan sincrónicamente en solicitudes webSe ejecutan de forma confiable cada minuto
Reintentos de webhook fallidosAtascados para siempreReintentados hasta 5 veces
Limpieza de base de datosLas tablas crecen indefinidamenteSe depuran cada hora

Hosting compartido (cPanel / Plesk / DirectAdmin)​

  1. Ve a Configuración → URL de Tarea Cron en PulseHub y copia la URL completa
  2. En tu panel de hosting, ve a Tareas Cron
  3. Establece la programación en Cada Minuto (* * * * *)
  4. Pega esto como el comando:
wget -q -O /dev/null "https://tudominio.com/cron.php?token=TU_SECRETO_CRON&job=all"

No se necesitan conocimientos de línea de comandos — solo copia la URL de Configuración y pégala en tu panel de hosting.

VPS / Servidor dedicado​

* * * * * php /var/www/pulsehub/cron.php all >> /var/log/pulsehub_cron.log 2>&1

Consulta la referencia completa de Tareas Cron.

4. Invita a Tu Equipo​

Ve a Agentes → Invitar Agente y crea cuentas para los miembros de tu equipo de soporte:

  • Administrador — acceso completo a toda la configuración, canales, automatizaciones y gestión de agentes
  • Agente — puede ver conversaciones, enviar mensajes, asignar estado y etiquetas. No puede cambiar la configuración del sistema.

5. (Opcional) Habilita las Sugerencias de Respuesta con IA​

Ve a Configuración → Espacio de Trabajo y pega tu clave API de OpenAI. Con esto configurado, un botón ✨ Sugerir con IA aparece en cada hilo de conversación.

6. Crea Tu Primera Regla de Automatización​

Ve a Automatizaciones → Nueva Regla y crea una regla de prueba simple:

  • Nombre: Etiquetar mensajes urgentes
  • Disparador: Message Received
  • Acción: Add Tag → new

Consulta la guía completa de Automatizaciones.

7. Embebe el Widget de Chat Web (Opcional)​

Si agregaste un canal de Chat Web, agrega este fragmento a tu sitio web antes de </body>:

<script
  src="https://tudominio.com/public/js/webchat-widget.js"
  data-channel="TU_ID_DE_CANAL"
  data-greeting="¡Hola! ¿Cómo podemos ayudarte hoy?"
  data-color="#10b981">
</script>

Verificación Rápida de Salud​

  1. Envía un mensaje de prueba por WhatsApp/SMS a tu número conectado → aparece en la bandeja en segundos
  2. Envía un email de prueba a tu bandeja conectada → aparece después de la siguiente ejecución cron (hasta 1 minuto)
  3. Responde al mensaje de prueba desde la bandeja → llega al dispositivo del remitente
  4. Revisa la página de Analíticas → muestra al menos 1 conversación y 2 mensajes
  5. Prueba la tarea cron — visita tu URL de cron en el navegador para confirmar que se ejecuta sin errores