Recursos · Integración n8n

Integración GraphQL n8nAutomatiza GraphQL con n8n.

¿Una sola URL que devuelve justo lo que pides? Así funciona la integración GraphQL n8n: 1 operación, 4 campos obligatorios, la consulta que escribes y la respuesta guardada en la propiedad que elijas. Sin nodo trigger: arranca con un horario. Pensada para quien ya conoce su esquema.

Probar la integración GraphQL en n8nVer las 1 operaciones

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué hace realmente la integración GraphQL n8n?

El nodo envía la consulta que escribes a un endpoint y guarda la respuesta donde tú indiques. No hay lista de operaciones que revisar ni recurso que elegir: 1 operación, 1 recurso y se acabó el menú. Lo que cambia de un proyecto a otro nunca es el nodo, es la consulta y el esquema que hay al otro lado del endpoint.

Primer escenario, el informe de la mañana. Una consulta trae las cifras del día anterior en un solo viaje, la respuesta cae en la propiedad que has nombrado y las filas siguen hacia Postgres o Supabase. Aquí GraphQL se gana el sitio: la consulta decide qué campos viajan y el flujo no arrastra datos que nadie va a mirar.

Segundo, la vigilancia. Un Schedule Trigger, el disparador que se ejecuta a intervalo fijo, se activa cada hora, el nodo pide a Product Hunt el top 5 de productos del momento y la lista sale como mensaje de Discord. Nadie abre un panel, el canal se encarga.

Tercero, la carga masiva. Las filas salen de Google Sheets, el nodo manda una mutación por fila a Shopify para crear el producto y fijar su inventario, y la hoja sigue siendo el sitio donde se edita el catálogo. Cada respuesta vuelve al flujo bajo la propiedad indicada, así que la ejecución deja constancia de lo que contestó la API.

El nodo hace una sola operación, que es lo habitual en un cliente genérico. Si el mismo servicio expone un endpoint REST, o si la llamada no cabe en este nodo, el nodo HTTP Request llega a cualquier URL y reutiliza el credential, la credencial que guardas una sola vez en n8n y reutilizas en cualquier flujo, gracias a su autenticación predefinida.

Dos límites antes de montar nada. No existe un trigger de GraphQL, ese nodo que arranca un flujo por su cuenta: la ejecución empieza con un Schedule Trigger a intervalo fijo, con un Webhook de n8n (una URL que llama un servicio externo) o con el trigger de otra herramienta. Y el nodo no tiene Return All ni Limit: cuántos elementos vuelven lo decide la consulta enviada. Para ver el conjunto, la Reseña n8n habla de la plataforma y el Curso n8n cubre cómo montar un flujo desde el primer nodo.

Conexión

¿Cómo conectar GraphQL con n8n?

  1. 01

    Elegir el modo de autenticación

    GraphQL es un lenguaje de consulta, no un servicio concreto, así que el nodo deja la autenticación abierta. None vale para un endpoint público. Header Auth y Query Auth encajan cuando la API espera un token en una cabecera o en la URL. Basic Auth y Digest Auth piden usuario y contraseña. OAuth1 y OAuth2 cubren el acceso delegado a una cuenta, y Custom Auth las API que mezclan varios de estos mecanismos.

  2. 02

    Guardar el credential una sola vez

    Un credential es el bloque de datos de acceso que n8n guarda por ti. Se crea en el menú Credentials, con un nombre que reconozcas dentro de seis meses, y cualquier flujo de la instancia puede usarlo. El nodo GraphQL lo ofrece después en su desplegable. Cambiar un token más adelante significa tocar ese credential, no cada nodo que llama a la API.

  3. 03

    Apuntar el nodo al endpoint

    Pega la URL de la API en Endpoint, con la forma http://example.com/graphql. Pon HTTP Request Method en GET o en POST según lo que acepte la API, escribe una consulta corta en Query y ejecuta el nodo una vez. Si aparece una respuesta legible bajo la propiedad indicada en Response Data Property Name, la conexión funciona.

Acciones

Qué sabe hacer el nodo GraphQL

El nodo GraphQL expone una operación. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Makes a GraphQL request and returns the received data

execute

Lo que ves en n8n

Notas y casos de uso

El nodo manda una petición al endpoint configurado y pasa la respuesta al nodo siguiente, guardada bajo el nombre de propiedad que hayas elegido.

Parámetros clave

  • Endpoint: la URL que acepta las consultas, con la forma http://example.com/graphql.
  • Request Format: graphql manda la consulta en texto plano, json la envuelve en un cuerpo JSON.
  • Query: la consulta, donde la expresión {{ $json.id }} lee un valor del item entrante.
  • Response Data Property Name: la propiedad que recibe la respuesta y el nombre que leerán los nodos siguientes.
Casos de uso
traer en una llamada los campos exactos que necesita un informe semanal, sin encadenar varias peticiones.
Necesitas ayuda

¿Necesitas ayuda para automatizar GraphQL con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

GraphQL y n8n: preguntas frecuentes

01¿La integración GraphQL n8n es gratis?
Sí. El nodo GraphQL viene incluido con n8n, así que no hay nada que instalar ni nada extra que pagar del lado de n8n, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. El flujo se comporta igual en los dos sitios, así que puedes prepararlo en uno y moverlo al otro sin tocar la consulta. El credential se crea gratis y sirve para todos los flujos de la instancia. Lo que cobre la API que hay detrás del endpoint es otro asunto y se arregla con quien la gestiona.
02¿Qué credentials necesita el nodo GraphQL?
Depende de la API a la que llames, y el nodo cubre 8 posibilidades: None, Basic Auth, Digest Auth, Header Auth, Query Auth, OAuth1, OAuth2 y Custom Auth. Un endpoint público que no pide identificación funciona con None. Una API que espera un token en una cabecera usa Header Auth, y la que lo espera en la URL usa Query Auth. Basic Auth y Digest Auth piden usuario y contraseña. OAuth1 y OAuth2 valen cuando el acceso se delega a una cuenta. Custom Auth cubre los endpoints que combinan varios de estos mecanismos. El credential se crea una vez en el menú Credentials y luego se elige en el nodo.
03¿Qué límites tiene el nodo GraphQL en n8n?
El nodo hace una cosa: manda una petición y devuelve los datos recibidos. No hay Return All ni Limit, así que cuántos elementos vuelven depende de la consulta, y recorrer una lista larga por páginas se resuelve dentro de esa consulta. Toda la respuesta aterriza bajo una sola propiedad, la indicada en Response Data Property Name, y los nodos siguientes leen de ahí. Tampoco hay trigger de GraphQL. Cuando un endpoint queda fuera de lo que este nodo sabe expresar, el nodo HTTP Request llama a cualquier URL de la misma API y reutiliza el credential ya guardado.
04¿El nodo GraphQL reacciona en tiempo real?
No, porque n8n no tiene un nodo trigger de GraphQL. Nada del lado del endpoint despierta un flujo por su cuenta, así que el arranque lo eliges tú. Un Schedule Trigger repite la consulta a intervalo fijo, cada hora para una vigilancia, una vez al día para un informe. Un Webhook de n8n le da al flujo su propia URL, y cualquier servicio capaz de llamar a esa URL lanza la ejecución. El trigger de otra herramienta funciona igual de bien: una fila nueva, un mensaje nuevo, un archivo nuevo, y la consulta GraphQL viene detrás en la misma ejecución.
05¿n8n o Make para GraphQL?
Depende de dónde quieras que viva el flujo. n8n corre en n8n Cloud o en tu propio servidor con Docker o npm, y una instancia autoalojada mantiene la consulta y la respuesta dentro de tu red, algo que pesa cuando el endpoint es interno. Make lo aloja Make, sin opción de autoalojamiento, y factura por operación: una consulta cada hora se convierte en un coste por operación de un lado y en una factura de servidor del otro. Las dos dibujan el flujo de forma visual. Los criterios honestos son el alojamiento, el control de los datos, el modelo de coste y qué lienzo lee más rápido tu equipo.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones