# HubSpot: conexão

O assistente lê no HubSpot quem está escrevendo para ele: o contato e a
empresa, os negócios e os chamados de suporte. Ele nunca grava nada no
HubSpot. O que exatamente ele pode ler, você define para cada caixa de e-mail
separadamente. Como as conexões funcionam no draften em geral é descrito na
página [Integrações](/pt/admin/integrations).

## Do que você vai precisar

- Uma conta do HubSpot com direitos de **super admin** (ou com a permissão
  **Developer tools access**) – só uma conta assim cria uma chave de API.
- No draften, o **proprietário ou um administrador da organização**.

O draften precisa de uma **chave de API só com permissões de leitura**. Hoje o
HubSpot a emite como **service key**. Contas mais antigas também podem ter um
token de **private app** da forma anterior (começa com `pat-`); ele continua
funcionando, só que o HubSpot não permite mais criar novos private apps.

## No HubSpot: service key

1. Abra a lista de chaves: no menu principal, **Development** → **Keys** →
   **Service keys** (em algumas contas, **Settings** → **Integrations** →
   **Service Keys**).
2. No canto superior direito, clique em **Create service key** e dê um nome à
   chave, por exemplo `draften`.
3. Clique em **Add new scope**. No painel à direita, procure (campo **Find
   a scope**) e marque só estas permissões de leitura:
   - `crm.objects.contacts.read` – contatos,
   - `crm.objects.companies.read` – empresas,
   - `crm.objects.owners.read` – quem cuida do contato,
   - `crm.objects.deals.read` – negócios,
   - `crm.objects.tickets.read` – chamados.

   Não adicione nada com `.write`. A chave só pode receber as permissões que o
   criador dela tem.
4. Crie a chave. Na página dela, clique em **Show** e depois em **Copy**.

Mais tarde, a chave pode ser **trocada** (**Rotate and expire now**, ou
**Rotate and expire later** – a antiga então ainda vale por 7 dias). Cole a
nova chave no draften (veja abaixo).

## No draften

1. Abra Organização → **Integrações** e, no cartão **Integrações**, preencha:
   - **Sistema** – **HubSpot**,
   - **Nome** – por exemplo `HubSpot – vendas e suporte`,
   - **Segredo de acesso** – a chave copiada.

   Clique em **Adicionar conexão**. A chave é guardada criptografada e nunca
   mais é exibida.
2. Na linha da conexão, abra o menu **⋯** → **Testar a conexão**. Em instantes
   aparece “Conexão em ordem (…)”. As permissões que faltam, o teste lista em
   “Não disponível com este token:”; quando a chave também tem permissões de
   gravação, ele avisa.
3. Em **Quais caixas de e-mail podem usar a conexão**, clique em **Conceder**
   ao lado da caixa de e-mail, marque o que o assistente pode ler e clique em
   **Salvar a permissão**:
   - **Contato e empresa**,
   - **Negócios** e, abaixo deles, **Valores dos negócios**,
   - **Chamados de suporte** e, abaixo deles, **Detalhe do chamado** e
     **Notas internas do chamado**.
4. Depois, o editor do assistente adiciona, nas Configurações do assistente →
   **Conhecimento**, uma fonte do tipo **sistema externo** e escolhe o que o
   assistente de fato lê – veja
   [Conectar um CRM e outros sistemas](/pt/connecting-a-crm).

Quando você trocar a chave, cole a nova na conexão em **Novo segredo de
acesso** e clique em **Trocar**; depois, **Testar a conexão** de novo.

## Erros do teste de conexão

A mensagem do teste vem em inglês, direto do HubSpot ou do draften:

| Na mensagem | O que significa | O que fazer |
|---|---|---|
| `the access token was refused (401)` | o HubSpot não aceitou a chave – um erro de digitação, ou a chave foi trocada ou apagada | colar uma chave válida |
| `… lacks a scope for this read (403)` | falta à chave uma permissão de leitura | adicionar a permissão à chave no HubSpot |
| `HubSpot rate limit reached (429)` | o limite de chamadas de API foi atingido | tentar mais tarde |
| `HubSpot answered HTTP …` | outra resposta do HubSpot | tentar de novo; se persistir, trocar a chave |