Freddy AI Agent custom functions: configuración, planes, facturación
Kira
Katelin Teen
Última edición 12 de noviembre de 2026

Las custom functions de Freddy AI Agent son fragmentos de JavaScript que transforman datos entre pasos de un flujo, no una forma de llamar a sistemas externos. Freshworks las marca para Freshdesk Omni en Growth, Pro y Enterprise, sin una línea de precio aparte en la página de precios; de todas formas pagas por sesión a $49 por cada 100, después de 500 incluidas una vez por cuenta. Para consultas en vivo necesitas antes una acción de API. Si prefieres describir la tarea en lugar de dibujar el flujo, eesel se conecta a Freshdesk y llega a tus propias APIs sin que tengas que escribir una función. La CLI de eesel deja que un agente de código la configure y pruebe respuestas antes.
¿Qué son las custom functions de Freddy AI Agent?
Las custom functions de Freddy AI Agent son fragmentos de JavaScript reutilizables que toman entradas, ejecutan tu lógica y devuelven un objeto JSON que los bloques posteriores del flujo pueden leer. Freshworks las describe como una forma de transformar y procesar datos, como extraer una fecha de entrega de una respuesta completa de un pedido o decidir si un pedido todavía está dentro de la ventana de devolución.

La biblioteca de functions está en AI Agent Studio > Library > Functions. Tiene dos pestañas: functions prediseñadas para fechas, texto, listas, aritmética y Base64, y My functions para las que escribes tú. La captura de arriba, tomada de la propia guía de functions de Freshworks, es la página donde vivirás.
Aquí está la parte fácil de pasar por alto. Una function nunca habla con tu sistema de pedidos. Leí todos los artículos que Freshworks ha publicado sobre esto, y cada uno describe las functions como transformación de datos dentro del flujo. La llamada al exterior es otro bloque, la acción de API, y los dos se encadenan. La actualización de producto de Freshworks de septiembre incluye las custom functions entre las incorporaciones de Freddy AI Agent Studio, junto con disparadores de flujo predefinidos.
| Pieza | Qué hace | ¿Llama a un sistema externo? |
|---|---|---|
| Pre-built function | Paso predefinido para fecha, texto, lista, matemáticas o Base64 | No |
| Custom function | Tu propio JavaScript, devuelve JSON | No |
| Acción de API | Solicitud REST con encabezados, cuerpo y autenticación | Sí |
| App de AI Actions | Operaciones tipadas creadas con el SDK de Freshworks | Sí, si programas el callback |
¿Cómo se combinan las functions con las acciones de API en un flujo?
Una function se sitúa entre dos bloques que sí hablan con tus sistemas: toma lo que devolvió una acción de API y le da al siguiente paso algo sobre lo que ramificarse. El propio ejemplo de Freshworks es un flujo de pedidos donde una acción de API devuelve el pedido y las fechas de entrega, una function verifica la elegibilidad y una condición lee isEligibleForReturn.

El constructor de flujos muestra la misma división. Al hacer clic en el icono de más, el menú de bloques lista Collect info, API Action, Execute Function, Condition paths, Custom response y Agent handoff como cosas separadas.

Las acciones de API son la mitad que cuesta tiempo de configuración. A cada una le das una URL, un método HTTP (GET, POST, PUT, PATCH o DELETE), encabezados y una opción de autenticación entre API Key, Bearer Token, Basic Auth u OAuth 2.0. Las variables de salida se mapean con JSON path, y la salida de una acción puede alimentar la siguiente. El artículo de acciones de API de Freshworks también señala que Ask for confirmation puede activarse para pasos de alto impacto como reembolsos.
"Test requests use real values and may affect your external system depending on the endpoint."
¿Cómo se crea una custom function?
Creas una custom function en cinco movimientos: ponerle nombre, definir entradas tipadas, escribir el código, probarla con valores de muestra y definir las salidas que el flujo puede usar. La guía para crear custom functions de Freshworks lo explica paso a paso, y necesitas acceso de administrador a AI Agent Studio además de un flujo existente.
- Ve a AI Agent Studio > Library > Functions y haz clic en Create.
- En General, añade un nombre y una descripción.
- Añade entradas. Cada una tiene un nombre, un tipo (texto, número, booleano o lista) y un indicador opcional de Required.
- Escribe la lógica en el editor de código. Debe devolver un objeto JSON válido. En el ejemplo de Freshworks, el cuerpo de la respuesta del flujo se lee desde
data['Response_body']. - Haz clic en Test function, introduce valores de muestra, ejecútala y revisa luego la respuesta y los registros de consola. Termina con Define outputs y Create.

El ejemplo de la documentación filtra pedidos cuyo total_price supera un umbral de 160 y devuelve los IDs de pedido y los nombres de artículo. Eso es típico de para qué sirven estas functions: reducir una respuesta grande de API a los dos campos que una frase de cara al cliente necesita.
Freshworks dice en la introducción que puedes escribir o generar la lógica de la function. Los pasos numerados solo describen cómo escribirla, así que no pude confirmar cómo es la opción de generar. Su propio consejo vale la pena seguirlo de cualquier forma: probar con entradas válidas, inválidas y vacías.
¿Cómo se usa una function dentro de un flujo?
Añades un bloque Execute Function, elige una function de My functions o Pre-built functions, mapeas valores del flujo a sus parámetros y, opcionalmente, mapeas sus salidas a propiedades de contacto o de ticket. El panel muestra una vista previa de los detalles de la function antes de confirmar.

Dos detalles de la guía para gestionar y usar functions ahorran tiempo de depuración. Primero, captura las entradas con un bloque Collect info antes de mapearlas, o mapéalas directamente desde propiedades de contacto o ticket, especialmente para correo o teléfono. Segundo, puedes clonar una function prediseñada y editarla, la vía más rápida hacia tu propia variante.
Aquí hay tres tareas donde recurriría a una function en lugar de una instrucción en el prompt:
- Ventana de devolución: calcular los días desde la entrega y devolver un booleano, para que la rama de la condición sea determinista.
- Verificación de promociones o cupones: comparar la fecha de caducidad con hoy antes de que el agente diga que un código es válido.
- Reducir una respuesta: devolver solo el número de seguimiento y el estado de una respuesta larga de envío.
La lista de functions prediseñadas de Freshworks ya cubre las dos primeras (Get Days Between, Compare Dates), así que una custom function se gana su lugar solo cuando tu regla es específica de tu negocio.
¿Qué planes incluyen las custom functions?
Los artículos de functions de Freshworks llevan un banner de plan para Freshdesk Omni con marcas en Growth, Pro y Enterprise, y la línea "Not available in previous plans." También dicen que si te registraste antes de diciembre de 2025, tu experiencia de Freshdesk Omni puede ser distinta. Los planes actuales en la página de precios son $19, $55 y $89 por agente al mes con facturación anual.
Mira las guías del plan Growth de Freshdesk y del plan Pro para ver qué más incluye cada nivel, y la comparación de planes de Freshdesk para verlos en paralelo.
Una valla contigua: la vía para desarrolladores para operaciones personalizadas, las apps de AI Actions, por ahora solo puede publicarse como apps personalizadas, y aparece como no disponible en Freshdesk Legacy, Freshcaller, Freshsales Classic y Freshservice MSP.
¿Cuánto cuestan las custom functions de Freddy?
Freshworks no lista un precio aparte para las custom functions, así que el medidor que realmente vas a vigilar es la sesión de AI Agent. La página de precios da las primeras 500 sesiones gratis en Growth, Pro y Enterprise, una vez por cuenta, luego $49 por cada 100 sesiones. Una sesión de correo es una ventana de 72 horas desde el primer correo del cliente, sin importar cuántas respuestas salgan dentro de ella.

La misma página lista otros dos medidores de uso: tareas de app conectora a $80 por cada 5.000, y acciones MCP a $15 por cada 1.000. Lo que no pude encontrar es ninguna afirmación sobre si una ejecución de function, o una acción de API dentro del flujo, aumenta alguno de los dos. Trata eso como una pregunta para tu representante de Freshworks antes de diseñar un flujo de alto volumen. Para la cuenta de sesiones en la práctica, mi aritmética: un equipo que ya usó sus 500 gratis y luego maneja 2.500 sesiones en un trimestre compra 25 paquetes, que son $1.225. La guía de consumo de sesiones muestra qué conversaciones cuentan, y el artículo de precios de Freddy AI por agente cubre el lado de los puestos.
¿Cuáles son los límites y los problemas a tener en cuenta?
Los límites prácticos vienen de cómo se comparten las functions y de cómo se comportan los canales, no de una cuota publicada. No encontré un límite declarado de tiempo de ejecución, memoria o número de llamadas para las functions, así que prueba con tamaños de payload realistas.
- La lógica compartida cambia en todas partes. Freshworks advierte que editar una acción de API compartida afecta a todos los flujos que la usan, así que prueba primero en un entorno que no sea de producción.
- No se puede borrar una function en uso. No puedes eliminar una function usada en un flujo activo.
- El chat es síncrono. En el chat, los bloques de acción de API se ejecutan durante la conversación y el campo de texto queda bloqueado hasta que terminan; un tiempo de espera agotado o un fallo lleva a la ruta de Fallback.
- El correo se salta la confirmación. Los bloques de confirmación se omiten para los agentes de correo, así que Freshworks recomienda poner salvaguardas para operaciones de alto impacto en la capa de API. La guía del agente de IA por correo de Freshdesk cubre ese canal.
- Las reglas van en código, no en prosa. Una function te da una verificación determinista, esa es su verdadera ventaja sobre una instrucción al modelo.
Donde la documentación de Freshworks se contradice a sí misma, esto es lo que encontré:
- Inicio de sesión de MCP. El artículo de flujos dice que la capa de MCP "uses OAuth-based authentication". El artículo de seguridad de MCP dice que OAuth no es compatible actualmente con las integraciones de MCP de Freshdesk, y el artículo de configuración de MCP dice que solo se admite API key. Esas páginas describen el propio servidor MCP de Freshworks, que puede no ser lo mismo que un servidor MCP que enlazas dentro de una acción de API, así que trataría ambas como sin confirmar.
- Periodo de cuota de MCP. La tabla del artículo de configuración da las acciones incluidas "per account, annually" (
1.200en Growth,6.000en Pro,12.000en Enterprise), mientras que el artículo de seguridad habla de cuotas mensuales. - Requisitos previos. El artículo de acciones de API dice que tu cuenta debe estar en Freshdesk Omni "or have AI Agent Studio enabled", mientras que la página de precios lista Freddy AI Agent en los tres planes de Freshdesk.
- Número de functions. La documentación lista
13functions prediseñadas en cinco grupos, pero la captura de la página de Functions muestra14en la pestaña de prediseñadas.
¿Cómo se comparan las functions de Freddy con las llamadas a API personalizadas de eesel?
Las functions de Freddy te dan lógica determinista que dibujas y codificas; eesel te da un compañero que decide cuándo llamar a tus APIs a partir de instrucciones. Resuelven mitades distintas de "mi agente necesita datos en vivo".

En eesel, Your APIs deja que el compañero llegue a cualquier API REST. Permites el dominio, añades el encabezado que la API espera (Bearer, Basic o una API key), y las credenciales se quedan en tus ajustes y nunca se le muestran a la IA. Puede hacer solicitudes GET, POST, PATCH y DELETE. Freshdesk en sí es una integración nativa: con una conexión completa (subdominio más API key) el compañero lee tu centro de ayuda, respuestas predefinidas y tickets pasados, y puede responder, dejar notas internas, etiquetar, asignar y cerrar. Cada acción puede fijarse en activada, preguntar antes o desactivada, según la guía de acciones y aprobaciones.
Donde Freddy es mejor: la verificación de la ventana de devolución es código, así que se comporta igual cada vez, y el flujo visual hace que la ruta sea auditable. En eesel esa regla vive en tus instrucciones, que un modelo sigue bien pero que no son una garantía compilada. Donde eesel es mejor: no hay function que escribir ni versionar, un solo workspace cubre tickets y chat en vivo, y un desarrollador o un agente de código puede ejecutar toda la configuración desde una terminal con la CLI de eesel. La página de eesel para Freshdesk en docs.eesel.ai lista la tabla de acciones.
Llevo años construyendo integraciones de Freshdesk para eesel, y las sorpresas rara vez están en las llamadas a la API. Una que nos costó horas: Freshdesk no dispara sus reglas de automatización para tickets creados por un agente, así que un disparador que asumías que despertaría al compañero simplemente nunca llega. La lógica que controlas en código no soluciona eso; conocer la plataforma sí.
Dos clientes muestran el patrón. SamCart ejecuta un agente de eesel en los tickets de Freshdesk y otro en el chat de su sitio web, ambos respondiendo desde unos 280 artículos del centro de ayuda, y el agente se retira en cuanto se asigna una persona. Timengo usa eesel en Freshdesk para soporte técnico en danés, redactando respuestas a partir de unos 5.300 tickets y artículos pasados, con un ingeniero enviando cada una. Ninguno necesitó una custom function; el trabajo estaba en el conocimiento y en las reglas de traspaso.
Para el panorama más amplio, mira Freddy AI frente a eesel AI, las alternativas a Freddy AI y las alternativas de IA a Freshdesk.
¿Qué deberías hacer después con Freddy y Freshdesk?
Si te quedas con Freddy, construye primero la acción de API, añade una function solo donde una regla deba ser código, y vigila tu número de sesiones. Tres guías vecinas ayudan aquí: fuentes de conocimiento de Freddy, el resumen del AI Agent de Freshdesk y las acciones conversacionales de Freddy.
Si estás conectando Freshdesk con un sistema de pedidos, los artículos de webhooks de Freshdesk y de Freshdesk y Shopify muestran la fontanería.
Los límites de tasa de la API de Freshdesk explican qué te frena.
La guía de integración de API de agentes de IA cubre el patrón en general.
Para más contexto, lee cómo añadir IA a Freshdesk, luego automatización en Freshdesk y la guía del chatbot de Freshdesk.
¿Estás evaluando el helpdesk en sí? Freshdesk frente a Zendesk y la reseña de Freshdesk son los puntos de partida, y Freddy Copilot cubre el asistente del lado del agente.
Prueba eesel para Freshdesk
Si tu objetivo es un agente de Freshdesk que responda desde tu centro de ayuda y tu propio sistema de pedidos, eesel funciona como un nuevo compañero que se une a tu cola en minutos. Conecta Freshdesk con un subdominio y una API key, empieza con borradores como notas internas, y amplía su acceso a medida que se gana la confianza. Con la CLI de eesel, un agente de código con IA puede subir conocimiento aprobado como artículos de solución exportados, ajustar las instrucciones del compañero y hacer preguntas de prueba para revisar las respuestas antes de que algo salga en vivo, aunque una persona con acceso de administrador sigue aprobando la propia conexión con Freshdesk. Mira la integración con Freshdesk o los precios de eesel.

Preguntas frecuentes
¿Qué son las custom functions de Freddy AI Agent?
Son fragmentos de JavaScript que escribes en AI Agent Studio: toman entradas, devuelven un objeto JSON y alimentan el siguiente paso del flujo. Transforman datos, por ejemplo convirtiendo dos fechas en un indicador de elegibilidad. No llaman a sistemas externos, de eso se encargan las acciones de API. La guía de agentes Freddy AI cubre el producto más amplio.
¿Qué planes de Freshdesk incluyen las custom functions de Freddy?
Los artículos de ayuda de Freshworks marcan las functions como Freshdesk Omni en Growth, Pro y Enterprise, y señalan que no están disponibles en planes anteriores. Si te registraste antes de diciembre de 2025, tu configuración puede ser distinta. Compara precios de planes en la guía de precios de Freshdesk.
¿Cuánto cuestan las custom functions de Freddy AI Agent?
La página de precios de Freshworks no lista un precio aparte para las functions. La unidad facturada del agente es la sesión: las primeras 500 están incluidas una vez por cuenta, luego $49 por cada 100 sesiones. Mira cómo se cuentan las sesiones y el desglose de precios de Freddy AI.
¿Puede una custom function de Freddy llamar a una API externa?
Los artículos de Freshworks describen las functions solo como transformación de datos, y canalizan las llamadas a sistemas externos a través de acciones de API. Si necesitas una consulta en vivo de un pedido, crea una acción de API y pasa su salida a la function. Un ejemplo de API de tickets de Freshdesk muestra la forma de la solicitud.
¿Necesito saber JavaScript para crear una custom function de Freddy?
Freshworks dice que se necesita una comprensión básica de JavaScript si escribes una custom function manualmente. Las functions prediseñadas para fechas, texto, listas, matemáticas y Base64 cubren los casos comunes sin código. Para una vía sin código, mira la biblioteca de skills prediseñadas de Freddy.
¿Cuál es la diferencia entre una custom function de Freddy y una API personalizada de eesel?
Una function de Freddy es código que escribes dentro de un flujo que tú dibujas. En eesel, permites un dominio de API, añades el encabezado de autenticación y describes en las instrucciones cuándo el compañero debe consultar algo. Lee la comparación de Freddy AI frente a eesel o mira la integración de eesel con Freshdesk.
¿Puedo eliminar una custom function que ya está en uso?
No. Freshworks dice que no puedes eliminar una function usada en un flujo activo, así que quita primero la dependencia. Clonar una function es la forma segura de editar la lógica sin tocar una function en vivo, algo que importa al seguir las mejores prácticas del agente de IA de Freshdesk en los despliegues.