🤖 Ficha del agente

La ficha del agente es la pantalla central donde configuras todos los aspectos de un agente de voz: su identidad, instrucciones, voz, funciones disponibles, comportamiento y los datos que extrae de cada llamada. Cada sección se guarda de forma independiente.

---

Cómo acceder#

En el menú lateral ve a Agentes de Llamada, selecciona el agente que quieres configurar y haz clic en su nombre.

---

Encabezado del agente#

En la parte superior verás:

• Nombre del agente
• ID del agente — identificador único del agente en el sistema.
• API Token — token de autenticación del agente. Haz clic sobre él para copiarlo al portapapeles. Se usa para autenticar las herramientas del sistema y la API de llamadas.
• Teléfono — número asignado al agente, si tiene uno configurado.
• Insignias de estado: Canal (Voz / Voz + WhatsApp), Dirección (Entrante / Saliente), Estado (Activo / Inactivo).

---

Probar agente de voz en tiempo real#

Justo debajo del encabezado aparece el bloque de prueba. Te permite iniciar una llamada de voz con el agente directamente desde el navegador, sin necesidad de un teléfono.

⚠️ Las llamadas de prueba se cobran igual que las llamadas entrantes reales: por minuto, según la tarifa voice_inbound de tu plan. El saldo se descuenta del titular del agente al finalizar la llamada.

---

Probar LLM en texto#

Debajo del bloque de prueba de voz aparece Probar LLM en texto (tarjeta celeste). Te permite conversar con el agente por escrito para verificar cómo responde, qué funciones ejecuta y cómo transita entre nodos o estados, sin gastar minutos de llamada.

Es la forma más rápida y económica de iterar sobre el prompt y las funciones: pruebas el comportamiento del LLM sin hacer una llamada real.

Cómo usarlo#

1. Escribe un mensaje como si fueras el cliente y presiona Enviar (o la tecla Enter).
2. El agente responde en el chat. Debajo del último mensaje verás información de diagnóstico del turno.
3. Usa ↻ Reiniciar para empezar una conversación nueva desde cero.

Qué muestra el chat#

Además de los mensajes del cliente y del agente, el chat muestra "en vivo" lo que ocurre por dentro:

💡 El chat usa la versión actual del agente (el borrador que estás editando), así que pruebas exactamente los cambios que acabas de hacer, sin necesidad de publicar.

⚠️ Cada mensaje se cobra 2 créditos (equivalente a $0.02). Es mucho más económico que un minuto de voz, pero se descuenta del saldo del titular del agente. Si la cuenta no tiene créditos, el chat avisa y no envía el mensaje.

---

Sección: Identidad#

Define la información básica del agente, visible dentro del panel.

Haz clic en Guardar identidad para aplicar los cambios.

---

Sección: Instrucciones del agente#

Define el comportamiento del agente durante las llamadas. Es la configuración más importante: determina quién es, cómo responde y qué puede o no puede hacer.

Haz clic en Guardar instrucciones para aplicar los cambios. Los cambios toman efecto desde la próxima llamada.

💡 Usa párrafos y listas en las instrucciones para estructurar el comportamiento en secciones claras (presentación, flujo de conversación, casos especiales, cierre).

---

Sección: Voz del agente#

Define con qué voz habla el agente y cómo suena.

Cambiar la voz#

Haz clic en 🎙️ Cambiar voz (o Elegir voz si aún no tiene una asignada) para abrir el selector. El selector tiene dos pestañas: Voces de la plataforma y 🧬 ElevenLabs.

Pestaña "Voces de la plataforma"#

Es el catálogo de voces disponibles. Dentro puedes:

• 🔍 Buscar por nombre de voz.
• Filtrar por idioma usando las pastillas de idioma.
• Filtrar por género: Todos / Femenina / Masculina.
• Escuchar la vista previa de audio de cada voz antes de seleccionarla.

Haz clic en Seleccionar en la tarjeta de la voz que prefieras.

Pestaña "🧬 ElevenLabs"#

Te permite agregar cualquier voz de la biblioteca pública de ElevenLabs usando solo su ID, sin salir del panel.

1. Abre la biblioteca de voces de ElevenLabs y copia el ID de la voz que quieras (ej: 9FG0AH71kXEuvM9IJg7u).
2. Pégalo en el campo ID de voz de ElevenLabs. Opcionalmente escribe un Nombre; si lo dejas vacío se toma el nombre original de ElevenLabs.
3. Haz clic en Agregar voz. El sistema detecta automáticamente el dueño de la voz y la incorpora a tu catálogo.
4. Aparece la voz resultante como una tarjeta con su vista previa. Haz clic en Seleccionar esta voz.
5. Confirma con Guardar voz para asignarla al agente.

Una vez agregada, la voz también queda disponible en la pestaña Voces de la plataforma para reutilizarla en otros agentes.

💡 El campo Public owner ID dentro de Opciones avanzadas casi nunca se necesita: el dueño se detecta solo. Úsalo únicamente si quieres forzar un dueño específico.

⚠️ Funciona con voces publicadas en la biblioteca de ElevenLabs. Si el ID corresponde a una voz privada no compartida, el sistema avisa que no pudo encontrarla.

Ajustes de la voz#

También seleccionas el Idioma en que el agente interpreta y habla.

Haz clic en Guardar voz para aplicar los cambios.

---

Sección: Base de conocimiento#

La base de conocimiento es el contenido que el agente puede consultar durante una llamada: preguntas frecuentes, catálogos de productos, políticas de la empresa, etc.

Bases vinculadas#

Cada base de conocimiento aparece como una tarjeta con su nombre, estado y acciones:

Ver fuentes de una base#

Haz clic en 📋 Fuentes para expandir el panel de fuentes de esa base. Cada fuente muestra:

• 📄 Documentos — nombre del archivo y tamaño.
• 🔗 URLs — dirección web indexada.
• ✏️ Textos — título del contenido.

Desde ese panel puedes:

• ⬇️ — Descargar o abrir la fuente original.
• 🗑️ — Eliminar esa fuente de la base. La base se reprocesa automáticamente.

Agregar fuentes a una base existente#

Haz clic en ➕ Agregar en la tarjeta de la base. Se abre un modal con tres tabs:

Desvincular una base#

Haz clic en Desvincular para quitar la base de este agente. La base no se elimina de tu cuenta — solo deja de estar disponible para este agente.

Crear una nueva base#

Haz clic en ➕ Crear nueva base. Ingresa un nombre (máx. 40 caracteres) y, opcionalmente, un archivo inicial. Puedes agregar más fuentes después.

Vincular una base existente#

Haz clic en 🔗 Vincular existente para ver todas las bases de tu cuenta que aún no están vinculadas a este agente. Haz clic en Vincular en la que quieras agregar.

⚠️ El agente consulta la base solo cuando la pregunta del usuario lo requiere. No cita los documentos textualmente: los interpreta para dar respuestas naturales.

---

Sección: Funciones del agente#

Las funciones permiten que el agente realice acciones concretas durante la llamada: transferir, consultar disponibilidad, agendar, ejecutar código, llamar a una API externa o usar herramientas integradas del sistema.

Herramientas del Sistema#

Son funciones predefinidas que se integran directamente con el panel Anunzi. Se autentican automáticamente con el API Token del agente.

🎫 Sistema de Tickets de soporte#

Activa tres funciones juntas para que el agente pueda gestionar reclamos durante la llamada:

Cuando el agente crea un ticket, el contacto recibe su número de caso (ej: "tu número de caso es el 42"). Los tickets quedan visibles en la sección Tickets del panel.

👤 Consultar contacto#

Permite al agente consultar la ficha y el historial reciente del contacto durante la llamada.

El agente busca por el número de teléfono del contacto y recibe nombre, estado, datos del lead y notas de los últimos 7 días.

---

📝 Agregar nota al contacto#

Permite al agente registrar una nota en el perfil del contacto durante la llamada. La nota queda guardada en el historial del lead y es visible desde su ficha en el panel.

Casos de uso típicos:

• Dejar constancia de lo que el contacto solicitó o acordó en la llamada.
• Registrar compromisos, fechas importantes o preferencias del contacto.
• Documentar el resultado de la llamada directamente desde la conversación.

⚠️ Si el número de teléfono no coincide con ningún contacto existente en tu cuenta, la nota no se guarda y el agente recibe un mensaje de error.

---

🕐 Verificar horario actual#

Permite al agente consultar la fecha y hora actuales en una zona horaria específica. Útil para informar al contacto qué hora es, verificar si se está dentro del horario de atención o referenciar la fecha en la conversación.

Al agregar esta función, selecciona la zona horaria en la que opera tu empresa. Las opciones disponibles cubren las principales zonas de América y Europa.

Casos de uso típicos:

• "¿En qué horario pueden llamarme?" → el agente consulta la hora actual y responde en contexto.
• Verificar si una sucursal está abierta antes de ofrecer un turno.
• Registrar en la conversación la fecha y hora exacta de un compromiso.

💡 La zona horaria se configura una sola vez en la ficha del agente. No es necesario que el contacto la mencione durante la llamada.

---

💬 Consultar conversación de WhatsApp#

Permite al agente recuperar el historial reciente de mensajes de WhatsApp de un contacto. Así el agente tiene contexto de lo que se habló por escrito antes o durante la llamada.

Al activar esta función se inyectan automáticamente las instrucciones necesarias en el prompt del agente para que sepa cuándo y cómo usarla.

Casos de uso típicos:

• El contacto llama para continuar una consulta que empezó por WhatsApp — el agente ya sabe de qué se trata.
• Verificar si el contacto recibió o respondió un mensaje enviado previamente.
• Dar seguimiento a una conversación sin pedirle al contacto que repita todo desde cero.

⚠️ El agente de WhatsApp seleccionado debe pertenecer a la misma cuenta. Si no hay conversaciones registradas para ese número, la función informa que no se encontraron mensajes.

---

📅 Google Calendar#

Permite al agente consultar disponibilidad y gestionar reuniones directamente en Google Calendar durante la llamada. Cada reunión incluye automáticamente un link de videollamada de Google Meet que le llega al contacto por email.

Requisito previo: conectar Google Calendar en Integraciones antes de activar esta función. Ver Google Calendar.

Agrega 4 funciones al agente:

No requiere campos adicionales al activar — el agente usa el calendario configurado en Integraciones.

---

🟢 Go High Level (CRM)#

Permite al agente trabajar directamente sobre tu CRM de Go High Level durante la llamada: buscar el contacto, crearlo o actualizarlo, dejar notas visibles, etiquetar, abrir oportunidades en tu pipeline y agendar citas.

Requisito previo: conectar Go High Level en Integraciones antes de activar esta función. Ver Go High Level.

A diferencia de Cal.com y Google Calendar, las funciones de GHL se activan por separado: podés elegir solo las que necesitás (por ejemplo, solo el CRM y usar Google Calendar para las citas).

No requiere campos adicionales al activar — el agente usa las credenciales y el pipeline/calendario configurados en Integraciones.

---

🟠 Clientify (CRM)#

Permite al agente trabajar directamente sobre tu CRM de Clientify durante la llamada: buscar el contacto, crearlo o actualizarlo, dejar notas, etiquetar, abrir oportunidades en tu pipeline, crear tareas y agendar citas.

Requisito previo: conectar Clientify en Integraciones antes de activar esta función. Ver Clientify.

Las funciones de Clientify también se activan por separado:

No requiere campos adicionales al activar.

💡 Para clientify_mover_etapa, el agente identifica la etapa por su nombre, no por un identificador. Si no hay coincidencia, ofrece las etapas disponibles del pipeline en vez de pedir un ID.

💡 Clientify no tiene consulta de horarios libres: clientify_agendar_cita agenda directamente (se guarda como tarea). Para que el agente proponga horarios disponibles antes de agendar, usá Google Calendar o Cal.com.

---

🟣 Odoo (CRM)#

Permite al agente trabajar directamente sobre tu Odoo durante la llamada: buscar el contacto, crearlo o actualizarlo, dejar notas, etiquetar, abrir oportunidades en tu pipeline, crear tareas reales y agendar citas en el calendario.

Requisito previo: conectar Odoo en Integraciones antes de activar esta función. Ver Odoo CRM.

Las funciones de Odoo también se activan por separado:

No requiere campos adicionales al activar. Las funciones de agenda (odoo_disponibilidad, odoo_agendar_cita) están en la pestaña Citas.

💡 Para odoo_mover_etapa, el agente identifica la etapa por su nombre (ej. "Qualified", "Won"), no por un identificador. Si no hay coincidencia, ofrece las etapas disponibles del pipeline.

💡 A diferencia de Clientify, Odoo sí tiene calendario real: odoo_agendar_cita crea una cita de verdad y odoo_disponibilidad revisa las franjas ocupadas antes de proponer un horario. Las horas se manejan en UTC.

---

Tipos de funciones personalizadas#

📞 Transferir llamada#

Transfiere la llamada a un número de teléfono cuando el agente lo considera necesario.

🔀 Transferir a otro agente#

Pasa la misma llamada a otro agente de voz, preservando todo el contexto de la conversación. Aparece como una sola llamada en el historial. Sirve para modularizar: por ejemplo, un agente recepcionista que transfiere al agente de agendamiento cuando el cliente quiere reservar un turno.

Se activa desde Funciones del agente → pestaña Llamadas → Transferir a otro agente.

💡 El análisis post-llamada y los webhooks quedan configurados para ambos agentes por defecto, así el historial y las integraciones reciben la información completa de la llamada.

💡 Agrega en el prompt una instrucción clara de cuándo transferir, para que el agente sepa activar la función en el momento correcto.

📅 Verificar disponibilidad (Cal.com)#

Consulta en tiempo real si hay turnos disponibles en un calendario de Cal.com.

📆 Reservar cita (Cal.com)#

Agenda un turno directamente en Cal.com durante la llamada.

💻 Función de código (JavaScript)#

Ejecuta código JavaScript personalizado en el servidor de Anunzi cuando el agente lo necesita. Útil para cálculos, transformaciones de datos o lógica personalizada.

🔗 Función personalizada (webhook)#

Llama a una URL externa (API propia, Make, Zapier, etc.) cuando el agente lo requiere.

Agregar y eliminar funciones#

• Haz clic en + Agregar función y elegí la categoría desde las pestañas de arriba (Atención al cliente, Citas, CRM, Código…).
• Las funciones sin configuración adicional (como las de GHL o Clientify) se pueden seleccionar varias a la vez — se marcan en verde — y activarlas todas juntas con "Activar N funciones".
• Las que necesitan datos (Cal.com, transferir llamada, código, webhook) se completan y activan de a una.
• Las funciones ya instaladas quedan marcadas con ✓ Instalada y no se pueden volver a agregar.
• Para eliminar una función existente, haz clic en la ✕ en su tarjeta dentro de la lista de funciones instaladas.
• Haz clic en Guardar funciones para aplicar todos los cambios.

💡 Los slots genéricos (transferir llamada, código, webhook, Cal.com, verificar horario) sí admiten varias instancias — por ejemplo, dos transferencias a distintos destinos según el contexto.

---

Sección: Comportamiento#

Controla cómo se comporta el agente durante el silencio, qué sonidos de ambiente genera y los límites de duración de la llamada.

Haz clic en Guardar comportamiento para aplicar los cambios.

---

Sección: Webhook de eventos#

Permite que Anunzi notifique a tu sistema externo cada vez que se registra una llamada en este agente.

Cuando está configurado, Anunzi envía un POST con el siguiente JSON al finalizar el procesamiento de cada llamada:

{
  "event": "call.completed",
  "assistant_id": "...",
  "call_id": "...",
  "phone_number": "...",
  "lead_name": "...",
  "direction": "inbound",
  "duration": 120,
  "start_at": "2025-01-01T10:00:00Z",
  "status": "...",
  "call_status": "...",
  "end_call_reason": "...",
  "transcript": "...",
  "recording_url": "...",
  "call_summary": "...",
  "transfer_failed": false,
  "transfer_success": false
}

Haz clic en Guardar webhook para aplicar los cambios.

💡 Puedes usar este webhook para enviar el resultado de la llamada a tu CRM, a una hoja de cálculo, o para disparar flujos en Make, Zapier o cualquier sistema que acepte webhooks.

---

Sección: Extractores de información#

Los extractores capturan datos específicos de cada llamada para analizarlos después. Por ejemplo: el nombre del cliente, su intención, el resultado de la conversación, el producto que consultó, etc.

Tipos de datos#

Agregar un extractor#

1. Haz clic en + Agregar extractor.
2. Selecciona el Tipo de dato.
3. Ingresa el Nombre del campo en snake_case (sin espacios). Ejemplo: nombre_cliente.
4. Escribe una Descripción clara de qué dato captura. Ejemplo: "Nombre completo del cliente mencionado durante la llamada".
5. Agrega Ejemplos separados por coma (opcional, ayuda al modelo a entender mejor).
6. Si el tipo es enum, ingresa las Opciones separadas por coma. Ejemplo: interesado, no_interesado, callback, venta.
7. Haz clic en Agregar.

Eliminar un extractor#

Haz clic en la ✕ en la tarjeta del extractor que quieres quitar.

Guardar#

Haz clic en Guardar extractores para que los cambios tomen efecto en las próximas llamadas.

💡 Los datos extraídos quedan disponibles en la ficha de cada llamada para su revisión y exportación.

---

📌 Recuerda: todos los cambios en la ficha aplican desde la próxima llamada. Las llamadas en curso no se ven afectadas.