Referencia de herramientas

Parámetros

• querystringopcional

  Filtro sin distinción entre mayúsculas y minúsculas por nombre o sitio web del vibiz (p. ej., «acme» o «acme.com»).

• limitintegeropcional

  Tamaño de página.

• cursorstringopcional

  `next_cursor` de la página anterior.

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• actionstringobligatorio

  «list»: cuentas publicitarias vinculadas a una cuenta social. «connect_url»: enlace para conectar anuncios.

  Valores: list, connect_url

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• socialAccountIdstringopcional

  ESPERA: ID de cuenta social (Mongo ObjectId hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id`. NO es un ID de cuenta publicitaria de Meta `act_…`; ese lo devuelve ESTA herramienta en `accounts[].id`.

• publisher_platformstringopcional

  Solo Meta: dónde se ejecuta la campaña. Por defecto, facebook.

  Valores: facebook, instagram

• redirectUrlstringopcional

  URL personalizada a la que devolver al usuario tras OAuth (solo plataformas con el mismo token).

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• actionstringobligatorio

  «list»: métricas de campaña. «tree»: campaña → conjuntos de anuncios → anuncios con presupuestos (más lento).

  Valores: list, tree

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• publisher_platformstringopcional

  Solo Meta: dónde se ejecuta la campaña. Por defecto, facebook.

  Valores: facebook, instagram

• statusstringopcional

  Devuelve solo elementos con este estado.

  Valores: active, paused, pending_review, rejected, completed, cancelled, error

• includeExternalbooleanopcional

  Por defecto false: solo campañas o anuncios creados por Vibiz. Usa true SOLO cuando el usuario pregunte por todo lo que hay en la cuenta publicitaria, incluidas campañas creadas en el Administrador de anuncios.

• limitintegeropcional

  Número máximo de campañas que devolver (por defecto, 20).

• fromDatestringopcional

  Fecha de inicio, YYYY-MM-DD.

• toDatestringopcional

  Fecha de fin, YYYY-MM-DD.

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• actionstringobligatorio

  «list»: anuncios con métricas. «get»: un anuncio. «analytics»: datos diarios de un anuncio. get/analytics requieren adId.

  Valores: list, get, analytics

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• publisher_platformstringopcional

  Solo Meta: dónde se ejecuta la campaña. Por defecto, facebook.

  Valores: facebook, instagram

• statusstringopcional

  Devuelve solo elementos con este estado.

  Valores: active, paused, pending_review, rejected, completed, cancelled, error

• includeExternalbooleanopcional

  Por defecto false: solo campañas o anuncios creados por Vibiz. Usa true SOLO cuando el usuario pregunte por todo lo que hay en la cuenta publicitaria, incluidas campañas creadas en el Administrador de anuncios.

• campaignIdstringopcional

  ESPERA: ID de campaña de la plataforma Meta (numérico de 16-18 dígitos, p. ej., «23859876543210000»). NO es un ID interno de campaña. Obtenlo de vibiz_ads_campaigns (action «list», platform «meta»), campo platformCampaignId.

• fromDatestringopcional

  YYYY-MM-DD

• toDatestringopcional

  YYYY-MM-DD

• limitintegeropcional

  Número máximo de filas que devolver.

• adIdstringopcional

  ID interno de anuncio: un Mongo ObjectId hexadecimal de 24 caracteres (p. ej., «65a3f0c1d2e4b8e9f4a1c2d3»). Se obtiene de vibiz_ads_creatives (action «list», platform «meta»), campo id. NO es el ID numérico de la plataforma Meta ni un UUID de campaign_ad de Vibiz.

• breakdownsarrayopcional

  Claves de dimensión opcionales (Meta: age | gender | country | publisher_platform | device_platform | region). El servidor las une en el parámetro de consulta «breakdowns», separadas por comas.

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• levelstringobligatorio

  «campaign» (solo Meta) o «creative» (un anuncio individual en cualquier plataforma).

  Valores: campaign, creative

• idstringobligatorio

  ID de campaña de la plataforma o ID interno de anuncio de vibiz_ads_creatives.

• publisher_platformstringopcional

  Solo Meta: dónde se ejecuta la campaña. Por defecto, facebook.

  Valores: facebook, instagram

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• actionstringobligatorio

  «create»: una campaña nueva. «boost_post»: promociona una publicación social publicada.

  Valores: create, boost_post

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

• adAccountIdstringopcional

  ID de cuenta publicitaria de Meta («act_…»). Omítelo para usar la cuenta seleccionada.

• namestringopcional

  Nombre de campaña (máximo 255).

• goalstringopcional

  Objetivo de optimización del conjunto de anuncios: elige el que coincida con lo que realmente quiere el negocio, NO «traffic» por defecto. Para generar VENTAS/COMPRAS (la mayoría de comercios electrónicos y ofertas de pago), usa «conversions».

  Valores: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion

• budgetAmountnumberopcional

  Presupuesto diario en la moneda de la cuenta publicitaria. Mínimo de $10/día.

• budgetTypestringopcional

  En el estudio solo se puede preparar «daily».

  Valores: daily, lifetime

• currencystringopcional
• headlinestringopcional
• bodystringopcional
• callToActionstringopcional

  Solo Meta.

  Valores: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE

• linkUrlstringopcional
• imageUrlstringopcional
• videoobjectopcional
• creativeIdstringopcional

  Una creatividad de Vibiz en lugar de imageUrl/video.

• campaignIdstringopcional

  Con adSetId: la campaña activa a la que pertenece el conjunto de anuncios.

• adSetIdstringopcional

  Prepara el anuncio en este conjunto existente (requiere campaignId).

• countriesarrayopcional

  OBLIGATORIO para una buena entrega: códigos de país ISO-3166 alpha-2 (p. ej., ['ES'], ['MX'], ['US'], ['GB']). NO lo dejes vacío: Meta usa Estados Unidos por defecto, lo que desperdicia presupuesto si el anuncio o negocio no se dirige a ese país.

• ageMinintegeropcional
• ageMaxintegeropcional
• interestsarrayopcional

  Segmentación por intereses opcional. Cada `{id,name}` DEBE proceder de `vibiz_meta_ads_targeting_search` (herramientas de anuncios) en esta sesión. Nunca inventes ni reutilices un ID recordado: Meta rechaza IDs obsoletos (subcódigo 1487079) y el lanzamiento falla.

• specialAdCategoriesarrayopcional
• audienceIdstringopcional

  Una audiencia personalizada de Meta a la que dirigirse.

• advantageAudienceintegeropcional
• budgetLevelstringopcional

  Valores: campaign, adset

• pixelIdstringopcional
• conversionEventstringopcional
• postIdstringopcional

  ESPERA: ID interno de publicación (Mongo ObjectId hexadecimal de 24 caracteres, p. ej., «65a3f0c1d2e4b8e9f4a1c2d3»). Obtenlo de la respuesta de `vibiz_social_publish` o de `vibiz_social_list_posts[].id`. Proporciona UNO de `postId` o `platformPostId`.

• platformPostIdstringopcional

  ESPERA: ID de publicación de la plataforma Meta (p. ej., ID de contenido de Instagram «12345_67890» o de Facebook «123_456»). Obtenlo de response.platforms[].platformPostId de `vibiz_social_publish` o consultando la publicación una vez publicada en la plataforma.

• accountIdstringopcional

  ESPERA: ID de cuenta social (Mongo ObjectId hexadecimal de 24 caracteres) del propietario de la publicación. Obtenlo de `vibiz_social_list_accounts[].id`. NO es la cuenta publicitaria de Meta `act_…`.

• budgetobjectopcional
• scheduleobjectopcional
• targetingobjectopcional
• bidAmountnumberopcional

  Solo Meta.

• trackingobjectopcional

  Solo Meta.

• endDatestringopcional

  Obligatorio para presupuestos totales.

• longHeadlinestringopcional

  Solo Display: titular largo (máximo 90 caracteres). Obligatorio para anuncios de Google Display.

• imagesobjectopcional

  Anuncios adaptables de Display: se requieren `landscape` y `square` en las campañas de Display.

• businessNamestringopcional

  Nombre visible del negocio junto al anuncio (máximo 25 caracteres). Obligatorio para Google Display.

• campaignTypestringopcional

  Elige `display` para anuncios adaptables con imágenes y `search` para anuncios de texto segmentados por palabras clave.

  Valores: display, search

• keywordsarrayopcional

  Solo campañas de búsqueda: lista de palabras clave (un término por entrada).

• additionalHeadlinesarrayopcional

  Variantes adicionales de titulares para anuncios adaptables de búsqueda. Google los alterna automáticamente.

• additionalDescriptionsarrayopcional

  Variantes adicionales de descripciones para anuncios adaptables de búsqueda. Google las alterna automáticamente.

• brandIdentityobjectopcional

  Identidad de marca de TikTok para cuentas solo publicitarias (sin cuenta de publicación conectada). Omítela para rellenarla desde la marca del espacio de trabajo (nombre y logotipo); Late guarda la identidad en la cuenta publicitaria tras el primer lanzamiento.

• boardIdstringopcional

  ESPERA: ID de tablero de Pinterest. Obligatorio: los anuncios de Pinterest deben dirigirse a un tablero específico.

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• levelstringobligatorio

  «campaign» o «creative» (un anuncio individual).

  Valores: campaign, creative

• idsarrayobligatorio

  IDs de campaña de la plataforma (nivel campaign) o IDs internos de anuncio (nivel creative).

• publisher_platformstringopcional

  Solo Meta: dónde se ejecuta la campaña. Por defecto, facebook.

  Valores: facebook, instagram

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

Parámetros

• vibizstringopcional

  El mismo valor que en el plan.

• formatstringobligatorio

  El mismo valor que en el plan.

  Valores: image, carousel, video, ugc, product_shot

• briefstringobligatorio

  El mismo valor que en el plan.

• countintegeropcional

  El mismo valor que en el plan.

• placementstringopcional

  El mismo valor que en el plan.

• offer_idstringopcional

  El mismo valor que en el plan.

• durationstringopcional

  El mismo valor que en el plan.

  Valores: 4s, 6s, 8s

• resolutionstringopcional

  El mismo valor que en el plan.

  Valores: 480p, 720p, 1080p

• extra_fieldsobjectopcional

  El mismo valor que en el plan.

Parámetros

• querystringobligatorio

  Lo que quiere el usuario, con sus propias palabras, p. ej., «responde a mis mensajes directos de Instagram».

• limitintegeropcional

  Máximo de coincidencias (por defecto, 5).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• imageUrlstringopcional

  URL pública http(s) de la imagen o vídeo que subir. El servidor la descarga y almacena. La mejor opción para la mayoría de los clientes.

• imageBase64stringopcional

  Bytes del archivo codificados en Base64 (sin prefijo data:). Requiere `contentType`. Solo archivos pequeños (≤ 3 MB); los archivos locales mayores usan el modo prefirmado (omite imageUrl e imageBase64).

• filenamestringopcional

  Nombre original del archivo, usado para deducir su extensión. Ejemplo: «hero-shot.jpg». Opcional si se proporciona `imageUrl`.

• contentTypestringopcional

  Tipo MIME. Obligatorio para `imageBase64` y el modo prefirmado; se deduce de la respuesta para `imageUrl`.

  Valores: image/jpeg, image/png, image/webp, image/gif, video/mp4, video/quicktime

Parámetros

• runIdstringobligatorio

  ID de ejecución de Trigger.dev de la respuesta de una herramienta vibiz_generate_*.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• rangestringopcional

  "7d" para la última semana (predeterminado), "30d" para el último mes, "90d" para el trimestre.

  Valores: 7d, 30d, 90d

• platformsarrayopcional

  Plataformas publicitarias que incluir (por defecto, las seis; se omiten las no conectadas).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional
• statusstringopcional

  Valores: draft, queued, processing, succeeded, failed

• mediaTypestringopcional

  Valores: image, video, any

• limitintegeropcional
• onlyFavoritesbooleanopcional
• currentVersionsOnlybooleanopcional
• displaybooleanopcional

  Usa true cuando el usuario deba ver la galería de creatividades dentro del chat.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• campaignIdstringobligatorio

  ID de campaña de la plataforma Meta de vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId.

• adSetIdstringobligatorio

  ID del conjunto de anuncios de la plataforma Meta de vibiz_ads_campaigns (action "tree", platform "meta"), campo adSets[].platformAdSetId`.

• linkUrlstringopcional

  URL de destino predeterminada cuando una creatividad omite linkUrl (normalmente el embudo o la página de destino).

• creativesarrayobligatorio
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• dailyBudgetnumberobligatorio

  Importe indicado por el fundador (unidades monetarias principales).

• budgetCurrencystringopcional

  Moneda ISO de `dailyBudget`. Predeterminado: USD.

• adAccountIdstringopcional

  Cuenta publicitaria de Meta opcional (act_…). Predeterminado: la cuenta seleccionada en el espacio de trabajo.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• entityTypestringobligatorio

  Valores: campaign, adset, ad

• idsarrayobligatorio

  ID de la plataforma Meta del nivel indicado: ID de campañas, de conjuntos de anuncios o de anuncios de Zernio (vibiz_ads_creatives (action "list", platform "meta"), campo id).

• dailyBudgetnumberobligatorio

  Nuevo presupuesto diario en unidades monetarias principales (20 = $20/día).

• campaignIdstringopcional

  Obligatorio cuando entityType es "adset": campaña propietaria de los conjuntos. ID de campaña de la plataforma Meta (16-18 dígitos) de vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId. NO es un ObjectId de Zernio ni un UUID de Vibiz.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• urlstringopcional

  URL de sitio web o Instagram, p. ej., https://acme.com o instagram.com/acme. Obligatorio salvo que vibiz reanude una marca existente.

• workspace_namestringopcional

  Nombre visible de un nuevo vibiz; por defecto, el nombre del sitio.

• vibizstringopcional

  Slug de un vibiz que reanudar en vez de crear uno.

Parámetros

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• formatstringobligatorio

  image (anuncio estático), carousel (varias diapositivas), video (vídeo publicitario), ugc (vídeo hablado de estilo creador), product_shot (foto de producto en una escena).

  Valores: image, carousel, video, ugc, product_shot

• briefstringobligatorio

  Qué crear, con las palabras del usuario: oferta, enfoque, público y frases imprescindibles.

• countintegeropcional

  Número de variaciones, 1-4.

• placementstringopcional

  Dónde se publica, p. ej., instagram_portrait, tiktok_story, facebook_feed, tiktok/reels/shorts para UGC.

• offer_idstringopcional

  Oferta que destacar, de vibiz_list_offers (conjunto de herramientas del espacio de trabajo). Opcional.

• durationstringopcional

  Duración de video / ugc. Predeterminado: 4s (video), 8s (ugc).

  Valores: 4s, 6s, 8s

• resolutionstringopcional

  Calidad de renderizado ugc (video: 720p o 1080p). Predeterminado: 720p.

  Valores: 480p, 720p, 1080p

• extra_fieldsobjectopcional

  Campos de origen específicos del formato (product_shot necesita productTitle, productImageUrl y recipeId).

Parámetros

• toolstringobligatorio

  Herramienta que respondió approval_required, p. ej., vibiz_social_publish.

• argumentsobjectobligatorio

  Argumentos exactos de esa herramienta (sin approval_token).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• statusstringopcional

  Filtra por estado.

  Valores: draft, scheduled, published, failed

• platformstringopcional

  Filtra por plataforma.

• limitnumberopcional

  Número máximo de publicaciones (1-100; predeterminado: 10).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• contentstringobligatorio

  Texto de la publicación.

• platformsarrayobligatorio

  Plataformas e ID de cuentas.

• mediaUrlsarrayopcional

  URL de imágenes o vídeos que adjuntar. Una URL terminada en .mp4 o .mov se publica como vídeo (Reel, TikTok o Short donde la plataforma lo permita); cualquier otra, como imagen. Sube primero los archivos locales con vibiz_gallery_upload y usa su publicUrl.

• scheduledForstringopcional

  Fecha y hora ISO para programar. Omítelo para publicar de inmediato.

• hashtagsarrayopcional

  Hashtags.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• personIdstringobligatorio
• genderstringopcional

  Valores: female, male

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• videoUrlstringobligatorio

  Vídeo que analizar: una URL de Vibiz o de una plataforma publicitaria.

• mimeTypestringopcional

  Solo si no es mp4 (p. ej., video/webm).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• sourceAdIdstringobligatorio

  ID campaign_ad de la imagen estática existente que se animará (obtenlo de la salida de `vibiz_generate_image`, del conjunto de herramientas creativas, o de la galería).

• sourceImageUrlstringobligatorio

  URL de la imagen de ese anuncio (debe ser una URL https válida).

• promptstringopcional

  Descripción de la animación: ¿cómo debe cobrar vida la imagen? P. ej., «acercamiento suave de cámara, la persona sonríe y asiente». Opcional; si se omite, se usa un valor predeterminado adecuado.

• aspectRatiostringopcional

  Relación de aspecto de salida. «auto» la deduce de la imagen original. Por defecto, «auto».

  Valores: 16:9, 9:16, auto

• durationstringopcional

  Duración del vídeo. Por defecto, «4s».

  Valores: 4s, 6s, 8s

• resolutionstringopcional

  Por defecto, «720p».

  Valores: 720p, 1080p

• generateAudiobooleanopcional

  Por defecto, true.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• photoUrlstringobligatorio

  Fotografía de base (https; Unsplash, Pexels o almacenamiento de Vibiz).

• headlinestringopcional

  De tres a seis palabras.

• subheadstringopcional

  Una frase breve de apoyo.

• platformstringopcional

  Valores: instagram_square, instagram_portrait, instagram_story, facebook_feed, landscape

• logoCornerstringopcional

  Valores: top-left, top-right, bottom-left, bottom-right

• noScrimbooleanopcional
• offerIdstringopcional

  Oferta a la que se refiere el anuncio, de vibiz_list_offers (herramientas del espacio de trabajo).

• icpIdstringopcional

  Audiencia a la que se dirige el anuncio, de vibiz_list_icps (herramientas del espacio de trabajo).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• creativeIdstringopcional

  ID de una creatividad. Devuelve su procedencia completa y las hipótesis asociadas.

• icpIdstringopcional

  ID de ICP de vibiz_list_icps (herramientas del espacio de trabajo). Devuelve todo lo creado para esa audiencia.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• adIdstringobligatorio

  ID de la creatividad (anuncio).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• referenceImageUrlstringopcional

  URL pública de la imagen que editar, obtenida de la galería, u omítela si usas conversationImageId para una imagen subida al chat.

• conversationImageIdstringopcional

  Si el usuario adjuntó la imagen del lienzo en el chat, pasa image-N de las etiquetas de la conversación.

• promptstringobligatorio

  Qué cambiar en la imagen. Describe la edición con precisión («pon el fondo naranja de atardecer», «elimina la marca de agua», «añade un botón COMPRAR AHORA abajo a la derecha»). Evita instrucciones de guion gráfico o fotogramas: se edita una sola imagen, no una animación.

• platformstringopcional

  Plataforma de destino de la imagen editada. DEBE ser uno de los valores indicados. Por defecto: «instagram_portrait».

  Valores: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic

• aspectRatiostringopcional

  Relación de aspecto de salida opcional. Si se omite, se deriva de `platform`. Nota: cambiar la relación respecto a la imagen original puede recortarla o ampliarla.

  Valores: 1:1, 16:9, 9:16, 4:5, 3:2

• stylestringopcional

  Clave de estilo por categoría. «hero-shot» es la predeterminada; elige la categoría cuyo estilo visual coincida con la intención del usuario.

  Valores: hero-shot, lifestyle-shot, ugc, hyperrealistic, saas-demo, founder-portrait, infographic

• imageCountintegeropcional

  Número de VARIANTES de edición que generar (1-4). Por defecto 1. Útil si el usuario quiere comparar varias interpretaciones de la misma edición.

• additionalReferenceImagesarrayopcional

  URLs opcionales de Discover o la galería procedentes de resultados anteriores de herramientas. Los archivos adicionales del chat usan conversationImageIds.

• conversationImageIdsarrayopcional

  Referencias adicionales de archivos subidos al chat (image-1, image-2, …).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• idstringobligatorio

  ID del vídeo meme de `videos[].id` en vibiz_produce_meme_videos (herramientas creativas).

• captionstringopcional

  Nuevo texto del vídeo. Omítelo para conservar el actual.

• templateIdstringopcional

  ID de plantilla de meme indicado por el usuario. Omítelo para conservar el meme actual.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• adIdstringobligatorio

  ID del anuncio del vídeo renderizado que se va a finalizar.

• subtitlesbooleanopcional

  Añade subtítulos (transcripción del audio hablado).

• subtitleStylestringopcional

  Estilo de subtítulos. Por defecto hormozi.

  Valores: statement, hormozi, beast, karaoke, classic, minimal, bounce, editorial, glass, gold, boxed

• subtitleLanguagestringopcional

  Código ISO 639-1 del idioma hablado, solo si el usuario lo indicó; si se omite, se detecta automáticamente.

• musicstringopcional

  Añade música de fondo: describe cómo debe sonar a lo largo del tiempo. Omítelo para no añadir música.

• musicDurationSecnumberopcional

  Límite superior opcional para la música; por defecto, ligeramente inferior a la duración del vídeo.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• promptstringobligatorio

  Describe todo el anuncio como UNA escena: sujeto, entorno, encuadre de marca, movimiento y texto en pantalla. NO proporciones guiones gráficos fotograma a fotograma.

• platformstringopcional

  Plataforma de destino. El servidor la convierte en una relación de aspecto de vídeo (9:16 para plataformas de historias, 16:9 para el resto). Por defecto: «facebook_feed».

  Valores: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic

• videoDurationstringopcional

  Duración del vídeo. Por defecto, «4s».

  Valores: 4s, 6s, 8s

• videoResolutionstringopcional

  Por defecto, «720p».

  Valores: 720p, 1080p

• generateAudiobooleanopcional

  Por defecto, true.

• useBrandbooleanopcional

  Aplica el kit de marca del espacio de trabajo. Por defecto true.

• allowPartialBrandbooleanopcional

  Permite un borrador anticipado. Por defecto false. Pon true solo si el usuario pide expresamente generar antes de completar la incorporación, la marca o el producto; el resultado puede no ajustarse a la marca.

• referenceImagesarrayopcional

  URLs opcionales de Discover o la galería procedentes de resultados anteriores de herramientas. Las imágenes subidas al chat deben usar conversationImageIds.

• conversationImageIdsarrayopcional

  Referencias a archivos subidos al chat (image-1, image-2, …). Nunca copies las URLs de los adjuntos en referenceImages.

• offerIdstringopcional

  ID de oferta o producto del vídeo. Obtenlo de `vibiz_list_offers[].id` (herramientas del espacio de trabajo). Al indicarlo, el guion se basa en el título, los detalles y la imagen del producto. OBLIGATORIO si el usuario dijo «un anuncio de vídeo de mi producto» o «un vídeo para esta oferta»: llama primero a `vibiz_list_offers` (herramientas del espacio de trabajo) y PREGUNTA si hay varias ofertas posibles.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• promptstringobligatorio

  De qué trata el carrusel: tema, enfoque y mensaje clave. El generador redacta el texto de cada diapositiva; tú describes la historia, no las diapositivas individuales.

• slideCountintegeropcional

  Número de diapositivas (2-10). Por defecto 3. Más diapositivas consumen más créditos (1 por diapositiva).

• platformstringopcional

  Destino de publicación. instagram_portrait=carrusel de Instagram 4:5; instagram_story=Story/Reels de Instagram 9:16; tiktok_story=TikTok 9:16; linkedin=1:1; facebook_feed=1:1. Dedúcelo del contexto o pregunta por la ubicación si no está clara.

  Valores: instagram_portrait, instagram_story, linkedin, facebook_feed, tiktok_story

• aspectRatiostringopcional

  Valor alternativo opcional. Normalmente se omite y se deriva de la plataforma. Indícalo solo si el usuario pide expresamente una relación distinta de la predeterminada.

  Valores: 1:1, 16:9, 9:16, 4:5, 3:2

• useBrandbooleanopcional

  Aplica el kit de marca del espacio de trabajo (colores, fuentes, logotipo y tono). Por defecto true.

• allowPartialBrandbooleanopcional

  Permite un borrador anticipado. Por defecto false. Pon true solo si el usuario pide expresamente generar antes de completar la incorporación, la marca o el producto; el resultado puede no ajustarse a la marca.

• offerIdstringopcional

  ID de oferta o producto del carrusel. Obtenlo de `vibiz_list_offers[].id` (herramientas del espacio de trabajo). Al indicarlo, los textos e imágenes se basan en ese producto. OBLIGATORIO si el usuario dijo «mi producto» o «un carrusel sobre [algo que vendo]»: llama primero a `vibiz_list_offers` (herramientas del espacio de trabajo) y PREGUNTA si hay varias ofertas posibles.

• slidesarrayopcional

  Diapositivas de carrusel redactadas previamente, opcionales. Si se indican, la generación usa esos titulares y textos en lugar de replantear la historia.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• promptstringobligatorio

  Describe la IMAGEN ESTÁTICA que se generará. No la estructures como un guion gráfico ni una serie de fotogramas.

• platformstringopcional

  Plataforma de destino. DEBE ser uno de los valores enumerados. Correspondencias habituales: TikTok → "tiktok_story", feed de Instagram → "instagram_portrait", historia de Instagram → "instagram_story", Facebook → "facebook_feed", LinkedIn → "linkedin". Predeterminado: "instagram_portrait".

  Valores: linkedin, instagram_portrait, instagram_story, facebook_feed, tiktok_story, landscape_3_2, landscape_4_3, landscape_5_4, cinematic

• aspectRatiostringopcional

  Opcional. Si se omite, se deduce de `platform`. 9:16 = vertical, 1:1 = cuadrado, 16:9 = horizontal.

  Valores: 1:1, 16:9, 9:16, 4:5, 3:2

• stylestringopcional

  Clave de estilo opcional por categoría. Omítela salvo que el usuario haya elegido o pedido un estilo concreto. Usa hero-shot para una imagen principal de estudio centrada en el producto, lifestyle-shot para un contexto real planificado, ugc para fotos de producto de creadores o de móvil propias de redes sociales, hyperrealistic para realismo fotográfico cinematográfico, saas-demo para interfaces de producto, founder-portrait para generar confianza e infographic para diagramas.

  Valores: hero-shot, lifestyle-shot, ugc, hyperrealistic, saas-demo, founder-portrait, infographic

• useBrandbooleanopcional

  Aplica el kit de marca del espacio de trabajo (colores, fuentes, logotipo y tono). Predeterminado: true. Usa false solo si el usuario pide expresamente un aspecto genérico.

• allowPartialBrandbooleanopcional

  Permite un borrador anticipado. Por defecto false. Pon true solo si el usuario pide expresamente generar antes de completar la incorporación, la marca o el producto; el resultado puede no ajustarse a la marca.

• imageCountintegeropcional

  Número de VARIACIONES de la MISMA imagen que se generarán (1-4). Predeterminado: 1. NO sirve para crear un guion gráfico de vídeo; usa `vibiz_generate_ugc` (conjunto de herramientas de creatividades) para contenido en movimiento.

• referenceImagesarrayopcional

  URL opcionales de Discover o de la galería procedentes de una respuesta anterior de herramienta (p. ej., originalUrl de vibiz_get_for_you). No pegues aquí URL de archivos adjuntos del chat; usa conversationImageIds.

• conversationImageIdsarrayopcional

  Referencias a imágenes subidas al chat (image-1, image-2, … de las etiquetas de la conversación). Obligatorio cuando el usuario haya adjuntado imágenes en el chat.

• offerIdstringopcional

  ID de la oferta o producto para el que se genera la imagen. Obtenlo de `vibiz_list_offers[].id` (conjunto de herramientas del espacio de trabajo). Si se indica, el generador de prompts basa la imagen en ese producto (título, precio, imagen y URL de origen). OBLIGATORIO cuando el usuario diga «mi producto» o «esta oferta»: llama primero a `vibiz_list_offers` (conjunto de herramientas del espacio de trabajo) y pasa el ID correspondiente. Si hay varias ofertas y el usuario no ha especificado cuál, PREGÚNTALE antes de llamar a esta herramienta.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• productIdstringopcional

  ID de producto opcional de vibiz_list_offers (conjunto de herramientas del espacio de trabajo).

• productTitlestringobligatorio

  Título del producto en el catálogo.

• productImageUrlstringobligatorio

  URL pública de la imagen exacta del producto del catálogo.

• productDescriptionstringopcional

  Contexto opcional sobre los materiales y la fabricación del producto.

• vendorstringopcional

  Proveedor del producto opcional.

• productTypestringopcional

  Categoría de producto opcional.

• talentPresetIdstringopcional

  Ficha de personaje opcional basada en el estilo para composiciones con una persona visible.

  Valores: sienna-vale, maya-sol, ren-hale, luca-arden, dax-mercer, milo-cruz, nia-laurent, ezra-cole, imani-roe, ravi-sloane, cleo-hart, ruby-voss, theo-maren, elara-quinn

• userNotesstringopcional

  Ajuste opcional subordinado a la composición seleccionada.

• secondaryProductImageUrlstringopcional

  Segunda vista opcional del producto para representar su construcción con precisión.

• allowPartialBrandbooleanopcional

  Permite la generación antes de que esté listo todo el contexto de incorporación.

• recipeIdstringobligatorio

  ID exacto de la composición de Product Studio.

  Valores: influencer_ugc.y2k_revival, influencer_ugc.quiet_luxury_scandi, influencer_ugc.coastal_grandmother, influencer_ugc.skater_thrasher, influencer_ugc.balletcore_soft_girl, influencer_ugc.gorpcore_techwear, influencer_ugc.dark_academia_indie_sleaze, influencer_ugc.cottagecore_picnic, influencer_ugc.metallic_y3k_futurist, influencer_ugc.old_money_prep, influencer_ugc.clean_girl, influencer_ugc.mob_wife, influencer_ugc.blokecore, influencer_ugc.festival, influencer_ugc.rave_cyber_y2k, model_on_body.studio_front_on, model_on_body.studio_three_quarter, model_on_body.studio_back_view, model_on_body.studio_editorial_dramatic, model_on_body.sunlit_outdoor_front, model_on_body.sunlit_outdoor_walking, model_on_body.full_body_editorial_pose, model_on_body.walking_motion, model_on_body.seated_reclined, model_on_body.cropped_application_detail, model_on_body.face_adjacent_closeup, model_on_body.candid_off_guard, model_on_body.fabric_motion_shot, model_on_body.layered_styling_context, model_on_body.mirror_reflection_on_body, packshot_catalog.front, packshot_catalog.three_quarter, packshot_catalog.side_profile, packshot_catalog.back, packshot_catalog.elevated_product, packshot_catalog.ghost_mannequin, product_hero_editorial.pedestal, product_hero_editorial.sculptural_shadow, product_hero_editorial.chrome_glass, product_hero_editorial.monochrome, product_hero_editorial.hard_flash, product_hero_editorial.graphic_color_field, product_hero_editorial.floating_composition, product_hero_editorial.material_led_hero, product_hero_editorial.architectural_composition, product_hero_editorial.minimal_premium_hero, lifestyle_in_use.outdoor_everyday_use, lifestyle_in_use.home_interior_everyday_use, lifestyle_in_use.workspace_desk_use, lifestyle_in_use.kitchen_mealtime_use, lifestyle_in_use.travel_on_the_go_use, lifestyle_in_use.social_gathering_use, lifestyle_in_use.fitness_active_use, lifestyle_in_use.pet_companion_use, lifestyle_in_use.automotive_commute_use, lifestyle_in_use.seasonal_weather_specific_use, flat_lay.clean_grid, flat_lay.styled_editorial, flat_lay.fabric_bed_surface, flat_lay.desk_layout, flat_lay.food_serving_layout, flat_lay.kit_collection_layout, flat_lay.asymmetric_composition, flat_lay.exploded_layout, detail_macro.material_texture, detail_macro.stitching_construction, detail_macro.hardware, detail_macro.label_graphic, detail_macro.surface_formula_texture, detail_macro.closure_fastener, detail_macro.sole_ports_functional_detail, detail_macro.edge_profile_finish, in_hand_held.close_natural_grip, in_hand_held.face_adjacent, in_hand_held.palm_scale_reference, in_hand_held.pov_reach, in_hand_held.passing_the_product, in_hand_held.casual_carry, in_hand_held.direct_flash_handheld, in_hand_held.refined_pdp_hand_crop, unboxing_delivery.bed_unboxing, unboxing_delivery.table_unboxing, unboxing_delivery.doorstep_delivery_moment, unboxing_delivery.packaging_peel_open, unboxing_delivery.hands_only_reveal, unboxing_delivery.box_contents_collection, routine_application.bathroom, routine_application.bedroom_getting_ready, routine_application.desk_workday, routine_application.gym_post_workout, routine_application.kitchen_morning_routine, routine_application.travel_pouch_hotel, routine_application.car_commute, routine_application.before_going_out, environment_placement.shelf, environment_placement.desk, environment_placement.bedside, environment_placement.kitchen_bathroom_counter, environment_placement.full_room_hero, environment_placement.workshop_workbench, environment_placement.installed_placement, environment_placement.retail_display_context, process_action.pouring, process_action.applying, process_action.spraying, process_action.opening, process_action.assembling, process_action.installing, process_action.plating, process_action.preparing_using

• aspectRatiostringopcional

  Formato de salida opcional. Se recomienda el predeterminado de la composición.

  Valores: 1:1, 3:4, 9:16, 4:3, 16:9

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• productIdstringopcional

  ID de producto opcional de vibiz_list_offers (conjunto de herramientas del espacio de trabajo).

• productTitlestringobligatorio

  Título del producto en el catálogo.

• productImageUrlstringobligatorio

  URL pública de la imagen exacta del producto del catálogo.

• productDescriptionstringopcional

  Contexto opcional sobre los materiales y la fabricación del producto.

• vendorstringopcional

  Proveedor del producto opcional.

• productTypestringopcional

  Categoría de producto opcional.

• talentPresetIdstringopcional

  Ficha de personaje opcional basada en el estilo para composiciones con una persona visible.

  Valores: sienna-vale, maya-sol, ren-hale, luca-arden, dax-mercer, milo-cruz, nia-laurent, ezra-cole, imani-roe, ravi-sloane, cleo-hart, ruby-voss, theo-maren, elara-quinn

• userNotesstringopcional

  Ajuste opcional subordinado a la composición seleccionada.

• secondaryProductImageUrlstringopcional

  Segunda vista opcional del producto para representar su construcción con precisión.

• allowPartialBrandbooleanopcional

  Permite la generación antes de que esté listo todo el contexto de incorporación.

• bundleIdstringobligatorio

  launch_essentials, social_content, pdp_catalog, influencer_collection o model_collection.

  Valores: launch_essentials, social_content, pdp_catalog, influencer_collection, model_collection

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• productNamestringobligatorio

  Nombre breve del producto, marca o servicio del vídeo (p. ej., «Vibiz», «Suscripción de café Acme»). Obligatorio.

• productDetailsstringobligatorio

  Párrafo que describa el producto, el público objetivo, los ganchos, los elementos diferenciadores y las indicaciones de tono o estilo. Obligatorio. NO envíes un guion gráfico: describe el producto y por qué importa; la tarea escribe su propio guion.

• scriptstringopcional

  Guion UGC completo opcional escrito por ti: diálogos entre comillas, momentos, cámara y sonido. Refiérete a una imagen de referencia como Image 1. Si se indica, se renderiza tal como está escrito (no se aplican styleId, videoStyle, hook ni creatorGender).

• styleIdstringopcional

  Estilo UGC con nombre (consulta `vibiz_list_ugc_styles` (conjunto de herramientas de creatividades)). Preferible a `videoStyle`.

  Valores: punchy-review, spicy-review, secret-review, asmr-unbox, slow-unbox, grwm-chaos, mirror-grwm, tryon-whisper, tryon-mic, street-demo, candid-demo

• videoStylestringopcional

  Estilo antiguo de persona hablando a cámara (se ignora si se indica `styleId`). talking_head es el aspecto predeterminado, centrado en el rostro y grabado con móvil.

  Valores: talking_head, review, unboxing, pov

• platformstringopcional

  Plataforma de destino para vídeo corto. Determina la relación de aspecto y el ritmo. Predeterminado: "tiktok".

  Valores: tiktok, reels, shorts

• durationstringopcional

  Duración del vídeo. Predeterminado: "8s".

  Valores: 4s, 6s, 8s

• resolutionstringopcional

  Calidad de renderizado. Predeterminado: "720p".

  Valores: 480p, 720p, 1080p

• creatorGenderstringopcional

  Género presentado por el creador de IA o la persona que habla a cámara. Predeterminado: "female".

  Valores: female, male

• hookstringopcional

  Gancho de apertura opcional (máx. 200 caracteres). Si se omite, la tarea genera uno a partir de productDetails.

• referenceImageUrlstringopcional

  Referencia opcional de producto, marca o estilo a partir de una URL devuelta anteriormente por una herramienta. Para archivos subidos al chat, usa conversationImageId.

• conversationImageIdstringopcional

  Si el usuario adjuntó una imagen de referencia en el chat, pasa image-N de las etiquetas de la conversación.

• conversationImageIdsarrayopcional

  Referencias adicionales de archivos subidos al chat (image-1, image-2, …).

• offerIdstringopcional

  ID de la oferta o producto para este clip UGC. Obtenlo de `vibiz_list_offers[].id` (conjunto de herramientas del espacio de trabajo). Si se indica, la oferta elegida por el agente del chat se registra en la fila del anuncio resultante para que otras herramientas puedan reutilizarla. OBLIGATORIO cuando el usuario diga «un UGC sobre mi producto» o «vídeo con portavoz para [lo que vendo]»: llama primero a `vibiz_list_offers` (conjunto de herramientas del espacio de trabajo) y PREGUNTA si hay varias ofertas posibles.

• allowPartialBrandbooleanopcional

  Permite un borrador anticipado. Por defecto false. Pon true solo si el usuario pide expresamente generar antes de completar la incorporación, la marca o el producto; el resultado puede no ajustarse a la marca.

• icpIdstringopcional

  ID opcional del perfil de cliente o ICP seleccionado. Úsalo cuando el usuario indique un público objetivo o cuando una oferta tenga un ICP claramente vinculado; orienta el gancho UGC y el enfoque del creador.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• displaybooleanopcional

  Usa true cuando el usuario deba ver la galería de inspiración de Discover dentro del chat.

• limitnumberopcional

  Número máximo de elementos que devolver (1..48; predeterminado: 24).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• displaybooleanopcional

  Usa true para mostrar la galería de vistas previas de estilos UGC dentro del chat. Omítelo para una consulta silenciosa.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• imageUrlstringobligatorio

  Creatividad generada que examinar.

• logoUrlstringopcional

  Logotipo oficial. Omítelo para usar el logotipo guardado del espacio de trabajo.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• countintegeropcional

  Número de vídeos, de 1 a 5. Predeterminado: 3.

• anglestringopcional

  Lo que pidió el usuario, con sus palabras: enfoques, tema o tono (p. ej., «bromea sobre hacer facturas a mano»). Omítelo si solo pidió vídeos meme.

• templateIdsarrayopcional

  Solo si el usuario dio ID concretos de plantillas de memes, en orden: el vídeo 1 usa el primero. Para los demás se eligen memes adecuados. Nunca adivines un ID.

Parámetros

• platformstringobligatorio

  Plataforma publicitaria: meta (Facebook + Instagram), google, tiktok, linkedin, pinterest o twitter (X).

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• levelstringobligatorio

  «campaign» o «creative» (un anuncio individual).

  Valores: campaign, creative

• idsarrayobligatorio

  IDs de campaña de la plataforma (nivel campaign) o IDs internos de anuncio (nivel creative).

• publisher_platformstringopcional

  Solo Meta: dónde se ejecuta la campaña. Por defecto, facebook.

  Valores: facebook, instagram

• vibizstringopcional

  Slug de marca de list_vibiz, p. ej., «acme». Omítelo solo si el conector está fijado a una marca.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• titlestringobligatorio
• descriptionstringopcional
• reasonstringopcional

  Una frase breve: el motivo para actuar ahora.

• impactstringopcional

  Resultado esperado breve, p. ej., '+8-12 clientes potenciales/semana'.

• approveLabelstringopcional
• sessionIdstringopcional
• planDayintegeropcional

  Plan móvil de 3 días: 1 = hoy, 2 = mañana, 3 = pasado mañana. Omítelo para una propuesta puntual.

• toolsarrayopcional

  Todas las herramientas de escritura o subagentes que usará la ejecución de la tarjeta; [] para trabajo de solo lectura. La plataforma calcula `critical` a partir de esta lista.

• ownerstringopcional

  Quién ejecuta la tarjeta: ads-operator para cambios en anuncios, cto para trabajo en sitios, researcher, video o ceo.

  Valores: ceo, ads-operator, cto, researcher, video

• planstringopcional

  Solo para el agente, nunca se muestra al fundador: el plan completo en Markdown que la ejecución sigue y con el que se evalúa (alcance, criterios de aceptación, enlaces y riesgos).

• areastringopcional

  El ámbito de la tarjeta.

  Valores: ads, site, social, leads, offers, content, research, other

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringobligatorio

  Valores: meta, google, tiktok, linkedin, pinterest, twitter

• objectivestringobligatorio

  traffic = visitas al sitio, conversions = ventas/registros, lead_generation = formularios.

  Valores: awareness, traffic, engagement, lead_generation, conversions, video_views, app_promotion

• daily_budgetnumberobligatorio

  «$30 al día» → 30. Nunca supongas un presupuesto.

• currencystringopcional

  ISO-4217; predeterminado: USD.

• creative_idstringopcional

  ID de creatividad (Meta).

• image_urlstringopcional

  URL pública de imagen cuando no hay creative_id.

• briefstringopcional

  Qué vende el anuncio; si se omiten el titular y el cuerpo, la primera frase se usa como titular y el resto como cuerpo.

• headlinestringopcional
• bodystringopcional
• link_urlstringopcional

  Página de destino.

• call_to_actionstringopcional

  P. ej., LEARN_MORE, SHOP_NOW, SIGN_UP.

• countriesarrayopcional

  P. ej., ["US","CA"]. Pregunta al usuario; no uses US por defecto.

• audience_hintstringopcional

  A quién se dirige, con las palabras del usuario. Un intervalo de edad ("25-45", "18+") se usa para segmentar por edad si la plataforma lo permite; el resto se muestra como nota, sin segmentación.

• age_minintegeropcional
• age_maxintegeropcional
• ad_account_idstringopcional

  Obligatorio fuera de Meta.

• social_account_idstringopcional

  De vibiz_social_list_accounts. Obligatorio fuera de Meta.

• campaign_namestringopcional
• extra_fieldsobjectopcional

  Solo campos de launch_create específicos de la plataforma.

• modestringopcional

  Valores: plan, execute

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• campaignIdstringobligatorio

  ID de campaña de la plataforma Meta (16-18 dígitos) de vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId. NO es un ObjectId de Zernio ni un UUID de Vibiz.

• adSetIdsarrayobligatorio

  ID del conjunto de anuncios de la plataforma Meta de vibiz_ads_campaigns (action "tree", platform "meta"), campo adSets[].platformAdSetId`.

• statusstringopcional

  Predeterminado: "active". "paused" se rechaza para los agentes.

  Valores: active, paused

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• sourcesarrayopcional

  Omítelo para crear todos los públicos de Vibiz que puedan crearse. Valores: auto_site_visitors, auto_leads_list, auto_page_engagers, auto_ig_engagers, o page_engagers:<pageId> / ig_engagers:<igUserId>.

• adAccountIdstringopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• adAccountIdstringopcional

  Cuenta publicitaria de Meta ("act_…"); por defecto, la seleccionada.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• adAccountIdstringopcional

  Cuenta publicitaria de Meta ("act_…"); por defecto, la seleccionada.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• campaignIdstringobligatorio

  ESPERA: ID de campaña de la plataforma Meta (numérico de 16-18 dígitos). Obtenlo de vibiz_ads_campaigns (action "list", platform "meta"), campo platformCampaignId.

• platformstringobligatorio

  Valores: facebook, instagram

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• sourceCampaignIdstringobligatorio

  Campaña activa que copiar (platformCampaignId).

• namestringopcional

  Nombre de la copia.

• adAccountIdstringopcional

  Coloca la copia en esta cuenta publicitaria de Meta ('act_…').

• conversionEventstringopcional

  Optimiza la copia para este evento en su lugar.

  Valores: LEAD, COMPLETE_REGISTRATION, CONTACT, SCHEDULE, SUBMIT_APPLICATION, SUBSCRIBE, START_TRIAL, PURCHASE, INITIATED_CHECKOUT, ADD_TO_CART, ADD_PAYMENT_INFO

• pixelIdstringopcional
• dailyBudgetnumberopcional

  Sustituye el presupuesto diario (presupuesto de campaña en CBO, de cada conjunto de anuncios en ABO).

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• campaignIdstringobligatorio

  ID de campaña de la plataforma Meta de vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId.

• adSetNamestringobligatorio

  Nombre del nuevo conjunto de anuncios (máx. 255 caracteres).

• dailyBudgetnumberopcional

  Obligatorio para campañas ABO (presupuesto por conjunto de anuncios). Omítelo si la campaña principal es CBO.

• goalstringopcional

  Objetivo de optimización del conjunto de anuncios: elige el que corresponda a lo que realmente quiere el negocio; NO uses 'traffic' por defecto. Para generar VENTAS/COMPRAS (la mayoría de comercios electrónicos y ofertas de pago), usa 'conversions'. Para captar CLIENTES POTENCIALES (formularios, registros y solicitudes de presupuesto), usa 'lead_generation'. Usa 'traffic' solo cuando el usuario quiera expresamente clics o visitas: optimiza para clics baratos, no compradores, por lo que suele desperdiciar presupuesto en negocios que buscan ventas. 'engagement'/'awareness'/'video_views' son solo para la parte inicial del embudo.

  Valores: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion

• budgetTypestringopcional

  Valores: daily, lifetime

• linkUrlstringopcional

  URL de destino predeterminada para creatividades sin linkUrl.

• countriesarrayopcional

  OBLIGATORIO para una buena entrega: códigos de país ISO-3166 alpha-2 (p. ej., ['ES'], ['MX'], ['US'], ['GB']). NO lo dejes vacío: Meta usa Estados Unidos por defecto, lo que desperdicia presupuesto si el anuncio o negocio no se dirige a ese mercado. Si el usuario no ha indicado dónde anunciarse, PREGUNTA antes de lanzar: recomienda países según la geografía del ICP y el mercado del negocio, y ofrece la opción mundial; no lo deduzcas en silencio. Haz coincidir el idioma de la creatividad con la ubicación del cliente: texto en español para un negocio de España → ['ES'], español para México → ['MX'], negocio estadounidense en inglés → ['US']; nunca uses ['US'] por defecto salvo que el público sea realmente estadounidense.

• ageMinintegeropcional
• ageMaxintegeropcional
• interestsarrayopcional

  Segmentación opcional por intereses. Cada `{id,name}` DEBE proceder de `vibiz_meta_ads_targeting_search` (conjunto de herramientas de anuncios) en esta sesión. No inventes ni reutilices un ID recordado: Meta rechaza los ID obsoletos (subcódigo 1487079) y el lanzamiento falla. Omite el array para lanzar con público amplio o Advantage+, sin intereses.

• creativesarrayobligatorio
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• campaignIdstringobligatorio

  Campaña propietaria del conjunto de anuncios de ORIGEN. ID de campaña de la plataforma Meta (16-18 dígitos) de vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId. NO es un ObjectId de Zernio ni un UUID de Vibiz.

• adSetIdstringobligatorio

  Conjunto de anuncios de origen (o el que contiene `adId`). ID del conjunto de anuncios de la plataforma Meta de vibiz_ads_campaigns (action "tree", platform "meta"), campo adSets[].platformAdSetId`.

• adIdstringopcional

  Copia solo este anuncio (ID de anuncio de la plataforma o de Zernio). Omítelo para copiar todo el conjunto.

• targetCampaignIdstringopcional

  Campaña de destino. Para copiar un conjunto de anuncios: dónde se coloca (por defecto, la misma campaña). Para copiar un anuncio: obligatorio junto con `targetAdSetId`.

• targetAdSetIdstringopcional

  Solo para copias de anuncios: conjunto de anuncios de destino (por defecto, el mismo conjunto).

• platformstringopcional

  Predeterminado: facebook.

  Valores: facebook, instagram

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• draftIdstringopcional

  Nuevo borrador de campaña (del resultado de una preparación o copia).

• campaignIdstringopcional

  platformCampaignId de una campaña de Meta activa (su lienzo en el estudio).

• founderMessagestringopcional

  Palabras del fundador para ESTE cambio, textuales («añade personas que interactúan con Facebook»). Necesarias si el cambio añade un público: un conjunto separado, el existente como señal inicial o mostrarles únicamente el existente es decisión SUYA. Después de preguntar, sus palabras + una nueva línea + una línea por respuesta ('<question> <chosen option>'). No parafrasees ni añadas lo que hayas deducido.

• campaignobjectopcional

  Cambios a nivel de campaña; solo cambian los campos enviados.

• adSetsarrayopcional
• adsarrayopcional

  Cambios a nivel de anuncio: texto, CTA, enlace y contenido multimedia (creativeId / imageUrl / videoUrl).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• adIdstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• adAccountIdstringopcional
• namestringobligatorio

  Nombre de campaña (máximo 255).

• goalstringobligatorio

  Objetivo de optimización del conjunto de anuncios: elige el que corresponda a lo que realmente quiere el negocio; NO uses 'traffic' por defecto. Para generar VENTAS/COMPRAS (la mayoría de comercios electrónicos y ofertas de pago), usa 'conversions'. Para captar CLIENTES POTENCIALES (formularios, registros y solicitudes de presupuesto), usa 'lead_generation'. Usa 'traffic' solo cuando el usuario quiera expresamente clics o visitas: optimiza para clics baratos, no compradores, por lo que suele desperdiciar presupuesto en negocios que buscan ventas. 'engagement'/'awareness'/'video_views' son solo para la parte inicial del embudo.

  Valores: engagement, traffic, awareness, video_views, lead_generation, conversions, app_promotion

• budgetAmountnumberobligatorio

  Presupuesto diario de todo el conjunto de anuncios. Mínimo $10/día.

• budgetTypestringopcional

  En el estudio solo se puede preparar «daily».

  Valores: daily, lifetime

• currencystringopcional
• creativesarrayobligatorio
• countriesarrayopcional

  OBLIGATORIO para una buena entrega: códigos de país ISO-3166 alpha-2 (p. ej., ['ES'], ['MX'], ['US'], ['GB']). NO lo dejes vacío: Meta usa Estados Unidos por defecto, lo que desperdicia presupuesto si el anuncio o negocio no se dirige a ese mercado. Si el usuario no ha indicado dónde anunciarse, PREGUNTA antes de lanzar: recomienda países según la geografía del ICP y el mercado del negocio, y ofrece la opción mundial; no lo deduzcas en silencio. Haz coincidir el idioma de la creatividad con la ubicación del cliente: texto en español para un negocio de España → ['ES'], español para México → ['MX'], negocio estadounidense en inglés → ['US']; nunca uses ['US'] por defecto salvo que el público sea realmente estadounidense.

• ageMinintegeropcional
• ageMaxintegeropcional
• interestsarrayopcional

  Segmentación opcional por intereses. Cada `{id,name}` DEBE proceder de `vibiz_meta_ads_targeting_search` (conjunto de herramientas de anuncios) en esta sesión. No inventes ni reutilices un ID recordado: Meta rechaza los ID obsoletos (subcódigo 1487079) y el lanzamiento falla. Omite el array para lanzar con público amplio o Advantage+, sin intereses.

• audienceIdstringopcional
• advantageAudienceintegeropcional
• budgetLevelstringopcional

  Valores: campaign, adset

• specialAdCategoriesarrayopcional
• pixelIdstringopcional
• conversionEventstringopcional
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• messagestringopcional

  Mensaje del fundador, textual.

• intentstringopcional

  Valores: prospecting, retargeting

• goalstringopcional
• conversionEventstringopcional
• countriesarrayopcional

  Códigos ISO de país, p. ej., ["US", "CA"].

• dailyBudgetnumberopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• adIdstringobligatorio

  UUID de `campaign_ad` de Vibiz.

• campaignIdstringobligatorio

  platformCampaignId de Meta.

• adSetIdstringobligatorio

  platformAdSetId de Meta.

• namestringopcional
• linkUrlstringopcional
• callToActionstringopcional

  Solo Meta.

  Valores: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE

• headlinestringopcional
• bodystringopcional
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Predeterminado: facebook.

  Valores: facebook, instagram

• limitintegeropcional

  Cuántos devolver (predeterminado: 6).

• fromDatestringopcional

  Fecha ISO (opcional).

• toDatestringopcional

  Fecha ISO (opcional).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• pixelIdstringobligatorio

  ID del píxel de Meta (dígitos).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• adAccountIdstringobligatorio

  ESPERA: ID de cuenta publicitaria de la plataforma Meta (cadena que empieza por "act_"). Obtenlo de vibiz_ads_accounts (action "list", platform "meta"), campo id.

• namestringobligatorio

  Nombre legible del píxel que aparece en el administrador de eventos de Meta. Consejo: incluye el nombre del espacio de trabajo para distinguir varios píxeles (p. ej., 'NeceSera — Píxel del sitio principal').

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobligatorio

  ESPERA: ID de etiqueta de seguimiento de Zernio (devuelto como `tag.id` por `vibiz_meta_ads_pixels_create` (conjunto de herramientas de anuncios), o `data[].id` por `vibiz_meta_ads_pixels_list` (conjunto de herramientas de anuncios)).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• adAccountIdstringopcional

  ESPERA: ID de cuenta publicitaria de la plataforma Meta (cadena que empieza por "act_"). Obtenlo de vibiz_ads_accounts (action "list", platform "meta"), campo id. OPCIONAL: omítelo para listar los píxeles de todas las cuentas publicitarias de esta cuenta social.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobligatorio

  ESPERA: ID de etiqueta de seguimiento de Zernio (devuelto como `tag.id` por `vibiz_meta_ads_pixels_create` (conjunto de herramientas de anuncios), o `data[].id` por `vibiz_meta_ads_pixels_list` (conjunto de herramientas de anuncios)).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobligatorio

  ESPERA: ID de etiqueta de seguimiento de Zernio (devuelto como `tag.id` por `vibiz_meta_ads_pixels_create` (conjunto de herramientas de anuncios), o `data[].id` por `vibiz_meta_ads_pixels_list` (conjunto de herramientas de anuncios)).

• adAccountIdstringobligatorio

  ESPERA: ID de cuenta publicitaria de la plataforma Meta (cadena que empieza por "act_"). Obtenlo de vibiz_ads_accounts (action "list", platform "meta"), campo id. Es la cuenta DESTINATARIA que recibirá acceso, NO la cuenta en la que se creó originalmente el píxel.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobligatorio

  ESPERA: ID de etiqueta de seguimiento de Zernio (devuelto como `tag.id` por `vibiz_meta_ads_pixels_create` (conjunto de herramientas de anuncios), o `data[].id` por `vibiz_meta_ads_pixels_list` (conjunto de herramientas de anuncios)).

• aggregationstringopcional

  Dimensión de agregación. Si se omite, usa el valor predeterminado del servidor de Zernio (event).

  Valores: event, host, url, device_type

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobligatorio

  ESPERA: ID de etiqueta de seguimiento de Zernio (devuelto como `tag.id` por `vibiz_meta_ads_pixels_create` (conjunto de herramientas de anuncios), o `data[].id` por `vibiz_meta_ads_pixels_list` (conjunto de herramientas de anuncios)).

• adAccountIdstringobligatorio

  ESPERA: ID de cuenta publicitaria de la plataforma Meta (cadena que empieza por "act_"). Obtenlo de vibiz_ads_accounts (action "list", platform "meta"), campo id.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id` o del ancestro de vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobligatorio

  ESPERA: ID de etiqueta de seguimiento de Zernio (devuelto como `tag.id` por `vibiz_meta_ads_pixels_create` (conjunto de herramientas de anuncios), o `data[].id` por `vibiz_meta_ads_pixels_list` (conjunto de herramientas de anuncios)).

• namestringopcional
• enableAutomaticMatchingbooleanopcional
• firstPartyCookieStatusstringopcional
• dataUseSettingstringopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• namestringobligatorio

  Nombre de campaña tal como aparece en el administrador de anuncios, p. ej., "{Business} Campaña de clientes potenciales {date} - Vibiz".

• adAccountIdstringopcional

  ID de cuenta publicitaria de Meta ('act_…'); omítelo para usar la cuenta seleccionada del espacio de trabajo.

• goalstringobligatorio

  Lo que el fundador quiere de la campaña; nunca lo supongas. Si no se ha indicado, pregunta con sus propias palabras («¿Qué quieres conseguir con esta campaña?»). lead_conversion = Clientes potenciales (recopila contactos interesados en tu oferta; optimiza para Lead por defecto, o Registro completado / Contacto / Reserva / Solicitud enviada / Suscripción / Inicio de prueba); conversions = Ventas (busca personas con probabilidad de comprar tu producto o servicio; optimiza para Compra por defecto, o Inicio de pago / Añadir al carrito / Añadir información de pago / Suscripción / Inicio de prueba / Registro completado); signup = Registros (consigue que las personas se registren o creen una cuenta en tu sitio; optimiza para Registro completado por defecto, o Suscripción / Inicio de prueba); traffic = Tráfico (envía tantas personas como sea posible a tu página); awareness = Notoriedad (llega a un público amplio y da a conocer tu marca). lead_generation = Formulario instantáneo de Meta cuyos contactos nunca llegan al sitio ni al CRM; solo cuando el fundador pide expresamente un formulario.

  Valores: lead_conversion, conversions, signup, traffic, awareness, engagement, video_views, lead_generation

• conversionEventstringopcional

  Evento del píxel para el que se optimizan los conjuntos de anuncios; predeterminado para todos los conjuntos (cada uno puede indicar el suyo con adSets[].conversionEvent). Omítelo para usar el predeterminado del objetivo. Debe corresponder al objetivo (Clientes potenciales: LEAD, COMPLETE_REGISTRATION, CONTACT, SCHEDULE, SUBMIT_APPLICATION, SUBSCRIBE, START_TRIAL; Ventas: PURCHASE, INITIATED_CHECKOUT, ADD_TO_CART, ADD_PAYMENT_INFO, SUBSCRIBE, START_TRIAL, COMPLETE_REGISTRATION; Registros: COMPLETE_REGISTRATION, SUBSCRIBE, START_TRIAL); se rechazan las incompatibilidades. Solo un evento que el píxel haya recibido puede servir para el aprendizaje: consulta ads_pixel_events.

  Valores: LEAD, COMPLETE_REGISTRATION, CONTACT, SCHEDULE, SUBMIT_APPLICATION, SUBSCRIBE, START_TRIAL, PURCHASE, INITIATED_CHECKOUT, ADD_TO_CART, ADD_PAYMENT_INFO

• pixelIdstringopcional

  ID del píxel de Meta de la lista de píxeles; la cuenta puede tener varios.

• specialAdCategoriesarrayopcional

  OBLIGATORIO para préstamos, crédito, seguros, inversión y banca (FINANCIAL_PRODUCTS_SERVICES), empleo (EMPLOYMENT) y vivienda (HOUSING). Meta impone entonces 18-65+ y todos los géneros.

• budgetLevelstringopcional

  'campaign' (predeterminado, CBO): un dailyBudget en la campaña. 'adset' (ABO): un dailyBudget en cada conjunto de anuncios.

  Valores: campaign, adset

• dailyBudgetnumberopcional

  Presupuesto diario de campaña (CBO), expresado en `currency`. Mínimo 10; por debajo, un conjunto de anuncios nunca sale de la fase de aprendizaje.

• currencystringopcional

  Código ISO de la moneda en que se EXPRESAN los presupuestos (predeterminado: USD). El borrador se guarda en la moneda de la cuenta publicitaria, convertido una sola vez al prepararlo con los tipos de cambio del lanzamiento; por tanto, dailyBudget/currency del resultado son los valores que muestra el estudio y ejecuta Meta.

• landingPageUrlstringopcional

  Destino predeterminado para anuncios sin linkUrl. Resuelve primero el sitio publicado; nunca supongas {slug}.vibiz.app.

• funnelIdstringopcional

  Un embudo de Vibiz (su ID) como destino: el lanzamiento instala el píxel y añade la atribución, igual que al elegir el sitio en el asistente.

• dsaBeneficiarystringopcional

  Meta DSA (UE): entidad jurídica beneficiaria. Obligatoria junto con dsaPayor al segmentar cualquier país de la UE/EEE o todo el mundo. Omite ambos si la cuenta tiene un anunciante predeterminado: el borrador los completa a partir de él; pregunta al fundador solo si no lo tiene. Nunca inventes uno.

• dsaPayorstringopcional

  Meta DSA (UE): entidad jurídica que paga. Normalmente, la misma que dsaBeneficiary.

• retargetKnownbooleanopcional

  «Todos los que ya nos conocen»: al lanzar, añade todos los públicos de Vibiz LISTOS (visitantes del sitio, clientes potenciales y personas que interactúan con la página e Instagram) a cada conjunto sin includeAudienceIds.

• adSetsarrayobligatorio

  Conjuntos de anuncios de la campaña: por defecto, un conjunto de público amplio; añade uno de retargeting (includeAudienceIds) o de intereses cuando los públicos difieran.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• draftIdstringopcional

  Nuevo borrador de campaña (del resultado de una preparación o copia).

• campaignIdstringopcional

  platformCampaignId de una campaña de Meta activa (su lienzo en el estudio).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• founderMessagestringopcional

  Palabras del fundador para ESTE cambio, textuales («añade personas que interactúan con Facebook»). Necesarias si el cambio añade un público: un conjunto separado, el existente como señal inicial o mostrarles únicamente el existente es decisión SUYA. Después de preguntar, sus palabras + una nueva línea + una línea por respuesta ('<question> <chosen option>'). No parafrasees ni añadas lo que hayas deducido.

• campaignIdstringobligatorio

  Campaña activa (platformCampaignId) en la que se preparan los cambios.

• addAdsarrayopcional

  Anuncios que añadir a conjuntos existentes.

• addAdSetsarrayopcional

  Nuevos conjuntos, cada uno con su propio público y anuncios.

• copyAdSetIdsarrayopcional

  Conjuntos de anuncios activos que copiar con sus anuncios.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• socialAccountIdstringobligatorio

  ESPERA: ID de cuenta social de Zernio (ObjectId de Mongo hexadecimal de 24 caracteres). Obtenlo de `vibiz_social_list_accounts[].id`. NO es un ID `act_…` de Meta.

• qstringobligatorio

  Texto de búsqueda, p. ej., «colegio privado» o «São Paulo». Al menos 2 caracteres.

• dimensionstringopcional

  Predeterminado: 'interest'. Usa 'geo' para buscar claves de región/ciudad (junto con geoType + countryCode).

  Valores: interest, geo, behavior, income

• geoTypestringopcional

  Solo cuando dimension=geo. El valor predeterminado 'all' busca todos los tipos geográficos a la vez.

  Valores: country, region, city, zip, metro, all

• countryCodestringopcional

  ISO-3166 alpha-2 que limita la búsqueda geográfica, p. ej., "BR". Se ignora al buscar intereses.

• limitintegeropcional

  Número máximo de filas que devolver (predeterminado: 15).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• adIdstringobligatorio
• headlinestringopcional
• bodystringopcional

  Texto principal.

• callToActionstringopcional

  Valores: LEARN_MORE, SHOP_NOW, SIGN_UP, BOOK_TRAVEL, CONTACT_US, DOWNLOAD, GET_OFFER, GET_QUOTE, SUBSCRIBE, WATCH_MORE

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• proposalIdstringobligatorio

  ID de tarjeta de vibiz_list_proposals (conjunto de herramientas de autonomía).

• statusstringopcional

  Valores: pending, approved, rejected, discussing, executed, dismissed

• rejectReasonstringopcional

  Por qué la rechazó el fundador; obligatorio con `rejected`.

• titlestringopcional
• descriptionstringopcional
• reasonstringopcional
• impactstringopcional
• approveLabelstringopcional
• planDayintegeropcional

  Plan móvil de 3 días: 1 = hoy, 2 = mañana, 3 = pasado mañana. Omítelo para una propuesta puntual.

• toolsarrayopcional

  Todas las herramientas de escritura o subagentes que usará la ejecución de la tarjeta; [] para trabajo de solo lectura. La plataforma calcula `critical` a partir de esta lista.

• ownerstringopcional

  Quién ejecuta la tarjeta: ads-operator para cambios en anuncios, cto para trabajo en sitios, researcher, video o ceo.

  Valores: ceo, ads-operator, cto, researcher, video

• planstringopcional

  Solo para el agente, nunca se muestra al fundador: el plan completo en Markdown que la ejecución sigue y con el que se evalúa (alcance, criterios de aceptación, enlaces y riesgos).

• areastringopcional

  El ámbito de la tarjeta.

  Valores: ads, site, social, leads, offers, content, research, other

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Plataforma que analizar. Omítela para todas las plataformas.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Filtra una plataforma. Omítelo para obtener el agregado de todas.

• fromDatestringopcional

  Fecha de inicio (YYYY-MM-DD). Por defecto: hace 30 días.

• toDatestringopcional

  Fecha de fin (YYYY-MM-DD). Por defecto: hoy.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Filtra por plataforma (facebook, instagram, linkedin, tiktok, etc.). Omítelo para todas.

• sortBystringopcional

  Métrica por la que ordenar. Por defecto: engagement.

  Valores: engagement, impressions, reach, likes, comments, shares, date

• fromDatestringopcional

  Fecha de inicio (YYYY-MM-DD). Por defecto: hace 90 días.

• toDatestringopcional

  Fecha de fin (YYYY-MM-DD). Por defecto: hoy.

• limitnumberopcional

  Máximo de publicaciones que devolver (1-100, por defecto 10).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• draftsarrayobligatorio

  Una entrada por cada publicación que preparar.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Plataforma opcional que el usuario quiere conectar (p. ej., "x", "instagram"). Se muestra como etiqueta; la página de conexiones gestiona todas las plataformas.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• recipientNamestringopcional
• recipientCompanystringopcional
• recipientRolestringopcional
• recipientIndustrystringopcional
• signalsstringopcional

  Señales de compra o contexto para personalizar el mensaje.

• senderProductstringopcional

  Lo que ofrece este espacio de trabajo; se usa para enfocar la propuesta.

• channelstringopcional

  Por defecto, email.

  Valores: email, linkedin

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• cursorstringopcional

  `nextCursor` de la página anterior.

• unreadOnlybooleanopcional
• searchstringopcional
• mailboxIdstringopcional

  Solo este buzón (de vibiz_email_status, herramientas de comunicación).

• limitintegeropcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• threadIdstringobligatorio

  De vibiz_email_list_threads (herramientas de comunicación).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• threadIdstringobligatorio

  De vibiz_email_list_threads (herramientas de comunicación).

• bodystringobligatorio

  Respuesta en texto sin formato.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• tostringobligatorio
• subjectstringobligatorio
• bodystringobligatorio

  Correo en texto sin formato.

• mailboxIdstringopcional

  Buzón desde el que se envía (de vibiz_email_status, herramientas de comunicación); omítelo para usar el primero que pueda enviar.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• mailboxIdstringobligatorio

  De vibiz_email_status (herramientas de comunicación).

• senderNamestringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Filtra por plataforma.

• sortBystringopcional

  Ordena por fecha o número de comentarios.

  Valores: date, comments

• limitnumberopcional

  Número máximo de publicaciones que devolver (1-50; predeterminado: 10).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• platformstringopcional

  Filtra por plataforma (instagram, facebook, twitter, etc.).

• limitnumberopcional

  Número máximo de conversaciones que devolver (1-50; predeterminado: 10).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• accountIdstringobligatorio

  Cuenta de Instagram/Facebook en la que ejecutar la automatización. Debe pertenecer al vibiz de destino.

• namestringobligatorio

  Una etiqueta para la automatización.

• dmMessagestringobligatorio

  El mensaje directo enviado automáticamente a cada persona que comenta.

• commentReplystringopcional

  Respuesta pública opcional al propio comentario.

• keywordsarrayopcional

  Palabras clave de activación. OMITIDO o vacío = se activa con CUALQUIER comentario (responde a todos).

• matchModestringopcional

  Cómo se comparan las palabras clave. Predeterminado: "contains".

  Valores: exact, contains

• platformPostIdstringopcional

  Limita a una publicación (ID del contenido en la plataforma, de `vibiz_inbox_comments` (conjunto de herramientas de comunicación)). Omítelo para toda la cuenta.

• triggerstringopcional

  Predeterminado: "comment". "story_reply" se activa con respuestas a historias de IG.

  Valores: comment, story_reply

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• automationIdstringobligatorio

  Automatización que eliminar. De `vibiz_inbox_list_comment_automations` (conjunto de herramientas de comunicación).

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• postIdstringobligatorio

  Publicación cuyos comentarios se leerán. De `vibiz_inbox_comments` (conjunto de herramientas de comunicación).

• accountIdstringobligatorio

  Cuenta propietaria de la publicación (de `vibiz_inbox_comments` (conjunto de herramientas de comunicación)). Debe pertenecer al vibiz de destino.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• conversationIdstringobligatorio

  Conversación que leer. De `vibiz_inbox_conversations` (conjunto de herramientas de comunicación).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• postIdstringobligatorio

  Publicación que contiene el comentario.

• commentIdstringobligatorio

  Comentario al que responder.

• accountIdstringobligatorio

  Cuenta social desde la que responder. Debe pertenecer al vibiz de destino.

• messagestringobligatorio

  Texto del mensaje de respuesta.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• postIdstringobligatorio

  Publicación cuyos comentarios se responderán. De `vibiz_inbox_comments` (conjunto de herramientas de comunicación).

• accountIdstringobligatorio

  Cuenta desde la que responder. Debe pertenecer al vibiz de destino.

• repliesarrayobligatorio

  Una entrada por comentario (máx. 50). Cada mensaje debe ser único y adaptado al contexto.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• postIdstringobligatorio

  Publicación que contiene el comentario. De `vibiz_inbox_comments` (conjunto de herramientas de comunicación).

• commentIdstringobligatorio

  Comentario a cuyo autor se enviará el mensaje directo. De `vibiz_inbox_get_comments` (conjunto de herramientas de comunicación).

• accountIdstringobligatorio

  Cuenta desde la que enviar. Debe pertenecer al vibiz de destino.

• messagestringobligatorio

  Texto del mensaje directo privado.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• conversationIdstringobligatorio

  Conversación en la que enviar.

• accountIdstringobligatorio

  Cuenta social desde la que enviar. Debe pertenecer al vibiz de destino.

• messagestringobligatorio

  Texto del mensaje.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• automationIdstringobligatorio

  Automatización que activar o desactivar. De `vibiz_inbox_list_comment_automations` (conjunto de herramientas de comunicación).

• activebooleanobligatorio

  true = iniciar/reanudar, false = detener/pausar.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• channelIdstringopcional

  ID de canal de Slack, p. ej., C0ATX….

• limitintegeropcional

  Número máximo de mensajes por canal.

• daysintegeropcional

  Periodo retrospectivo en días.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• querystringopcional

  Filtro por nombre de canal sin distinguir mayúsculas y minúsculas.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• channelIdstringobligatorio

  ID del canal de Slack.

• textstringobligatorio
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• memberIdstringobligatorio

  De `teammates` en vibiz_slack_list_channels (conjunto de herramientas de comunicación).

• textstringobligatorio
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• channelIdstringobligatorio

  ID del canal de Slack.

• tsstringobligatorio

  El ts del mensaje inicial del hilo, p. ej., 1760000000.123456.

• limitintegeropcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• offerIdstringobligatorio
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• imageUrlsarrayopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• refreshbooleanopcional
• pageUrlsarrayopcional

  Páginas específicas que leer. Implica actualizar los datos.

• confirmobjectopcional
• dismissobjectopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• titlestringobligatorio
• markdownstringobligatorio

  El contenido en Markdown (títulos, listas, tablas).

• documentIdstringopcional

  Edita este documento existente en lugar de crear otro.

Parámetros

• brandobjectobligatorio

  Datos de marca estructurados a partir del repositorio local. Obligatorio: `companyName`. Los demás campos rellenan WorkspaceBranding.

• workspaceNamestringopcional

  Nombre explícito opcional del espacio de trabajo. Si se omite, se deriva de `brand.companyName`.

Parámetros

• websiteUrlstringobligatorio

  URL de un sitio web (https://example.com) o perfil de Instagram (instagram.com/handle). La URL se valida accediendo al sitio o extrayendo el perfil de Instagram; las URLs inaccesibles fallan.

• workspaceNamestringopcional

  Nombre explícito opcional. Si se omite, se deriva de la URL o del contenido extraído.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• namestringobligatorio
• titlestringopcional
• descriptionstringopcional
• demographicsobjectopcional
• painPointsarrayopcional
• goalsarrayopcional
• channelsarrayopcional
• landingSlugstringopcional

  Base de slug opcional para la página de destino del ICP.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• titlestringobligatorio
• descriptionstringopcional
• priceCentsintegeropcional

  Importe de Stripe en la unidad menor de la moneda (2900 = $29 USD, 500 = ¥500 JPY). Pon 0 u omítelo para ofertas sin pago.

• priceCurrencystringopcional
• iconEmojistringopcional
• imageUrlstringopcional

  URL pública de imagen para la miniatura de la oferta.

• sourcestringopcional

  Etiqueta de origen. Por defecto, 'agent_chat'. Usa 'manual' cuando el usuario añade un producto directamente a su catálogo.

• scrapeUrlstringopcional

  URL de la página de producto original si la fila se extrajo de ella. Se guarda en sourceData para trazabilidad.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• offerIdstringobligatorio
• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• namestringobligatorio

  Nombre breve del perfil (p. ej., «Fundador de SaaS», «Padre ocupado», «Gamer de la generación Z»). Obligatorio.

• titlestringopcional

  Cargo o función opcional que aparece debajo del nombre (p. ej., «Responsable de marketing en un SaaS B2B de 50 empleados»).

• descriptionstringopcional

  Resumen opcional de un párrafo sobre quién es, qué le motiva y cómo encaja la marca en su vida.

• demographicsobjectopcional

  Bloque demográfico opcional. Todos los campos son cadenas de texto libre.

• painPointsarrayopcional

  Lista opcional de problemas o frustraciones.

• goalsarrayopcional

  Lista opcional de objetivos o resultados deseados.

• channelsarrayopcional

  Lista opcional de canales donde este perfil pasa tiempo (p. ej., «TikTok», «LinkedIn», «Reddit r/SaaS»).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• titlestringobligatorio

  Nombre de oferta breve y llamativo (máx. ~100 caracteres). P. ej., «50% de descuento en todo», «Prueba gratuita de 14 días», «Paquete inicial de $99».

• descriptionstringopcional

  Detalles opcionales de la oferta: condiciones, qué incluye y propuesta de valor. Máx. ~500 caracteres.

• priceCentsintegeropcional

  Importe de Stripe en la unidad monetaria menor (9900 = $99.00 USD, 500 = ¥500 JPY). Omítelo para ofertas gratuitas o recursos de captación.

• priceCurrencystringopcional

  Código de moneda ISO. Predeterminado: "USD".

• typestringopcional

  Tipo de modelo de negocio. Usa "generic" si no estás seguro.

  Valores: software, service, ecommerce, agency, generic

• iconEmojistringopcional

  Un emoji que represente visualmente la oferta. P. ej., "🎁", "💰", "🚀".

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• icpIdstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• querystringopcional

  Qué buscar en los documentos subidos, p. ej., «política de reembolso» o «precios para empresas». Omítelo para obtener solo el resumen y la lista de documentos.

• limitnumberopcional

  Número máximo de pasajes que devolver (1..25; predeterminado: 8).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• offerIdstringobligatorio
• icpIdstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• categorystringopcional

  Valores: product, lifestyle, team, screenshot, abstract

• limitintegeropcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• limitintegeropcional

  Número máximo de páginas que devolver (predeterminado: 20).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• offerIdstringopcional

  Solo esta oferta (opcional).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• displaybooleanopcional

  Usa true cuando el usuario deba ver la galería de productos dentro del chat.

• purposestringopcional

  Cuando display=true, catalog = explorar productos; product_picker = elegir uno antes de generar.

  Valores: catalog, product_picker

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• keystringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• keystringobligatorio
• valuestringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• hasProductGroundingbooleanopcional

  Usa true solo si la próxima generación ya tiene una oferta, producto o imagen de referencia concretos. Así, el estado de preparación del catálogo de comercio electrónico pasa a ser informativo en vez de bloquear.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• namestringobligatorio
• bodyMdstringobligatorio
• kindstringopcional

  Valores: workflow, goal, lesson

• triggerstringopcional

  Solo flujos de trabajo: cuándo se aplica, en prosa.

• statusstringopcional

  Valores: proposed, active, archived

Parámetros

• tzstringopcional

  Zona horaria IANA (p. ej., "Asia/Kolkata", "Europe/Rome", "America/New_York"). Predeterminado: UTC.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• offerIdstringobligatorio
• icpIdstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• companyNamestringopcional
• headlinestringopcional
• websiteUrlstringopcional
• logoUrlstringopcional
• logoConversationImageIdstringopcional

  Si el usuario subió un logotipo al chat, pasa el ID de conversación mostrado como image-N. Nunca copies URL de adjuntos en logoUrl.

• colorsobjectopcional
• fontsobjectopcional
• tonestringopcional
• energystringopcional
• targetAudiencestringopcional
• languagestringopcional
• formalitystringopcional

  Valores: formal, informal, neutral

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• icpIdstringobligatorio
• namestringopcional
• titlestringnullopcional
• descriptionstringnullopcional
• demographicsobjectnullopcional
• painPointsarraynullopcional
• goalsarraynullopcional
• channelsarraynullopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• sectionstringopcional

  Encabezado de la sección que sustituir. Omítelo para sustituir todo el resumen.

• contentstringobligatorio

  Resumen completo revisado, o nuevo cuerpo de `section` si se indica una.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• offerIdstringobligatorio
• titlestringopcional
• descriptionstringopcional
• priceCentsintegeropcional

  Importe de Stripe en la unidad monetaria menor (2900 = $29 USD, 500 = ¥500 JPY).

• priceCurrencystringopcional
• iconEmojistringopcional
• statusstringopcional

  Valores: draft, published, active

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• docstringobligatorio

  Valores: company, member

• memberIdstringopcional

  Obligatorio si doc es 'member'.

• contentstringobligatorio

  Markdown completo revisado del documento elegido.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• competitorsarrayopcional

  Nombres de marcas o dominios indicados por el usuario. Omítelos para usar los competidores guardados (gratis).

• maxCompetitorsintegeropcional

  Número de competidores. Por defecto 5; más solo si lo pide el usuario.

• adsPerCompetitorintegeropcional
• countrystringopcional

  País ISO para una búsqueda con nombre. Por defecto: el mercado del espacio de trabajo.

• includeImagesbooleanopcional

  Adjunta las imágenes de los anuncios como contenido visual para poder verlas. Por defecto true.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• refreshbooleanopcional

  Fuerza una búsqueda nueva en lugar de devolver la lista guardada. Consume créditos. Por defecto false.

• countriesarrayopcional

  Códigos ISO de país para consultar la biblioteca de anuncios, p. ej., ["US","GB"]. Solo se usan en una búsqueda nueva. Por defecto ["US"].

• hintstringopcional

  Indicación de posicionamiento opcional para orientar la búsqueda, p. ej., «centrarse en herramientas de creatividades publicitarias con IA». Solo se usa en una búsqueda nueva.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• qstringopcional

  Texto libre que se busca en la descripción, las palabras habladas, el texto en pantalla, el arquetipo, la presentación y las etiquetas; p. ej., «planteamiento del problema» o «cuidado de la piel».

• aspectstringopcional

  Valores: 9:16, 1:1, 16:9

• limitintegeropcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• querystringopcional
• emotionstringopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• qstringopcional
• limitintegeropcional

Parámetros

• symbolstringobligatorio

  Símbolo bursátil o de criptomoneda (BTC, ETH, AAPL, TSLA, ...)

• kindstringopcional

  Tipo de activo. Predeterminado: "auto" (prueba primero criptomonedas y luego acciones).

  Valores: auto, crypto, stock

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• urlstringobligatorio

  URL pública de la publicación de TikTok, Instagram, Facebook o X que leer (p. ej., https://www.tiktok.com/@user/video/123). Facebook acepta enlaces a publicaciones, fotos, reels/vídeos y contenidos compartidos (facebook.com/share/…, fb.watch/…), no a páginas.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• querystringobligatorio

  Nicho o palabra clave que buscar en la biblioteca de anuncios de Meta. Ejemplos: «cereales», «seguro para mascotas», «barritas de proteínas», «incorporación SaaS». Obligatorio para discover; para scrape, obligatorio SALVO que se indique `pageId`.

• countrystringopcional

  Código ISO de país, p. ej., 'US', 'GB', 'DE', 'IT'.

• modestringopcional

  'discover' devuelve anunciantes únicos (económico, ~$4). 'scrape' devuelve registros completos de anuncios (más caro, ~$7+ según el límite).

  Valores: discover, scrape

• sampleSizeintegeropcional

  Anuncios que muestrear en modo discover. Más anuncios = más anunciantes únicos encontrados, pero el coste aumenta linealmente. Se ignora en modo scrape.

• pageIdstringopcional

  ID de página de Facebook de una respuesta anterior de `discover`. Solo modo scrape: si se indica, filtra los anuncios de ese anunciante (mejor rendimiento por dólar que buscar por palabra clave).

• limitintegeropcional

  Número máximo de anuncios que devolver en modo scrape. Coste lineal: limit * ~$0.14. Se ignora en modo discover.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• querystringobligatorio
• limitintegeropcional
• orientationstringopcional

  Valores: landscape, portrait, squarish

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• queriesarrayobligatorio
• limitintegeropcional
• tonestringopcional

  Valores: light, dark

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• nichestringobligatorio

  Tema, nicho o palabra clave cuyas tendencias investigar (p. ej., «cuidado de la piel para hombres», «herramientas de productividad con IA»).

• platformsarrayopcional

  Plataformas que analizar. Predeterminado: TikTok e Instagram.

• modestringopcional

  discover = muestra económica; deep = extracción más amplia y costosa.

  Valores: discover, deep

• confirmbooleanopcional

  Obligatorio para una extracción `deep`: acepta el coste de recopilación. Sin ello, una solicitud deep devuelve una estimación previa en vez de gastar. Se ignora para `discover`.

• daysintegeropcional

  Periodo de actualidad en días. Predeterminado: 14 (~2 semanas, recomendado). Amplíalo (p. ej., 30) para nichos más lentos o redúcelo (p. ej., 3) para ver lo que está de moda ahora.

Parámetros

• urlstringobligatorio

  URL que obtener (con o sin https://)

• includeScreenshotbooleanopcional

  Si se debe capturar una imagen del área visible. Predeterminado: true.

Parámetros

• querystringobligatorio

  Consulta de búsqueda

• sourcesarrayopcional

  Fuentes en las que buscar. Predeterminado: ["web", "news"]. Usa solo ["web"] para consultas no relacionadas con noticias y mantener la respuesta concisa.

• limitnumberopcional

  Número máximo de resultados que devolver (1-10). Predeterminado: 5.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• contact_job_titlearrayopcional

  Cargos objetivo, p. ej., ["CEO", "CMO"].

• contact_not_job_titlearrayopcional

  Cargos que excluir.

• seniority_levelarrayopcional

  Niveles de responsabilidad, p. ej., ["c_suite", "vp", "director"].

• contact_locationarrayopcional

  Países o regiones objetivo, p. ej., ["United States"].

• company_industryarrayopcional

  Sectores (taxonomía de LinkedIn). Para SaaS, pasa ["computer software", "internet", "information technology & services"]; el valor literal «saas» está documentado, pero el actor lo rechaza.

• company_keywordsarrayopcional

  Palabras clave que describen la empresa.

• company_domainarrayopcional

  Dominios de empresas específicos a los que dirigirse.

• sizearrayopcional

  Rangos de número de empleados, p. ej., ["11-50", "51-200"].

• min_revenuestringopcional
• max_revenuestringopcional
• fundingarrayopcional
• email_statusarrayopcional

  El valor predeterminado es ["validated"].

• fetch_countnumberopcional

  Número de clientes potenciales que obtener (10..10000). Las ejecuciones pequeñas soportan un coste fijo desproporcionado; es preferible >=50.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• emailstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• leadIdstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• limitintegeropcional

  Personas leídas antes de agrupar (predeterminado: 500).

• topNintegeropcional

  Filas por desglose (predeterminado: 12).

• sampleintegeropcional

  Personas individuales devueltas (predeterminado: 25; 0 para solo recuentos).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• limitnumberopcional

  Número máximo de clientes potenciales que mostrar (1..50; predeterminado: 24).

• displaybooleanopcional

  Usa true cuando el usuario deba ver el tablero de clientes potenciales dentro del chat.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• scopestringopcional

  upcoming = las más próximas primero (predeterminado); past = las más recientes primero.

  Valores: upcoming, past

• limitintegeropcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• meetingIdstringobligatorio

  ID de reunión de vibiz_list_meetings (conjunto de herramientas de CRM).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• daysintegeropcional

  Intervalo en días (predeterminado: 30).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• leadIdstringobligatorio
• statusstringobligatorio

  Valores: new, qualified, contacted, replied, disqualified

• reasonstringobligatorio

  Motivo de este estado: pruebas concretas, mostradas en la cronología del CRM.

• notesstringopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• promptstringobligatorio

  Describe la página de destino: qué vende, el mensaje principal, la llamada a la acción, la audiencia y el tono. El generador redacta sus textos; tú solo describes el objetivo. Se guardan como máximo 500 caracteres.

• qualificationbooleanopcional

  Opcional. Pon true para crear un embudo de cualificación de clientes potenciales (cuestionario de varios pasos y pago o restricción de acceso) en lugar de una sola página de destino. Por defecto: false.

• creativeIdstringopcional

  ID campaign_ad opcional para usar como imagen principal o referencia de la página.

• creativeImageUrlstringopcional

  URL de imagen opcional para usar como imagen principal (alternativa a creativeId).

• allowPartialBrandbooleanopcional

  Permite un borrador anticipado. Por defecto false. Pon true solo si el usuario pide expresamente generar antes de completar la incorporación, la marca o el producto; el resultado puede no ajustarse a la marca.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• funnelIdstringobligatorio

  ID del embudo existente que se reescribirá. Obtenlo del espacio de trabajo del usuario (embudo reciente) o pídele que cree uno primero con `vibiz_generate_funnel` (conjunto de herramientas de sitios).

• promptstringobligatorio

  Describe el flujo de cualificación o acceso: qué campos recopilar, qué protege el muro de pago, qué preguntas hacer y adónde lleva la llamada a la acción. El generador escribe su propio HTML; describe el objetivo.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• intentstringobligatorio

  Para qué sirve la página, p. ej., «Página de destino del programa de coaching de 12 semanas».

• labelstringopcional

  Dos o tres palabras que den nombre a la página.

• headlinestringopcional
• subheadlinestringopcional
• ctaLabelstringopcional

  Texto exacto del botón, p. ej., «Reserva una llamada».

• navLinksarrayobligatorio

  Entre dos y cuatro palabras de navegación, cada una correspondiente a una sección de ESTA página.

• herostringobligatorio

  La primera pantalla alrededor del titular: dónde va el texto y qué ocupa el resto.

• sectionsarrayobligatorio

  Todas las secciones después de la cabecera principal, de arriba abajo, terminando con la franja de llamada a la acción final. El pie de página se añade automáticamente.

• icpIdstringopcional
• offerIdstringopcional
• requestKeystringopcional

  Clave de idempotencia opcional: una llamada repetida con la misma clave reutiliza la imagen renderizada en vez de crear otra.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• sitestringopcional

  Valores: source, workspace

• devicesarrayopcional

  Tamaños de pantalla que devolver (por defecto, ordenador y móvil).

• pageUrlstringopcional

  Una página concreta del sitio (p. ej., la página «Acerca de»). Predeterminado: el sitio elegido.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• includeInFlightbooleanopcional
• includeFailedbooleanopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• funnelIdstringobligatorio

  ID del embudo de vibiz_list_landing_pages (conjunto de herramientas de sitios).

• pathstringopcional

  Ruta pública en el dominio de la organización. `/` = página de inicio.

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• funnelIdstringobligatorio

  Embudo que revisar, de vibiz_list_landing_pages (conjunto de herramientas de sitios).

• intentstringopcional

  Qué debía hacer la página, para que el evaluador la valore según el objetivo. Si falta, usa el prompt del propio embudo.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• daysintegeropcional

  Intervalo en días (predeterminado: 7), comparado con el intervalo anterior de igual duración.

• pageLimitintegeropcional

  Número de rutas que listar con vistas y visitantes (predeterminado: 8). Auméntalo para encontrar una página concreta.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• namestringobligatorio

  Etiqueta breve, p. ej., 'Revisión de la mañana'.

• briefTemplatestringobligatorio

  Lo que hace el agente en cada activación: solo instrucciones imperativas, sin indicar el horario.

• assignedTostringopcional

  ID del agente del organigrama que lo ejecuta, p. ej., 'cto'. Por defecto, 'ceo'.

• presetstringopcional

  Frecuencia predefinida. Por defecto, diaria.

  Valores: hourly, daily, weekly, every_6h

• intervalSecondsintegeropcional

  Intervalo personalizado en segundos. Usa el preajuste O este valor.

• firstRunLocalTimestringopcional

  Hora local de la primera ejecución en formato 24h, p. ej., '10:00'.

• timezonestringopcional

  Zona IANA alternativa; por defecto, la del espacio de trabajo. Establécela solo si el fundador indica una.

• enabledbooleanopcional

  El valor predeterminado es true.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• routineIdstringobligatorio

  ID de rutina de vibiz_list_routines (herramientas de autonomía).

• approval_tokenstringopcional

  Solo de vibiz_review_action, después de que la llamada haya devuelto approval_required. Nunca lo inventes, reutilices ni edites.

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• taskIdstringobligatorio

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• statusarrayopcional

  Solo tarjetas con estos estados (opcional).

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• assignedTostringopcional

  Solo tareas de este agente, p. ej., 'cto'.

• statusarrayopcional

  Solo tareas con estos estados.

• parentTaskIdstringnullopcional

  ID de una tarea para obtener sus subtareas, o null para obtener solo tareas de nivel superior.

• planDayintegeropcional

  Solo tareas etiquetadas con este día del plan.

• limitintegeropcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• subjectstringobligatorio

  Qué se prueba, p. ej., «asuntos de correos de bienvenida».

• axisstringobligatorio

  Valores: creative, icp, email, offer

• variantsarrayobligatorio
• panelSizeintegeropcional

  Perfiles que entrevistar. Omítelo para ajustar la cantidad al presupuesto simulado.

• icpIdsarrayopcional

  Limita el panel a estos ICP (de vibiz_list_icps (conjunto de herramientas del espacio de trabajo)).

• budgetnumberopcional

  Presupuesto publicitario DIARIO simulado en dólares enteros.

• daysintegeropcional

  Días de duración de la campaña simulada (predeterminado: 7).

• platformstringopcional

  Origen del tráfico; modifica el comportamiento de los perfiles y el CPM.

  Valores: tiktok, meta, linkedin, email, other

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• rationalestringobligatorio

  Por qué haces este cambio.

• statusUpdatesarrayopcional
• objectiveEditsarrayopcional

Parámetros

• targetobjectopcional

  Marca sobre la que actuar: {"vibiz":"<slug from list_vibiz>"}. Omítela cuando el conector esté fijado a una marca. Nunca uses otra marca como alternativa; una marca no incluida requiere vibiz_onboard_brand.

• organizationIdstringopcional

  ID de organización de Clerk (opcional si la autenticación ya está limitada a la organización)

• routineIdstringobligatorio

  ID de rutina de vibiz_list_routines (herramientas de autonomía).

• enabledbooleanopcional

  false pausa la rutina; true la reanuda.

• namestringopcional
• briefTemplatestringopcional

  Lo que hace el agente en cada activación: solo instrucciones imperativas, sin indicar el horario.

• presetstringopcional

  Valores: hourly, daily, weekly, every_6h

• intervalSecondsintegeropcional