> 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

## Visão geral

Conecte seus agentes de IA da ElevenLabs ao CRM do [HubSpot](https://www.hubspot.com/) para gerenciar contatos, empresas e negócios. Essa integração permite que seus agentes criem e atualizem registros no CRM, pesquisem dados existentes e automatizem workflows de vendas e marketing.

## Recursos

| Recurso                     | Suporte                                                 |
| --------------------------- | ------------------------------------------------------- |
| Modo de retenção zero (ZRM) | Não compatível                                          |
| Anexos nas ferramentas      | Não compatível — as ferramentas operam apenas com texto |

## Configuração

Esta integração usa um token de **Aplicativo Privado do HubSpot** para autenticação.

#### Criar um Aplicativo Privado no HubSpot

Acesse **Development** > **Legacy apps** na sua [conta do HubSpot](https://developers.hubspot.com/docs/api/private-apps) e clique em **Create legacy app** > **Private**. Conceda os escopos de CRM de que seu agente precisa (por exemplo, `crm.objects.contacts.read`, `crm.objects.contacts.write`).

#### Copiar o token de acesso

Depois de criar o aplicativo, copie o token de acesso gerado. Ele começa com `pat-`.

#### Conectar na ElevenLabs

Na configuração da integração da ElevenLabs, cole o token do seu aplicativo privado no campo **Private App Access Token**.

> **Note**
>
> No momento, esta integração é compatível apenas com contas do HubSpot hospedadas nos EUA (`api.hubapi.com`).
> Contas hospedadas na UE (com tokens que começam com `pat-eu1-`) ainda não são compatíveis.

## Vídeo de demonstração

> **Note**
>
> Esta demonstração usa ferramentas de webhook legadas. Se você estiver usando a integração nativa do HubSpot, as ferramentas serão
> configuradas automaticamente — não é necessário configurar webhooks manualmente.

## Como funciona

#### Identificação do cliente

O agente pede ao interlocutor uma informação de identificação, como o endereço de e-mail, e pesquisa o CRM para verificar se já existe um registro.

#### Entender a intenção da ligação

O agente pergunta ao interlocutor o motivo da ligação. Esta etapa pode ser adaptada ao seu workflow específico.

#### Obter interações anteriores

O agente busca interações anteriores no CRM usando o ID do contato obtido durante a identificação.

#### Criação de ticket

O agente conversa sobre o problema com o interlocutor, relaciona-o a interações anteriores e cria um ticket para itens que exigem acompanhamento.

## Links úteis

* [Documentação da API do HubSpot](https://developers.hubspot.com/docs/api/overview)
* [Guia de Aplicativos Privados](https://developers.hubspot.com/docs/api/private-apps)
* [Referência da API de CRM](https://developers.hubspot.com/docs/api/crm/understanding-the-crm)