Estado de Aircall
Ayuda para iniciar sesiónEsta guía explica cómo conectar HubSpot con el AI Voice Agent de Aircall y habilitar AI Actions, para que tu agente pueda buscar y actualizar registros de HubSpot durante una llamada en vivo sin transferirla a una persona.
Acciones de HubSpot disponibles
Cada acción que aparece a continuación está predefinida por Aircall. Sus entradas, salidas y comportamiento son fijos. Los administradores controlan qué acciones están habilitadas y qué agentes pueden usarlas, pero no pueden cambiar lo que hace una acción.
| Capacidad | Lo que 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 de reuniones | Obtiene franjas horarias disponibles para reuniones en un calendario determinado (próximamente) |
| Reservar reunión | Reserva una reunión en nombre de la persona que llama (próximamente) |
Paso 1: Instala la aplicación Aircall AI desde el marketplace de HubSpot
AI Actions requiere una aplicación independiente del marketplace de HubSpot llamada Aircall AI. Es distinta de cualquier integración existente entre Aircall y HubSpot que ya tengas instalada.
Cuando abras la configuración de la integración de HubSpot en Aircall, un banner te pedirá que te autentiques e instales la aplicación.
Pasos:
- Haz clic en el banner en Aircall. Serás redirigido al marketplace de HubSpot.
- Autentícate con la cuenta de HubSpot que quieres conectar.
- Instala la aplicación Aircall AI y aprueba los permisos solicitados.
- Vuelve a Aircall. La sección AI Actions ahora estará desbloqueada.
Nota: Si la conexión OAuth caduca en algún momento, el banner volverá a aparecer y todas las capacidades se desactivarán hasta que vuelvas a conectarte.
Paso 2: Habilita capacidades en la integración de HubSpot
Todas las capacidades están desactivadas de forma predeterminada. Habilita solo las que quieras que usen tus agentes.
Pasos
- Ve a Aircall Dashboard > Integraciones & API.
- Abre tu integración de HubSpot conectada.
- En la sección AI Actions, activa las capacidades que quieras poner a disposición.
Importante: Habilitar una capacidad aquí no afecta a las llamadas en vivo ni a las configuraciones existentes. Solo hace que la acción esté disponible para asignarla a AI Voice Agents. Si una capacidad está desactivada, no aparecerá en la configuración del agente.
Paso 3: Asigna acciones a un AI Voice Agent
Pasos
- Ve a Aircall Dashboard > AI Agents > AI Voice Agents y abre el agente que quieras configurar.
- En Functional abilities, haz clic en AI actions.
- Haz clic en + Add action.
- Selecciona la acción de HubSpot en el menú desplegable y luego haz clic en Save action.
Nota: Si falta una acción de HubSpot en el menú desplegable, no está habilitada en la integración. Vuelve al Paso 2 y actívala.
Indicarle al agente cuándo usar una acción
Después de agregar acciones, puedes proporcionar al agente instrucciones en lenguaje claro sobre cuándo debe usarlas. Por ejemplo, puedes especificar los tipos de preguntas de las personas que llaman que deberían activar una búsqueda de Get Contact.
La acción en sí es fija. Estas instrucciones solo influyen en cuándo el agente decide invocarla durante una llamada.
Probar tu configuración
Aircall ofrece dos formas de validar tu configuración antes de entrar en producción.
Pestaña Integration Testing:
- Ve a Aircall Dashboard > Integraciones & API.
- Abre tu integración de HubSpot conectada y ve a la pestaña AI Actions Testing.
- Selecciona una acción, completa los parámetros y haz clic en Execute para verificar la conexión y la respuesta de HubSpot.
Llamada de prueba en la configuración del agente:
- Ve a Aircall Dashboard > AI Agents > AI Voice Agents y abre el agente que quieras configurar.
- Haz clic en Test Call en la ventana derecha izquierda para simular el comportamiento real de una llamada de extremo a extremo.
Importante: Las llamadas de prueba consumen minutos de AI Voice Agent y pueden crear registros reales en HubSpot. Usa un portal sandbox de HubSpot cuando sea posible.
Facturación
AI Actions está incluido sin coste adicional. Las invocaciones cuentan dentro de tus minutos existentes de AI Voice Agent. No hay ningún cargo por invocación.
Preguntas frecuentes
¿Necesito 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 requerida específicamente para AI Actions. Tu integración existente entre Aircall y HubSpot sigue funcionando en paralelo.
¿Pueden los administradores cambiar lo que hace una acción?
No. El comportamiento, las entradas y las salidas de cada acción están definidos por Aircall y no se pueden modificar. Los administradores solo controlan qué acciones están habilitadas y qué agentes pueden usarlas.
¿Las AI Actions de HubSpot están disponibles en todos los planes de Aircall?
Las AI Actions de HubSpot están incluidas dentro de 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 de reconexión vuelve a aparecer en Aircall y todas las capacidades de AI Action se desactivan hasta que vuelvas a autenticarte.