- Inicio
- Recursos
- Integraciones
- KoBoToolbox
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
¿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.
¿Cómo se conecta KoBoToolbox con n8n?
- 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.
- 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.orgpara el servidor global,https://eu.kobotoolbox.orgpara 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. - 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.
¿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.*1Notas de configuración
01Configure the KoBoToolbox Trigger
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
aSAvYreNzVEkrWg5Gdcvgcon 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.
02On Form Submission
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.
¿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.
| Recurso | Create | Get | Get Many | Delete | Logs | Get Validation Status | Redeploy | Retry All | Retry One | Update Validation Status |
|---|---|---|---|---|---|---|---|---|---|---|
| File | ✓ | ✓ | ✓ | ✓ | ||||||
| Form | ✓ | ✓ | ✓ | |||||||
| Hook | ✓ | ✓ | ✓ | ✓ | ✓ | |||||
| Submission | ✓ | ✓ | ✓ | ✓ | ✓ |
Índice de operaciones
File
4 operacionesCreate a file
file.createLo 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.
Delete a file
file.deleteLo 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 ejemploafQoJxA4kmKEXVpkH6SYbhb. Es el identificador, no el nombre del archivo. - Form Name or ID: el formulario al que pertenece, útil cuando un mismo flujo maneja varios.
Get a file content
file.getLo 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.
Get many files
file.getAllLo 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.
Form
3 operacionesGet a form
form.getLo 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.
Get many forms
form.getAllLo 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.
Redeploy Current Form Version
form.redeployLo 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.
Hook
5 operacionesGet a hook
hook.getLo 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 ejemplohVehywQ2oXPYGHJHKtqth4. - Form Name or ID: el formulario que lo aloja.
Get Many hooks
hook.getAllLo 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.
Get Logs for a hook
hook.getLogsLo 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.
Retry All hooks
hook.retryAllLo 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.
Retry One hook
hook.retryOneLo 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 ejemplohlSbGKaUKzTVNoWEVMYbLHe. - Hook ID: el hook al que pertenece ese registro.
Submission
5 operacionesDelete a submission
submission.deleteLo 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.
Get a submission
submission.getLo 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.
Get many submissions
submission.getAllLo 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}.
Get the validation status for a submission
submission.getValidationLo 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ó.
Update the validation status for a submission
submission.setValidationLo 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.
¿Necesitas ayuda para automatizar KoBoToolbox con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
