> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/crm-integrations/odoo.md).

# Odoo

### 1. Antes de empezar

Comprueba que la integración Odoo está disponible y que dispones de:

* URL base pública de Odoo.
* Nombre de la base de datos.
* Usuario.
* API key.
* Permisos en los modelos que utilizarás.

### 2. Conectar Odoo

1. Selecciona **Odoo** y activa la integración.
2. Completa URL, base de datos, usuario y API key.
3. Define duración predeterminada y zona horaria para citas CRM.
4. Guarda y pulsa **Actualizar permisos**.
5. Habilita las acciones detectadas que quieras usar.

### 3. Acciones disponibles

Según las ACL del usuario Odoo:

* Buscar partner por email.
* Buscar partner por teléfono; Aizy consulta los campos phone y mobile.
* Crear o actualizar partner.
* Crear ticket de Helpdesk.
* Crear cita en Calendar.

Los permisos se verifican contra los modelos configurados. Si Odoo no tiene instalado un módulo o el usuario carece de acceso, su acción no aparecerá.

### 4. Gestión de contactos

Configura criterio de búsqueda, creación y datos necesarios en la tarjeta **Gestión de contactos**. Una búsqueda usa solo email o solo teléfono. Tickets y citas no reconocen contactos internamente: ejecuta antes la acción de contacto para propagar **crm\_contact\_id**.

### 5. Configurar una Task

Añade una acción CRM con proveedor Odoo. Los tickets requieren asunto y contenido. Las citas requieren nombre y descripción; solo se asocia partner cuando una acción anterior resolvió el contacto.

Tickets y citas correctos se guardan como nota interna de Inbox con ID y enlace validado a Odoo cuando puede construirse de forma segura.

### 6. Seguridad

Usa un usuario técnico con los permisos mínimos necesarios y una API key dedicada. No documentes ni compartas la clave.
