VipterCentro de Ayuda

Conectar HubSpot

Crea y actualiza el contacto en HubSpot en cada evento de venta, marca como cliente a quien pagó y abre un negocio para cada pedido pagado, en el pipeline y la etapa que elijas.

Admin o PropietarioTodos los planesVerificado el 4 oct 2026

Con HubSpot conectado, cada evento de venta de Vipter crea o actualiza el contacto del comprador por correo. Cuando entra el pago, el contacto pasa a ser cliente, y cada pedido pagado se convierte en un negocio asociado a él, con el valor y la fecha de la compra. Tu equipo comercial ve todo en el CRM sin escribir nada.

Antes de empezar, lee cómo funcionan las automatizaciones.

Antes de empezar

  • Una cuenta de HubSpot con permiso para crear aplicaciones privadas.
  • Rol Admin o Propietario en el proyecto de Vipter.

Paso 1: crear una aplicación privada en HubSpot

  1. En HubSpot, abre SettingsIntegrationsPrivate Apps (Configuración › Integraciones › Aplicaciones privadas) y haz clic en Create a private app (Crear una aplicación privada).
  2. Ponle un nombre, como Vipter.
  3. En la pestaña Scopes (Alcances), marca estos cuatro:
    • crm.objects.contacts.read
    • crm.objects.contacts.write
    • crm.objects.deals.read
    • crm.objects.deals.write
  4. Crea la aplicación y copia el Access token (Token de acceso). Empieza con pat-.

HubSpot cambia los menús de vez en cuando. Si no encuentras la opción, busca "private apps" (aplicaciones privadas) en el buscador de la configuración.

Creación de una aplicación privada en HubSpot con los alcances de contactos y negocios marcados
Ilustración provisional: la pantalla real puede tener pequeñas diferencias. La captura definitiva llegará pronto.

Guarda el token con cuidado

Con el token se pueden leer y cambiar los contactos y negocios de tu CRM. Pega el token solo en Vipter. Una vez guardado, el campo solo muestra el final.

Paso 2: conectar en Vipter

  1. En el panel de Vipter, abre GeneralIntegracionesCRM y email marketingHubSpot.
  2. En Conexión, completa los campos numerados.
Tarjeta Conexión de HubSpot en Vipter con el token, el pipeline y la etapa del negocio numerados
#CampoQué pegar
1Token de acceso de la aplicación privadaObligatorio · queda oculto después de guardarEl token de acceso de la aplicación privada, copiado en el paso 1.
2Pipeline (opcional)OpcionalEl ID interno del pipeline de negocios. En blanco, el negocio va al pipeline predeterminado (default).
3Etapa del negocio (opcional)OpcionalEl ID interno de la etapa en la que nace el negocio. En blanco, la etapa es Closed won (closedwon).
  1. En Eventos enviados, desmarca lo que no quieras enviar.
  2. Deja encendido Activo — enviar eventos a esta plataforma, haz clic en Guardar y después en Probar conexión.

El pipeline y la etapa piden el ID interno, que es distinto del nombre que aparece en pantalla. Los IDs están en la configuración de los pipelines de negocios de HubSpot. En el pipeline predeterminado, los IDs ya son default y closedwon, y puedes dejar los dos campos en blanco.

HubSpot no usa valores por evento ni reglas por oferta: lo que cambia de un evento a otro es lo que pasa en el contacto, descrito abajo.

Qué pasa en cada evento

EventoEn HubSpot
Cualquier eventoEl contacto se crea o se actualiza por correo, con nombre, apellido, teléfono con código de país y dirección. Un campo en blanco no borra lo que tu equipo ya completó.
Pedido pagado, Suscripción creada, Suscripción renovada, Pedido enviado, Pedido entregadoEl contacto también pasa a la etapa del ciclo de vida Customer (Cliente). Un contacto que ya está en una etapa posterior a Customer, como Evangelist (Evangelizador), se queda donde está.
Pedido pagadoUn negocio nuevo, asociado al contacto, con el nombre Produto · Pedido <número>, el valor, la fecha del pago, el pipeline, la etapa y la moneda del pedido.
  • Cada pedido pagado se convierte en un negocio, incluidas las renovaciones de suscripción, que son pedidos nuevos.
  • El negocio guarda Pedido Vipter <número> en la descripción. Así Vipter sabe que el negocio de ese pedido ya existe: un reintento o un reenvío no crea otro.
  • Si la cuenta de HubSpot no tiene la moneda del pedido, el negocio se crea en la moneda de la cuenta.

Probar con una compra

  1. Haz clic en Probar conexión. Vipter consulta un contacto con el token guardado.
  2. Haz una compra de prueba de una oferta, con tu correo.

Funcionó si

Aparece La conexión funciona, el evento Pedido pagado aparece como enviado en Envíos recientes, y HubSpot muestra el contacto como Customer, con el negocio del pedido asociado.

Envíos, reintentos y reenvío

  • enviado: contacto y, en el pedido pagado, negocio creados o ya existentes.
  • omitido: la venta no tiene correo (customer has no e-mail).
  • falló: una etapa falló. El motivo empieza por la etapa: contact, deal search o deal. Un rechazo de HubSpot, como la falta de un alcance, no se repite. Los fallos pasajeros reciben reintentos automáticos.

Después de corregir la causa, usa Reenviar. Consulta reintentos y reenvío.

Problemas comunes

  • La plataforma rechazó las credenciales con código 401

    El token está mal o se borró la aplicación privada. Copia el token de nuevo y guarda.

  • El contacto se crea, pero el pedido pagado falla en deal search o deal con 403

    La aplicación no tiene los alcances de negocios. Agrega crm.objects.deals.read y crm.objects.deals.write en la aplicación privada y usa Reenviar.

  • El pedido pagado falla en deal con 400

    El pipeline o la etapa no existen con ese ID. Usa el ID interno, no el nombre, y revisa que la etapa pertenezca al pipeline indicado.

Qué hacer después

  • Consulta los eventos enviados y cuándo sale cada uno.
  • Para recibir todos los datos del pedido en un sistema propio, usa los webhooks.
¿Te ayudó esta página?

En esta página

Idioma