---
title: "Conecta HubSpot"
description: "Inicia sesión en HubSpot desde Scratcher y crea o actualiza contactos con las propiedades que elijas, paso a paso."
url: https://scratcher.io/es-419/help/integrations/hubspot
language: es-419
---

1. [Centro de ayuda](https://scratcher.io/es-419/help)
2. [Integraciones](https://scratcher.io/es-419/help/integrations)
3. Conecta HubSpot

# Conecta HubSpot

Inicia sesión en HubSpot desde Scratcher y crea o actualiza contactos con las propiedades que elijas, paso a paso.

Con la integración de HubSpot, cada persona que se registra se crea como contacto en HubSpot. Si ya existe un contacto con el mismo correo electrónico, se actualiza en su lugar.

## Qué necesitas

- Una cuenta de HubSpot. Funcionan todas las ediciones de HubSpot, incluido el CRM gratuito.
- Un usuario de HubSpot con permiso para conectar apps. En HubSpot, eso es un **Super Admin** o un usuario con el permiso de acceso **App Marketplace**.
- Un plan de Scratcher que incluya todas las integraciones nativas. Si el botón está bloqueado, consulta [Tu prueba, los planes y qué pasa cuando termina la prueba](https://scratcher.io/es-419/help/billing/trial-and-plans).

No necesitas una clave de API. Solo inicias sesión en HubSpot y apruebas el acceso.

## Paso 1: Conecta HubSpot

1. En Scratcher, ve a **Settings** > **Integrations** y haz clic en **HubSpot**.
2. Haz clic en **Install integration**. Se te redirigirá a HubSpot.
3. Inicia sesión en HubSpot. Si tienes varias cuentas de HubSpot, elige la que quieres conectar.
4. HubSpot te muestra lo que solicita Scratcher. Haz clic para conectar la app.
5. Vuelves a Scratcher y HubSpot queda instalado.

## El acceso que solicita Scratcher

HubSpot te pide aprobar estos permisos:

- Leer y escribir contactos (`crm.objects.contacts.read` y `crm.objects.contacts.write`): para buscar un contacto por correo electrónico, crear contactos nuevos y actualizar los existentes.
- Leer y escribir las propiedades de contacto (`crm.schemas.contacts.read` y `crm.schemas.contacts.write`): para mostrar tus propiedades de contacto en la asignación de campos.

Scratcher solo trabaja con contactos. No lee ni modifica negocios, empresas, correos electrónicos ni nada más.

## Paso 2: Actívala en una campaña

1. En el editor, ve a **Connect** > **Integrations** > **HubSpot** y haz clic en **Activate**.
2. Si conectaste más de una cuenta de HubSpot, elígela en **Select account**.
3. En **Field mappings**, haz clic en **Add field mapping** y relaciona tus campos con las propiedades de contacto de HubSpot. Por ejemplo, "Lead - First name" con **First Name** y "Lead - Last name" con **Last Name**.
4. En **Filter by permissions (optional)**, elige tu casilla de consentimiento de marketing para que solo se envíen las personas que aceptaron.
5. Haz clic en **Save** y luego en **Test** para enviar un contacto de prueba.

> Ten en cuenta: en HubSpot no hay que elegir ninguna lista, así que Scratcher empieza a enviar datos en cuanto haces clic en **Activate**. Si la campaña ya tiene leads, configura rápido las asignaciones y el filtro, o activa HubSpot antes de que la campaña salga en vivo.

## Asignación de campos

- La lista **Destination field** muestra tus propiedades de contacto de HubSpot, incluidas tus propiedades personalizadas. Las propiedades internas de HubSpot no se muestran.
- El correo electrónico y el número de teléfono siempre se envían a las propiedades **Email** y **Phone Number** de HubSpot. Todo lo demás lo asignas tú, incluidos el nombre y el apellido.
- Las propiedades de casilla reciben sí o no, y las de fecha reciben una fecha; por eso, asigna el campo **Accepted** de un consentimiento a una propiedad de casilla y las fechas a propiedades de fecha.
- Para indicar de dónde vienen los contactos, asigna un **Use custom value**, como "Scratcher summer game", a la propiedad que uses para el origen del lead. Así podrás crear una lista o un workflow en HubSpot a partir de esa propiedad.

## Consentimiento

HubSpot no recibe de Scratcher ningún estado de suscripción ni de marketing. Usa **Filter by permissions** para enviar solo a quienes aceptaron, o asigna los campos **Accepted**, **Date** y **Content** del consentimiento a propiedades, para tener la prueba del consentimiento en HubSpot.

## Qué se envía y cuándo

Los nuevos registros se envían en uno o dos minutos. Los leads existentes se envían cuando activas la integración. Cuando alguien vuelve a participar, su contacto se actualiza.

## Solución de problemas

Los envíos fallidos aparecen en **Settings** > **Integrations** > **Delivery status** con el mensaje original de HubSpot.

- **El valor de una propiedad no es válido**: el valor no corresponde a la propiedad en HubSpot, por ejemplo, texto en una propiedad numérica o desplegable. Revisa la asignación o cambia el tipo de propiedad en HubSpot.
- **La conexión deja de funcionar**: se eliminó al usuario de HubSpot que conectó la app, o la app se desinstaló en HubSpot. Elimina la cuenta en la pestaña **Accounts**, vuelve a conectar HubSpot y elige la nueva cuenta en tus campañas.
- **Los contactos no reciben el nombre**: asigna "Lead - First name" a **First Name**. Solo el correo electrónico y el teléfono se completan automáticamente.

Integraciones

- [Cómo funcionan las integraciones](https://scratcher.io/es-419/help/integrations/how-integrations-work)
- [Todas las integraciones](https://scratcher.io/es-419/help/integrations/other-integrations)
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status)
- [Conecta HubSpot](https://scratcher.io/es-419/help/integrations/hubspot)
- [Conecta Salesforce Marketing Cloud](https://scratcher.io/es-419/help/integrations/salesforce-marketing-cloud)
- [Conecta Microsoft Dynamics 365 con Zapier](https://scratcher.io/es-419/help/integrations/microsoft-dynamics-365)
- [Conecta Emarsys](https://scratcher.io/es-419/help/integrations/emarsys)
- [Conecta Klaviyo](https://scratcher.io/es-419/help/integrations/klaviyo)
- [Conecta Mailchimp](https://scratcher.io/es-419/help/integrations/mailchimp)
- [Conecta ActiveCampaign](https://scratcher.io/es-419/help/integrations/activecampaign)
- [Conecta Apsis One](https://scratcher.io/es-419/help/integrations/apsis-one)
- [Conecta Drip](https://scratcher.io/es-419/help/integrations/drip)
- [Conecta HeyLoyalty](https://scratcher.io/es-419/help/integrations/heyloyalty)
- [Conecta Peytz](https://scratcher.io/es-419/help/integrations/peytz)
- [Conecta Marketingplatform](https://scratcher.io/es-419/help/integrations/marketingplatform)
- [Conecta Campaign Monitor con Zapier](https://scratcher.io/es-419/help/integrations/campaign-monitor)
- [Conecta ActiveTrail con Zapier](https://scratcher.io/es-419/help/integrations/activetrail)
- [Conecta Bloomreach](https://scratcher.io/es-419/help/integrations/bloomreach)
- [Conecta Iterable](https://scratcher.io/es-419/help/integrations/iterable)
- [Conectar Mapp](https://scratcher.io/es-419/help/integrations/mapp)
- [Conecta Agillic](https://scratcher.io/es-419/help/integrations/agillic)
- [Conecta Ortto](https://scratcher.io/es-419/help/integrations/ortto)
- [Conecta Emarketeer](https://scratcher.io/es-419/help/integrations/emarketeer)
- [Conecta Shopify](https://scratcher.io/es-419/help/integrations/shopify)
- [Conecta Hello Retail](https://scratcher.io/es-419/help/integrations/hello-retail)
- [Conecta más de 8.000 apps con Zapier](https://scratcher.io/es-419/help/integrations/zapier)
- [Conecta monday.com con Zapier](https://scratcher.io/es-419/help/integrations/monday-com)
- [Conecta Asana con Zapier](https://scratcher.io/es-419/help/integrations/asana)
- [Conecta Podio con Zapier](https://scratcher.io/es-419/help/integrations/podio)
- [Conecta Intercom con Zapier](https://scratcher.io/es-419/help/integrations/intercom)

Sigue aprendiendo

## Artículos relacionados

- [Cómo funcionan las integraciones](https://scratcher.io/es-419/help/integrations/how-integrations-work): Conecta tu herramienta de email o CRM una sola vez, actívala en cada campaña, elige una lista, asigna tus campos y envía solo a las personas que dieron su consentimiento.
- [Revisa el estado de envío y reenvía leads](https://scratcher.io/es-419/help/integrations/delivery-status): Consulta qué leads se enviaron a tus herramientas, entiende los mensajes de error, soluciona el problema y vuelve a enviarlos.
- [Solicita el consentimiento y agrega términos y condiciones](https://scratcher.io/es-419/help/forms/consent-and-permissions): Agrega casillas de consentimiento para newsletters, enlaza tus términos, elige qué casilla suscribe a las personas y envía a tu herramienta de email solo a quienes dijeron que sí.

¿Necesitas ayuda?

## ¿Sigues necesitando ayuda?

Hay personas reales para ayudarte. Si ya usas Scratcher, lo más rápido es el chat dentro de la plataforma.

- **[Chatea con nosotros](https://platform.scratcher.io/es-419/login)**

    Inicia sesión y haz clic en el botón del chat, abajo a la derecha. Rex responde al instante y nuestro equipo está a un clic.
- **[Agenda una reunión](https://scratcher.io/es-419/book-a-meeting)**

    Una videollamada gratuita de 30 minutos con nuestro equipo: una demostración, ideas para campañas o ayuda con tu configuración.
- **[Escríbenos](mailto:contact@scratcher.io)**

    Escribe a contact@scratcher.io y te responderemos.
