# Get an integration working

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

Un'integrazione è a livello aziendale. Connettere HubSpot qui non fa sì che l'agent lo utilizzi. Deve ancora attivare lo strumento **on** sotto **Skills - Tools & Workflows**, o un nodo workflow rimane **Setup required** fino a quando la stessa azienda non è connessa.

Barra laterale - **Integrations**. Quattro schede: **Connected**, **Catalogue**, **Deployable Channels**, **AI Assistants**. Il primo giorno è **Catalogue** - **Connect** / **Authorize**, poi lo strumento dell'agent.

Riga della pagina su **Connected**: *These are the tools already connected, and what they can do.* Su **Catalogue**: *Business systems and tools you can connect. Connect once here, then switch it on per agent under Agent -> Skills.*

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

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

## Perché la configurazione è importante

Tre cose devono essere vere o lo strumento è decorazione:

1. **Catalogue - Connect** o **Authorize** su *questa* azienda (OAuth o credenziali).
2. La scheda dello strumento corrispondente dell'agent è attiva, con le operazioni che desidera.
3. **Salvi** l'agent.

Un nodo workflow per lo stesso provider è una quarta cosa: il grafico, più la stessa connessione.

## Le quattro schede

- **Connected** — Working / Not connected / Action needed / Disconnect
- **Catalogue** — Connect o Authorize un provider
- **Deployable Channels** — widget, chat, mail - non CRM
- **AI Assistants** — Claude, ChatGPT che chiamano Voice Logica

**Authorize** appare sui provider OAuth (HubSpot, Zoho CRM, Google Meet / Chat, Microsoft 365, Dropbox). **Connect** appare sulle configurazioni credenziali / API (Salesforce, Guesty, Custom API, ERP, ecommerce, corrieri). Dopo che funziona, la scheda lascia Catalogue e appare su **Connected**.

[Google Workspace](https://docs.voicelogica.ai/it/integrations/google/) appare anche su **Connected** anche prima dell'autorizzazione - ambiti per calendar, Drive, Sheets, e mail. Catalogue elenca ancora Google Meet / Google Chat separatamente.

La ricerca Catalogue mostra **Search 42 Integrations...** con filtri: All, CRM, ERP, E-commerce, Communication, Hospitality, Productivity, Payments, Logistics.

**Deployable Channels** è come alcune superfici chat / mail / WhatsApp si collegano. Le **Channels - Website Widget** dell'agent e [Telephony](https://docs.voicelogica.ai/it/telephony/) sono ancora i percorsi chiamante usuali.

## Quale percorso

- **Conoscere il chiamante dal nostro CRM** — turn on **HubSpot o Zoho** (needs [HubSpot](https://docs.voicelogica.ai/it/integrations/hubspot/) o [Zoho CRM](https://docs.voicelogica.ai/it/integrations/zoho-crm/). Salesforce, Freshdesk, e Zendesk sono sulla stessa scheda Catalogue.)
- **Proprietari e ospiti (Guesty)** — turn on **Guesty** (needs Client ID + secret. [Guesty](https://docs.voicelogica.ai/it/integrations/guesty/).)
- **La nostra API ERP / shop** — turn on **Custom API** (needs Base URL + un header auth. [Custom API](https://docs.voicelogica.ai/it/integrations/custom-api/). Shopify / Woo e altre schede catalogue usano **Connect**, poi quello strumento.)
- **Prenotare su Google Calendar / scrivere un Sheet** — turn on **Google Workspace** (needs [Google](https://docs.voicelogica.ai/it/integrations/google/). Si apre da **Connected** - **Connect Google**.)
- **Claude o ChatGPT per chiamare i nostri agent** — turn on **AI Assistants** (needs L'altra direzione. [AI Assistants](https://docs.voicelogica.ai/it/integrations/mcp-settings/).)

## Prima configurazione - HubSpot, poi una chiamata identificata

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

   Completi la schermata di consenso HubSpot (*Connecting your Voice Logica AI account to HubSpot*). La scheda dovrebbe spostarsi su **Connected** con uno stato working.

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

   Attivi **HubSpot**. Abiliti identify-by-phone (e auto-identify on incoming) quando appaiono quelle opzioni. Scelga le proprietà che desidera leggere.

3. **Salvi** l'agent. Chiami il DID di produzione da un numero che esiste su un contatto HubSpot.

4. Ascolti il nome. Se il saluto è generico - il numero non è sul contatto, lo strumento è disattivato, o ha connesso HubSpot su un'azienda diversa.

## Risoluzione dei problemi

**Lo strumento dice che non è ancora connesso per il tuo workspace**

1. **Integrations - Connected** mostra quel provider su *questa* azienda.
2. Lo stato è working, non **Action needed** / **Not connected**.
3. Ha salvato l'agent dopo aver attivato lo strumento.

**Il nodo workflow dice Setup required**

Connetta prima lo stesso provider. [Pick a node](https://docs.voicelogica.ai/it/workflow-nodes/). Lo strumento dell'agent e il nodo sono superfici diverse.

## Prossimi passi

[HubSpot](https://docs.voicelogica.ai/it/integrations/hubspot/) - primo CRM.  
[Google authorizations](https://docs.voicelogica.ai/it/integrations/google/) - calendar, Drive, Sheets, mail.  
[AI Assistants](https://docs.voicelogica.ai/it/integrations/mcp-settings/) - Claude / ChatGPT che la chiamano.