Automatización e Integración

Resumen

El sistema de automatización e integración de Corcava proporciona funciones específicas de notificación y flujo de trabajo que conectan tus actividades de gestión de proyectos con plataformas de comunicación externas. Basado en análisis del código, el sistema se enfoca en notificaciones de finalización de tareas y automatización a nivel de tablero en lugar de automatización compleja de flujos de trabajo.

Entender estas funciones de automatización te ayudará a mantenerte conectado con tu equipo a través de plataformas externas y mantener la conciencia del progreso del proyecto.

Automatizaciones de Tableros - Acciones Automatizadas Basadas en Movimientos de Tareas

Tipos de Automatización Disponibles

Automatizaciones de Finalización de Tareas: El sistema proporciona dos tipos específicos de automatización que se activan cuando las tareas se mueven a columnas "Completado":

1. Notificaciones de Tarea Completada en Slack (TYPE_TASK_DONE_SLACK):

Disparador - Cuando la tarea se mueve a columna marcada como "Completado"
Acción - Envía mensaje de notificación al canal de Slack configurado
Mensaje - "La [nombre de tarea] ha sido movida a la columna Completado"
Configuración - Específica del tablero, una automatización por tablero
Requisitos - La integración de Slack debe estar conectada

2. Notificaciones de Tarea Completada en Telegram (TYPE_TASK_DONE_TELEGRAM):

Disparador - Cuando la tarea se mueve a columna marcada como "Completado"
Acción - Envía notificación al chat de Telegram configurado
Mensaje - "Tarea [nombre de tarea] está completada"
Configuración - Específica del tablero, requiere configuración de bot de Telegram
Requisitos - Conexión de automatización de Telegram establecida

Configuración de Automatización

Configurar Automatizaciones:

Abrir Tablero - Navegar a cualquier tablero de proyecto
Hacer Clic en "Automatizaciones" - Acceder al modal de automatización desde el encabezado del tablero
Elegir Tipo de Automatización:
- Reporte Diario - Resúmenes automáticos de progreso diario
- Tarea Completada - Notificaciones cuando las tareas se completan
Configurar Plataforma:
- Slack - Seleccionar canal y conectar integración de Slack
- Telegram - Configurar conexión de bot y seleccionar chat
Guardar Configuración - La automatización se activa inmediatamente

Gestión de Automatización:

Específica del Tablero - Cada automatización se configura por tablero
Instancia Única - Solo una automatización de cada tipo por tablero
Comportamiento de Sobrescritura - Nueva automatización reemplaza la existente del mismo tipo
Basada en Equipo - Las automatizaciones pertenecen al equipo, no a usuarios individuales

Limitaciones de Automatización

Lo que NO está Implementado:

❌ Reglas de Flujo de Trabajo Complejas - Sin lógica condicional o disparadores complejos
❌ Automatizaciones Multi-paso - Solo notificaciones de acción única
❌ Reglas Específicas por Columna - Solo se soportan disparadores de columna "Completado"
❌ Automatizaciones Específicas por Usuario - Solo automatizaciones a nivel de tablero
❌ Disparadores Basados en Tiempo - Sin automatizaciones programadas o basadas en tiempo
❌ Acciones Personalizadas - Sin acciones de automatización personalizadas más allá de notificaciones

Integración con Slack - Plataforma de Comunicación del Equipo

Características de Conexión con Slack

Configuración de Integración con Slack:

Conectar Slack - Usar botón "Conectar Slack" en el modal de automatización
Autenticación OAuth - Flujo OAuth estándar de Slack para conexión segura
Acceso a Canales - El sistema recupera lista de canales privados
Almacenamiento de Token - Token de Slack almacenado en configuración del equipo

Funciones Disponibles de Slack:

Notificaciones de Finalización de Tareas:

Mensajes Automáticos - Notificaciones enviadas cuando las tareas llegan a la columna "Completado"
Selección de Canal - Elegir canal específico de Slack para notificaciones
Formato de Mensaje - Mensaje estándar: "La [nombre de tarea] ha sido movida a la columna Completado"
Específico del Tablero - Configurar diferentes canales para diferentes tableros

Automatización de Reporte Diario:

Configuración Disponible - Existe interfaz para configuración de reporte diario
Estado de Implementación - La implementación del backend puede ser limitada
Selección de Canal - Elegir canal objetivo para reportes diarios
Basado en Tablero - Reportes específicos para tableros individuales

Implementación de Integración con Slack

Detalles Técnicos:

Integración API - Usa Slack Web API para listado de canales y mensajería
Canales Privados - Actualmente configurado para acceder solo a canales privados
Integración con Slack - Sistema de comunicación profesional con Slack
Escuchadores de Eventos - El escuchador TaskDoneSlackNotification maneja la finalización de tareas
Manejo de Errores - Registro integral de errores para problemas de API de Slack

Beneficios de la Integración con Slack: ✅ Notificaciones en Tiempo Real - Alertas inmediatas cuando se completan tareas
✅ Conciencia del Equipo - Mantener al equipo informado sin revisar tableros de proyectos
✅ Organización de Canales - Enrutar notificaciones a canales apropiados del equipo
✅ Integración Profesional - Integración estándar OAuth y API de Slack

Integración con Telegram - Comunicación Basada en Bot

Características del Bot de Telegram

Bot Administrador de Telegram: El sistema incluye un bot de Telegram para gestión de tareas y notificaciones.

Capacidades del Bot:

Creación de Tareas vía Bot:

Entrada de Texto - Crear tareas enviando mensajes al bot
Selección de Tablero - Especificar tablero objetivo por nombre o ID
Colocación Automática - Tareas creadas en columna "Por Hacer" automáticamente
Atribución de Usuario - Tareas creadas por usuario autenticado de Telegram

Comandos del Bot:

/start - Inicializar interacción con el bot
/board - Especificar tablero objetivo para creación de tareas
/message - Agregar contenido y descripción de tarea
/reply - Completar creación de tarea y guardar en tablero

Notificaciones de Finalización de Tareas:

Disparador de Columna Completado - Notificaciones enviadas cuando las tareas llegan a la columna "Completado"
Formato de Mensaje - "Tarea [nombre de tarea] está completada"
Específico del Chat - Notificaciones enviadas a chats de Telegram configurados
Específico del Tablero - Configurar diferentes chats para diferentes tableros

Configuración de Integración con Telegram

Proceso de Conexión del Bot:

Acceder al Modal de Automatización - Hacer clic en "Automatizaciones" en el tablero de proyecto
Elegir Opción de Telegram - Seleccionar tipo de automatización de Telegram
Configuración de Enlace del Bot - Usar enlace del bot proporcionado para conectar chat de Telegram
Selección de Chat - Elegir chat objetivo para notificaciones
Guardar Configuración - La automatización se activa para el tablero

Implementación Técnica:

Integración con Telegram - Sistema de comunicación profesional con Telegram
TelegramTaskManager - Maneja comandos del bot y creación de tareas
Soporte de Webhook - Endpoint de webhook de Telegram para recibir mensajes del bot
Seguimiento en Base de Datos - Tablas TelegramChat y telegram_automations

Beneficios de la Integración con Telegram: ✅ Accesibilidad Móvil - Crear y rastrear tareas desde la aplicación móvil de Telegram
✅ Notificaciones Instantáneas - Alertas inmediatas para finalización de tareas
✅ Comandos del Bot - Comandos de texto simples para gestión de tareas
✅ Coordinación del Equipo - Notificaciones de chat grupal para conciencia del equipo

Soporte de Webhooks - Disparadores Externos

Implementación de Webhooks

Webhooks Disponibles: Basado en análisis del código, el sistema incluye varios endpoints de webhook:

Webhooks de Pago:

Webhooks de Stripe - Manejar actualizaciones de estado de pago para facturas
Webhooks de PassimPay - Manejar notificaciones de pago con criptomonedas
Integración de Facturas - Los webhooks de pago actualizan el estado de facturas

Webhooks de Integración:

Webhook de Career Habr - Manejar eventos de integración de tablón de empleos
Webhook de Freelancer - Manejar eventos de integración de plataforma freelance
Webhook de AppSumo - Manejar eventos de compra y activación de AppSumo

Webhooks de Comunicación:

Webhooks de Telegram - Recibir mensajes y comandos del bot
Webhook del Administrador de Telegram - Manejar interacciones del bot administrador

Características de Webhooks

Implementación Técnica:

Sistema de Webhooks - Manejo dedicado de webhooks para servicios externos
Exención CSRF - Los webhooks están exentos de protección CSRF
Manejo de Autenticación - Los webhooks manejan autenticación externa
Registro de Errores - Registro integral de errores para fallos de webhooks

Limitaciones de Webhooks:

❌ Sin Webhooks Personalizados de Proyectos - Sin endpoints de webhook específicos de proyectos
❌ Sin Webhooks de Eventos de Tareas - Sin webhooks para creación/actualizaciones de tareas
❌ Sin Webhooks de Eventos de Tableros - Sin webhooks para cambios de tableros
❌ Disparadores Externos Limitados - Webhooks enfocados en pagos e integraciones

Automatización de Pipeline - Flujos de Trabajo Automatizados Entre Proyectos

Análisis del Sistema de Pipeline

Implementación de Pipeline: El sistema incluye un sistema de automatización de pipeline separado enfocado principalmente en flujos de trabajo de contactos y correo electrónico:

Características de Pipeline:

Pipelines Basados en Email - Secuencias automáticas de email para contactos
Pasos con Retraso de Tiempo - Pasos de pipeline con retrasos configurables
Integración de Contactos - Pipelines adjuntos a contactos para nutrición
Integración de Plantillas - Usar plantillas de email en pasos de pipeline

Componentes de Pipeline:

Configuración de Pipeline - Configuración y gestión principal del pipeline
Pasos de Pipeline - Pasos individuales en secuencias automatizadas
Pipelines Activos - Instancias de pipeline actualmente en ejecución
Disparadores Automáticos - Activación automatizada de pipeline

Limitaciones de Pipeline en Contexto de Proyectos

Lo que NO está Disponible para Gestión de Proyectos:

❌ Pipelines Basados en Tareas - Sin pipelines disparados por eventos de tareas
❌ Pipelines de Flujo de Trabajo de Tableros - Sin flujos de trabajo automatizados a nivel de tablero
❌ Pipelines de Hitos de Proyectos - Sin flujos de trabajo de finalización de proyectos
❌ Pipelines de Asignación de Equipos - Sin flujos de trabajo automatizados de asignación de equipos

Enfoque Actual de Pipeline:

✅ Pipelines de Contactos - Secuencias de nutrición por email para contactos
✅ Automatización de Email - Envío automático de emails y seguimientos
✅ Integración CRM - Integración de pipeline con gestión de contactos
❌ Integración de Gestión de Proyectos - Conexión limitada con flujos de trabajo de proyectos

Limitaciones de Integración y Expectativas Realistas

Lo que Está Realmente Implementado

Automatizaciones a Nivel de Tablero:

✅ Notificaciones de Tarea Completada - Notificaciones de Slack y Telegram cuando se completan tareas
✅ Configuración de Reporte Diario - Interfaz para reportes de progreso diario (la implementación puede ser limitada)
✅ Conexión de Plataforma - Integración OAuth con Slack, configuración de bot para Telegram

Comunicación Externa:

✅ Integración de Canal de Slack - Enviar mensajes a canales específicos de Slack
✅ Comandos de Bot de Telegram - Crear tareas y recibir notificaciones vía bot
✅ Endpoints de Webhook - Manejar notificaciones de servicios externos

Lo que NO está Implementado

Automatización Compleja:

❌ Flujos de Trabajo Multi-paso - Sin secuencias de automatización complejas
❌ Lógica Condicional - Sin reglas de automatización si/entonces
❌ Automatización Entre Tableros - Sin automatización entre múltiples tableros
❌ Disparadores Basados en Tiempo - Sin acciones de automatización programadas
❌ Reglas Específicas por Usuario - Sin configuración de automatización por usuario

Integración Avanzada:

❌ Creación de Webhooks Personalizados - Sin endpoints de webhook creados por usuarios
❌ Automatización API - Sin integraciones API personalizadas para eventos de proyectos
❌ Herramientas de Flujo de Trabajo de Terceros - Sin integraciones de Zapier, IFTTT o similares
❌ Reglas Avanzadas de Notificación - Solo notificación básica, sin reglas complejas

Comenzando con la Automatización

Guía de Configuración Rápida

Paso 1: Configurar Integración con Slack

Navegar a cualquier tablero de proyecto
Hacer clic en botón "Automatizaciones"
Elegir pestaña "Tarea Completada"
Hacer clic en "Conectar Slack" si no está ya conectado
Seleccionar canal objetivo para notificaciones
Guardar configuración de automatización

Paso 2: Configurar Notificaciones de Telegram

Abrir modal de automatización en tablero de proyecto
Seleccionar pestaña "Tarea Completada"
Hacer clic en opción de Telegram
Seguir enlace del bot para configurar conexión de Telegram
Configurar chat objetivo para notificaciones
Guardar automatización para activar

Paso 3: Probar Automatización

Crear una tarea de prueba en tu tablero
Mover tarea a columna "Completado"
Verificar que la notificación aparece en el canal de Slack configurado o chat de Telegram
Ajustar configuración si es necesario

Mejores Prácticas de Automatización

✅ Comenzar Simple - Empezar con notificaciones básicas de finalización de tareas
✅ Coordinación del Equipo - Asegurar que el equipo quiere notificaciones automatizadas
✅ Gestión de Canales - Usar canales apropiados para diferentes tipos de notificaciones
✅ Revisión Regular - Evaluar periódicamente la efectividad de la automatización
✅ Expectativas Realistas - Entender las limitaciones actuales de automatización

Solución de Problemas de Automatización

Problemas Comunes

Notificaciones de Slack No Funcionan:

Estado de Conexión - Verificar que la integración de Slack está correctamente conectada
Acceso al Canal - Asegurar que el bot tiene acceso al canal objetivo
Validez del Token - Verificar si el token de Slack sigue siendo válido
Selección de Canal - Verificar que el canal correcto está seleccionado en la automatización

Notificaciones de Telegram No Funcionan:

Conexión del Bot - Verificar que la conexión del bot de Telegram está establecida
Configuración del Chat - Verificar tabla telegram_automations para configuración adecuada del chat
Permisos del Bot - Asegurar que el bot tiene permiso para enviar mensajes al chat objetivo
Hash de Automatización - Verificar que el hash de automatización coincide con la conexión de Telegram

Automatización No se Dispara:

Columna Completado - Verificar que la columna está correctamente marcada como columna "Completado"
Movimiento de Tarea - Asegurar que la tarea se mueve realmente a la columna completado (no solo actualizada)
Existencia de Automatización - Verificar que la automatización está correctamente guardada para el tablero
Escuchador de Eventos - Verificar que el evento TaskDone se está despachando

Próximos Pasos

Ahora que entiendes la automatización e integración, estás listo para explorar:

Filtrado y Búsqueda - Encontrar y organizar tareas eficientemente
Gestión de Archivos e Historial - Gestionar trabajo completado y datos históricos
Permisos y Control de Acceso - Gestión detallada del sistema de permisos
Funciones Móviles y Responsivas - Interfaz móvil e interacciones táctiles

Recuerda: El sistema de automatización de Corcava se enfoca en notificaciones esenciales e integraciones básicas. Aunque no es tan complejo como plataformas dedicadas de automatización, proporciona conectividad valiosa con Slack y Telegram para comunicación y conciencia del equipo.