Nets

Una Net recolecta publicaciones públicas de redes sociales de las cuentas, hashtags, lugares o enlaces de publicaciones que elijas, conserva las que cumplen una regla de relevancia escrita en lenguaje simple y llena tus propias columnas para cada publicación y comentario.

Cada ejecución de una Net es un Catch: cubre una ventana de tiempo, recolecta lo que se publicó en ella y produce una tabla. Ejecuta Catches a mano, de forma programada o por la API, y la vista de Tendencias los compara en el tiempo. Por ahora las Nets funcionan con Instagram.

• Seguir las quejas sobre tus productos: qué producto, qué salió mal y si respondiste
• Encontrar negocios que buscan proveedores en una ciudad o bajo un hashtag
• Seguir lo que la gente dice sobre un tema: postura, temas y afirmaciones

1. 1Abre “Nets” en la barra lateral y haz clic en “Nueva Net”.
2. 2Elige cómo empezar: “Descríbela” (escribe una frase y la IA propone el alcance, la regla de relevancia y las columnas), “Empezar desde una plantilla”, “Copiar una Net existente” o “Net en blanco”.
3. 3Si la describiste, revisa la propuesta, desmarca lo que no quieras y haz clic en “Crear Net”. Las cuentas sugeridas podrían no existir, así que revísalas en la pestaña Prueba.
4. 4Si no, completa el constructor: Básico, Recolectar, Por publicación y comentario, Por hilo, y Medios y límites (abajo), y haz clic en “Crear Net”.
5. 5La Net se abre en su pestaña Prueba. Ejecuta una prueba antes de tu primer Catch.

Las imágenes se leen para extraer texto y contenido (volantes, listas de precios, productos dañados). En los Reels solo se transcribe el sonido; el video nunca se procesa, y los Reels solo con música se omiten. La espera de asentamiento hace que las publicaciones recientes esperen a un Catch posterior para que su hilo de comentarios tenga tiempo de llenarse.

Cada fila también lleva columnas incluidas, cuyos nombres no puedes reutilizar: Platform, Type, Post ID, Comment ID, URL, Author, Posted At, Likes, Comments, Views, Media, Hashtags, Location, Text, Image Text y Transcript. Tus columnas van después.

“Ejecutar prueba” recolecta una muestra pequeña de tu alcance, muestra qué se conserva, se descarta o se excluye, y previsualiza la tabla, antes de cualquier Catch.

• La prueba siempre usa tus cambios actuales, incluso los que no guardaste. Guárdalos cuando los resultados se vean bien.
• Pestañas: Conservadas, Descartadas, Excluidas y Vista previa de tabla (las primeras publicaciones conservadas con sus comentarios, estructuradas con tus columnas).
• “Por Catch (estimado)” proyecta publicaciones por día, publicaciones por Catch, y filas por Catch. “Como mínimo” significa que la muestra llegó a su tope.
• “Ajusta el alcance” sugiere hashtags o cuentas para agregar o excluir y una regla revisada; un clic actualiza el borrador, y luego pruebas de nuevo para comparar.
• Si solo cambiaste la regla o las columnas, “Probar de nuevo” reutiliza la última muestra: no recolecta de nuevo, solo vuelven a correr tu regla y tus columnas.

Una muestra nueva toma alrededor de un minuto. Cada organización puede ejecutar hasta 40 pruebas cada 24 horas.

1. 1Haz clic en “Ejecutar Catch”.
2. 2Elige “Desde el último Catch” (retoma donde terminó el último Catch y se detiene a la espera de asentamiento antes de ahora; el primer Catch mira hacia atrás la cantidad de días configurada) o “Un rango de fechas (retroactivo)” con las fechas Desde y Hasta.
3. 3Haz clic en “Iniciar Catch”. El Catch aparece en “Catches” con su ventana, publicaciones conservadas, filas, estado y origen (Manual, Programado o API).

Un Catch retroactivo no mueve el punto de retoma, y las publicaciones ya procesadas se omiten. Como las publicaciones se recolectan de la más reciente a la más antigua, llegar muy atrás puede requerir un tope mayor de Publicaciones por Catch. Solo corre un Catch “desde el último Catch” a la vez por Net, y una Net inactiva no puede ejecutarse.

Mientras corre, un Catch muestra su etapa: Recolectando publicaciones, Revisando relevancia, Recolectando comentarios, Leyendo imágenes y audio, Llenando tus columnas y Entregando. Termina como Completado, Fallido o Cancelado. “Cancelar Catch” lo detiene; no se entrega nada, y las publicaciones podrán recolectarse de nuevo.

Un Catch completado muestra publicaciones nuevas, conservadas, comentarios, filas, imágenes leídas y audio transcrito. Su tabla se puede filtrar por publicaciones o comentarios, buscar y descargar como CSV o JSON; cada fila enlaza a la publicación (“Abrir publicación”) y cada valor indica de dónde salió (el texto del elemento, la publicación original, el audio del Reel, los metadatos o una imagen).

En la pestaña “Programación”, activa “Ejecutar de forma programada” y elige una frecuencia: cada hora, cada día, días hábiles (lun–vie), cada semana o un cron personalizado. Cada Catch programado retoma donde terminó el anterior. La pestaña muestra dónde empieza el próximo Catch. La programación queda en pausa mientras la Net está inactiva.

“Tendencias” aparece tras los primeros Catches completados y los compara:

• Publicaciones conservadas por Catch, y publicaciones por día en el último Catch
• Picos en el último Catch, que se marcan cuando hay 3 Catches anteriores para comparar
• Los mayores cambios en tus categorías, verificaciones, preguntas de hilo y categorías de hilo respecto al Catch anterior
• La distribución de categorías y los resultados de las verificaciones Sí/No en el último Catch
• Hashtags principales y autores principales

Copia el ID desde “ID de la Net” y encola un Catch. Un cuerpo vacío ejecuta “desde el último Catch”:

curl -X POST https://run.tavnit.io/api/nets/NET_ID/catch \
  -H "X-API-Key: $TAVNIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Envía window_start (y, si quieres, window_end, que por defecto es ahora) como marcas de tiempo ISO para un Catch retroactivo:

{
  "window_start": "2026-09-01T00:00:00Z",
  "window_end": "2026-09-15T00:00:00Z"
}

La respuesta (202) trae el catch_id. Consulta su estado, y obtén las columns y rows una vez completado, con:

curl https://run.tavnit.io/api/catches/CATCH_ID \
  -H "X-API-Key: $TAVNIT_API_KEY"

POST /api/catches/CATCH_ID/cancel cancela un Catch en cola o en ejecución. Errores: 400 por una ventana inválida, 402 si tu organización no puede iniciar trabajo nuevo en este momento (contacta al equipo de Tavnit), 403 si las Nets no están activadas para tu organización, 409 por una Net inactiva o un Catch “desde el último Catch” ya en curso. Consulta la página de la API REST para la autenticación.

Consulta Roles de usuario.

• Solo Instagram, y solo publicaciones públicas.
• Sin búsqueda por palabras clave: la recolección parte de cuentas, hashtags, lugares o enlaces de publicaciones.
• Hasta 5.000 publicaciones por Catch.
• El video de los Reels nunca se analiza, solo su audio; los Reels solo con música se omiten.
• Si un hilo no se puede estructurar, sus filas se conservan con columnas vacías y el Catch indica cuántos fueron.