Configurar la Distribución inteligente al Propietario del contacto de HubSpot mediante el widget Ring-to (a través de la API) en un flujo de llamadas

Configura la distribución inteligente al propietario del contacto de HubSpot en un número de teléfono compartido de Aircall para garantizar que las personas que llaman se comuniquen de forma eficiente con su punto de contacto asignado.

Nota: Es posible que el videotutorial muestre la versión anterior de la sección Probar respuesta. Consulta siempre los pasos escritos de este artículo para obtener las indicaciones más recientes.

En esta guía aprenderás:

• Cómo mejora el widget Llamar a (mediante API) la eficiencia y la experiencia del cliente

• Cómo configurar la distribución inteligente al propietario del contacto de HubSpot

  • Primer paso: Crear campos personalizados en HubSpot y generar un token de portador

  • Segundo paso: Configurar el widget Llamar a (mediante API) en el editor de flujos

Importante: El widget Llamar a (mediante API) solo está disponible con el plan Professional. Para cambiar de plan, ponte en contacto con tu gestor de cuenta de Aircall.

Cómo mejora el widget Llamar a (mediante API) la eficiencia y la experiencia del cliente

La distribución inteligente en un número de teléfono compartido ofrece importantes ventajas en cuanto a eficiencia, precisión y experiencia del cliente. Al dirigir de forma inteligente las llamadas entrantes según los datos del CRM, la distribución inteligente garantiza que cada persona que llama contacte rápidamente con la persona adecuada, lo que reduce los tiempos de espera y mejora las tasas de resolución en la primera llamada.

Al utilizar el widget Llamar a (mediante API) de Aircall en un flujo de llamadas, una implementación habitual dirige a las personas que llaman directamente a su propietario del contacto de HubSpot. Esto evita que todo el equipo se vea interrumpido por llamadas que no le corresponden y elimina la necesidad de poner a las personas que llaman en espera mientras se las transfiere a su contacto asignado.

Cómo configurar la distribución inteligente al propietario del contacto de HubSpot

Primer paso: Crea propiedades personalizadas en HubSpot y genera un token de portador

Importante: Este paso requiere familiaridad con los campos personalizados y las aplicaciones privadas de HubSpot.

Comienza en HubSpot creando una propiedad personalizada para almacenar la dirección de correo electrónico del propietario del contacto.

Pasos

1. Ve a Propiedades de contacto en la configuración de HubSpot.

2. Selecciona Crear propiedad.

3. Completa los detalles de la propiedad de la siguiente manera:

Nota: Configura la sección Reglas como quieras, pero asegúrate de que los caracteres especiales no estén restringidos, ya que las direcciones de correo electrónico incluyen caracteres como @ y .

4. A continuación, puedes crear un flujo de trabajo de HubSpot para rellenar este campo automáticamente:

• Inscribe todos los contactos nuevos al crearlos.

• Para incluir los contactos existentes, selecciona Sí, inscribir ahora a los contactos existentes que cumplan los criterios del activador en el paso Revisar y publicar de la configuración del flujo de trabajo.

5. Una vez creada la propiedad, rellénala con una dirección de correo electrónico. Necesitarás este valor más adelante para comprobar la validez de la ruta en el widget Llamar a (mediante API).

6. A continuación, genera un token Bearer en tu portal para desarrolladores de HubSpot. Este token autenticará tu solicitud de API al configurar el widget Llamar a (mediante API) en el editor de flujos. Para obtener instrucciones detalladas, consulta la guía de HubSpot sobre aplicaciones privadas.

Paso 2: Configura el widget Llamar a (mediante API) en el editor de flujos

Importante: Esta sección requiere estar familiarizado con la API REST de HubSpot, JSON y los flujos de llamadas.

1. Ve a Panel de control de Aircall > Números y abre el número cuyo flujo de llamadas quieras configurar.

   • Es importante tener en cuenta que no es necesario asignar a la configuración del flujo de llamadas a los usuarios de Aircall a quienes se dirigirán llamadas mediante la API. Si están asignados, recibirán notificaciones de llamadas perdidas en su lista de tareas pendientes si no responden a la llamada transferida. Sin embargo, no recibirán estas notificaciones si no están asignados al número.

2. Ve al número de teléfono en el que quieras configurar el widget Llamar a (mediante API). Añade el widget Llamar a (mediante API) en el lugar deseado de la configuración del flujo de llamadas para abrir el editor del widget.

3. Establece el Método de autenticación en Token Bearer y haz clic en Establecer credenciales. En el formulario emergente de credenciales, pega el token Bearer creado en el paso anterior.

4. Vuelve al editor del widget y completa la configuración de la solicitud:

• URL: https://api.hubapi.com/crm/v3/objects/contacts/search

• Método: POST

• Cuerpo:

  Copiar

  {
    "properties": [
      "firstname",
      "lastname",
      "company",
      "email",
      "hubspot_owner_id",
      "aircall_contact_owner_email",
      "hs_calculated_phone_number",
      "hs_calculated_mobile_number",
      "hs_searchable_calculated_phone_number",
      "hs_searchable_calculated_mobile_number",
      "last_used_aircall_phone_number"
    ],
    "filterGroups": [
      {
        "filters": [
          {
            "propertyName": "hs_calculated_mobile_number",
            "operator": "EQ",
            "value": "{{callerNumber}}"
          }
        ]
      },
      {
        "filters": [
          {
            "propertyName": "hs_calculated_phone_number",
            "operator": "EQ",
            "value": "{{callerNumber}}"
          }
        ]
      }
    ],
    "sorts": [
      {
        "propertyName": "lastmodifieddate",
        "direction": "DESCENDING"
      }
    ],
    "limit": 10
  }

5. Establece la configuración de la respuesta:

• Tipo de respuesta = Usuario (ID o correo electrónico)
• Ruta = results[0].properties.aircall_contact_owner_email

6. Ejecuta una prueba en el campo específico Probar respuesta:

• Introduce un número de teléfono válido en el formato internacional E.164.

• Confirma que se devuelva una carga útil JSON.

• Confirma que la Ruta sea válida para encontrar el valor utilizado para transferir o dirigir la llamada entrante.

• Confirma que la dirección de correo electrónico del contacto existente coincida con la dirección de correo electrónico de un usuario existente en Aircall.

Consejo: Ajusta la configuración de timbre directamente debajo de la prueba para adaptarla a las operaciones de tu empresa.

Ahora ya puedes empezar a probar las llamadas entrantes para la Distribución inteligente al Propietario del contacto de HubSpot mediante el widget Llamar a (mediante API).