Acciones internas

Herramientas que ejecutan funciones del sistema — reportes, tareas, mensajes y localizacion de personal.

Como funciona

Una herramienta de accion interna ejecuta una funcion predefinida del backend durante una conversacion. Esto permite que el agente realice operaciones del sistema sin intervencion manual — desde generar un PDF hasta enviar un mensaje de WhatsApp.

Acciones disponibles

Accion	Descripcion	Parametros principales
generate_report	Genera un reporte PDF con bloques de contenido estructurado y branding corporativo	titulo, bloques de contenido, coleccion (opcional)
assign_task	Crea una tarea y la asigna a un miembro del equipo. Envia notificaciones por email y/o WhatsApp	titulo, descripcion, asignado, departamento, prioridad
send_whatsapp_message	Envia un mensaje de WhatsApp a un contacto	numero de telefono, mensaje
send_file	Envia un archivo (PDF, imagen) via WhatsApp	numero, archivo
send_email	Envia un correo electronico via Postmark. Puede incluir PDFs adjuntos	destinatario, asunto, cuerpo
locate_nearest_personnel	Localiza al personal mas cercano a una ubicacion por proximidad geografica (ciudad, estado, pais)	ciudad, estado, pais, departamento (opcional)

Puedes ver la lista completa al crear una herramienta de tipo Accion interna en el selector de acciones.

Configuracion

Campo	Descripcion
Nombre de la accion	Funcion interna a ejecutar (selecciona de la lista)
Valores por defecto	Parametros predeterminados que se envian automaticamente sin que el agente los solicite

Valores por defecto

Los valores por defecto permiten fijar parametros que siempre se envian a la accion. Esto es util para:

Configurar el branding corporativo en generate_report (logo, nombre de empresa, pie de pagina).
Fijar el departamento en assign_task cuando el agente siempre asigna al mismo equipo.
Preconfigurar la cuenta de email en send_email.

Los parametros que el agente obtiene del usuario durante la conversacion tienen prioridad sobre los valores por defecto.

Ejemplo: Generar reportes

Escenario: Un agente de voz que genera reportes de inventario cuando el cliente lo solicita.

Crea una herramienta con accion generate_report.

En valores por defecto, configura tu branding:

{
  "company_name": "Acme Corp",
  "logo_url": "https://acme.com/logo.png",
  "header_lines": ["Division Industrial", "Tel: +34 900 123 456"],
  "footer_text": "Documento confidencial"
}

Agrega parametros para que el agente pregunte: titulo del reporte y tipo de datos.
Asigna la herramienta al agente.

Cuando un usuario dice "genera un reporte de los equipos en bodega", el agente:

Recopila la informacion necesaria del usuario.
Ejecuta la accion generate_report con el branding preconfigurado.
El PDF se genera con encabezado corporativo, tablas de datos y pie de pagina.
Devuelve el reporte al usuario (URL de descarga o adjunto).

Ejemplo: Asignar tareas con notificacion

Escenario: Un agente de soporte que crea tareas de mantenimiento y notifica al tecnico asignado.

Crea una herramienta con accion assign_task.

En valores por defecto, configura:

{
  "department_id": "ID_DEL_DEPARTAMENTO",
  "notify_email": true,
  "notify_whatsapp": true,
  "priority": "medium"
}

Agrega parametros: titulo, descripcion, nombre del tecnico.
Asigna la herramienta al agente.

Cuando el agente crea la tarea:

Se genera un codigo automatico (ej: MAN-042).
Se envia un email al tecnico con los detalles.
Se envia un mensaje de WhatsApp al tecnico.
La tarea aparece en el tablero Kanban del dashboard.

Ejemplo: Localizar personal cercano

Escenario: Un agente que necesita encontrar al tecnico mas cercano a la ubicacion del cliente.

Crea una herramienta con accion locate_nearest_personnel.
Agrega parametros: ciudad, estado/provincia (opcionales).
El agente preguntara la ubicacion al usuario.

La localizacion funciona por proximidad geografica:

Prioridad 1: Personal en la misma ciudad.
Prioridad 2: Personal en el mismo estado/provincia.
Prioridad 3: Personal en el mismo pais.