---
title: Integraciones con tu sistema (Make, n8n…)
description: 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.
order: 15
---

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**.

:::info[Llegan poco a poco]
Las integraciones se están activando por fases. Si en la ficha de tu agente, en el [modo avanzado](/recursos/producto/usar-la-web/modo-basico-y-avanzado), no ves la tarjeta **Integraciones**, todavía no están disponibles para tu organización.
:::

## 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](/recursos/producto/privacidad-y-datos).
