# Configurar una integración

} from '../../../../components/docs';

Una integración se aplica a toda la empresa. Conectar HubSpot aquí no hace que el agent lo use automáticamente. Todavía debe activar la herramienta bajo **Skills - Tools & Workflows**, o un nodo de workflow permanecerá en **Setup required** hasta que la misma empresa esté conectada.

Barra lateral - **Integrations**. Cuatro pestañas: **Connected**, **Catalogue**, **Deployable Channels**, **AI Assistants**. El primer día es **Catalogue** - **Connect** / **Authorize**, luego la herramienta del agent.

Descripción de página en **Connected**: *Estas son las herramientas ya conectadas y lo que pueden hacer.* En **Catalogue**: *Sistemas empresariales y herramientas que puede conectar. Conéctelos una vez aquí, luego actívelos por agent en Agent → Skills.*

  <ShotPlaceholder
    src="/assets/integrations/integrations-index.png"
    name="int-connected"
    alt="Pestaña Connected de Integrations con Google Workspace"
    capture="Integrations Connected."
  />

  <ShotPlaceholder
    src="/assets/integrations/catalogue.png"
    name="int-cat"
    alt="Catalogue de Integrations con tarjetas de Connect y Authorize"
    capture="Integrations Catalogue."
  />

## Por qué importa la configuración

Tres cosas deben ser verdaderas o la herramienta es solo decoración:

1. **Catalogue - Connect** o **Authorize** en *esta* empresa (OAuth o credenciales).
2. La tarjeta de herramienta correspondiente del agent está activada, con las operaciones que desea.
3. Hace **Save** del agent.

Un nodo de workflow para el mismo proveedor es una cuarta cosa: el grafo, más la misma conexión.

## Las cuatro pestañas

- **Connected** — Working / Not connected / Action needed / Disconnect
- **Catalogue** — Connect o Authorize un proveedor
- **Deployable Channels** — widget, chat, mail - no CRM
- **AI Assistants** — Claude, ChatGPT llamando a Voice Logica

**Authorize** aparece en proveedores OAuth (HubSpot, Zoho CRM, Google Meet / Chat, Microsoft 365, Dropbox). **Connect** aparece en configuraciones de credenciales / API (Salesforce, Guesty, Custom API, ERPs, comercio electrónico, mensajería). Después de funcionar, la tarjeta sale de Catalogue y se muestra en **Connected**.

[Google Workspace](https://docs.voicelogica.ai/es/integrations/google/) también aparece en **Connected** incluso antes de autorizar - scopes para calendar, Drive, Sheets y mail. Catalogue todavía lista Google Meet / Google Chat por separado.

La búsqueda de Catalogue muestra **Search 42 Integrations...** con filtros: All, CRM, ERP, E-commerce, Communication, Hospitality, Productivity, Payments, Logistics.

**Deployable Channels** es cómo se adjuntan algunas superficies de chat / mail / WhatsApp. Las **Channels - Website Widget** del agent y [Telephony](https://docs.voicelogica.ai/es/telephony/) siguen siendo las rutas habituales de llamadas.

## Qué camino seguir

- **Conocer al llamante desde nuestro CRM** — turn on **HubSpot o Zoho** (needs [HubSpot](https://docs.voicelogica.ai/es/integrations/hubspot/) o [Zoho CRM](https://docs.voicelogica.ai/es/integrations/zoho-crm/). Salesforce, Freshdesk y Zendesk están en la misma pestaña de Catalogue.)
- **Propietarios e invitados (Guesty)** — turn on **Guesty** (needs Client ID + secret. [Guesty](https://docs.voicelogica.ai/es/integrations/guesty/).)
- **Nuestra propia API de ERP / tienda** — turn on **Custom API** (needs URL base + un header de autenticación. [Custom API](https://docs.voicelogica.ai/es/integrations/custom-api/). Shopify / Woo y otras tarjetas de catalogue usan **Connect**, luego esa herramienta.)
- **Reservar en Google Calendar / escribir un Sheet** — turn on **Google Workspace** (needs [Google](https://docs.voicelogica.ai/es/integrations/google/). Se abre desde **Connected** - **Connect Google**.)
- **Claude o ChatGPT para llamar a nuestros agents** — turn on **AI Assistants** (needs La otra dirección. [AI Assistants](https://docs.voicelogica.ai/es/integrations/mcp-settings/).)

## Primera configuración - HubSpot, luego una llamada identificada

1. **Integrations - Catalogue - HubSpot - Authorize**

   Complete la pantalla de consentimiento de HubSpot (*Connecting your Voice Logica AI account to HubSpot*). La tarjeta debería moverse a **Connected** con un estado working.

2. **My Agents - este agent - Skills - Tools & Workflows**

   Active **HubSpot**. Habilite identify-by-phone (y auto-identify en llamadas entrantes) cuando aparezcan esas opciones. Elija las propiedades que desea leer.

3. Haga **Save** del agent. Llame al DID de producción desde un número que exista en un contacto de HubSpot.

4. Escuche el nombre. Si el saludo es genérico - el número no está en el contacto, la herramienta está apagada, o conectó HubSpot en una empresa diferente.

## Solución de problemas

**La herramienta dice que aún no está conectada para su workspace**

1. **Integrations - Connected** muestra ese proveedor en *esta* empresa.
2. El estado es working, no **Action needed** / **Not connected**.
3. Guardó el agent después de activar la herramienta.

**El nodo de workflow dice Setup required**

Conecte primero el mismo proveedor. [Pick a node](https://docs.voicelogica.ai/es/workflow-nodes/). La herramienta del agent y el nodo son superficies diferentes.

## Próximos pasos

[HubSpot](https://docs.voicelogica.ai/es/integrations/hubspot/) - primer CRM.  
[Autorizaciones de Google](https://docs.voicelogica.ai/es/integrations/google/) - calendar, Drive, Sheets, mail.  
[AI Assistants](https://docs.voicelogica.ai/es/integrations/mcp-settings/) - Claude / ChatGPT llamándole.