Resumen
Esta guía explica cómo configurar la acción Crear o actualizar contacto de HubSpot en Astra. Una vez configurada, esta acción crea o actualiza automáticamente los registros de contacto en HubSpot en función de las conversaciones con los clientes, lo que le ayuda a mantener sus datos de CRM precisos y actualizados.
Cómo funciona la acción
Cuando se ejecuta esta acción:
Astra busca un contacto en HubSpot utilizando el correo electrónico del cliente
Si el contacto existe, actualiza el registro según su configuración
Si el contacto no existe, puede crear uno nuevo (dependiendo de su configuración)
Esto garantiza que sus datos de contacto permanezcan sincronizados sin esfuerzo manual.
Instrucciones
Siga estos pasos para configurar la acción:
Paso 1: Abra la plantilla de creación o actualización de contactos de HubSpot
Inicie sesión en su cuenta de Astra
Vaya a la Biblioteca de acciones
Seleccione HubSpot: crear o actualizar contacto
Abra el paso Configuración
Paso 2: Configure la intención de la acción
Qué debe hacer
Introduzca un nombre de acción e intención claros
Haga clic en Editar intención de la acción en cualquier momento para actualizarla
Qué sucede
Una intención bien definida ayuda al agente a decidir cuándo activar esta acción
Sincronización sin conexión
Mantenga esto DESACTIVADO para ejecutar la acción durante la conversación
Actívelo para ejecutar la acción una vez finalizada la conversación
Paso 3: Seleccione su cuenta de HubSpot
Qué debe hacer
Elija una cuenta de HubSpot existente
O haga clic en Añadir cuenta para conectar una nueva
Qué sucede
Todos los datos creados o actualizados por esta acción se guardarán en la cuenta seleccionada
Paso 4: Configure la creación y actualización de contactos
Permitir la creación y actualización de nuevos contactos
Cuando está activado:
Crea un nuevo contacto si no existe ninguno para el correo electrónico
Actualiza completamente los contactos creados a través de Astra
Cuando está desactivado:
No crea nuevos contactos
Permitir la actualización de campos existentes
Cuando está activado:
Actualiza los campos asignados para los contactos que ya están en HubSpot (incluso si no se crearon a través de Astra)
Cuando está desactivado:
No actualiza las propiedades de contacto existentes
Solo aplica las actualizaciones de resumen como una nota (si está configurado)
Paso 5: Asigne campos (HubSpot → Astra)
La asignación de campos define cómo fluyen los datos de Astra a HubSpot.
Qué debe hacer
Para cada fila:
Seleccione una propiedad de contacto de HubSpot (lado izquierdo)
Haga coincidirla con un campo de Astra (lado derecho)
Qué sucede
Cuando se ejecuta la acción, Astra escribe los datos asignados en las propiedades de contacto de HubSpot correspondientes
Campos obligatorios
Debe asignar el siguiente campo:
email
La acción no se ejecutará sin él.
Añadir más campos
Haga clic en Asignar campo para añadir asignaciones adicionales
Puede asignar:
Propiedades estándar (correo electrónico, teléfono, nombre, etc.)
Propiedades personalizadas de su cuenta de HubSpot
Nota: Solo los campos compatibles y las propiedades personalizadas editables (tipos de texto) están disponibles para la asignación.
Creación de nuevos campos Astra
Puede crear nuevos campos Astra mientras realiza la asignación.
Estos campos:
Estarán disponibles en la configuración del agente
Aparecerán como atributos de contacto para la selección
Uso del campo de resumen
Si se proporciona un resumen:
Astra crea o actualiza una nota en el contacto con el resumen de la conversación
Si también asigna una propiedad de HubSpot a Resumen:
El mismo resumen se escribe en esa propiedad de contacto
Aún se crea una nota y se vincula al contacto
Qué sucede cuando se ejecuta la acción
Este es el comportamiento de extremo a extremo:
Astra busca un contacto utilizando el correo electrónico asignado
Si no se encuentra ningún contacto:
Solo se crea un nuevo contacto si lo permiten sus ajustes
Si existe un contacto:
El contacto se actualiza según su configuración
Si las actualizaciones completas están restringidas:
Solo se puede añadir o actualizar la nota de resumen
Función adicional: Sincronización sin conexión
La sincronización sin conexión permite que la acción se ejecute después de que finalice la conversación en lugar de durante la conversación.
Cuando está activada
La acción se ejecuta una vez finalizada la conversación
Condiciones de finalización de la conversación
Agente de texto: 10 minutos después del último mensaje
Agente de voz: Cuando finaliza la llamada
Esto es útil cuando desea capturar información finalizada en lugar de actualizar los datos en tiempo real.
Qué hacer a continuación
Una vez configurada, su acción automáticamente:
Captura los detalles del cliente de las conversaciones
Crea o actualiza contactos en HubSpot
Mantenga sus datos de CRM actualizados sin esfuerzo manual
Ahora puede usar esta acción como parte de sus flujos de trabajo de automatización en Astra.