Saltar al contenido
Oratelia
Acceder

Producto

Integraciones con tu sistema (Make, n8n…)

Conecta tu agente con tu sistema para que sepa quién llama, consulte datos durante la llamada y te envíe cada llamada al colgar; y lee tus llamadas, contactos y citas con una clave de API.

Ver en Markdown
En esta página

Con las integraciones, tu agente puede hablar con el sistema que ya usas (tu programa de gestión, tu hoja de pedidos, tu agenda…) a través de herramientas de automatización como Make o n8n.

Qué puedes conectar#

  • Al empezar la llamada. Antes de contestar, tu agente pregunta a tu sistema por quien llama (le enviamos su número). Si tu sistema responde a tiempo con su nombre, si tiene algo pendiente o lo que tú decidas, tu agente lo tiene en cuenta. Si no responde a tiempo, atiende como siempre.
  • Consultas durante la llamada. Tu agente puede consultar tu sistema mientras habla, por ejemplo, el estado de un pedido o si queda una pieza. Antes pide a quien llama los datos que hagan falta (por ejemplo, el número de pedido) y después le cuenta la respuesta con sus palabras.
  • Al colgar. Al terminar cada llamada te enviamos el resumen, los datos que recogió tu agente y el resultado, para que los guardes donde quieras. Si tu sistema no responde, lo volvemos a intentar más tarde.
  • Claves de API. Para que tu sistema lea tus llamadas, tus contactos y tus citas cuando quiera (solo lectura).

Cómo se configura#

Todo se hace en la web, en el modo avanzado. El Modificador de agentes por teléfono puede decirte qué tiene conectado cada agente, pero no las cambia: las direcciones y las claves se escriben en la web.

  1. En tu herramienta de automatización, crea un escenario (Make) o un flujo (n8n) que empiece al recibir datos en una dirección propia. Copia esa dirección: empieza por https://.
  2. En la ficha de tu agente, en el modo avanzado, abre Integraciones y pega la dirección donde corresponda.
  3. Para Al empezar la llamada y para cada consulta, añade los datos con su nombre, su tipo (texto, número o sí o no) y qué son. Tu agente solo recibe y solo pide los datos que declares aquí.
  4. Pulsa Guardar las integraciones. La primera vez verás tu secreto de firma: cópialo, porque no se vuelve a enseñar.
  5. Pulsa Probar lo guardado. Enviamos un ejemplo con datos de prueba (nunca de tus clientes) y verás el resultado y lo que recibiría tu agente.

Solo se puede enviar a los dominios que Oratelia tiene aprobados (los de Make y n8n en la nube, entre otros). Si usas tu propio servidor, pide al equipo de Oratelia que lo añada.

Cómo saber que la petición es de Oratelia#

Cada petición lleva una firma con tu secreto, en la cabecera X-Oratelia-Signature, y la hora en X-Oratelia-Timestamp. Tu sistema puede recalcularla: es el código HMAC-SHA256, con tu secreto, del texto <hora>.<cuerpo>, precedido de sha256=. Si no coincide o la hora tiene más de cinco minutos, descártala. Si alguna vez crees que alguien conoce tu secreto, pulsa Cambiar el secreto y pon el nuevo en tu sistema.

Las peticiones no salen desde direcciones IP fijas: comprueba la firma en lugar de filtrar por IP.

Ejemplos con Make#

  • Guardar cada llamada en una hoja de cálculo. Escenario: «recibir datos en una dirección propia» → «añadir una fila» en tu hoja. Pega la dirección en Al colgar, pulsa Probar lo guardado para que Make conozca los campos (resumen, datos_recogidos, resultado, llamada.llamante…) y elige cuáles van a cada columna.
  • Saludar a tus clientes por su nombre. Escenario: «recibir datos en una dirección propia» → «buscar» en tu lista de clientes por llamada.llamante → «responder a la petición» con {"variables": {"cliente": "<nombre>"}}. En la ficha, en Al empezar la llamada, declara el dato cliente (texto, «Nombre del cliente»). El escenario tiene que responder en un par de segundos.

Ejemplos con n8n#

  • Consultar el estado de un pedido. Flujo: disparador HTTP → busca el pedido con el dato numero → responde con {"texto": "Tu pedido sale mañana por la tarde."}. En la ficha, añade una consulta estado_pedido («Consulta el estado de un pedido»), método GET, con el dato numero (número, obligatorio).
  • Comprobar la firma. Antes de usar los datos, un nodo de código que recalcule la firma con tu secreto y pare el flujo si no coincide.

Claves de API#

En Organización, en el modo avanzado, el propietario o un administrador puede crear claves de API. Cada clave se enseña una sola vez, al crearla: guárdala en tu herramienta. Con ella, tu sistema puede leer:

  • tus llamadas (…/api/v2/integraciones/llamadas), de la más reciente a la más antigua, por páginas;
  • tus contactos (…/contactos), si tienes contactos;
  • tus citas (…/citas), si tienes citas.

La clave va en la cabecera Authorization: Bearer <tu clave>. Solo sirve para leer: no se puede cambiar nada con ella. Si ya no la usas o crees que alguien la conoce, pulsa Revocar y deja de funcionar al momento.

El registro de peticiones#

En la tarjeta Integraciones verás cada petición que ha salido hacia tu sistema, cuándo, a qué dominio y si llegó (Entregado, Error, Sin respuesta a tiempo, Bloqueado o Reintentando), sin los datos enviados. Si alguna falla, verás un aviso en la ficha también en el modo básico.

Tus datos#

Lo que envías a tu sistema (el número de quien llama, el resumen, los datos recogidos y, si lo eliges, la transcripción) queda en tu sistema y bajo tu responsabilidad: Oratelia no puede borrarlo de allí. En Oratelia, el registro de peticiones no guarda los datos de quien llama y se borra pasado un tiempo. Más en Privacidad y datos.