Tres momentos, tres piezas
Por programa entendemos el sitio donde ya trabajas, como tu CRM, tu programa de gestión, tu ERP o una automatización tuya en n8n. Lera no trae un conector para cada marca. Tu agente habla con tu programa a través de una dirección web que te da quien lo lleva, y vale cualquiera que pueda recibir una petición por internet.
Durante la llamada, con las funciones. Una función es una pregunta o un encargo que el agente le hace a tu programa en mitad de la conversación, como mirar un pedido o dar de alta un aviso, y con la respuesta sigue hablando.
Antes de descolgar, con Saber quién llama. Lera le pregunta a tu programa de quién es el número que llama, y el saludo ya puede llevar su nombre.
Al terminar la llamada, con las acciones al terminar y con el Webhook post-llamada. Un webhook es un aviso automático que un programa le manda a otro. Aquí Lera le manda a tu programa cada llamada cuando acaba, con su resumen y los datos recogidos.
La diferencia importa. Lo que el agente necesita saber mientras habla va en una función. Lo que solo tiene que llegar a tu programa cuando la llamada acaba va al terminar, y así quien llama no espera al teléfono.
Las funciones, durante la llamada
En una distribuidora, por ejemplo, un cliente llama por su pedido. El agente le pide el número, se lo pregunta a tu programa con una función y le dice que sale mañana por la mañana. Todo en la misma llamada.
Se crean en tu agente. Abre tu agente en Agentes, ve a Herramientas, pulsa Añadir y elige Nueva función.
Ponle un nombre, como consultar_pedido, y una descripción que le diga al agente cuándo usarla, con tus palabras, por ejemplo «cuando pregunten por el estado de su pedido».
En Endpoint pega la dirección web de tu programa, que tiene que empezar por https. En Parámetros añade los datos que el agente tiene que pedir antes de preguntar, como numero_pedido.
Debajo tienes «Lo que recibirá tu sistema», el mensaje exacto que le llegará a tu programa, listo para copiarlo y pasárselo a quien lo programe. Los datos que pide el agente van dentro de input, con el nombre que les has puesto.
Si un dato solo puede ser una de unas pocas opciones, como la compañía o el gremio, rellena «solo estas opciones». Tu programa recibirá siempre una de ellas, escrita tal como la pusiste.
Lo que tiene que saber tu programa
Mientras tu programa contesta, quien llama está esperando al teléfono. Lera espera 8 segundos de serie, y el plazo se puede subir en la ficha de la función si tu programa de verdad tarda.
La petición no se repite. Si tu programa falla, el agente se entera y lo dice con naturalidad, sin dar la gestión por hecha, porque repetirla sola a mitad de conversación podría crear dos avisos. Cada petición lleva el identificador de la llamada, para que tu programa no apunte dos veces lo mismo.
Que tu programa conteste con frases que se puedan decir en voz alta, como «treinta y dos euros con cincuenta», y con pocas opciones. La respuesta se corta a 6.000 caracteres, así que un listado largo es mejor filtrarlo antes.
Si tu programa tarda más de un segundo, activa «Aviso mientras ejecuta» con una frase como «Un momento, lo compruebo» y elige «Solo si tarda». Así solo suena cuando de verdad hay espera.
En las pruebas del panel, la función puede devolver una «Respuesta de prueba» en vez de llamar a tu programa. En las llamadas reales llama siempre a tu dirección. Y cada petición dice de dónde viene, del teléfono, de tu web o de una prueba, para que tu programa no guarde datos de prueba como si fueran reales.
Al terminar la llamada
Las acciones al terminar la llamada son de cada agente. Abre tu agente, ve a Acciones al terminar la llamada, pulsa Añadir y elige Función personalizada, que manda los datos de la llamada a una dirección tuya. Se ejecutan después del análisis post-llamada, así que pueden llevar lo que el análisis acaba de sacar, y con «Configurar condiciones» decides en qué llamadas se mandan.
Con «Probar con una llamada» eliges una llamada de tu historial y ves qué se habría mandado, sin mandar nada.
El Webhook post-llamada es de todo el proyecto. En Integraciones, conéctalo y pega la dirección de tu programa en «URL del webhook». Al terminar cada llamada, de cualquiera de tus agentes, Lera le manda el resumen, la intención, el sentimiento, los datos del análisis y la transcripción. Si tu programa no responde, se intenta hasta tres veces.
Para lo que pasa antes de descolgar, Saber quién llama tiene su propia guía, con lo que recibe tu programa y lo que tiene que contestar.
Cómo comprueba tu programa que la petición es de Lera
Cada petición va firmada. Lleva tres cabeceras, x-lera-signature, x-lera-timestamp y x-lera-nonce, y la firma es un HMAC-SHA256 de la marca de tiempo, el nonce y el cuerpo tal cual llega, calculado con el secreto de tu proyecto.
El secreto está al pie de Herramientas, en «Verificar peticiones · ver secreto de firma». Hay uno por proyecto, y firma igual las funciones, Saber quién llama y el Webhook post-llamada.
Quien programe tu lado tiene que recalcular la firma con el cuerpo tal cual llega, compararla en tiempo constante y guardar el nonce, para que nadie pueda reenviar la misma petición. Si además quieres una clave tuya, ponla en una cabecera y no en la dirección, porque una dirección completa acaba escrita en los registros de tu servidor.
Lo que conviene saber
Si contratas un plan, conectar tu programa, es decir, las funciones, Saber quién llama y las acciones al terminar la llamada que llaman a tu programa, va desde el Profesional, y la API y el MCP desde el Avanzado. Cal.com y los avisos por correo van en todos.
Si lo que quieres es reservar citas en Cal.com, no necesitas una función tuya. Tu agente trae un conector propio para Cal.com, que se añade en Herramientas.
Si tu agente borra datos personales al colgar, el Webhook post-llamada ya sale con las marcas en su lugar. Las funciones durante la llamada y las acciones al terminar, en cambio, llevan los datos tal cual.
Cuando una función falla, en Historial de llamadas ves el motivo junto a la función, por ejemplo «tu sistema no respondió a tiempo» o «tu sistema respondió 500».
Antes de abrirlo a tus clientes, haz una llamada real, porque en la prueba del panel la función puede estar devolviendo su respuesta de prueba.
Preguntas frecuentes
¿Tenéis conector para mi ERP? No hay un conector por marca. La función apunta a la dirección web de tu programa, así que vale cualquiera que pueda recibir una petición por internet, directo o a través de n8n.
¿Puedo usar n8n? Sí. Pega en la función la dirección de tu flujo de n8n y haz que el flujo conteste con lo que el agente tiene que decir.
¿Tengo que saber programar? En el panel no. Lo que hace falta es una dirección web que reciba la petición y conteste, y esa la prepara quien lleve tu programa. También se lo puedes pedir a Maite, la ayudante del panel, con una frase como «añade una función que mire el estado de un pedido, la dirección es…».
¿Qué pasa si mi programa está caído? En una función, el agente lo dice y la llamada sigue sin dar nada por hecho. En el Webhook post-llamada, se intenta hasta tres veces.