Flujo de trabajo de sondeo de n8n para prospectos locales

Descargue y configure el flujo de trabajo

Descargue la plantilla JSON de n8n e impórtela en su instancia de n8n. Es una receta de sondeo para la API actual, no una integración nativa de OwnerClue. El JSON se ha verificado localmente; no se ha ejecutado contra una tarea de producción de pago en una cuenta de n8n.

1. Cree una clave de OwnerClue con leads:read y leads:write.
2. En n8n, cree una credencial de Header Auth con el nombre que prefiera, con el encabezado Authorization y el valor Bearer más su clave. Selecciónela en Create search, Read status y Download CSV.
3. En Configure, establezca apiBase, keyword y un locationCode real desde el endpoint de ubicaciones. La plantilla usa 0 como marcador de posición intencional.
4. Mantenga depth en 20 o menos si usa solo la prueba de 20 créditos y ningún otro trabajo los ha consumido.
5. Ejecute manualmente. El CSV aparece como datos binarios en Download CSV tras la finalización.

La documentación oficial de HTTP Request de n8n explica la selección de credenciales y los formatos de respuesta.

Comportamiento de sondeo y reintento

Create search envía una clave de idempotencia por ejecución y guarda data.id. Wait retrasa cada sondeo cinco segundos. Read status usa ese ID original. Completed pasa a la descarga del CSV; failed, paused, cancelled o stopped se detiene para inspección; otros estados esperan de nuevo. El flujo de trabajo tiene un tiempo de espera de ejecución de 30 minutos para acotar la espera. Los fallos HTTP detienen la ejecución; inspeccione la respuesta y reintente solo después de corregir su causa.

Si la creación devolvió 202 pero perdió su respuesta, reintente el POST sin cambios usando la misma clave de idempotencia. No vuelva a ejecutar una nueva ejecución de n8n con una nueva clave solo para recuperar una tarea existente: guarde el ID y sondee esa tarea.

Paginación de resultados si necesita JSON

La rama de descarga solicita el CSV completo y deja que la exportación existente entregue todas las filas en streaming. Para usar JSON en su lugar, haga GET /searches/{id}/results?limit=100, guarde data.items y luego repita con data.nextCursor hasta que sea null. Mantenga limit constante y lea después de la finalización. No trate solo la primera página como la lista completa.

Use la misma forma para /campaigns/{id} o /enrichments/{id}, cambiando el cuerpo de creación y los endpoints según corresponda. La entrada de enriquecimiento sigue siendo de como máximo 1,000 filas por tarea de API. Esta plantilla no añade sincronización con CRM, validación de buzones ni un webhook de finalización.