Esta guía explica cómo conectar HubSpot al AI Voice Agent de Aircall y habilitar las acciones de IA para que tu agente pueda consultar y actualizar registros de HubSpot durante una llamada en tiempo real sin transferirla a una persona.
Acciones de HubSpot disponibles
Aircall predefine todas las acciones que aparecen a continuación. Sus entradas, salidas y comportamiento son fijos. Los administradores controlan qué acciones están habilitadas y qué agentes pueden utilizarlas, pero no pueden cambiar lo que hace una acción.
| Función | Qué hace |
|---|---|
| Obtener contacto | Busca un contacto por número de teléfono, correo electrónico o ID de contacto |
| Obtener empresa | Busca una empresa por número de teléfono, correo electrónico, dominio o ID de empresa |
| Crear contacto | Crea un nuevo registro de contacto |
| Actualizar contacto | Actualiza los datos de un contacto existente |
| Crear empresa | Crea un nuevo registro de empresa |
| Actualizar empresa | Actualiza los datos de una empresa existente |
| Disponibilidad para reuniones | Obtiene los horarios disponibles para reuniones de un calendario determinado |
| Reservar reunión | Reserva una reunión en nombre de la persona que llama |
Paso 1: Instalar la aplicación Aircall AI desde el marketplace de HubSpot
Las acciones de IA requieren una aplicación independiente del marketplace de HubSpot llamada Aircall AI. Es distinta de cualquier integración con Aircall y HubSpot que ya tengas instalada.
Al abrir la configuración de la integración con HubSpot en Aircall, un banner te pedirá que te autentiques e instales la aplicación.
Pasos:
- Haz clic en el banner de Aircall. Se te redirigirá al marketplace de HubSpot.
- Autentícate con la cuenta de HubSpot que quieras conectar.
- Instala la aplicación Aircall AI y aprueba los permisos solicitados.
- Vuelve a Aircall. La sección Acciones de IA ya estará desbloqueada.
Nota: Si la conexión OAuth caduca, el banner volverá a aparecer y todas las funciones quedarán deshabilitadas hasta que vuelvas a conectarte.
Paso 2: Habilitar funciones en la integración con HubSpot
Todas las funciones están desactivadas de forma predeterminada. Habilita únicamente las que quieras que utilicen tus agentes.
Pasos
- Ve a Panel de control de Aircall > Integraciones > Aplicaciones.
- Abre tu HubSpot conectado.
- En la sección Acciones de IA, activa las funciones que quieras hacer disponibles.
Importante: Habilitar una función aquí no afecta a las llamadas en tiempo real ni a las configuraciones existentes. Solo hace que la acción esté disponible para asignarla a AI Voice Agent. Si una función está desactivada, no aparecerá en la configuración del agente.
Paso 3: Asignar acciones a un AI Voice Agent
Pasos
- Ve a Panel de control de Aircall > Agentes de IA > AI Voice Agent y abre el agente que quieras configurar.
- En Capacidades funcionales, haz clic en Acciones de IA.
- Haz clic en + Añadir acción.
- Selecciona la acción de HubSpot en el menú desplegable y, a continuación, haz clic en Guardar acción.
Nota: Si una acción de HubSpot no aparece en el menú desplegable, no está habilitada en la integración. Vuelve al paso 2 y actívala.
Indicar al agente cuándo debe utilizar una acción
Después de añadir acciones, puedes proporcionar al agente instrucciones en lenguaje natural sobre cuándo utilizarlas. Por ejemplo, puedes especificar los tipos de preguntas de las personas que llaman que deben activar una búsqueda mediante Obtener contacto.
La acción en sí es fija. Estas instrucciones solo influyen en cuándo decide invocarla el agente durante una llamada.
Probar la configuración
Aircall ofrece dos formas de validar la configuración antes de ponerla en marcha.
Pestaña de pruebas de la integración:
- Ve a Panel de control de Aircall > Integraciones y API.
- Abre tu HubSpot conectado y ve a la pestaña Pruebas de acciones de IA.
- Selecciona una acción, completa los parámetros y haz clic en Ejecutar para comprobar la conexión y la respuesta de HubSpot.
Llamada de prueba en la configuración del agente:
- Ve a Panel de control de Aircall > Agentes de IA > AI Voice Agent y abre el agente que quieras configurar.
- Haz clic en Llamada de prueba en la ventana izquierda de la derecha para simular de principio a fin el comportamiento de una llamada real.
Importante: Las llamadas de prueba consumen minutos de AI Voice Agent y pueden crear registros reales de HubSpot. Utiliza un portal sandbox de HubSpot siempre que sea posible.
Facturación
Las acciones de IA están incluidas sin coste adicional. Las invocaciones se descuentan de tus minutos existentes de AI Voice Agent. No se cobra por invocación.
Preguntas frecuentes
¿Tengo que instalar la aplicación Aircall AI si ya tengo la integración de Aircall con HubSpot?
Sí. La aplicación Aircall AI es una aplicación independiente del marketplace de HubSpot necesaria específicamente para las acciones de IA. Tu integración existente de Aircall con HubSpot seguirá funcionando en paralelo.
¿Pueden los administradores cambiar lo que hace una acción?
No. Aircall define el comportamiento, las entradas y las salidas de cada acción, y no se pueden modificar. Los administradores solo controlan qué acciones están habilitadas y qué agentes pueden utilizarlas.
¿Están disponibles las acciones de IA de HubSpot en todos los planes de Aircall?
Las acciones de IA de HubSpot están incluidas en tus minutos existentes de AI Voice Agent. No se requiere ningún plan ni SKU adicional.
¿Qué ocurre si caduca la conexión OAuth de HubSpot?
El banner para volver a conectarse reaparecerá en Aircall y todas las funciones de las acciones de IA quedarán deshabilitadas hasta que vuelvas a autenticarte.
Estado de Aircall
Ayuda para iniciar sesión