Integración con HubSpot: guía de configuración

La integración con HubSpot vincula un sitio web de Serpfull con una cuenta de HubSpot. Serpfull añade una nota a la empresa correspondiente en HubSpot cuando ocurre algo importante en el sitio web (caídas, recuperaciones, caducidad del dominio, resultados de auditoría, cambios de posición, informes nuevos), y una tarjeta de Serpfull en las fichas de empresa muestra las posiciones, la disponibilidad y la puntuación SEO del sitio.

Antes de empezar

• Una cuenta de Serpfull con al menos un sitio web, y el rol de propietario o administrador en tu organización de Serpfull.
• Una cuenta de HubSpot donde puedas instalar apps (un Super Admin o un usuario con acceso al App Marketplace).
• El dominio del sitio web como nombre de dominio de una empresa en HubSpot, o la opción de que Serpfull cree la empresa.

1. Instalar y conectar

• En Serpfull, elige el sitio web en el selector, abre Integraciones → HubSpot y pulsa Conectar HubSpot. También puedes empezar desde la ficha de Serpfull en el App Marketplace de HubSpot y pulsar Instalar.
• Inicia sesión en HubSpot si te lo pide, elige la cuenta de HubSpot, revisa los permisos y pulsa Conectar app.
• Vuelves a Serpfull. Si empezaste en HubSpot, inicia sesión en Serpfull y elige el sitio web que quieres conectar (este paso caduca a los 15 minutos).
• La página muestra Conectado con el nombre y el ID de la cuenta de HubSpot.

Permisos que pedimos

• Leer empresas: encontrar la empresa cuyo dominio coincide con tu sitio web y mostrar la tarjeta en ella.
• Escribir empresas: añadir notas a esa empresa y, solo si lo activas, crear la empresa cuando no haya ninguna que coincida.
• Acceso OAuth básico: identificar la cuenta de HubSpot que conectaste.

2. Elegir qué sincronizar

• Eventos: marca los eventos que deben convertirse en notas. Por defecto: sitio caído, sitio recuperado, dominio a punto de caducar, bajada de la puntuación de auditoría e informe listo.
• Crear la empresa si no existe: desactivado por defecto. Si lo activas, Serpfull crea una empresa con el nombre del sitio web y su dominio.
• Volver a emparejar: olvida la empresa guardada para que el siguiente evento vuelva a buscar por dominio (útil después de fusionar o sustituir empresas).
• Pulsa Guardar. Usa Enviar nota de prueba para publicar una nota de prueba en la empresa emparejada.

3. Usarla

• Las notas aparecen en la cronología de la empresa en HubSpot, normalmente menos de un minuto después del evento. La tabla Actividad reciente de Serpfull muestra cada nota y si se envió.
• Abre una empresa en HubSpot para ver la tarjeta de Serpfull: palabras clave seguidas, posición media y mejores palabras clave, incidencias de disponibilidad y tiempo de caída de los últimos 30 días, y la puntuación SEO media, con un enlace al sitio web en Serpfull.
• Si HubSpot está ocupado o limita las peticiones, Serpfull reintenta tras 1 minuto, 5 minutos, 30 minutos, 2 horas y 6 horas, y después marca la nota como fallida.

Desconectar

En Serpfull, abre Integraciones → HubSpot para el sitio web y pulsa Desconectar. Serpfull revoca su acceso a tu cuenta de HubSpot, borra los tokens guardados y cancela las notas en cola. Desactivar la integración con HubSpot para un sitio web también la desconecta.

Desinstalar desde HubSpot

En HubSpot, ve a Configuración → Integraciones → Apps conectadas, abre Serpfull y elige Desinstalar. Serpfull lo detecta en unos 10 minutos (o en su siguiente petición), marca como desconectados todos los sitios web vinculados a esa cuenta de HubSpot, borra los tokens guardados y avisa a tu equipo en la app.

Qué pasa con tus datos

• Las notas ya añadidas siguen en HubSpot después de desconectar o desinstalar; bórralas en HubSpot si no las quieres.
• Las empresas que creó Serpfull siguen en HubSpot.
• Serpfull solo guarda el ID y el dominio de la cuenta de HubSpot, el ID de la empresa emparejada, tu configuración de sincronización y un registro de 30 días de las notas enviadas. Los tokens se cifran en reposo y se borran al desconectar.
• Serpfull no lee ni guarda tus contactos, negocios ni otros registros de HubSpot.

Privacidad

La tarjeta se carga desde Serpfull con una petición firmada por HubSpot; comprobamos la firma y solo mostramos datos de los sitios web conectados a esa cuenta de HubSpot. Consulta nuestra política de privacidad para saber cómo tratamos los datos de las apps conectadas.

Desde un asistente

El conector de IA tiene hubspot_status, hubspot_connect_link, hubspot_update_settings, hubspot_send_test y hubspot_disconnect. La conexión siempre termina en tu navegador.

Ayuda

Escribe a support@serpfull.com indicando tu sitio web y el ID de tu cuenta de HubSpot.