Conectores API

Esta sección permite integrar tu IVR con un servicio externo a través de una API. Con esto podrás enviar datos capturados por el IVR y recibir una respuesta que permitirá decidir hacia qué parte del flujo continuar.

Integrar Conector API

Vamos a ver el proceso y los datos necesarios para la integración de un conector API y así luego utilizarlo en el flujo del IVR en el nodo de Capturar Variable.

• Información general

  • Nombre del conector de API
    Ingresa un nombre único que identifique la función del conector.
    Ejemplo: Validación de DNI, Consulta de deuda, Estado del cliente.
  • Descripción
    Agrega una breve descripción del objetivo del conector.
  • Tipo de petición
    

    Selecciona el método HTTP que utilizará la API.
    Opciones disponibles:

    • GET

    • POST

  • URL de API Server
    Ingresa la URL del endpoint del servicio externo.
    Debe iniciar con https://
  • Datos de autenticación
    

    Si tu servicio externo requiere autenticación, selecciona el tipo correspondiente:

    • Basic Auth

    • API Key

    • Token

    Al seleccionar una opción, se mostrarán los campos necesarios para completarla.

• Configuración
  

En esta sección defines qué datos capturados por el IVR serán enviados a la API, y cómo se enviarán.

• • Nombre del parámetro a capturar del IVR
    Escribe el nombre del dato que será tomado desde el IVR.
    Ejemplos:
    • dni
    • numero_documento
    • telefono
  • Tipo de envío
    

    Selecciona cómo se enviará el parámetro:

    • Body

    • Params 

    Dependiendo de la opción elegida, aparecerán campos adicionales para completar la estructura del envío.

• Respuesta del API

Luego de recibir la respuesta de la API, podrás definir qué valor debe leer el IVR para tomar decisiones dentro del flujo.

• • Nombre del campo a devolver del API
    Utiliza una clave única proporcionada por el servicio para autorizar las peticiones de la API.
  • Tipo de dato
    Especifica el tipo de valor que devuelve el campo de la API

• Guardar e integrar

  Para finalizar, haz clic en Integrar.
  Esto habilitará el conector para ser usado dentro del flujo de IVR Operador Automático.

  

Acciones para conectores de API

En este apartado puedes crear y gestionar múltiples conectores de API. Para cada conector, tendrás disponibles las siguientes acciones:

Ver detalles

Al hacer clic en el ícono Ver detalles dentro de un conector API, se abre una ventana modal que muestra toda la información configurada para ese conector. Esta vista es solo de consulta y permite revisar rápidamente los parámetros técnicos sin riesgo de modificar nada.

Editar

La opción Editar permite acceder al formulario completo de configuración del conector API para modificar cualquier dato previamente registrado, incluyendo nombre, descripción, método de petición, URL, headers y parámetros. Desde esta vista el usuario puede actualizar la información técnica del conector y guardar los cambios que impactarán en los IVR que lo utilicen.

Eliminar

La opción Eliminar permite borrar un conector API de manera permanente.
Al seleccionarla, se muestra una ventana de confirmación donde el usuario debe validar si desea continuar con la eliminación. Este proceso es irreversible y, al confirmar, el conector deja de estar disponible para su uso en cualquier IVR vinculado.

¿Necesitas ayuda?

Si tienes dudas o necesitas soporte adicional, puedes escribirnos a:
📩 support@beexcc.com

¡Estamos aquí para ayudarte!