> 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.md).

# CRM Integrations

### 1. Descripción

En **Integraciones CRM** conectas el bot con HubSpot, Zoho CRM u Odoo. Las acciones se ejecutan desde **Tasks** del modo Conversational Prompt.

### 2. Configuración por proveedor

1. Selecciona HubSpot, Zoho u Odoo.
2. Activa la conexión y completa sus credenciales.
3. Guarda.
4. Pulsa **Actualizar permisos**.
5. Revisa **Scopes permitidos** y activa únicamente las **Acciones disponibles** que quieras usar.

Aizy solo muestra acciones implementadas y autorizadas por la conexión. Una acción no se puede ejecutar si el proveedor está desconectado, no tiene permisos o no está habilitada.

### 3. Gestión de contactos

Cada proveedor permite definir:

* Criterio principal: buscar por email o por teléfono.
* Qué hacer si no existe: no crear o crear un contacto.
* Datos solicitados al crear: nombre, email, teléfono, empresa, dirección, ciudad y país.

En WhatsApp se prioriza el teléfono.

En Tasks, buscar por email, buscar por teléfono y crear/actualizar contacto son acciones independientes. Las acciones de deal, ticket, lead, caso, tarea o cita no buscan contactos automáticamente; coloca primero una acción de contacto si quieres asociarlo.

### 4. Acciones por proveedor

| Proveedor | Acciones posibles, sujetas a permisos                                                       |
| --------- | ------------------------------------------------------------------------------------------- |
| HubSpot   | Buscar contacto por email/teléfono, crear o actualizar contacto, crear deal y crear ticket. |
| Zoho CRM  | Buscar contacto por email/teléfono, crear o actualizar contacto, crear lead, caso o tarea.  |
| Odoo      | Buscar contacto por email/teléfono, crear o actualizar partner, crear ticket o cita.        |

### 5. Uso en Tasks

Añade una **Acción en CRM**, elige proveedor y selecciona una acción habilitada. Puedes usar variables de usuario, conversación, resumen o extracciones anteriores. Las acciones de contacto propagan **crm\_contact\_id** a las acciones siguientes de la misma tarea.