# HubSpot: conexión

El asistente lee en HubSpot quién le escribe: el contacto y la empresa, los
negocios y los tickets de soporte. Nunca escribe en HubSpot. Qué puede leer
exactamente lo decide usted para cada buzón por separado. Cómo funciona una
conexión en draften en general lo describe la página
[Integraciones](/es/admin/integrations).

## Qué necesita

- Una cuenta de HubSpot con permisos de **super admin** (o con el permiso
  **Developer tools access**): solo una cuenta así puede crear una clave de
  API.
- En draften, ser **propietario o administrador de la organización**.

draften necesita una **clave de API solo con ámbitos de lectura**. Hoy HubSpot
la emite como **service key**. Las cuentas más antiguas pueden tener también
un token anterior de **private app** (empieza por `pat-`); sigue funcionando,
pero HubSpot ya no permite crear private apps nuevas.

## En HubSpot: service key

1. Abra la lista de claves: en el menú principal, **Development** → **Keys** →
   **Service keys** (en algunas cuentas, **Settings** → **Integrations** →
   **Service Keys**).
2. Arriba a la derecha, haga clic en **Create service key** y ponga un nombre
   a la clave, por ejemplo `draften`.
3. Haga clic en **Add new scope**. En el panel de la derecha, busque (campo
   **Find a scope**) y marque solo estos ámbitos de lectura:
   - `crm.objects.contacts.read`: contactos,
   - `crm.objects.companies.read`: empresas,
   - `crm.objects.owners.read`: quién se ocupa del contacto,
   - `crm.objects.deals.read`: negocios,
   - `crm.objects.tickets.read`: tickets.

   No añada nada con `.write`. La clave solo puede recibir los ámbitos que
   tiene permitidos quien la crea.
4. Cree la clave. En su página, haga clic en **Show** y luego en **Copy**.

La clave se puede **sustituir** más adelante (**Rotate and expire now**, o
**Rotate and expire later**: la antigua sigue siendo válida 7 días más). Pegue
la nueva clave en draften (más abajo).

## En draften

1. Abra Organización › **Integraciones** y, en la tarjeta **Integraciones**,
   rellene:
   - **Sistema**: **HubSpot**,
   - **Nombre**: por ejemplo `HubSpot – ventas y soporte`,
   - **Secreto de acceso**: la clave copiada.

   Haga clic en **Añadir conexión**. La clave se guarda cifrada y no se vuelve
   a mostrar.
2. En la fila de la conexión, abra el menú **⋯** → **Probar la conexión**. Al
   cabo de un momento aparece «Conexión correcta (…)». Los ámbitos que falten,
   la prueba los indica bajo «No disponible con este token:»; si la clave
   también tiene ámbitos de escritura, avisa de ello.
3. En la parte **Qué buzones pueden usar la conexión**, haga clic en
   **Conceder** junto al buzón, marque lo que puede leer el asistente y haga
   clic en **Guardar el permiso**:
   - **Contacto y empresa**,
   - **Negocios** y, debajo, **Importes de los negocios**,
   - **Tickets de soporte** y, debajo, **Detalle del ticket** y **Notas
     internas de un ticket**.
4. Después, el editor del asistente añade en la Configuración del asistente ›
   **Base de conocimiento** una fuente del tipo **sistema externo** y elige lo
   que el asistente lee realmente: consulte
   [Conectar un CRM y otros sistemas](/es/connecting-a-crm).

Si sustituye la clave, pegue la nueva en la conexión, en **Nuevo secreto de
acceso**, y haga clic en **Sustituir**; después, vuelva a hacer clic en
**Probar la conexión**.

## Errores de la prueba de conexión

El mensaje de la prueba está en inglés y viene directamente de HubSpot o de
draften:

| En el mensaje | Qué significa | Qué hacer |
|---|---|---|
| `the access token was refused (401)` | HubSpot no aceptó la clave: una errata, o la clave se sustituyó o se eliminó | pegar una clave válida |
| `… lacks a scope for this read (403)` | a la clave le falta un ámbito de lectura | añadir el ámbito a la clave en HubSpot |
| `HubSpot rate limit reached (429)` | se agotó el límite de llamadas a la API | intentarlo más tarde |
| `HubSpot answered HTTP …` | otra respuesta de HubSpot | volver a intentarlo; si persiste, sustituir la clave |