> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integraciones

> Cómo conectar WooCommerce, Zendesk, Google Drive, Encuadrado y Odoo desde el hub de Integraciones de tu agente.

# Integraciones

El hub de **Integraciones** es el único lugar para conectar, probar y desconectar las cuentas externas que usan tus Acciones y tus fuentes de la Base de conocimiento. En vez de cargar credenciales por separado en cada Acción o cada fuente, conectas la cuenta una sola vez acá y el resto de ChatNorris la reutiliza.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-integraciones-lista.png" alt="TODO: captura del hub de Integraciones con las tarjetas de proveedores y su estado" />
</Frame>

## Dónde encontrarlo

Entra al detalle de un agente y haz clic en **Integraciones** en el menú lateral (`Chatbots → [tu agente] → Integraciones`).

## Proveedores disponibles

<CardGroup cols={2}>
  <Card title="WooCommerce" icon="cart-shopping">
    Catálogo de productos y consulta de pedidos verificados. Alimenta la Acción [WooCommerce](/guias/acciones#woocommerce) y la fuente de conocimiento del mismo nombre.
  </Card>

  <Card title="Zendesk" icon="headset">
    Artículos del Centro de ayuda y creación de tickets de soporte. Alimenta la fuente [Zendesk](/guias/knowledge-base#zendesk) y la Acción [Zendesk Tickets](/guias/acciones#zendesk-tickets).
  </Card>

  <Card title="Google Drive" icon="google-drive">
    Documentos y carpetas de Google Drive como fuente de conocimiento. Ver [Base de conocimiento → Google Drive](/guias/knowledge-base#google-drive).
  </Card>

  <Card title="Encuadrado" icon="calendar-check">
    Disponibilidad y reservas verificadas en tu agenda clínica. Alimenta la Acción [Encuadrado — Agenda](/guias/acciones#encuadrado--agenda).
  </Card>

  <Card title="Odoo" icon="building">
    Conexión a tu ERP Odoo (CRM, ventas, soporte) — self-hosted, Odoo.sh u Online. Alimenta la Acción [Odoo](/guias/acciones#odoo).
  </Card>
</CardGroup>

<Note>
  Cada proveedor requiere que tu plan incluya integraciones (Standard o Premium; Odoo es exclusivo de Premium) y, en varios casos, que ChatNorris haya habilitado el piloto para tu organización. Ver el estado de cada proveedor en la sección [Estados de conexión](#estados-de-conexion) más abajo.
</Note>

## Conectar un proveedor

<Steps>
  <Step title="Abre el proveedor que quieres conectar">
    Haz clic en su tarjeta desde la lista de Integraciones. Se abre la pantalla de detalle con el formulario de conexión.
  </Step>

  <Step title="Completa las credenciales">
    Cada proveedor pide datos distintos:

    * **WooCommerce** — URL de la tienda, Consumer key y Consumer secret (generados desde WooCommerce → Configuración → Avanzado → API REST).
    * **Zendesk** — inicias sesión con tu cuenta de Zendesk (OAuth); no cargas ninguna credencial a mano.
    * **Google Drive** — inicias sesión con tu cuenta de Google (OAuth) y luego eliges archivos/carpetas puntuales con el selector de Google.
    * **Encuadrado** — tu API key de Encuadrado.
    * **Odoo** — URL de tu instancia, base de datos (se autodetecta si tu servidor solo tiene una), usuario y API key.
  </Step>

  <Step title="Prueba la conexión">
    Usa el botón **Probar conexión** para confirmar que las credenciales funcionan antes de usarlas en una Acción o fuente de KB.
  </Step>

  <Step title="Usa la integración desde una Acción o fuente de KB">
    Conectar el proveedor no activa nada por sí solo. Para WooCommerce, Zendesk y Encuadrado, ve a **Acciones** y crea o edita la Acción correspondiente. Para Zendesk y Google Drive, ve a **Knowledge Base** y agrega la fuente correspondiente. Odoo se configura desde la Acción **Odoo** en **Acciones**.
  </Step>
</Steps>

## Estados de conexión

Cada tarjeta del hub muestra uno de estos estados:

| Estado                     | Qué significa                                                                                                                                                                                                                                         |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sin conectar**           | Todavía no cargaste credenciales para este proveedor.                                                                                                                                                                                                 |
| **Conectada**              | La conexión está activa y fue probada correctamente.                                                                                                                                                                                                  |
| **Requiere atención**      | La conexión existe pero algo falla (credenciales vencidas, permisos insuficientes) — vuelve a probarla o reconéctala.                                                                                                                                 |
| **No incluida en tu plan** | Tu plan actual no incluye esta integración. Aparece un link directo para ver los planes.                                                                                                                                                              |
| **Beta / Piloto**          | El proveedor está en etapa piloto: aunque tu plan lo incluya, ChatNorris tiene que habilitarlo explícitamente para tu organización antes de que puedas conectarlo. Si lo necesitas, escríbenos a **[hola@chatnorris.ai](mailto:hola@chatnorris.ai)**. |

<Warning>
  Odoo, Encuadrado y algunas capacidades de Zendesk están en etapa piloto. Si tu organización no tiene el piloto habilitado, la integración puede aparecer bloqueada o directamente no ofrecerse como opción creable desde la Acción correspondiente.
</Warning>

## Desconectar un proveedor

Desde el detalle del proveedor, haz clic en **Desconectar**. Esto elimina las credenciales guardadas; las Acciones o fuentes de KB que dependían de esa conexión dejan de funcionar hasta que vuelvas a conectar el proveedor.

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo tener más de una conexión del mismo proveedor en un agente?">
    No. Cada proveedor admite una sola conexión por agente. Si necesitas conectar cuentas distintas para negocios o tiendas distintas, usa agentes separados.
  </Accordion>

  <Accordion title="¿Conectar un proveedor consume créditos?">
    No. Conectar y probar una integración no tiene costo en créditos. Los créditos se consumen cuando la Acción o la fuente de KB efectivamente se usan (ver [Modelos de IA y créditos](/guias/modelos-ia-creditos)).
  </Accordion>

  <Accordion title="Ya tenía WooCommerce o Zendesk conectado desde la propia Acción, ¿tengo que reconectar?">
    No. Las conexiones existentes se migraron automáticamente al hub de Integraciones — las vas a encontrar ya conectadas ahí. Solo necesitas reconectar si la conexión aparece como "Requiere atención".
  </Accordion>

  <Accordion title="¿Por qué no veo Odoo o Encuadrado como opción?">
    Ambos están en etapa piloto (y Odoo, además, es exclusivo del plan Premium). Si tu organización no tiene el piloto habilitado, no van a aparecer como conectables. Escríbenos a [hola@chatnorris.ai](mailto:hola@chatnorris.ai) si los necesitas.
  </Accordion>
</AccordionGroup>