Configura un AI Voice Agent saliente que califique los leads creados en HubSpot y los actualice automáticamente mediante Acciones de IA de HubSpot. Este artículo explica cómo crear el agente, conectarlo a HubSpot y configurar el flujo de trabajo que activa la llamada saliente.

Nota: En este artículo, usaremos un ejemplo basado en ACME, una empresa de SaaS con un formulario de leads entrantes en su sitio web, gestionado por HubSpot. En lugar de llamar y calificar manualmente cada nuevo lead, ACME quiere que un AI Voice Agent lo haga automáticamente. Las cuentas más grandes se transfieren a representantes de ventas en tiempo real, mientras que las cuentas más pequeñas son calificadas por el agente y registradas para que el equipo de ventas haga un seguimiento. El agente también recupera el registro de contacto del lead en HubSpot y actualiza el campo de etapa del ciclo de vida para reflejar que la calificación se ha completado.

Al implementar esta configuración, puedes calificar los leads en cuanto llegan, lo que garantiza que los leads con mayor potencial lleguen más rápido a tus representantes de ventas mientras aún están interesados. Esto acelera tu ciclo de ventas, mejora las tasas de conversión de lead a demostración y mantiene tu pipeline más limpio al filtrar los leads no calificados antes de que lleguen a tus representantes, lo que permite que tu equipo se centre en vender en lugar de buscar y calificar manualmente cada lead entrante.

Cómo funciona

Esta configuración puede adaptarse prácticamente a cualquier situación, pero este es el aspecto que tendría un flujo de llamada típico en el ejemplo de ACME:

  1. Un nuevo lead envía un formulario en el sitio web, gestionado por HubSpot, lo que crea un registro de contacto.
  2. El envío del formulario activa un flujo de trabajo de HubSpot, inscribe el registro de contacto e inicia una llamada saliente mediante el AI Voice Agent.
  3. El agente se conecta con el lead, activa la acción Obtener contacto para recuperar el registro de contacto y comienza la calificación, haciendo referencia a los campos del contacto como contexto de {{variable}} durante toda la conversación, incluido el número de licencias que necesita el lead.
  4. Si el lead tiene 15 usuarios o más, el agente activa la acción Actualizar contacto para actualizar la propiedad de etapa del ciclo de vida y, a continuación, transfiere inmediatamente la llamada a un representante de ventas.
  5. Si el lead tiene 14 usuarios o menos, el agente activa la acción Actualizar contacto para actualizar la propiedad de etapa del ciclo de vida y, a continuación, informa a la persona que llama de que el equipo de ventas se pondrá en contacto con ella en breve antes de finalizar la llamada cortésmente.

Antes de empezar

Esta guía presupone que ya cuentas con lo siguiente:

  • Tienes una cuenta activa de HubSpot con un formulario web de captación de leads.
  • El envío del formulario activa la creación de un registro de contacto en HubSpot y rellena los campos estándar firstname, lastname, phone y email del objeto de contacto.
  • La propiedad de etapa del ciclo de vida existe en el objeto de contacto y puede actualizarse mediante la Acción de IA Actualizar contacto.
  • Tienes una Integración con HubSpot activa en el Panel de Aircall.
  • El campo contact_phone debe tener el formato E.164 (por ejemplo, +14155551234).

Paso 1: Crea tu clave API de Aircall y tu token de autenticación básica

Antes de crear tu AI Voice Agent, genera una clave API en Aircall. El flujo de trabajo de HubSpot la utilizará para autenticar su solicitud al activar la llamada saliente. Como HubSpot requiere las credenciales en forma de token de autenticación básica en lugar de un par de ID y token de API sin procesar, primero tendrás que combinarlos y codificarlos.

Pasos

  1. En el Panel de Aircall, ve a Integraciones > Claves API desde el menú de navegación de la izquierda.
  2. Haz clic en Generar una clave API y asigna un nombre a la nueva clave.
  3. Copia tu ID de API y tu token de API y combínalos en una única cadena: API_ID:API_Token (sin espacios y separados por dos puntos).
  4. Codifica el resultado en Base64 mediante uno de los siguientes métodos:

    Herramienta del navegador: pega la cadena combinada en una herramienta de codificación Base64.

    Terminal (macOS/Linux):

    echo -n "YOUR_API_ID:YOUR_API_TOKEN" | base64

    Windows PowerShell:

    [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("YOUR_API_ID:YOUR_API_TOKEN"))
  5. El resultado es una cadena como YWJjMTIzOnRlc3R0b2tlbg==. Cópiala y guárdala en un lugar seguro; la necesitarás en el paso 5.
generate API key view

Paso 2: Activa las Acciones de IA

Activa las Acciones de IA en la Integración con HubSpot específica que quieras conectar a tu AI Voice Agent. En el ejemplo de ACME, esto significa activar Obtener contacto y Actualizar contacto.

Pasos

  1. Vuelve a la página de inicio de la API en el Panel de Aircall.
  2. Busca y selecciona tu Integración con HubSpot existente.
  3. Haz clic en la pestaña Acciones de IA de la barra de navegación superior.
  4. Activa Actualizar contacto y Obtener contacto en AI Voice Agent.
Image showing how to activate aI actions

Paso 3: Crea y configura tu AI Voice Agent

Crea tu agente.

Pasos

  1. Ve a Agentes de IA > AI Voice Agents desde el menú de navegación de la izquierda.
  2. Haz clic en Crear un AI Voice Agent y selecciona Llamadas salientes.

Una vez creado el agente, hay que configurarlo. Las siguientes secciones siguen el orden en el que aparecen en el menú de navegación de la izquierda del editor del agente de IA y explican la función que desempeña cada una en el caso práctico de ACME.

Para obtener más ayuda con estos pasos de configuración, consulta Configurar tu AI Voice Agent.

Asignación de números, Perfil del agente e Información de la empresa

  • Asignación de números: el número de teléfono desde el que el agente realizará la llamada cuando se active.
  • Perfil del agente: establece la identidad principal del agente.
  • Información de la empresa: define cómo se refiere el agente a tu empresa.
Imagen que muestra el perfil del agente

Información de la empresa

La Información de la empresa es donde proporcionas la información que el agente utiliza para responder a las preguntas de quien llama.

Consejo: Para este caso de uso, añade una fuente de conocimiento concisa por si el cliente potencial tiene preguntas sobre tu empresa. Para obtener el mejor rendimiento, evita intentar abarcarlo todo y céntrate en las preguntas más frecuentes sobre los temas más relevantes en esta fase del ciclo de ventas. Sobrecargar la base de conocimientos puede ralentizar las respuestas y reducir la precisión.
Imagen que muestra la fuente de la base de conocimientos

Guion de llamada: mensajes de bienvenida y despedida

Los mensajes de bienvenida y despedida definen lo que oye quien llama al principio y al final de una llamada.

El agente puede personalizar su saludo mediante variables dinámicas completadas a partir del registro de contacto de HubSpot. Todo lo que recopile tu formulario se asigna a una propiedad correspondiente del registro de contacto, ya sea un campo estándar como Nombre o una propiedad personalizada que hayas creado. Cualquiera de estas propiedades puede incluirse en la carga útil de contexto y utilizarse en el guion del agente como una {{variable}} (por ejemplo, asignar el nombre a la propiedad firstname te permite usar {{firstname}} en el saludo: «Hola, {{firstname}}. He visto que has enviado el formulario...»).

Para el caso de uso de ACME, este es el saludo configurado:

Hola, {{firstname}}. Soy el asistente de IA de ACME. He visto que has enviado el formulario para {{company}}. ¿Tienes un par de minutos para que te haga unas preguntas rápidas?
Nota: Para que el agente reconozca realmente la variable durante la llamada, esta debe incluirse explícitamente en la carga útil de contexto de la acción de código personalizado (que se explica más adelante en este artículo). No estará disponible automáticamente solo porque exista en el registro de contacto.
Imagen que muestra el guion de llamada

Pautas de conversación

Las Pautas de conversación te permiten definir cómo mantiene una conversación el agente, ajustando el tono, definiendo respuestas para determinadas frases e indicando cómo debe gestionar casos excepcionales. Aquí también estableces la lógica condicional que permite tomar decisiones de forma autónoma y da al agente la capacidad de razonar dentro de los límites que hayas establecido.

Para el caso de uso de ACME, las Pautas de conversación configuran una lógica condicional que dirige al agente en función de si el cliente potencial alcanza el umbral de 15 usuarios. Si lo alcanza, el agente transfiere la llamada a un representante de ventas. Si no, el agente completa el proceso de cualificación y comunica al cliente potencial que un representante de ventas se pondrá en contacto con él en breve.

## UMBRAL DE TRANSFERENCIA PARA LA CUALIFICACIÓN
- Transfiere siempre a quienes respondan a la pregunta de admisión «¿cuántas personas de tu equipo utilizarían esta herramienta?» con 15 o más

- De lo contrario, continúa con las preguntas de admisión hasta completar la cualificación, informa al cliente de que un representante de ventas se pondrá en contacto con él en breve y finaliza la llamada.

- No expliques el umbral a quien llama bajo ninguna circunstancia
Consejo: Puedes ampliar estas Pautas de conversación con frases adicionales específicas de tu empresa, ajustes de tono o indicaciones generales de comportamiento específicas de tu caso de uso.
Pautas de conversación

Flujo de trabajo de llamadas salientes

  • URL del Webhook: el ID de agente único de tu AI Voice Agent. Cópialo y guárdalo junto con el código de autenticación básica creado en el paso 1, ya que se utiliza en el flujo de trabajo de HubSpot.
  • Si se detecta el buzón de voz: define cómo reacciona tu agente si inicia una llamada saliente y llega al buzón de voz. Para este caso de uso, selecciona Colgar.

Reglas de desvío de llamadas

Las Reglas de desvío de llamadas definen si una llamada se transfiere, cuándo y a quién.

Para el caso de uso de ACME, la llamada solo debe transferirse al equipo de ventas si el cliente potencial cumple un criterio específico: 15 usuarios o más. Esta lógica condicional ya se aborda en las Pautas de conversación, pero aquí se refuerza y perfecciona:

  • Rol de transferencia = Equipo
  • Datos de contacto = Ventas
  • Condición de activación = La respuesta a «¿Aproximadamente cuántas personas de tu equipo utilizarían esta herramienta?» es mayor o igual que 15
  • Mensaje de transferencia = «Voy a ponerte en contacto con nuestro equipo de ventas. Un momento, por favor».
Flujo de trabajo de llamadas salientes

Flujo de admisión

Las preguntas de admisión te permiten configurar las preguntas de cualificación que el agente hace al cliente potencial, incluida la pregunta de umbral que determina si se transfiere la llamada.

Consejo: No hagas más de cinco preguntas de admisión. Hacer demasiadas puede alargar la conversación y frustrar a quien llama, así que limítate a lo que tu equipo realmente necesita en esta fase del ciclo de ventas. Evita también volver a preguntar cualquier dato que ya se haya recopilado en el formulario.

Cuando se transfiere una llamada, las preguntas de admisión se envían al representante que la recibe para proporcionarle contexto y, una vez que finaliza la llamada, se registran con un formato estructurado en el registro de llamadas de HubSpot y Aircall Workspace.

Para el caso de uso de ACME, las preguntas de admisión son:

  • ¿Cuál es el principal problema que esperas resolver con una herramienta como esta?
  • ¿Tienes en mente un plazo aproximado para tomar una decisión?
  • ¿Serías tú quien tomaría la decisión final o hay otras personas implicadas?
  • ¿Aproximadamente cuántas personas de tu equipo utilizarían esta herramienta?
intake flow

Acciones de IA

Añade las acciones de IA a tu AI Voice Agent.

Pasos

  1. Ve a Acciones de IA en el menú de navegación izquierdo del agente de IA.
  2. Haz clic en Añadir acción.
  3. En el panel lateral, abre la lista desplegable y selecciona HubSpot > Obtener contacto. Haz clic en Guardar acción. Haz lo mismo con HubSpot > Actualizar contacto.

Pautas de conversación para las acciones de IA

Aquí defines cuándo debe usar el agente cada acción y qué debe decir o hacer después.

Para el caso de uso de ACME, Obtener contacto recupera el contacto creado mediante el envío del formulario y Actualizar contacto actualiza la propiedad de la fase del ciclo de vida. Como esta llamada representa la cualificación de un lead, ACME actualiza la fase del ciclo de vida a Lead cualificado para ventas (valor interno: salesqualifiedlead). El valor al que debes actualizarla depende de si utilizas fases del ciclo de vida estándar o personalizadas y del punto del ciclo de ventas que representa esta llamada. Asegúrate de sustituir salesqualifiedlead por el valor correspondiente a tu caso de uso.

##Obtener contacto
- Cuando la persona que llama confirme que acepta responder a preguntas, utiliza «Obtener contacto» con el número {{phone}} de la persona que llama disponible en el contexto

- Pregunta «Solo para confirmar, ¿{{phone}} es el número de teléfono que tenemos registrado para ti?» y confirma si responde sí o no. Léelo en formato E164

- Si responde SÍ, la identidad queda confirmada. Guarda el contactId para usarlo en acciones posteriores y continúa con las preguntas de admisión.

- Si responde NO, pide a la persona que llama su dirección de correo electrónico e intenta usar «Obtener contacto» de nuevo. Si se encuentra el registro, la identidad queda confirmada. Guarda el contactId para usarlo en acciones posteriores y continúa con las preguntas de admisión.

- Si sigues sin poder recuperar el registro del contacto, discúlpate y dile a la persona que llama: «No puedo recuperar tu registro de contacto en nuestro sistema. Alguien de nuestro equipo de ventas se pondrá en contacto contigo lo antes posible mediante la información que proporcionaste en el formulario» y finaliza la llamada.

##Actualizar contacto
- Cuando la persona que llama haya respondido a la pregunta de cualificación (número de usuarios), utiliza «Actualizar contacto» con el contactId guardado anteriormente para actualizar lifecyclestage a "salesqualifiedlead".

- Actualizar contacto siempre debe ejecutarse antes de que la llamada se desvíe hacia una transferencia o despedida, para que la fase del ciclo de vida se actualice independientemente del resultado.
AI Actions conversational guidelines

Paso 4: Prueba tu agente de cualificación de leads

Cuando todo esté configurado y antes de continuar con la configuración de HubSpot, prueba minuciosamente tu agente mediante el panel Llamada de prueba situado a la derecha del editor del agente. Esto simula la experiencia de una llamada real sin enviar ninguna actividad de llamada a tu equipo ni activar actividad en HubSpot.

Completa tres escenarios para confirmar que el agente se comporta según lo previsto:

  • Escenario ideal: llama como un lead con 15 usuarios o más y confirma que el agente te transferirá a un representante de ventas (la transferencia no se realizará realmente, ya que se trata de una llamada simulada). Después, llama como un lead con menos de 15 usuarios y confirma que el propio agente completa la cualificación y te informa de que un representante de ventas se pondrá en contacto contigo.
  • Escenario ambiguo: da una respuesta imprecisa o insegura cuando te pregunten por tu número de usuarios (por ejemplo, «aún no lo sé») y observa cómo gestiona el agente la ambigüedad, si hace una pregunta aclaratoria o realiza una suposición.
  • Escenario problemático: pon a prueba al agente con condiciones difíciles, como interrumpirlo a mitad de una respuesta, dar respuestas contradictorias sobre el número de usuarios o pedirle que haga algo fuera de su ámbito (por ejemplo, «resérvame una demostración de todos modos»). Confirma que gestiona estas situaciones correctamente en lugar de proporcionar información incorrecta.

Si obtienes resultados inesperados, identifica el problema, realiza los ajustes necesarios y repite el proceso hasta que tengas la seguridad de que el agente está listo para cualificar leads.

Paso 5: Crea tu flujo de trabajo de HubSpot y una acción de código personalizado

A continuación, configura HubSpot creando un flujo de trabajo que active la llamada saliente del AI Voice Agent.

Pasos

  1. En HubSpot, ve a Automatización > Flujos de trabajo.
  2. Haz clic en Crear flujo de trabajo > Desde cero.

Activador de inscripción

Para el activador de inscripción, utiliza dos opciones: la inscripción manual, una práctica herramienta de prueba que te permite ejecutar el flujo de trabajo sin enviar cada vez el formulario real de leads, y la condición real que cumplirán los clientes potenciales, que consiste en enviar el formulario específico de leads.

Pasos

  1. En el activador de inscripción, selecciona Activar manualmente > Contacto > Guardar y continuar.
  2. Vuelve a hacer clic en el activador de inscripción y, debajo de O, selecciona Cuando se produzca un evento.
  3. En Añadir criterios, busca y selecciona Envío de formulario.
  4. De forma predeterminada, se añadirá El envío del formulario se ha completado cualquier número de veces en cualquier momento.
  5. Haz clic en + Añadir criterios y selecciona Nombre del formulario.
  6. Configura Nombre del formulario = es cualquiera de = [tu formulario de captación de leads].
  7. Haz clic en Guardar.

Reinscripción

Nota: Mantén desactivada la reinscripción para este flujo de trabajo, ya que cada lead solo debe cualificarse una vez por cada envío de formulario. Activarla podría generar llamadas salientes duplicadas si alguien envía el formulario más de una vez. Si quieres gestionar las llamadas sin respuesta, Aircall registra el resultado de la llamada en HubSpot, por lo que puedes plantearte crear otro flujo de trabajo de seguimiento que utilice esta información para volver a activar la llamada después de un intervalo, en lugar de depender aquí de la reinscripción.
Re-enrollment trigger

Acción de código personalizado

Pasos

  1. Debajo del activador de inscripción, haz clic en + para añadir una acción.
  2. Busca Código personalizado y selecciónalo.
  3. Elige Node.js 18.x como lenguaje.
  4. En Secretos, haz clic en Elegir un secreto > Añadir nuevo secreto.
  5. Nombre del secreto: AIRCALL_BASIC_AUTH (asegúrate de que no haya espacios).
  6. Valor del secreto: pega la cadena Base64 del paso 1.
  7. Guarda el secreto y vuelve a la acción.
  8. De nuevo en la acción, selecciona AIRCALL_BASIC_AUTH en el menú desplegable. Aparecerá como una etiqueta.
Acción de código personalizado

Propiedad que se incluirá en el código

Haz clic en Añadir propiedad para cada campo que el AI Voice Agent necesite para cualificar y personalizar la llamada. Para cada uno, selecciona la propiedad de HubSpot de la que se extraerán los datos y asígnale un nombre de variable, que será el nombre que utilizarás para hacer referencia a ese valor en el código (por ejemplo, event.inputFields['firstname']).

Cualquier {{variable}} que ya hayas utilizado en el saludo y las Pautas de conversación del agente debe incluirse aquí con un nombre de variable coincidente. De lo contrario, el agente no podrá acceder a ella durante la llamada.

Para el caso de uso de cualificación de leads de ACME y para la mayoría de los casos de uso de cualificación estándar, mantén esta lista breve. El agente solo necesita suficiente contexto para personalizar el saludo y confirmar la identidad de la persona que llama:

Propiedad de HubSpotNombre de la variablePor qué la necesitamos
Nombre (firstname)firstnamePersonaliza el saludo del agente
Apellidos (lastname)lastnamePersonaliza el saludo del agente
Número de teléfono (phone)phoneSe confirma con la persona que llama mediante Obtener contacto
Nombre de la empresa (company)companyPersonaliza el guion del agente
Correo electrónico (email)emailIdentificador alternativo si no se confirma el teléfono
ID del registro (hs_object_id)hs_object_idSe utiliza para evitar llamadas duplicadas e identificar el registro para las acciones del CRM
Nota: El ID del registro (hs_object_id) es el ID numérico interno de HubSpot para el registro del contacto. Se utiliza como idempotency_key para evitar llamadas duplicadas y como variable de contexto hubspot_contact_id para que las acciones Obtener contacto y Actualizar contacto del agente hagan referencia al registro correcto durante toda la llamada.
Propiedades

Pegar el código

Selecciona todo el contenido del editor de código y sustitúyelo por la plantilla siguiente. Después de pegarla, actualiza los siguientes marcadores de posición:

Marcador de posiciónSustituir por
YOUR_AGENT_IDEl ID del agente de IA de la URL del Webhook que copiaste en el paso 3 (por ejemplo, 01KS46D6J80BCRWG5KCBHJVKSC)
YOUR_PREFIXUn identificador breve para este flujo de trabajo (por ejemplo, acme-qualification)
const axios = require('axios');

exports.main = async (event, callback) => {
  // Pull contact fields from HubSpot
  const firstname     = event.inputFields['firstname'];
  const lastname      = event.inputFields['lastname'];
  const phone         = event.inputFields['phone'];
  const company       = event.inputFields['company'];
  const email         = event.inputFields['email'];
  const hs_contact_id = event.inputFields['hs_object_id'];

  // Auth and endpoint
  const basicAuth = process.env.AIRCALL_BASIC_AUTH;
  const agentUrl = 'https://api.aircall.io/v1/outbound-calls/agents/YOUR_AGENT_ID';

  try {
    const response = await axios.post(
      agentUrl,
      {
        contact_phone: phone,
        idempotency_key: `acme-qualification-${hs_contact_id}`, // unique per workflow + contact
        context: {
          firstname: firstname,
          lastname: lastname,
          company: company,
          email: email,
          hubspot_contact_id: String(hs_contact_id)
        },
        expiration_seconds: 600 // call attempt expires after 10 minutes if it can't connect
      },
      {
        headers: {
          Authorization: `Basic ${basicAuth}`,
          'Content-Type': 'application/json'
        }
      }
    );
    callback({ outputFields: { aircall_status: String(response.status), aircall_message: 'Call triggered successfully' } });
  } catch (error) {
    const status = error.response?.status || 500;
    const body = JSON.stringify(error.response?.data) || 'No response body';
    callback({ outputFields: { aircall_status: String(status), aircall_message: `Error: ${error.message} | ${body}` } });
  }
};
Importante: Las filas event.inputFields y context payload del código deben coincidir con los campos de variables que configuraste en Propiedad que se incluirá en el código, que a su vez deben coincidir con las variables utilizadas en el saludo y las Pautas de conversación de tu AI Voice Agent.
Código del cliente

Salidas de datos

En Salidas de datos, añade dos salidas. No afectan a la activación de la llamada, sino que aparecen en el historial del flujo de trabajo de HubSpot para facilitar la depuración.

  • Nombre de la salida = aircall_status. Tipo = cadena.
  • Nombre de la salida = aircall_message. Tipo = cadena.

El flujo de trabajo completado debería tener este aspecto: 

Flujo de trabajo completado

Paso 6: Prueba la acción de código personalizado y el flujo de trabajo

Antes de activar este flujo de trabajo para leads reales, pruébalo de principio a fin. Esto confirma tres cosas: que HubSpot puede autenticarse correctamente con Aircall, que la llamada saliente se activa realmente y que el agente recibe el contexto correcto para mantener la conversación según lo previsto. Realizar ahora la prueba con un contacto ficticio te permite detectar problemas de autenticación, errores de formato o variables que no coinciden antes de que afecten a un cliente potencial real.

Pasos

  1. En la acción de código personalizado, haz clic en Probar.
  2. Selecciona un registro de contacto con un número de teléfono. Para esta primera prueba, usa tus propios datos o un contacto interno ficticio, no un cliente potencial real.
  3. Comprueba la sección Resultados de datos después de la ejecución.
  4. aircall_status = 200 significa que se ha ejecutado correctamente. El agente llamará al número de teléfono de tu contacto de prueba y seguirá el guion.
  5. Si el estado no es 200, estos son algunos errores habituales y cómo corregirlos antes de la siguiente prueba:
ErrorCausa principalSolución
409, el agente saliente no tiene númeroNo hay ningún número de teléfono asignado al agente en AircallPanel de control > AI Voice Agents > [Agente] > Conectar número
401, no autorizadoToken de autenticación básica incorrecto o caducadoVuelve a generar `ID:TOKEN
400, contact_phone no válidoEl número de teléfono no tiene el formato E.164Normaliza la propiedad del teléfono en HubSpot
404, no encontradoEl ID del agente de la URL no existe en la cuentaVuelve a copiar la URL del Webhook desde Panel de control > AI Voice Agents > [Agente] > Flujo de trabajo de llamadas salientes
La llamada se inicia, pero el agente no tiene contextoLas claves de contexto del código no coinciden con los nombres de {{variable}} del guionComprueba las mayúsculas, las minúsculas y la ortografía. Por ejemplo, firstname en el código debe coincidir con {{firstname}} en el guion
Llamadas duplicadas al mismo contactoidempotency_key no es únicaAsegúrate de que idempotency_key incluya tanto el prefijo del flujo de trabajo como hs_contact_id

Activación del flujo de trabajo

Cuando hayas completado las pruebas, haz clic en Revisar y activar. Cuando aparezca la pregunta «¿Quieres inscribir a los contactos que actualmente cumplen los criterios de inscripción?», selecciona No, inscribir solo a los contactos que cumplan los criterios de inscripción después de activar el flujo de trabajo.

Tu flujo de trabajo y tu AI Voice Agent ya están activos.

Prácticas recomendadas

  • Mantén la Información de la empresa concisa y centrada en las preguntas más relevantes para esta etapa del ciclo de ventas, en lugar de intentar abarcarlo todo.
  • Limita las preguntas de admisión a cinco o menos y evita volver a preguntar información que ya se haya recopilado en el formulario del cliente potencial.
  • Mantén desactivada la reinscripción para que cada cliente potencial solo se cualifique una vez por cada envío del formulario.
  • Prueba el AI Voice Agent mediante el panel de llamada de prueba antes de continuar con la configuración de HubSpot. Después, prueba de principio a fin todo el flujo de trabajo de HubSpot con un contacto ficticio antes de activarlo para clientes potenciales reales.
  • Asegúrate de que cada {{variable}} utilizada en el saludo y las Pautas de conversación del agente también esté configurada en Propiedad que se incluirá en el código, con nombres de variables coincidentes.
  • Asegúrate de que idempotency_key incluya tanto el prefijo del flujo de trabajo como el ID de registro del contacto para evitar llamadas salientes duplicadas.

Preguntas frecuentes

¿Puede el AI Voice Agent actualizar registros de HubSpot sin transferir la llamada?

Sí. La acción Actualizar contacto se ejecuta antes de que la llamada se derive hacia una transferencia o una despedida, por lo que la etapa del ciclo de vida se actualiza independientemente del resultado.

¿Qué ocurre si el AI Voice Agent no puede confirmar la identidad de la persona que llama?

Solicita el correo electrónico de la persona que llama y vuelve a intentar la acción Obtener contacto. Si sigue sin poder recuperar el registro del contacto, se disculpa, informa a la persona que llama de que un miembro del equipo de ventas hará un seguimiento utilizando la información de su formulario y finaliza la llamada.

¿Por qué debe tener el número de teléfono el formato E.164?

El campo contact_phone debe tener el formato E.164 (por ejemplo, +14155551234) para que la llamada saliente se inicie correctamente. De lo contrario, el flujo de trabajo devolverá un error 400 y tendrás que normalizar la propiedad del teléfono en HubSpot.

¿Por qué debe permanecer desactivada la reinscripción para este flujo de trabajo?

Activar la reinscripción podría generar llamadas salientes duplicadas si un cliente potencial envía el formulario más de una vez. Si necesitas gestionar las llamadas sin respuesta, utiliza un flujo de trabajo de seguimiento independiente basado en el resultado de la llamada registrado en HubSpot, en lugar de depender de la reinscripción.

¿Qué ocurre si quiero cambiar el número de usuarios necesario para transferir la llamada al equipo de ventas?

Actualiza la condición de activación tanto en las Pautas de conversación como en las Reglas de desvío de llamadas para que reflejen tu propio umbral y el comportamiento del agente permanezca coordinado con la lógica de transferencia.

¿Puedo probar el flujo de trabajo sin enviar el formulario real del cliente potencial?

Sí. Utiliza la opción de inscripción manual del activador de inscripción. Esto te permite ejecutar el flujo de trabajo sin enviar el formulario cada vez que quieras probarlo.