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.
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
- Abra la lista de claves: en el menú principal, Development → Keys → Service keys (en algunas cuentas, Settings → Integrations → Service Keys).
- Arriba a la derecha, haga clic en Create service key y ponga un nombre a la clave, por ejemplo
draften. - 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. - 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
- 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.
- 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.
- 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.
- 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.
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 |