Saturn Studio – Apify

Apify es una plataforma CRM que proporciona herramientas de marketing, ventas y atención al cliente para ayudar a las empresas a crecer. Con soluciones de automatización, gestión de leads y análisis de datos, Apify permite a las organizaciones mejorar las relaciones con los clientes y optimizar sus estrategias de negocio.

📌 ¿Qué es este módulo?

Este módulo te permite interactuar con la plataforma Apify directamente desde Saturn Studio. Puedes ejecutar y administrar Actors (Actores), Tareas y Datasets (Conjuntos de datos) de Apify, así como suscribirte a webhooks para monitorear eventos, facilitando la integración de las capacidades de web scraping y automatización de Apify en tus flujos de trabajo.

Descripción de los comandos

Suscribirse a Webhook

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Apify necesaria para esperar a un actor	credential
Actor	Seleccione el actor que desea ejecutar	My Actor
Descripción	Descripción del webhook para esperar la finalización del actor	Webhook para esperar finalización de actor
Asignar resultado a variable	Variable where the result will be stored. Example {“response”{“data”{“id””IcuPYbCSum4h57MRa”,”createdAt””2025-03-10T210514.535Z”,”modifiedAt””2025-03-10T210514.535Z”,”userId””r2wGftDCi0C01GqZS”,”isEnabled”true,”isAdHoc”false,”eventTypes”[“ACTOR.RUN.SUCCEEDED”],”condition”{“actorId””TJdehJYUf26tLd4t1″},”ignoreSslErrors”false,”doNotRetry”false,”requestUrl””https//qgj1zsts-3000.brs.devtunnels.ms/webhook/c963e13f9a6771590bf88dc791ccf9c6”,”payloadTemplate””{\n “userId” {{userId}},\n “createdAt” {{createdAt}},\n “eventType” {{eventType}},\n “eventData” {{eventData}},\n “resource” {{resource}}\n}”,”lastDispatch”null,”stats”{“totalDispatches”0},”actionType””HTTP_REQUEST”,”shouldInterpolateStrings”false,”description””Description”}}	{var}

Esperar por un Actor

Esperar por la finalización de un actor en Apify

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Apify necesaria para esperar por el actor	credential
Asignar resultado a variable	Variable donde se almacenará el resultado al finalizar el actor.	{“userId”:”p7wvGtDCy7C01GqZS”,”createdAt”:”2025-03-10T20:52:46.772Z”,”eventType”:”ACTOR.RUN.SUCCEEDED”,”eventData”:{“actorId”:”TJdehJYUf26tLd4t1″,”actorRunId”:”KJLN04adhTQZRWl5j”},”resource”:{“id”:”KJLN04adhTQZRWl5j”,”actId”:”TJdehJYUf26tLd4t1″,”userId”:”f1thRtDCy5C01GqZS”,”startedAt”:”2025-03-10T20:52:38.175Z”,”finishedAt”:”2025-03-10T20:52:40.666Z”,”status”:”SUCCEEDED”,”meta”:{“origin”:”DEVELOPMENT”}}}{var}

Ejecutar un Actor

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Apify necesaria para ejecutar el actor	credential
Actor	Selecciona el actor que deseas ejecutar	My Actor
Url	Url del sitio web del cual obtener los datos (si aplica)	https://rocketbot.com/es/
Timeout	Tiempo máximo en segundos para esperar que el actor finalice	12.5
Memoria	Límite de memoria para la ejecución, en megabytes.	128
Asignar resultado a variable	Variable where the result will be stored. Example {“response”{“data”{“id””QEtJv8L8vZm9cOP5u”,”actId””TJdehJYUf26tLd4t1″,”userId””g7wvGtDPe3J01GqZW”,”startedAt””2025-03-10T142901.627Z”,”finishedAt”null,”status””READY”,”meta”{“origin””API”,”userAgent””node”}}}}	Variable donde se almacenará la información de la ejecución. {var}

Obtener Dataset

Obtener los ítems de un dataset (conjunto de datos) desde Apify

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Apify necesaria para obtener el dataset	credential
ID del Dataset	ID del dataset del cual deseas obtener los ítems	ITPgs154hed79LnEA
Limpiar	Si se selecciona, los campos vacíos y ocultos serán eliminados	true
Formato	Formato en que se devolverán los datos, por defecto es JSON	JSON, CSV, HTML, XML, RSS
Límite	Número máximo de ítems a obtener	100
Asignar resultado a variable	Variable donde se almacenará la lista de ítems obtenidos. {“response”[{“level””h1″,”text””Your full-stack platform for web scraping”},{“level””h3″,”text””TikTok Data Extractor”}]}	{var}

Ejecutar una Tarea

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Apify necesaria para ejecutar la tarea	credential
Tarea	Selecciona la tarea que deseas ejecutar	My Task
Asignar resultado a variable	Variable donde se almacenará la información de la ejecución.  {“response”{“data”{“id””MZqXXu2JZ1nhkefyZ”,”actId””TJdehJYUf26tLd4t1″,”userId””r2wvEtDHy3C04GqXS”,”actorTaskId””qMlcG4JF7tgsp5H8g”,”startedAt””2025-03-10T184415.823Z”,”finishedAt”null,”status””READY”,”meta”{“origin””API”,”userAgent””node”}}}}	{var}

🧪Ejemplo de uso

1. Ejecutar un Actor: Iniciar la ejecución de un actor específico (ej. My Actor) en Apify para extraer datos de una URL (https://rocketbot.com/es/), almacenando la información inicial de la ejecución en runInfo.
2. Esperar por un Actor: Utilizar el comando Esperar por un Actor para pausar el flujo hasta que el actor iniciado en el paso anterior complete su ejecución, usando la credencial configurada. El resultado detallado de la finalización se guarda en actorCompletionData.
3. Obtener Dataset: Una vez que el actor ha finalizado (indicado por el comando anterior), usar Obtener Dataset con el ID del Dataset asociado a la ejecución del actor para recuperar los primeros 100 ítems en formato JSON, guardándolos en la variable extractedData.

🧩 Requisitos

• Tener una credencial válida de Apify configurada en Saturn Studio.
• Conocer los nombres o IDs de los Actors (Actores), Tasks (Tareas) o Datasets (Conjuntos de datos) que se desean utilizar en Apify.
• Para Ejecutar un Actor, puede ser necesario proporcionar parámetros específicos requeridos por el actor (como Url).
• Para Obtener Dataset, se necesita el ID del Dataset del cual se quieren obtener los ítems.