Saltar al contenido
For the complete documentation index, see llms.txt. This page is also available as Markdown.

HubSpot

Conecta HubSpot una vez para todo el workspace de dCal y cada reserva aceptada se convierte en un contacto con una reunión. Conoce los dos permisos que necesita la aplicación privada, qué escribe dCal

Conecta HubSpot una vez y cada reserva que alguien de tu workspace acepte se convierte en un contacto de HubSpot con una reunión. Las reprogramaciones y cancelaciones actualizan esa misma reunión. En cada evento también puedes elegir qué respuestas de la reserva llenan qué propiedades del contacto.


Qué llega a HubSpot

Cuándo
Qué hace dCal en HubSpot

Se acepta una reserva

Busca el contacto por correo, o lo crea, y le agrega una reunión.

La reserva se reprograma

Mueve esa misma reunión al nuevo horario.

La reserva se cancela, o la rechazas

Marca esa misma reunión como cancelada y le pone al inicio del título [Cancelada] ([Canceled] si el anfitrión usa dCal en inglés).

  • Solo reservas aceptadas. Una reserva inmediata se escribe enseguida. Una solicitud que espera tu visto bueno se escribe cuando la confirmas, y una solicitud rechazada nunca se escribe.

  • Cuenta cualquier forma de reservar: tus páginas de reservas, las páginas de equipo, las reservas que creas desde Reservas, tus agentes de Dapta y la API.

  • El contacto. dCal busca el contacto por el correo exacto que escribió el invitado. Un contacto que ya existe conserva su nombre. Uno nuevo se crea con el correo, un nombre (la primera palabra del nombre que escribió el invitado) y un apellido (el resto). Solo la persona que reservó se convierte en contacto, nunca los invitados adicionales.

  • La reunión. Su título es el nombre del evento, lleva la hora de inicio y de fin, y su cuerpo muestra el anfitrión, cada respuesta del invitado, la campaña de la reserva cuando tiene una (una línea como utm_source: newsletter por cada etiqueta UTM que guardó) y la referencia de la reserva. El texto que parece HTML, en una respuesta o en una etiqueta UTM, llega como texto plano. El enlace para gestionar la reserva nunca se incluye. dCal no le asigna un propietario de HubSpot: el anfitrión aparece como texto en el cuerpo.

  • Nunca se borra nada en HubSpot, y dCal nunca crea propiedades ahí.

  • Nunca hace más lenta una reserva. dCal escribe en HubSpot en segundo plano, así que la reserva del invitado se completa aunque HubSpot esté lento.

💡 Tip: El ID de seguimiento de HubSpot que puedes poner en un evento, en Conexión con el CRM > Seguimiento y píxeles, es distinto de esta integración. Carga el código de seguimiento de HubSpot en la página de reservas de ese evento para que las visitas cuenten en HubSpot, y con los formularios recopilados activados en tu portal de HubSpot, HubSpot también puede capturar el formulario de reserva. Las reservas en sí llegan a HubSpot solo por esta integración. Mira Seguimiento y píxeles.


Antes de empezar

  • Eres administrador o propietario de tu workspace de dCal.

  • Puedes crear una aplicación privada en tu cuenta de HubSpot.


Conecta HubSpot

Paso 1: Entra a Ajustes > Integraciones, o abre app.dcal.ai/admin/settings/integrations. La tarjeta de HubSpot dice Sin conectar. Haz clic en Conectar.

La tarjeta de HubSpot en la pestaña Integraciones con la etiqueta Sin conectar y el botón Conectar, ambos marcados, y la línea Este espacio de trabajo no está enviando nada a HubSpot.
Una tarjeta, una conexión para todo el workspace.

Paso 2: El diálogo Conectar HubSpot muestra los dos permisos que necesita la aplicación privada. En HubSpot, crea una aplicación privada y concédele los dos:

  • crm.objects.contacts.read

  • crm.objects.contacts.write

Después copia el token de acceso de la aplicación. El diálogo te indica Configuración, Integraciones y Aplicaciones privadas en HubSpot; las cuentas más nuevas de HubSpot muestran las aplicaciones privadas en Development, Legacy apps. La guía de aplicaciones privadas de HubSpot tiene los pasos actuales.

El diálogo Conectar HubSpot con los dos permisos crm.objects.contacts.read y crm.objects.contacts.write como lista de verificación sin marcar y resaltada, el campo Token de acceso vacío, el campo opcional Nombre del portal y el botón Conectar todavía desactivado
Marca cada permiso a medida que lo concedes en HubSpot. Las marcas son solo una lista para ti.

⚠️ Nota: Concede los dos permisos antes de pegar el token. dCal comprueba el token leyendo de HubSpot, así que un token que solo puede leer igual se conecta, y la tarjeta pasa a Requiere atención con la primera reserva aceptada.


Paso 3: Pega el token en Token de acceso. Si quieres, ponle a la conexión un Nombre del portal (opcional), como Portal de ventas de Acme, para reconocerla después. Haz clic en Conectar.

dCal comprueba el token con HubSpot antes de guardar nada y no vuelve a mostrarlo. Verás HubSpot conectado. y la tarjeta dice Conectado, con el nombre del portal, Token terminado en con sus últimos cuatro caracteres y Última comprobación con una fecha.

Si la comprobación falla, no se guarda nada y el diálogo te dice por qué:

Mensaje
Qué hacer

HubSpot rechazó ese token. Comprueba que la aplicación privada esté activa y tenga los dos permisos.

Vuelve a copiar el token de la aplicación privada y revisa que la aplicación esté activa.

HubSpot indica que faltan estos permisos: seguido de los nombres de los permisos

Concede esos permisos a la aplicación privada en HubSpot y vuelve a hacer clic en Conectar.

No pudimos contactar con HubSpot para comprobar ese token. Inténtalo de nuevo en un momento.

Espera un momento y vuelve a hacer clic en Conectar.


Envía las respuestas de la reserva a propiedades del contacto

Las asignaciones se definen por evento. Cualquier persona que pueda editar el evento puede definirlas, una vez que el workspace está conectado.

Paso 4: Abre el evento desde Eventos y elige Conexión con el CRM > Enviar respuestas a tu CRM. Haz clic en + Asignar una respuesta, elige la Respuesta y la Propiedad de contacto que llena, y haz clic en Guardar cambios.

Grupo
Respuestas que puedes enviar

Preguntas del formulario

Las preguntas de la reserva de este evento.

Datos del invitado

Teléfono, Notas, Zona horaria, Idioma.

Datos del evento

Nombre del evento, Inicio de la reserva, Duración en minutos, Anfitrión asignado, Correo del anfitrión asignado.

Campaña (UTM)

Fuente (utm_source), Medio (utm_medium), Campaña (utm_campaign), Término (utm_term), Contenido (utm_content): las etiquetas UTM del enlace desde el que reservó el invitado. Mira Mide el origen de tus reservas.

  • Siempre se envía: el nombre y el correo identifican al contacto, por eso no se pueden asignar.

  • + Añadir otra propiedad envía la misma respuesta a más de una propiedad, hasta 10.

  • Cada propiedad acepta una sola respuesta, y un evento admite hasta 50 asignaciones.

  • La lista de propiedades solo ofrece las que encajan con la respuesta, como una propiedad numérica para una respuesta numérica, y solo las que dCal puede escribir. Si falta la que quieres, créala en HubSpot y haz clic en Actualizar propiedades.

  • Sugerir asignaciones completa por ti los pares obvios. Revísalos: nada se guarda hasta que haces clic en Guardar cambios.

  • En una pregunta de opciones, cada opción se empareja con una opción de HubSpot por su valor o su etiqueta, sin importar mayúsculas, tildes ni espacios. La sección te dice cuántas opciones coinciden, y una opción sin pareja no se envía.

  • Una etiqueta UTM llena una propiedad de texto, o un desplegable de una sola opción, como el origen de un lead: ahí, el valor de la etiqueta se empareja con una opción de la misma forma, y un valor sin pareja no se envía.

Si el workspace todavía no conectó HubSpot, la sección dice Todavía no hay ningún CRM conectado con un enlace Ir a Integraciones. Las asignaciones que ya definiste se conservan y vuelven a funcionar cuando HubSpot se reconecta.


Reglas de sobrescritura

Regla
Qué significa para ti

Una propiedad asignada se sobrescribe en cada reserva aceptada.

Siempre tiene la respuesta más reciente del contacto.

Una respuesta vacía nunca borra un valor.

Una pregunta opcional sin responder conserva lo que HubSpot ya tiene.

La campaña se escribe como un solo conjunto.

Cuando una reserva tiene alguna etiqueta UTM, una etiqueta asignada que le falta vacía su propiedad, así que dos campañas nunca se mezclan en un contacto. Una reserva sin etiquetas UTM deja la campaña anterior como está.

El nombre y el correo solo se escriben cuando dCal crea el contacto.

Un contacto que HubSpot ya conoce conserva su nombre.

Las propiedades asignadas se escriben cuando se acepta una reserva.

Reprogramar o cancelar no las toca.


Estados de la conexión

Etiqueta
Qué significa
Qué hacer

Sin conectar

Este workspace no envía nada a HubSpot.

Haz clic en Conectar.

Conectado

Las reservas aceptadas llegan a HubSpot.

Nada.

Requiere atención

Las reservas dejaron de llegar a HubSpot. La tarjeta muestra los permisos que, según HubSpot, faltan.

Concede esos permisos en HubSpot. La próxima reserva aceptada pasa sola; no hay nada que volver a pegar.

Desconectado

Se quitó el token. Las reservas existentes siguen apuntando a sus reuniones.

Haz clic en Reconectar y pega un token del mismo portal para retomar donde quedó.

Para dejar de enviar reservas, haz clic en Desconectar y luego en Sí, desconectar. No se borra nada dentro de HubSpot: los contactos y las reuniones que ya están ahí se quedan tal cual.

Relacionado

Última actualización