Integraciones de API

Entendiendo las Integraciones de API

Auralytik proporciona dos formas de conectarse a APIs externas:

Gestionando Credenciales de API

Almacena y gestiona credenciales de autenticacion de forma segura para tus conexiones de API.

Accediendo a Credenciales

1. Navega a AI Integraciones desde la barra lateral
2. Selecciona la pestana Credenciales
3. Ve, crea o edita credenciales

Tipos de Autenticacion

Creando Credenciales

1. Haz clic en "Agregar Credencial"
2. Ingresa un nombre descriptivo (ej., "CRM Produccion API")
3. Selecciona el tipo de autenticacion
4. Ingresa los valores de credencial
5. Haz clic en "Guardar"

Creando Integraciones de API

Las integraciones completas de API te permiten configurar multiples endpoints con funciones avanzadas.

Creando una Integracion

1. Navega a AI Integraciones → Integraciones
2. Haz clic en "Crear Integracion"
3. Ingresa detalles de la integracion:
   • Nombre (ej., "CRM de Clientes")
   • URL Base (ej., "https://api.crm.com/v1")
   • Headers por defecto
   • Metodo de autenticacion
4. Agrega endpoints
5. Guarda la integracion

Configurando Endpoints

Cada integracion puede tener multiples endpoints:

Endpoint: Obtener Cliente
Metodo: GET
Ruta: /customers/{customerId}
Parametros:
  - customerId (ruta): Identificador del cliente

Endpoint: Actualizar Cliente
Metodo: PATCH
Ruta: /customers/{customerId}
Parametros:
  - customerId (ruta): Identificador del cliente
  - body (JSON): Payload de actúalizacion

Autenticacion Avanzada

Las integraciones completas soportan metodos de autenticacion avanzados:

Usando APIs en Flujos

Usa el paso LlamadaApi en tus flujos para interactúar con APIs externas.

Configuracion del Paso LlamadaApi

1. Agrega un paso LlamadaApi a tu flujo
2. Selecciona la integracion y endpoint
3. Mapea variables del flujo a parametros de API
4. Mapea campos de respuesta de API a variables del flujo

Mapeo de Parametros

Mapea datos de tu dataset o variables del flujo a parametros de API:

// Endpoint API: GET /customers/{customerId}
// Mapeo de parametros:
customerId → {{row.customer_id}}

// Endpoint API: POST /appointments
// Mapeo de body:
{
  "customer_id": "{{row.customer_id}}",
  "date": "{{extraido.fecha_preferida}}",
  "time": "{{extraido.hora_preferida}}",
  "notes": "{{clasificacion_ia}}"
}

Mapeo de Respuesta

Extrae datos de respuestas de API para usar en pasos subsiguientes:

// Respuesta API:
{
  "customer": {
    "name": "Juan Garcia",
    "balance": 150000,
    "status": "active"
  }
}

// Mapeo de respuesta:
nombre_cliente → response.customer.name
saldo_cliente → response.customer.balance
estado_cliente → response.customer.status

Manejo de Errores

Configura como manejar errores de API:

• Continuar: Proceder con el flujo aunque la API falle
• Reintentar: Reintentar la solicitud con backoff
• Fallar: Marcar la fila como fallida
• Ramificar: Dirigir a una rama de manejo de errores

Usando APIs en Acciones de Voz

Realiza llamadas API en tiempo real durante conversaciones de voz para proporcionar informacion dinamica.

Configurando Acciones de Voz con API

1. En tu paso LlamadaVoz, ve a Acciones
2. Agrega una accion LlamadaApi
3. Selecciona la integracion y endpoint
4. Define parametros que la IA debe recopilar del llamante
5. Configura la plantilla de respuesta para que la IA la hable

Ejemplo de API en Tiempo Real

// Accion: verificar_saldo
// Descripcion: Consultar saldo de cuenta del cliente
// Parametros:
//   - numero_cuenta: Numero de cuenta del cliente

// IA durante la llamada:
"Por favor indiqueme su numero de cuenta"
[Cliente: "1234567"]
// IA dispara llamada API con numero_cuenta=1234567

// Plantilla de respuesta:
"Su saldo actúal es {{response.balance}} pesos.
 Su proximo pago de {{response.next_payment}} vence el
 {{response.due_date}}."

Aprende Mas

Para detalles completos sobre configuracion de acciones de voz:Guia de Acciones de Voz →