Recursos · Integración n8n

Integración KoBoToolbox n8nAutomatiza KoBoToolbox con n8n.

¿Cuántos datos de campo siguen esperando a que alguien exporte un archivo? La integración KoBoToolbox n8n aporta un nodo con 17 operaciones en 4 recursos y un trigger que arranca el flujo en cuanto un formulario recibe un envío. Pensada para equipos que recogen datos sin conexión y los procesan en la oficina.

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

Por qué automatizar

¿Qué resuelve la integración KoBoToolbox n8n?

La integración KoBoToolbox n8n une una cuenta de recogida de datos con el resto de tus herramientas mediante dos nodos. El nodo KoBoToolbox reúne 17 operaciones repartidas en 4 recursos: File, Form, Hook y Submission. El KoBoToolbox Trigger escucha 1 evento y arranca un flujo de trabajo cuando un formulario recibe un envío nuevo. Los dos comparten el mismo credential, es decir, el acceso que guardas una sola vez en n8n, aquí un token de API.

Primer escenario, el aviso que llega antes que el informe. El trigger salta con formSubmission, submission.get devuelve el envío completo con Reformat activado, y un mensaje sale hacia Telegram con lo esencial. El responsable de zona se entera el mismo día, no el viernes.

Segundo escenario, el inventario de formularios. form.getAll recorre la cuenta con Return All activado y vuelca la lista en Google Sheets, así los coordinadores ven de un vistazo qué formularios siguen activos y cuáles llevan meses parados.

Tercer escenario, los hooks que fallan en silencio. hook.getLogs filtra los registros por Failed, hook.retryAll vuelve a lanzar los intentos fallidos de ese hook, y el recuento sale por Pushover al móvil de guardia. Un sistema roto deja de descubrirse tres semanas tarde.

Los adjuntos siguen el mismo camino: las operaciones de envío pueden descargarlos en propiedades binarias y el flujo los reenvía después, por ejemplo con SendGrid, sin que nadie entre en la interfaz de KoBoToolbox.

Dos cosas que conviene tener claras. Cuando un endpoint de la API de KoBoToolbox queda fuera de las 17 operaciones del nodo, el nodo HTTP Request lo llama directamente y reutiliza ese mismo credential mediante la autenticación predefinida, así que ningún flujo se queda a medias. Y en cualquier listado manda Return All: desactivado, el nodo se detiene en Limit, y un export truncado se parece punto por punto a uno completo. Si todavía estás eligiendo plataforma, la Reseña n8n entra más a fondo.

Conexión

¿Cómo se conecta KoBoToolbox con n8n?

  1. 01

    Copia tu token de API

    Entra en la cuenta de KoBoToolbox y abre Account Settings: ahí aparece el token de API. Es el único dato secreto que n8n necesita. Aprovecha para anotar en qué servidor se creó la cuenta, porque el siguiente paso lo pide y los dos servidores no son intercambiables.

  2. 02

    Crea el credential en n8n

    En n8n, menú Credentials, añade un credential de KoBoToolbox. API Root URL espera la dirección del servidor donde se creó la cuenta: https://kf.kobotoolbox.org para el servidor global, https://eu.kobotoolbox.org para el de la Unión Europea. API Token recibe la cadena copiada en Account Settings. Guárdalo una vez y todos tus flujos lo reutilizan.

  3. 03

    Elige el formulario en el nodo

    Coloca el nodo KoBoToolbox o el KoBoToolbox Trigger en el lienzo y selecciona el credential en el desplegable. Form Name or ID carga entonces los formularios de esa cuenta, de modo que eliges por nombre en lugar de buscar un identificador como aSAvYreNzVEkrWg5Gdcvg. También puedes pasar el identificador con una expresión, ese fragmento de código que n8n evalúa al ejecutar.

Disparadores

¿Qué arranca un flujo de KoBoToolbox ?

KoBoToolbox Trigger es el nodo que arranca un workflow cuando algo ocurre en KoBoToolbox. Escucha 1 eventos, listados abajo por familia. Eliges uno o varios, activas el workflow y n8n registra el webhook (la URL que KoBoToolbox llama) en tu cuenta.

Lo que ves en n8n

Todos los eventos, por familia

Una fila por objeto, un chip por acción. El evento que marcas en el nodo se escribe objeto.acción; pasa el cursor por un chip para leer cuándo se dispara.

form.*1

    Notas de configuración

    01Configure the KoBoToolbox TriggerEl nodo trigger arranca un flujo con los envíos nuevos de un formulario concreto. Él mismo crea y borra el hook en KoBoToolbox, así que no hay nada que configurar dentro de la herramienta. Lee el envío igual que la operación Get a submission, con las mismas opciones de reformateo.

    El nodo trigger arranca un flujo con los envíos nuevos de un formulario concreto. Él mismo crea y borra el hook en KoBoToolbox, así que no hay nada que configurar dentro de la herramienta. Lee el envío igual que la operación Get a submission, con las mismas opciones de reformateo.

    Parámetros clave

    • Form Name or ID: obligatorio, es el formulario vigilado. Lo eliges en la lista que n8n carga desde la cuenta o pasas un identificador como aSAvYreNzVEkrWg5Gdcvg con una expresión.
    • Reformat: dentro de la colección Options, aplica un reformateo a los datos del envío, como la interpretación de coordenadas GeoJSON, en lugar de entregarte la carga en bruto.
    Cuándo usarlo
    siempre que el trabajo deba empezar en el momento de la recogida y no en el del export, desde un aviso al supervisor hasta alimentar un panel de seguimiento.
    02On Form SubmissionformSubmission es el único evento del catálogo, una sola familia, y se ajusta en el parámetro Trigger On. El mecanismo es un webhook, o sea una URL a la que KoBoToolbox llama justo cuando llega el envío: el flujo arranca en segundos, sin ningún ciclo de consulta por medio. Versión 1 del trigger.

    formSubmission es el único evento del catálogo, una sola familia, y se ajusta en el parámetro Trigger On. El mecanismo es un webhook, o sea una URL a la que KoBoToolbox llama justo cuando llega el envío: el flujo arranca en segundos, sin ningún ciclo de consulta por medio. Versión 1 del trigger.

    Parámetros clave

    • Download Attachments: trae al flujo las fotos o vídeos enviados junto a las respuestas en vez de dejarlos atrás.
    • Attachments Naming Scheme y Attachments Prefix: nombran las propiedades binarias, por secuencia o a partir del identificador de la pregunta original, con un índice que empieza en 0 añadido al prefijo.
    • File Size: qué versión del adjunto recuperar cuando hay varias disponibles.
    • Multiselect Mask y Number Mask: selectores separados por comas para los campos que deben tratarse como listas o como números.
    Cuándo usarlo
    siempre que una foto o una coordenada pesen tanto como las respuestas, porque son estas opciones las que deciden qué llega de verdad al flujo.
    Acciones

    ¿Qué sabe hacer el nodo KoBoToolbox ?

    El nodo KoBoToolbox expone 17 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

    Matriz recursos × operaciones
    RecursoCreateGetGet ManyDeleteLogsGet Validation StatusRedeployRetry AllRetry OneUpdate Validation Status
    File✓✓✓✓
    Form✓✓✓
    Hook✓✓✓✓✓
    Submission✓✓✓✓✓

    File

    4 operaciones
    01

    Create a file

    file.create

    Lo que ves en n8n

    Notas y casos de uso

    Sube un archivo a un formulario, ya sea desde datos binarios que el flujo ya lleva o desde un enlace público.

    Parámetros clave

    • Form Name or ID: el formulario que recibe el archivo, elegido en el desplegable o pasado como identificador con una expresión.
    • File Upload Mode: dos opciones, Binary File cuando el archivo viaja dentro del item, URL cuando KoBoToolbox debe ir a buscarlo.
    • Property Name: la propiedad binaria que contiene el archivo. Tipos admitidos: image, audio, video, csv, xml y zip.
    • File URL: el enlace HTTP(s) al archivo, usado en el modo URL.
    Casos de uso
    una lista de referencia que el flujo regenera cada mes y deja en el formulario sin pasar por la interfaz.
    02

    Delete a file

    file.delete

    Lo que ves en n8n

    Notas y casos de uso

    Borra un archivo de un formulario a partir de su identificador.

    Parámetros clave

    • File ID: el uid del archivo, que empieza por af, por ejemplo afQoJxA4kmKEXVpkH6SYbhb. Es el identificador, no el nombre del archivo.
    • Form Name or ID: el formulario al que pertenece, útil cuando un mismo flujo maneja varios.
    Casos de uso
    la segunda mitad de una rutina de actualización. Se borra la versión caducada y Create a file deja la nueva, de modo que el formulario nunca acumula dos versiones del mismo documento.
    03

    Get a file content

    file.get

    Lo que ves en n8n

    Notas y casos de uso

    Lee un archivo ya asociado a un formulario y puede traer su contenido al flujo en formato binario.

    Parámetros clave

    • File ID: el uid que empieza por af, muchas veces tomado de un nodo anterior con {{ $json.field }}.
    • Download File Content: decide si el contenido se descarga en una propiedad binaria.
    • Property Name: el nombre de la propiedad binaria donde se escribe el archivo.
    Casos de uso
    sacar un documento del formulario para enviarlo adjunto, sin abrir el acceso a la cuenta de KoBoToolbox a todo el equipo.
    04

    Get many files

    file.getAll

    Lo que ves en n8n

    Notas y casos de uso

    Enumera los archivos asociados a un formulario, con un solo campo que rellenar.

    Parámetros clave

    • Form Name or ID: el único campo obligatorio aquí. Señalas el formulario y el nodo devuelve sus archivos.
    Casos de uso
    el inventario previo a la limpieza. El flujo recorre los archivos, conserva los que espera y pasa el resto a Delete a file. También sirve cuando un formulario ha cambiado de manos varias veces y nadie recuerda qué se subió.

    Form

    3 operaciones
    05

    Get a form

    form.get

    Lo que ves en n8n

    Notas y casos de uso

    Devuelve un formulario de la cuenta, uno solo.

    Parámetros clave

    • Form Name or ID: el formulario que se lee. El desplegable es el camino rápido; la expresión entra cuando el identificador llega de un paso anterior.
    Casos de uso
    un paso de consulta en mitad de un flujo más largo, cuando una rama necesita la ficha del formulario antes de decidir qué hacer, justo antes de un redespliegue o de enviar un resumen a un canal.
    06

    Get many forms

    form.getAll

    Lo que ves en n8n

    Notas y casos de uso

    Recorre los formularios de la cuenta y los devuelve como items.

    Parámetros clave

    • Return All: activado, el nodo encadena las páginas de la API hasta el último formulario; desactivado, se detiene en Limit.
    • Limit: el número máximo de formularios devueltos cuando Return All queda desactivado.
    • Filter: en Options, una búsqueda de texto sobre los datos del formulario, por ejemplo owner__username:meg AND name__icontains:quixotic.
    • Sort: en Options, los criterios de orden aplicados al resultado.
    Casos de uso
    un inventario semanal de todos los formularios de la cuenta, volcado en una hoja que consultan los responsables de proyecto.
    07

    Redeploy Current Form Version

    form.redeploy

    Lo que ves en n8n

    Notas y casos de uso

    Vuelve a desplegar la versión actual de un formulario desde el flujo de trabajo.

    Parámetros clave

    • Form Name or ID: el formulario afectado, indicado una vez en el nodo y reutilizado en cada ejecución.
    Casos de uso
    el último paso de una cadena que empieza en otro sitio. Un coordinador aprueba un cambio en un canal, el flujo recoge esa aprobación y lanza el redespliegue, con lo que la acción queda registrada en una ejecución en lugar de depender de la memoria de alguien.

    Hook

    5 operaciones
    08

    Get a hook

    hook.get

    Lo que ves en n8n

    Notas y casos de uso

    Devuelve la definición de un hook declarado en un formulario.

    Parámetros clave

    • Hook ID: el identificador del hook, que empieza por h, por ejemplo hVehywQ2oXPYGHJHKtqth4.
    • Form Name or ID: el formulario que lo aloja.
    Casos de uso
    la comprobación previa a un reintento. El flujo lee la definición, confirma que va a actuar sobre el hook correcto y sigue hacia los registros o hacia las operaciones de reintento de la misma rama.
    09

    Get Many hooks

    hook.getAll

    Lo que ves en n8n

    Notas y casos de uso

    Enumera los hooks declarados en un formulario, para ver a qué está conectado.

    Parámetros clave

    • Return All: activado, vuelven todos los hooks del formulario; desactivado, el nodo se detiene en Limit.
    • Limit: el tope que se aplica cuando Return All queda desactivado.
    Casos de uso
    una auditoría sobre formularios que llevan tiempo en marcha. Se recogen los hooks, se guardan los identificadores y se pasan a las operaciones de registros y de reintento dentro del mismo flujo.
    10

    Get Logs for a hook

    hook.getLogs

    Lo que ves en n8n

    Notas y casos de uso

    Recupera los registros de un hook, con filtros para acotar lo que vuelve.

    Parámetros clave

    • Hook ID: el hook cuyos registros quieres, identificador que empieza por h.
    • Log Status: All, Failed, Pending o Success.
    • Start Date y End Date: la fecha mínima y la máxima de los registros recuperados, que es como mantienes la revisión centrada en una ventana concreta en vez de repasar todo el histórico.
    Casos de uso
    una revisión matinal filtrada por Failed sobre el día anterior, con el resultado contado y publicado en un canal para que una avería silenciosa se note.
    11

    Retry All hooks

    hook.retryAll

    Lo que ves en n8n

    Notas y casos de uso

    Vuelve a lanzar de una sola vez todos los intentos fallidos de un hook concreto.

    Parámetros clave

    • Hook ID: el hook cuyos intentos fallidos se reproducen.
    • Form Name or ID: el formulario al que está asociado ese hook.
    Casos de uso
    la recuperación después de una caída del sistema receptor. En vez de repasar registro a registro, el flujo llama a esta operación una vez por hook y pasa a la rama de notificación.
    12

    Retry One hook

    hook.retryOne

    Lo que ves en n8n

    Notas y casos de uso

    Reproduce un intento concreto en lugar del lote entero.

    Parámetros clave

    • Hook Log ID: el registro que se relanza, identificador que empieza por hl, por ejemplo hlSbGKaUKzTVNoWEVMYbLHe.
    • Hook ID: el hook al que pertenece ese registro.
    Casos de uso
    encaja con Get Logs for a hook. Filtras por Failed, recorres los resultados y relanzas cada registro por separado cuando te interesa saber cómo acaba cada uno.

    Submission

    5 operaciones
    13

    Delete a submission

    submission.delete

    Lo que ves en n8n

    Notas y casos de uso

    Elimina un envío de un formulario.

    Parámetros clave

    • Submission ID: un número, por ejemplo 245128, no el nombre de la persona encuestada.
    • Form Name or ID: el formulario que contiene ese envío.
    Casos de uso
    retirar las entradas de prueba que quedan tras un ensayo del formulario, para que el recuento real empiece limpio. Pon un paso de confirmación delante, porque detrás no hay ninguna rama de vuelta atrás.
    14

    Get a submission

    submission.get

    Lo que ves en n8n

    Notas y casos de uso

    Recupera un envío con sus datos y una serie de opciones para dar forma a la respuesta.

    Parámetros clave

    • Submission ID: el identificador numérico del envío, a menudo pasado como {{ $json.field }} desde un nodo anterior.
    • Fields to Retrieve: una lista separada por comas, del tipo _submission_time,_submitted_by. Si se deja vacía, vuelven todos los campos.
    • Reformat: aplica la lógica de reformateo, incluida la interpretación de coordenadas GeoJSON.
    Casos de uso
    enriquecer un aviso. La notificación lleva un identificador y esta operación lo convierte en el conjunto completo de respuestas.
    15

    Get many submissions

    submission.getAll

    Lo que ves en n8n

    Notas y casos de uso

    Reúne los envíos de un formulario en volumen, que es la operación sobre la que se montan casi todos los exports.

    Parámetros clave

    • Return All: activado, el nodo pagina hasta el último envío; desactivado, se detiene en Limit.
    • Filter: None o JSON, y con JSON es Filters (JSON) quien lleva la consulta.
    • Sort: en Options, predicados de orden en formato JSON de MongoDB, por ejemplo {"_submission_time":1}.
    Casos de uso
    el export nocturno a una hoja de cálculo, ordenado por fecha de envío para que las filas recientes queden abajo.
    16

    Get the validation status for a submission

    submission.getValidation

    Lo que ves en n8n

    Notas y casos de uso

    Indica en qué punto del circuito de revisión está un envío, sin modificar nada.

    Parámetros clave

    • Submission ID: el identificador numérico del envío que se consulta.
    • Form Name or ID: el formulario en el que se registró.
    Casos de uso
    la condición de entrada de un flujo de revisión. Se lee el estado primero y se bifurca para saltar los envíos que un supervisor ya ha tratado, en vez de avisar al canal por segunda vez.
    17

    Update the validation status for a submission

    submission.setValidation

    Lo que ves en n8n

    Notas y casos de uso

    Escribe la decisión de revisión sobre el propio envío, para que el estado viva en el dato y no en una conversación.

    Parámetros clave

    • Validation Status: Approved, Not Approved u On Hold, los tres valores que acepta el nodo.
    • Submission ID: el identificador numérico del envío que se actualiza.
    Casos de uso
    un supervisor responde en un canal, el flujo traduce la respuesta a uno de los tres valores y lo aplica, y el siguiente export ya arrastra esa decisión.
    Necesitas ayuda

    ¿Necesitas ayuda para automatizar KoBoToolbox con n8n?

    El equipo te responde directamente.

    Cada mensaje lo lee una persona.

    FAQ

    KoBoToolbox y n8n, las dudas que vienen después

    01¿La integración KoBoToolbox n8n es gratuita?
    Sí por el lado de n8n. El nodo KoBoToolbox y el KoBoToolbox Trigger vienen incluidos con n8n, así que no hay nada que instalar, nada que comprar y ningún paso por un mercado de extensiones. Vale tanto en n8n Cloud, la oferta alojada por n8n, como en una instancia autoalojada instalada con Docker o npm bajo la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos casos, de modo que lo que montas en un portátil se mueve a un servidor sin reescribir nada. Lo que cueste una cuenta de KoBoToolbox es otra cuestión y no se trata aquí.
    02¿Qué credenciales hacen falta para conectar KoBoToolbox con n8n?
    Un solo credential, por token de API, con dos valores. API Root URL espera la dirección del servidor de KoBoToolbox donde se creó la cuenta: https://kf.kobotoolbox.org para el servidor global y https://eu.kobotoolbox.org para el de la Unión Europea. API Token recibe la cadena que aparece en los Account Settings de esa misma cuenta. El credential se crea una vez desde el menú Credentials de n8n y, a partir de ahí, tanto el nodo como el trigger lo encuentran en su desplegable. Ni pantalla de OAuth, ni aplicación que registrar, ni lista de permisos que marcar.
    03¿Qué límites tiene el nodo de KoBoToolbox?
    Dos cosas que conviene prever. La paginación: en las operaciones de listado, Return All encadena las páginas de la API hasta el final, y dejarlo desactivado significa que el nodo se detiene en Limit. Un export truncado se ve exactamente igual que uno completo, y así es como aparece un hueco de datos que nadie detecta. La cobertura: el nodo expone 17 operaciones sobre 4 recursos y, cuando el endpoint que necesitas queda fuera de ese catálogo, el nodo HTTP Request llama a la API de KoBoToolbox directamente reutilizando ese mismo credential mediante la autenticación predefinida. El flujo continúa, con un nodo genérico más en la cadena.
    04¿El KoBoToolbox Trigger reacciona en tiempo real?
    Sí. El mecanismo es un webhook, es decir, una URL a la que KoBoToolbox llama en cuanto entra un envío, así que el flujo arranca en segundos y no según un horario. No hay intervalo de consulta que ajustar ni retraso que aceptar. El propio nodo trigger se encarga de crear y borrar el hook cuando activas o desactivas el flujo, de modo que no hay que configurar nada a mano dentro de KoBoToolbox. Lee el envío igual que la operación Get a submission, con las mismas opciones de reformateo y de adjuntos.
    05¿n8n o Make para KoBoToolbox?
    Depende de tres criterios, y las dos herramientas se sostienen. El alojamiento: Make es una plataforma alojada, sin opción de autoalojamiento, mientras que n8n corre en tu propio servidor o en n8n Cloud, algo que pesa cuando los datos de campo no pueden salir de un territorio concreto. El modelo de coste: Make factura por operación, así que un flujo que recorre miles de envíos tiene allí otra forma. La lógica visual: las dos dibujan el flujo en un lienzo, con costumbres distintas en bifurcaciones y código. Para KoBoToolbox, el punto de partida son las mismas 17 operaciones y el mismo webhook de envío.