WhatsAppCentralizado/docs/odoo-module-install.md

Guía de Instalación: Módulo Odoo WhatsApp Hub

Esta guía explica cómo instalar y configurar el módulo odoo_whatsapp_hub en tu instancia de Odoo 19.

Requisitos Previos

• Odoo 19 Community o Enterprise
• Acceso de administrador a la instancia de Odoo
• WhatsApp Centralizado en ejecución y accesible desde Odoo
• Python 3.10+ (incluido en Odoo 19)

Método 1: Instalación Manual (Recomendado)

Paso 1: Copiar el Módulo

Copia la carpeta odoo_whatsapp_hub al directorio de addons de tu instalación de Odoo:

# Si Odoo está instalado localmente
cp -r /ruta/a/WhatsAppCentralizado/odoo_whatsapp_hub /ruta/a/odoo/addons/

# Si usas Docker
docker cp odoo_whatsapp_hub odoo_container:/mnt/extra-addons/

# Si usas Odoo.sh
# Sube el módulo via Git al repositorio de tu proyecto

Paso 2: Agregar Ruta de Addons (si es necesario)

Si usas un directorio custom, asegúrate de que esté en la configuración de Odoo:

# /etc/odoo/odoo.conf
[options]
addons_path = /usr/lib/python3/dist-packages/odoo/addons,/mnt/extra-addons

Paso 3: Reiniciar Odoo

# Systemd
sudo systemctl restart odoo

# Docker
docker-compose restart odoo

# Manual
./odoo-bin -c /etc/odoo/odoo.conf

Paso 4: Actualizar Lista de Aplicaciones

1. Ir a Aplicaciones
2. Hacer clic en Actualizar lista de aplicaciones
3. Confirmar la actualización

Paso 5: Instalar el Módulo

1. En Aplicaciones, quitar el filtro "Apps"
2. Buscar "WhatsApp Hub"
3. Hacer clic en Instalar

Método 2: Instalación via Git (Odoo.sh o desarrollo)

# En el directorio de tu proyecto Odoo
cd /ruta/a/tu/proyecto/odoo

# Clonar o copiar como submódulo
git submodule add https://git.consultoria-as.com/consultoria-as/WhatsAppCentralizado.git external/whatsapp

# Crear enlace simbólico
ln -s ../external/whatsapp/odoo_whatsapp_hub addons/odoo_whatsapp_hub

# Commit y push
git add .
git commit -m "Add WhatsApp Hub module"
git push

Configuración Post-Instalación

1. Configurar Cuenta WhatsApp

1. Ir a WhatsApp > Configuración > Cuentas WhatsApp
2. Editar la cuenta "WhatsApp Principal" o crear una nueva
3. Configurar:

Campo	Valor	Descripción
Nombre	Mi WhatsApp	Nombre descriptivo
URL API	http://192.168.10.221:8000	URL de WhatsApp Centralizado
API Key	(tu token JWT)	Token de autenticación
ID Externo	(ID de la cuenta)	ID de la cuenta en WhatsApp Central
Cuenta por Defecto	✓	Marcar si es la principal

2. Obtener el API Key

Para obtener el token JWT:

# Hacer login en la API
curl -X POST http://192.168.10.221:8000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "admin@whatsapp.local", "password": "admin123"}'

# Respuesta:
# {"access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."}

Copia el access_token y pégalo en el campo API Key de la cuenta WhatsApp.

3. Vincular Cuenta Externa

El ID Externo es el ID de la cuenta de WhatsApp en el sistema central:

1. Ir a WhatsApp Centralizado > Cuentas
2. Copiar el ID de la cuenta conectada
3. Pegarlo en el campo ID Externo en Odoo

4. Configurar Webhook en WhatsApp Central

Para recibir mensajes en Odoo, configura el webhook:

URL del Webhook: https://tu-odoo.com/whatsapp/webhook

En WhatsApp Centralizado, ve a Configuración y agrega:

• URL: https://tu-odoo.com/whatsapp/webhook
• Eventos: message, status_update, conversation_update

Uso del Módulo

Ver Conversaciones

1. Ir a WhatsApp > Conversaciones
2. Vista Kanban agrupada por estado
3. Filtros: No leídos, Activas, Mis conversaciones

Enviar WhatsApp desde Contacto

1. Abrir un contacto en Contactos
2. Hacer clic en Enviar WhatsApp (botón verde)
3. Escribir mensaje y enviar

Envío Masivo

1. Seleccionar múltiples contactos en la lista
2. Acción > Enviar WhatsApp
3. Escribir mensaje con variables opcionales ({{name}}, {{email}})
4. Confirmar envío

Widget de Chat

El widget de chat OWL está disponible en la vista de conversaciones para enviar mensajes en tiempo real.

Estructura del Módulo

odoo_whatsapp_hub/
├── __manifest__.py          # Manifest del módulo (v19.0.1.0.0)
├── __init__.py
├── models/
│   ├── whatsapp_account.py      # Cuentas WhatsApp
│   ├── whatsapp_conversation.py # Conversaciones
│   ├── whatsapp_message.py      # Mensajes
│   └── res_partner.py           # Extensión de contactos
├── controllers/
│   └── webhook.py               # Endpoint para webhooks
├── wizards/
│   ├── send_whatsapp.py         # Wizard envío individual
│   └── mass_whatsapp.py         # Wizard envío masivo
├── views/
│   ├── whatsapp_menu.xml
│   ├── whatsapp_account_views.xml
│   ├── whatsapp_conversation_views.xml
│   ├── res_partner_views.xml
│   └── send_whatsapp_wizard.xml
├── security/
│   └── ir.model.access.csv      # Permisos de acceso
├── data/
│   └── whatsapp_data.xml        # Datos iniciales
└── static/src/
    ├── css/whatsapp.css         # Estilos WhatsApp
    ├── js/chat_widget.js        # Widget OWL
    └── xml/chat_widget.xml      # Template OWL

Permisos

Modelo	Usuario Normal	Administrador
whatsapp.account	Solo lectura	CRUD completo
whatsapp.conversation	Leer, Crear, Escribir	CRUD completo
whatsapp.message	Leer, Crear, Escribir	CRUD completo

Solución de Problemas

El módulo no aparece en la lista

1. Verificar que la carpeta esté en addons_path
2. Reiniciar Odoo con -u all o --update=all
3. Verificar logs: tail -f /var/log/odoo/odoo.log

Error de conexión a la API

1. Verificar que WhatsApp Centralizado esté corriendo
2. Probar conexión: curl http://192.168.10.221:8000/health
3. Verificar firewall permite conexión desde Odoo

Webhooks no funcionan

1. Verificar que Odoo sea accesible desde WhatsApp Central
2. Probar endpoint: curl https://tu-odoo.com/whatsapp/webhook/test
3. Revisar logs de Odoo para errores

Mensajes no se envían

1. Verificar API Key válido
2. Verificar ID Externo correcto
3. Verificar cuenta conectada en WhatsApp Central
4. Revisar logs del servicio integrations

Actualizaciones

Para actualizar el módulo:

# Copiar nueva versión
cp -r /nueva/version/odoo_whatsapp_hub /ruta/a/odoo/addons/

# Reiniciar y actualizar
./odoo-bin -c /etc/odoo/odoo.conf -u odoo_whatsapp_hub

O desde la interfaz:

1. Ir a Aplicaciones
2. Buscar "WhatsApp Hub"
3. Menú ⋮ > Actualizar

Soporte

Para problemas o consultas:

• Repositorio: https://git.consultoria-as.com/consultoria-as/WhatsAppCentralizado
• Issues: Crear issue en el repositorio