Conectores API

Esta sección permite integrar tu IVR o Chatbot con un servicio externo a través de una API. Con esto podrás enviar datos capturados por el flujo 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 Operador Automático o Chatbot en el nodo de Capturar Variable o Consulta API, según corresponda.

• 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 o Chatbot serán enviados a la API, y cómo se enviarán.

• • Nombre del parámetro a capturar del flujo
    Escribe el nombre del dato que será tomado desde el IVR o Chatbot.
    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

En esta sección defines qué valor devolverá la API y cómo será interpretado por el sistema para continuar el flujo dentro del IVR Operador Automático o Chatbot.

Debes completar los siguientes campos:

• • Nombre del campo a devolver del API

    Corresponde al nombre exacto del atributo que retorna la API en su respuesta. Este valor será leído por el sistema para evaluar condiciones dentro del flujo.

  • Tipo de dato

    Permite definir el formato del valor que devuelve la API. Según el tipo seleccionado, el flujo podrá tomar decisiones específicas dentro del IVR o Chatbot.

Opciones disponibles:

• • Numérico

    Se utiliza cuando la API devuelve un valor cuantitativo. Este tipo permite realizar comparaciones entre valores para definir condiciones dentro del flujo y dirigir la ejecución hacia distintas rutas según el resultado evaluado.

  • Boolean

    Se utiliza cuando la API devuelve un valor lógico verdadero o falso. Este tipo permite bifurcar el flujo en dos posibles caminos según la condición evaluada.

  • String

    Se utiliza cuando la API devuelve valores de texto o alfanuméricos. Este tipo permite comparar contenidos específicos para dirigir el flujo hacia distintos nodos según el valor recibido.

• Guardar e integrar

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

  

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 o Chatbots 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 o Chatbot vinculado.

¿Necesitas ayuda?

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

¡Estamos aquí para ayudarte!