Crear una Acción Personalizada

Las acciones personalizadas permiten integrar APIs o servicios externos dentro de la plataforma Anunzi IA. Con ellas, podés ampliar las funciones de tu asistente de voz: realizar llamadas a APIs, manipular datos o ejecutar tareas específicas antes o durante una llamada.

---

🧩 Paso a paso: configuración de una acción personalizada

1. Conectarse a la API

En esta sección configurás la llamada a la API definiendo:

• Method: seleccioná el método HTTP (GET, POST, PUT, PATCH).

• URL: el endpoint al que se enviará la solicitud, por ejemplo: https://api.example.com/v1/user/profile.

Subsecciones:

• Body: definí el contenido del cuerpo de la solicitud. Podés insertar variables usando <> (deben crearse previamente en la sección Variables).

• Headers: agregá pares clave-valor necesarios, como Content-Type: application/json.

• Authentication: si la API requiere autenticación, activá Authorization needed y añadí los datos correspondientes (por ejemplo, un token).

---

2. Variables

Las variables funcionan como espacios reservados que el asistente llena antes o durante la llamada.

• Before the Call: se establecen antes de iniciar la llamada (ejemplo: {user_phone_number} usa el número del llamante).

• During the Call: el asistente solicita la información al usuario durante la conversación (ejemplo: nombre, ID o número de cuenta). Podés definir su tipo (string, int, phone_number) y un ejemplo.

---

3. Detalles de la acción

Aquí definís qué hace tu acción:

• Name: nombre claro y descriptivo (ejemplo: Fetch User Profile).

Es clave que el nombre sea simple y refleje claramente su función.

• Description: breve descripción de lo que realiza (ejemplo: “Llama a la API para obtener los datos del usuario”).

• Speech: texto que dirá el asistente mientras la acción se ejecuta. Podés activar la opción para que la acción se ejecute antes de que comience la llamada.

---

4. Escribir un prompt con los resultados

Una vez configurada la acción, escribí un prompt para que el asistente use los resultados dentro de la conversación. Esto permite que responda basándose en los datos obtenidos o las tareas realizadas.

---

🚀 Beneficios de las acciones personalizadas

• Amplían las capacidades del asistente: integran datos y funciones en tiempo real (como consultar información de clientes o hacer cálculos).

• Flujos conversacionales dinámicos: adaptan la conversación según las respuestas del usuario o datos externos.

• Workflows personalizados: permiten crear procesos complejos con servicios de terceros, controlando completamente cómo se gestionan las llamadas.

Las acciones personalizadas de Anunzi IA brindan una estructura potente y flexible para conectar tus sistemas externos y potenciar el rendimiento de tu asistente según las necesidades de tu negocio.