Documentación
Agentes de WhatsApp.md

Funciones del agente

Las funciones son capacidades adicionales que puedes activar para que el agente realice acciones concretas durante la conversación: agendar citas, registrar reclamos, consultar el historial del contacto, hacer seguimiento automático y más.

A diferencia de las instrucciones (que definen el comportamiento), las funciones permiten al agente interactuar directamente con servicios y datos de la plataforma.

🧩 ¿Necesitas una función a medida (por ejemplo, registrar una fecha de recontacto y enviarla a tu CRM)? Mira Funciones personalizadas.

Cómo agregar una función

  1. En la ficha del agente, abre la sección Funciones del agente.
  2. Haz clic en + Agregar función.
  3. Elegí la categoría desde las pestañas de arriba (Atención al cliente, Citas, Llamadas, CRM…) y hacé clic en la tarjeta de la función que querés activar.
  4. Si la función necesita datos (por ejemplo una API key), se abre un formulario para completarlos y se activa sola al guardar.
  5. Si la función no necesita datos, podés seleccionar varias tarjetas a la vez (se marcan en verde) y activarlas todas juntas con el botón "Activar N funciones".

Las funciones activas aparecen en la lista de "Funciones instaladas", y sus tarjetas quedan marcadas con ✓ Instalada en el selector (ya no se pueden volver a agregar). Para quitar una función, haz clic en el ícono de eliminar junto a ella en la lista.

💡 Cada función que activas extiende las instrucciones del agente automáticamente. Si quieres personalizar cómo el agente usa esa función, puedes editar las instrucciones manualmente después de agregarla.


🔍 Extractores de información

Los extractores definen qué datos quieres capturar de cada conversación (nombre, intención, presupuesto, producto de interés, etc.). Cuando los configuras, el agente captura automáticamente esa información durante el diálogo y la guarda en la ficha del contacto una vez que el lead se cualifica o finaliza la conversación.

Funcionan igual que los extractores de los agentes de voz: tú defines los campos y el sistema se encarga del resto. No necesitas crear ninguna función a mano.

Cómo configurarlos

  1. En la ficha del agente, abre la sección Extractores de información.
  2. Haz clic en + Agregar extractor.
  3. Define el campo:
    • Tipo de dato: Texto, Número, Sí/No (boolean) u Opciones fijas (enum).
    • Nombre del campo: en snake_case, sin espacios (ej: nombre, presupuesto, producto_interes).
    • Descripción: qué debe capturar el agente en ese campo.
    • Ejemplos (opcional): para guiar al modelo.
    • Opciones (solo enum): los valores permitidos, separados por coma.
    • Campo obligatorio (opcional): marca si el agente debe intentar siempre obtenerlo.
  4. Haz clic en Agregar y repite por cada dato que quieras capturar.
  5. Haz clic en Guardar extractores.

Al guardar, el sistema activa de forma automática una función oculta en el agente que recopila esos campos. No aparece en la lista de Funciones del agente — se gestiona por completo desde esta sección.

Tipos de dato

Tipo Para qué sirve Ejemplo
Texto Cualquier valor libre nombre, direccion
Número Cantidades, montos, edades presupuesto, cantidad
Sí / No Datos verdadero/falso tiene_vehiculo, es_cliente
Opciones fijas El agente elige entre una lista cerrada de valores interes: alto, medio, bajo

Dónde se ven los datos capturados

Cada dato que el agente captura aparece en la ficha del contacto (en Contactos / Leads), junto al resto de su información. Así puedes ver de un vistazo todo lo que se recopiló en la conversación, con cada campo y su valor.

💡 El agente captura los datos de forma natural, sin pedirlos todos de golpe, y vuelve a guardarlos si más adelante obtiene información adicional. No hace falta que edites las instrucciones: al guardar extractores, el sistema agrega la indicación necesaria al agente.


📅 Agenda Cal.com

Permite al agente consultar disponibilidad, reservar, reprogramar y cancelar citas en Cal.com directamente desde la conversación.

Agrega 4 funciones al agente:

Función Qué hace
check_availability Consulta los horarios disponibles para un rango de fechas
create_booking Reserva un turno para el contacto
reschedule_booking Reprograma una reserva existente
cancel_booking Cancela una reserva existente

Campos requeridos al activar:

Campo Descripción
API Key de Cal.com Clave de acceso a tu cuenta (formato: cal_live_...).
Event Type ID ID numérico del tipo de evento en Cal.com.
Zona horaria Zona horaria por defecto si el contacto no la indica (ej: America/Argentina/Buenos_Aires).

📅 Google Calendar

Permite al agente consultar disponibilidad, crear reuniones, reprogramar y cancelar citas directamente en Google Calendar. 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:

Función Qué hace
gcal_check_availability Consulta los horarios libres en el calendario para un rango de fechas
gcal_create_event Crea la reunión con invitación al contacto y link de Google Meet
gcal_update_event Reprograma o modifica una reunión existente
gcal_cancel_event Cancela una reunión existente

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

💡 El agente solicita nombre, email y teléfono del contacto antes de crear la reunión. El contacto recibe la invitación con el link de Google Meet directamente en su correo.


🟢 Go High Level (CRM)

Permite al agente trabajar directamente sobre tu CRM de Go High Level durante la conversación: 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.

Agrega estas funciones al agente:

Función Qué hace
ghl_buscar_contacto Busca el contacto en GHL por teléfono o email y devuelve nombre, datos y etiquetas
ghl_guardar_contacto Crea o actualiza el contacto sin duplicar
ghl_agregar_nota Guarda una nota en el contacto y la deja visible en la conversación, etiquetada como nota del agente IA
ghl_agregar_tag Agrega una o más etiquetas al contacto
ghl_crear_oportunidad Abre una oportunidad para el contacto en el pipeline y etapa por defecto
ghl_disponibilidad Consulta los horarios libres de un calendario de GHL
ghl_reservar_cita Reserva una cita en el calendario de GHL para el contacto

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

💡 La nota del agente (ghl_agregar_nota) se ve apenas abres el contacto: además de quedar en la pestaña de Notas, aparece en el hilo de la conversación prefijada con "🤖📝 Nota del agente IA:". Es un registro interno, no se le envía nada al cliente.


🟠 Clientify (CRM)

Permite al agente trabajar directamente sobre tu CRM de Clientify durante la conversación: 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.

A diferencia de otros bundles, las funciones de Clientify se activan por separado: activá solo las que necesites (por ejemplo, solo el CRM) y combiná con otra integración para lo que Clientify no cubre.

Función Qué hace
clientify_buscar_contacto Busca el contacto en Clientify por teléfono o email
clientify_guardar_contacto Crea o actualiza el contacto sin duplicar
clientify_agregar_nota Guarda una nota en el contacto
clientify_agregar_tag Agrega una o más etiquetas al contacto
clientify_crear_oportunidad Abre una oportunidad (deal) para el contacto en el pipeline y etapa por defecto
clientify_mover_etapa Mueve la oportunidad del contacto a otra etapa, por nombre de la etapa
clientify_crear_tarea Crea una tarea o seguimiento asociado al contacto
clientify_agendar_cita Agenda una cita para el contacto (se registra como una tarea)

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

💡 Para clientify_mover_etapa, decile al agente el nombre de la etapa (ej. "Ganado"), no un identificador. Si no encuentra una coincidencia exacta, el agente te ofrece las etapas disponibles del pipeline.

💡 Clientify no tiene un módulo de agenda con consulta de disponibilidad: clientify_agendar_cita crea directamente una tarea marcada como cita. Si necesitás que el agente proponga horarios libres, combiná esta función con Google Calendar o Cal.com.


🟣 Odoo (CRM)

Permite al agente trabajar directamente sobre tu Odoo durante la conversación: 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.

Al igual que Clientify, las funciones de Odoo se activan por separado: activá solo las que necesites.

Función Qué hace
odoo_buscar_contacto Busca el contacto en Odoo por teléfono o email
odoo_guardar_contacto Crea o actualiza el contacto sin duplicar
odoo_agregar_nota Guarda una nota en el chatter del contacto
odoo_agregar_tag Agrega una o más etiquetas al contacto
odoo_crear_oportunidad Abre una oportunidad en el pipeline CRM
odoo_mover_etapa Mueve la oportunidad del contacto a otra etapa, por nombre de la etapa
odoo_crear_tarea Crea una actividad/tarea real asociada al contacto
odoo_disponibilidad Consulta los eventos ya agendados de un día para ofrecer horarios libres
odoo_agendar_cita Agenda una cita real en el calendario de Odoo

No requiere campos adicionales al activar — el agente usa las credenciales y el equipo de ventas configurados en Integraciones. Las funciones de agenda (odoo_disponibilidad, odoo_agendar_cita) están en la pestaña Citas.

💡 Para odoo_mover_etapa, decile al agente el nombre de la etapa (ej. "Qualified", "Won"), no un identificador. Si no hay coincidencia, ofrece las etapas disponibles de tu pipeline.

💡 A diferencia de Clientify, Odoo sí tiene calendario real: odoo_agendar_cita crea una cita de verdad y odoo_disponibilidad permite revisar qué franjas están ocupadas antes de proponer un horario. Las horas se manejan en UTC.


🎫 Sistema de Tickets de soporte

Permite al agente registrar y consultar reclamos o consultas del contacto como tickets de soporte, asignándoles un número de caso (ej. CAS-000042).

Agrega 3 funciones al agente:

Función Qué hace
crear_ticket_soporte Registra un nuevo reclamo o consulta como ticket
consultar_ticket Consulta el estado de un caso existente por número o teléfono
actualizar_ticket Agrega una nota al ticket cuando el contacto da seguimiento

No requiere campos adicionales al activar.


👤 Consulta de ficha del contacto

Permite al agente acceder al historial registrado del contacto en Anunzi: datos personales, estado, score y notas recientes. Útil para personalizar la conversación sin pedirle al contacto información que ya fue capturada.

Agrega 1 función:

Función Qué hace
consultar_contacto Devuelve la ficha del contacto actual (o de un teléfono específico)

No requiere campos adicionales al activar.


📝 Notas al contacto

Permite al agente guardar notas en la ficha del contacto durante o al finalizar la conversación. Ideal para registrar resúmenes, compromisos o información relevante mencionada.

Agrega 1 función:

Función Qué hace
agregar_nota Guarda una nota en la sección Notas de la ficha del contacto

El agente guarda la nota de forma silenciosa, sin avisarle al contacto.

No requiere campos adicionales al activar.


📞 Historial de llamadas

Permite al agente consultar las llamadas telefónicas previas que el contacto tuvo con un agente de voz de tu cuenta. Útil para contextualizar la conversación cuando el contacto hace referencia a una llamada anterior.

Agrega 1 función:

Función Qué hace
consultar_llamadas Devuelve el historial de llamadas del contacto con el agente de voz seleccionado

Campos requeridos al activar:

Campo Descripción
Agente de llamadas El agente de voz cuyas llamadas se consultarán.
Llamadas a recuperar Cantidad máxima de llamadas a traer (3, 5 o 10).

🔄 Seguimiento Automático

El seguimiento automático permite que el agente retome contacto con personas que iniciaron una conversación pero no volvieron a escribir. Pasados X días de inactividad, el agente les envía un mensaje de seguimiento personalizado por IA, basado en el historial de la conversación.

⚠️ Esta función se configura en la sección Seguimiento Automático de la ficha del agente, no en el selector de funciones. El agente debe tener un número de WhatsApp conectado para poder activarla.

¿Cómo funciona?

  1. La conversación finaliza sin que el contacto haya resuelto su consulta o completado una acción.
  2. Pasados los días configurados, el agente revisa el historial de la conversación con IA y genera un mensaje de seguimiento personalizado.
  3. Envía el mensaje usando una plantilla de WhatsApp aprobada por Meta (obligatorio para mensajes proactivos fuera de la ventana de 24 horas).
  4. Si el contacto responde, la conversación retoma normalmente con el agente.

Cómo activarlo

  1. En la ficha del agente, abre la sección Seguimiento Automático.
  2. Activa el toggle "Activar seguimiento automático".
  3. El sistema crea automáticamente una plantilla de WhatsApp en tu cuenta de Meta y muestra su estado.
  4. Configura los parámetros según tus necesidades.

Configuración

Campo Descripción
Días de espera Cuántos días de inactividad deben pasar antes de enviar el seguimiento. Rango: 1 a 30 días.
Máx. seguimientos Cantidad máxima de mensajes de seguimiento por conversación (1 a 3).
Personalización con IA Si está activo, el agente revisa el historial y genera un mensaje contextual. Si está desactivado, envía un mensaje genérico.

Estado de la plantilla

Estado Qué significa
✅ Activa La plantilla está aprobada y el seguimiento funcionará.
⏳ Pendiente de aprobación Meta está revisando la plantilla (24-48 horas). El seguimiento comenzará automáticamente una vez aprobada.
❌ Rechazada Meta rechazó la plantilla. Usa el botón Crear plantilla para generar una nueva.

Ejemplo de mensaje generado

Hola María, ¿pudiste revisar los planes que estabas comparando? Seguimos disponibles para ayudarte.

El mensaje se adapta al tema de la conversación original. Si la personalización con IA está desactivada, el mensaje es genérico.

Créditos

Cada mensaje de seguimiento consume créditos equivalentes a un envío de plantilla de campaña de WhatsApp. Ver Sobre los créditos.

Esc