social-media-automation/docs/FEATURES_OVERVIEW.md

Features Overview

Sistema de automatización de redes sociales para Consultoría AS.

Tabla de Contenidos

1. Analytics y Reportes
2. Integración Odoo
3. A/B Testing
4. Reciclaje de Contenido
5. Thread Series
6. Image Templates

---

Analytics y Reportes

Sistema completo de métricas y análisis de rendimiento.

Documentación completa: ANALYTICS.md

Características principales:

• Dashboard interactivo con métricas en tiempo real
• Tracking de engagement por post y plataforma
• Análisis de mejores horarios para publicar
• Reportes semanales automáticos vía Telegram
• Histórico de métricas por post

Endpoints API:

Método	Endpoint	Descripción
GET	/api/analytics/dashboard	Datos del dashboard
GET	/api/analytics/top-posts	Posts con mejor rendimiento
GET	/api/analytics/optimal-times	Mejores horarios
GET	/api/analytics/engagement-trend	Tendencia de engagement
GET	/api/analytics/reports	Reportes históricos
POST	/api/analytics/reports/generate	Generar reporte
POST	/api/analytics/reports/send-telegram	Enviar reporte a Telegram

---

Integración Odoo

Sincronización bidireccional con Odoo ERP.

Documentación completa: ODOO_INTEGRATION.md

Características principales:

• Sincronización de productos desde Odoo
• Sincronización de servicios desde Odoo
• Exportación de leads al CRM de Odoo
• Gestión de leads desde interacciones sociales
• Logs de sincronización

Endpoints API:

Método	Endpoint	Descripción
GET	/api/odoo/status	Estado de conexión
POST	/api/odoo/sync/products	Sincronizar productos
POST	/api/odoo/sync/services	Sincronizar servicios
POST	/api/odoo/sync/leads	Exportar leads
GET	/api/odoo/sync/logs	Historial de sync
GET	/api/leads/	Listar leads
POST	/api/leads/	Crear lead
POST	/api/leads/from-interaction/{id}	Lead desde interacción

---

A/B Testing

Sistema de pruebas A/B para optimizar contenido.

Documentación completa: AB_TESTING.md

Características principales:

• Crear tests con 2-4 variantes
• Publicación automática de variantes
• Seguimiento de métricas por variante
• Análisis estadístico (chi-square)
• Determinación automática de ganador

Endpoints API:

Método	Endpoint	Descripción
GET	/api/ab-tests/	Listar tests
POST	/api/ab-tests/	Crear test
POST	/api/ab-tests/{id}/start	Iniciar test
POST	/api/ab-tests/{id}/evaluate	Evaluar resultados
GET	/api/ab-tests/{id}/results	Ver resultados
POST	/api/ab-tests/{id}/cancel	Cancelar test

---

Reciclaje de Contenido

Republica contenido exitoso automáticamente.

Documentación completa: CONTENT_RECYCLING.md

Características principales:

• Identificación de posts reciclables por engagement
• Sistema de puntuación para candidatos
• Modificaciones opcionales al reciclar
• Límite de reciclajes por post
• Reciclaje automático programado

Endpoints API:

Método	Endpoint	Descripción
GET	/api/recycling/candidates	Posts candidatos
POST	/api/recycling/{post_id}	Reciclar post
POST	/api/recycling/auto	Reciclaje automático
GET	/api/recycling/history	Historial
POST	/api/recycling/{post_id}/disable	Deshabilitar reciclaje

---

Thread Series

Publica hilos de múltiples posts programados.

Documentación completa: THREAD_SERIES.md

Características principales:

• Crear series de posts conectados
• Generación con IA
• Programación con intervalos configurables
• Soporte para reply chains
• Seguimiento de progreso

Endpoints API:

Método	Endpoint	Descripción
GET	/api/threads/	Listar series
POST	/api/threads/	Crear serie manual
POST	/api/threads/generate	Generar con IA
POST	/api/threads/{id}/schedule	Programar serie
POST	/api/threads/{id}/publish-next	Publicar siguiente
POST	/api/threads/{id}/cancel	Cancelar serie

---

Image Templates

Sistema de plantillas para generar imágenes.

Documentación completa: IMAGE_TEMPLATES.md

Características principales:

• Plantillas HTML/CSS inline
• Variables dinámicas
• Múltiples tamaños de salida
• Categorías y tipos de plantillas
• Preview antes de generar

Endpoints API:

Método	Endpoint	Descripción
GET	/api/templates/	Listar plantillas
POST	/api/templates/	Crear plantilla
PUT	/api/templates/{id}	Actualizar
DELETE	/api/templates/{id}	Eliminar
POST	/api/templates/preview	Previsualizar

---

Tareas Programadas (Celery Beat)

Tarea	Frecuencia	Descripción
check_scheduled_posts	Cada minuto	Publica posts programados
check_thread_schedules	Cada minuto	Publica posts de hilos
fetch_post_metrics	Cada 15 min	Actualiza métricas
sync_interactions	Cada 15 min	Sincroniza interacciones
export_leads_to_odoo	Cada hora	Exporta leads
evaluate_ab_tests	Cada hora	Evalúa tests A/B
generate_daily_content	6:00 AM	Genera contenido
sync_products_from_odoo	6:00 AM	Sincroniza productos
sync_services_from_odoo	6:05 AM	Sincroniza servicios
auto_recycle_content	2:00 AM	Recicla contenido
recalculate_optimal_times	Lunes 2:00 AM	Recalcula horarios
generate_weekly_report	Domingo 9:00 AM	Genera reporte
send_daily_summary	9:00 PM	Resumen diario
cleanup_old_data	Domingo 3:00 AM	Limpieza de datos

---

Configuración

Variables de entorno requeridas en .env:

# Analytics
ANALYTICS_FETCH_INTERVAL=15
TELEGRAM_REPORT_ENABLED=true
TELEGRAM_REPORT_DAY=6

# Odoo
ODOO_URL=https://tuempresa.odoo.com
ODOO_DB=nombre_bd
ODOO_USERNAME=usuario
ODOO_PASSWORD=api_key
ODOO_SYNC_ENABLED=false

---

Dashboard URLs

URL	Descripción
/dashboard	Panel principal
/dashboard/analytics	Analytics
/dashboard/leads	Gestión de leads
/dashboard/posts	Gestión de posts
/dashboard/calendar	Calendario
/dashboard/interactions	Interacciones
/api/docs	Documentación Swagger