> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HubSpot

## Panoramica

Collega i tuoi agenti IA di ElevenLabs al CRM [HubSpot](https://www.hubspot.com/) per gestire contatti, aziende e trattative. Questa integrazione consente ai tuoi agenti di creare e aggiornare record CRM, cercare dati esistenti e automatizzare workflow di vendite e marketing.

## Funzionalità

| Funzionalità                  | Supporto                                              |
| ----------------------------- | ----------------------------------------------------- |
| Modalità zero retention (ZRM) | Non supportata                                        |
| Allegati negli strumenti      | Non supportati — gli strumenti operano solo sul testo |

## Configurazione

Questa integrazione utilizza un token **HubSpot Private App** per l'autenticazione.

#### Crea una Private App in HubSpot

Vai a **Sviluppo** > **App legacy** nel tuo [account HubSpot](https://developers.hubspot.com/docs/api/private-apps) e fai clic su **Crea app legacy** > **Privata**. Concedi gli ambiti CRM necessari al tuo agente (ad esempio, `crm.objects.contacts.read`, `crm.objects.contacts.write`).

#### Copia il token di accesso

Dopo aver creato l'app, copia il token di accesso generato. Inizia con `pat-`.

#### Connettiti in ElevenLabs

Nella configurazione dell'integrazione ElevenLabs, incolla il token della tua app privata nel campo **Token di accesso Private App**.

> **Note**
>
> Questa integrazione al momento supporta solo gli account HubSpot forniti negli Stati Uniti (`api.hubapi.com`). Gli account forniti nell'UE
> (token che iniziano con `pat-eu1-`) non sono ancora supportati.

## Video dimostrativo

> **Note**
>
> Questa demo utilizza strumenti webhook legacy. Se utilizzi l'integrazione HubSpot nativa, gli strumenti vengono
> configurati automaticamente — non è necessaria alcuna configurazione manuale dei webhook.

## Come funziona

#### Identificazione del cliente

L'agente chiede al chiamante un dato identificativo, come l'indirizzo email, quindi cerca nel CRM per verificare se esiste un record.

#### Comprendi l'intento della chiamata

L'agente chiede al chiamante lo scopo della chiamata. Questo passaggio può essere adattato al tuo workflow specifico.

#### Recupera le interazioni precedenti

L'agente recupera le interazioni precedenti dal CRM utilizzando l'ID del contatto ottenuto durante l'identificazione.

#### Creazione del ticket

L'agente discute il problema con il chiamante, lo collega alle eventuali interazioni precedenti e crea un ticket per le attività di follow-up.

## Link utili

* [Documentazione dell'API HubSpot](https://developers.hubspot.com/docs/api/overview)
* [Guida alle Private App](https://developers.hubspot.com/docs/api/private-apps)
* [Riferimento API CRM](https://developers.hubspot.com/docs/api/crm/understanding-the-crm)