Riferimento strumenti

Parametri

• querystringfacoltativo

  Filtro senza distinzione tra maiuscole e minuscole sul nome o sito del vibiz (es. «acme» o «acme.com»).

• limitintegerfacoltativo

  Dimensione della pagina.

• cursorstringfacoltativo

  `next_cursor` della pagina precedente.

Parametri

• platformstringobbligatorio

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

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

• actionstringobbligatorio

  "list": account pubblicitari associati a un account social. "connect_url": link per collegare gli annunci.

  Valori: list, connect_url

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• socialAccountIdstringfacoltativo

  RICHIEDE: ID dell’account social (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id`. NON l’ID `act_…` di un account pubblicitario Meta: quello viene restituito da QUESTO strumento come `accounts[].id`.

• publisher_platformstringfacoltativo

  Solo Meta: dove viene pubblicata la campagna. Predefinito facebook.

  Valori: facebook, instagram

• redirectUrlstringfacoltativo

  URL personalizzato a cui reindirizzare l’utente dopo OAuth (solo piattaforme con lo stesso token).

Parametri

• platformstringobbligatorio

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

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

• actionstringobbligatorio

  "list": metriche delle campagne. "tree": campagna → gruppi di inserzioni → annunci con budget (più lento).

  Valori: list, tree

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• publisher_platformstringfacoltativo

  Solo Meta: dove viene pubblicata la campagna. Predefinito facebook.

  Valori: facebook, instagram

• statusstringfacoltativo

  Restituisci solo elementi con questo stato.

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

• includeExternalbooleanfacoltativo

  Predefinito false: solo campagne/annunci creati da Vibiz. Imposta true SOLO se l’utente chiede tutto l’account pubblicitario, incluse le campagne create in Gestione inserzioni.

• limitintegerfacoltativo

  Numero massimo di campagne da restituire (predefinito 20).

• fromDatestringfacoltativo

  Data iniziale, YYYY-MM-DD.

• toDatestringfacoltativo

  Data finale, YYYY-MM-DD.

Parametri

• platformstringobbligatorio

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

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

• actionstringobbligatorio

  "list": annunci con metriche. "get": un annuncio. "analytics": un annuncio per giorno. get/analytics richiedono adId.

  Valori: list, get, analytics

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• publisher_platformstringfacoltativo

  Solo Meta: dove viene pubblicata la campagna. Predefinito facebook.

  Valori: facebook, instagram

• statusstringfacoltativo

  Restituisci solo elementi con questo stato.

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

• includeExternalbooleanfacoltativo

  Predefinito false: solo campagne/annunci creati da Vibiz. Imposta true SOLO se l’utente chiede tutto l’account pubblicitario, incluse le campagne create in Gestione inserzioni.

• campaignIdstringfacoltativo

  RICHIEDE: ID della campagna sulla piattaforma Meta (numerico di 16-18 cifre, es. "23859876543210000"). NON un ID interno di campagna. Ricavalo da vibiz_ads_campaigns (action "list", platform "meta"), campo platformCampaignId.

• fromDatestringfacoltativo

  YYYY-MM-DD

• toDatestringfacoltativo

  YYYY-MM-DD

• limitintegerfacoltativo

  Numero massimo di righe da restituire.

• adIdstringfacoltativo

  ID interno dell’annuncio: Mongo ObjectId esadecimale di 24 caratteri (es. "65a3f0c1d2e4b8e9f4a1c2d3"). Si ricava da vibiz_ads_creatives (action "list", platform "meta"), campo id. NON l’ID numerico Meta, NON un UUID campaign_ad di Vibiz.

• breakdownsarrayfacoltativo

  Chiavi di dimensione facoltative (Meta: age | gender | country | publisher_platform | device_platform | region). Unite lato server in un parametro query 'breakdowns' separato da virgole.

Parametri

• platformstringobbligatorio

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

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

• levelstringobbligatorio

  "campaign" (solo Meta) oppure "creative" (un singolo annuncio, qualsiasi piattaforma).

  Valori: campaign, creative

• idstringobbligatorio

  ID della campagna sulla piattaforma, oppure ID interno dell’annuncio da vibiz_ads_creatives.

• publisher_platformstringfacoltativo

  Solo Meta: dove viene pubblicata la campagna. Predefinito facebook.

  Valori: facebook, instagram

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• platformstringobbligatorio

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

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

• actionstringobbligatorio

  "create": nuova campagna. "boost_post": promuove un post social pubblicato.

  Valori: create, boost_post

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

• adAccountIdstringfacoltativo

  ID dell’account pubblicitario Meta ("act_…"). Ometti per l’account selezionato.

• namestringfacoltativo

  Nome della campagna (massimo 255).

• goalstringfacoltativo

  Obiettivo di ottimizzazione del gruppo di inserzioni: scegli quello che corrisponde a ciò che l’attività vuole davvero, NON 'traffic' per impostazione predefinita. Per VENDITE/ACQUISTI (gran parte degli e-commerce e delle offerte a pagamento), usa 'conversions'.

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

• budgetAmountnumberfacoltativo

  Budget giornaliero nella valuta dell’account pubblicitario. Minimo $10 al giorno.

• budgetTypestringfacoltativo

  Solo 'daily' può essere preparato nello studio.

  Valori: daily, lifetime

• currencystringfacoltativo
• headlinestringfacoltativo
• bodystringfacoltativo
• callToActionstringfacoltativo

  Solo Meta.

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

• linkUrlstringfacoltativo
• imageUrlstringfacoltativo
• videoobjectfacoltativo
• creativeIdstringfacoltativo

  Una creatività Vibiz al posto di imageUrl/video.

• campaignIdstringfacoltativo

  Con adSetId: la campagna attiva a cui appartiene il gruppo di inserzioni.

• adSetIdstringfacoltativo

  Prepara l’annuncio in questo gruppo di inserzioni esistente (richiede campaignId).

• countriesarrayfacoltativo

  OBBLIGATORIO per una buona distribuzione: codici paese ISO-3166 alpha-2 (es. ['ES'], ['MX'], ['US'], ['GB']). NON lasciare vuoto: Meta usa gli Stati Uniti come valore predefinito, sprecando budget se annuncio o attività non sono rivolti agli USA.

• ageMinintegerfacoltativo
• ageMaxintegerfacoltativo
• interestsarrayfacoltativo

  Targeting per interessi facoltativo. Ogni `{id,name}` DEVE provenire da `vibiz_meta_ads_targeting_search` (gruppo ads) in questa sessione. Non inventare né riusare ID ricordati: Meta rifiuta quelli obsoleti (sottocodice 1487079) e il lancio fallisce.

• specialAdCategoriesarrayfacoltativo
• audienceIdstringfacoltativo

  Un pubblico personalizzato Meta a cui rivolgersi.

• advantageAudienceintegerfacoltativo
• budgetLevelstringfacoltativo

  Valori: campaign, adset

• pixelIdstringfacoltativo
• conversionEventstringfacoltativo
• postIdstringfacoltativo

  RICHIEDE: ID interno del post (Mongo ObjectId esadecimale di 24 caratteri, es. "65a3f0c1d2e4b8e9f4a1c2d3"). Ricavalo dalla risposta di `vibiz_social_publish` o da `vibiz_social_list_posts[].id`. Fornisci UNO tra `postId` e `platformPostId`.

• platformPostIdstringfacoltativo

  RICHIEDE: ID del post sulla piattaforma Meta (es. ID media Instagram "12345_67890" o Facebook "123_456"). Ricavalo da response.platforms[].platformPostId di `vibiz_social_publish` oppure interrogando il post dopo la pubblicazione sulla piattaforma.

• accountIdstringfacoltativo

  RICHIEDE: ID dell’account social (Mongo ObjectId esadecimale di 24 caratteri) del proprietario del post. Ricavalo da `vibiz_social_list_accounts[].id`. NON l’account pubblicitario Meta `act_…`.

• budgetobjectfacoltativo
• scheduleobjectfacoltativo
• targetingobjectfacoltativo
• bidAmountnumberfacoltativo

  Solo Meta.

• trackingobjectfacoltativo

  Solo Meta.

• endDatestringfacoltativo

  Obbligatorio per i budget totali.

• longHeadlinestringfacoltativo

  Solo Display: titolo lungo (massimo 90 caratteri). Obbligatorio per annunci Google Display.

• imagesobjectfacoltativo

  Annunci display adattabili: per le campagne Display sono obbligatori sia `landscape` sia `square`.

• businessNamestringfacoltativo

  Nome dell’attività mostrato accanto all’annuncio (massimo 25 caratteri). Obbligatorio per Google Display.

• campaignTypestringfacoltativo

  Scegli `display` per annunci adattabili con immagini, `search` per annunci testuali con targeting per parole chiave.

  Valori: display, search

• keywordsarrayfacoltativo

  Solo campagne Search: elenco di parole chiave (un termine per voce).

• additionalHeadlinesarrayfacoltativo

  Varianti aggiuntive del titolo per annunci Search adattabili. Google le alterna automaticamente.

• additionalDescriptionsarrayfacoltativo

  Varianti aggiuntive della descrizione per annunci Search adattabili. Google le alterna automaticamente.

• brandIdentityobjectfacoltativo

  Identità del brand TikTok per account solo pubblicitari (nessun account di pubblicazione collegato). Ometti per compilarla dal brand dello spazio di lavoro (nome + logo); Late conserva l’identità sull’account pubblicitario dopo il primo lancio.

• boardIdstringfacoltativo

  RICHIEDE: ID della bacheca Pinterest. Obbligatorio: gli annunci Pinterest devono puntare a una bacheca specifica.

Parametri

• platformstringobbligatorio

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

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

• levelstringobbligatorio

  "campaign" oppure "creative" (un singolo annuncio).

  Valori: campaign, creative

• idsarrayobbligatorio

  ID delle campagne sulla piattaforma (livello campaign) oppure ID interni degli annunci (livello creative).

• publisher_platformstringfacoltativo

  Solo Meta: dove viene pubblicata la campagna. Predefinito facebook.

  Valori: facebook, instagram

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

Parametri

• vibizstringfacoltativo

  Stesso valore del piano.

• formatstringobbligatorio

  Stesso valore del piano.

  Valori: image, carousel, video, ugc, product_shot

• briefstringobbligatorio

  Stesso valore del piano.

• countintegerfacoltativo

  Stesso valore del piano.

• placementstringfacoltativo

  Stesso valore del piano.

• offer_idstringfacoltativo

  Stesso valore del piano.

• durationstringfacoltativo

  Stesso valore del piano.

  Valori: 4s, 6s, 8s

• resolutionstringfacoltativo

  Stesso valore del piano.

  Valori: 480p, 720p, 1080p

• extra_fieldsobjectfacoltativo

  Stesso valore del piano.

Parametri

• querystringobbligatorio

  Ciò che vuole l’utente, con le sue parole, es. «rispondi ai miei messaggi diretti Instagram».

• limitintegerfacoltativo

  Numero massimo di risultati (predefinito 5).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• imageUrlstringfacoltativo

  URL pubblico http(s) dell’immagine/video da caricare. Il server lo recupera e lo conserva. Opzione migliore per la maggior parte dei client.

• imageBase64stringfacoltativo

  Byte del file codificati in Base64 (senza prefisso data:). Richiede `contentType`. Solo file piccoli (≤ 3 MB); per file locali più grandi usa la modalità con URL prefirmato (ometti imageUrl e imageBase64).

• filenamestringfacoltativo

  Nome originale del file, usato per ricavare l’estensione. Esempio: "hero-shot.jpg". Facoltativo se viene fornito `imageUrl`.

• contentTypestringfacoltativo

  Tipo MIME. Obbligatorio per `imageBase64` e la modalità prefirmata; dedotto dalla risposta per `imageUrl`.

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

Parametri

• runIdstringobbligatorio

  ID dell’esecuzione Trigger.dev dalla risposta di uno strumento vibiz_generate_*.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• rangestringfacoltativo

  "7d" per l’ultima settimana (predefinito), "30d" per l’ultimo mese, "90d" per il trimestre.

  Valori: 7d, 30d, 90d

• platformsarrayfacoltativo

  Piattaforme pubblicitarie da includere (predefinite: tutte e sei; quelle non collegate vengono saltate).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo
• statusstringfacoltativo

  Valori: draft, queued, processing, succeeded, failed

• mediaTypestringfacoltativo

  Valori: image, video, any

• limitintegerfacoltativo
• onlyFavoritesbooleanfacoltativo
• currentVersionsOnlybooleanfacoltativo
• displaybooleanfacoltativo

  Imposta true se l’utente deve vedere la galleria creatività integrata nella chat.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• campaignIdstringobbligatorio

  ID della campagna sulla piattaforma Meta da vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId.

• adSetIdstringobbligatorio

  ID del gruppo di inserzioni sulla piattaforma Meta da vibiz_ads_campaigns (action "tree", platform "meta"), campo adSets[].platformAdSetId`.

• linkUrlstringfacoltativo

  URL di destinazione predefinito quando una creatività omette linkUrl (di solito funnel / landing page).

• creativesarrayobbligatorio
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• dailyBudgetnumberobbligatorio

  Importo come indicato dal fondatore (unità principali).

• budgetCurrencystringfacoltativo

  Valuta ISO di `dailyBudget`. Predefinita USD.

• adAccountIdstringfacoltativo

  Account pubblicitario Meta facoltativo (act_…). Predefinito: account selezionato nello spazio di lavoro.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• entityTypestringobbligatorio

  Valori: campaign, adset, ad

• idsarrayobbligatorio

  ID della piattaforma Meta del livello indicato: ID campagne, gruppi di inserzioni o ID annunci Zernio (vibiz_ads_creatives (action "list", platform "meta"), campo id).

• dailyBudgetnumberobbligatorio

  Nuovo budget giornaliero in unità principali (20 = $20/giorno).

• campaignIdstringfacoltativo

  Obbligatorio quando entityType è "adset": campagna proprietaria dei gruppi. ID campagna Meta (16-18 cifre) da vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId. NON un ObjectId Zernio o UUID Vibiz.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• urlstringfacoltativo

  URL del sito o Instagram, es. https://acme.com o instagram.com/acme. Obbligatorio salvo ripresa di un brand esistente tramite vibiz.

• workspace_namestringfacoltativo

  Nome visualizzato per un nuovo vibiz; predefinito il nome del sito.

• vibizstringfacoltativo

  Slug di un vibiz da riprendere invece di crearne uno.

Parametri

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• formatstringobbligatorio

  image (annuncio statico), carousel (più slide), video (video pubblicitario), ugc (video parlato in stile creator), product_shot (foto del prodotto in una scena).

  Valori: image, carousel, video, ugc, product_shot

• briefstringobbligatorio

  Cosa creare, nelle parole dell’utente: offerta, approccio, pubblico, frasi obbligatorie.

• countintegerfacoltativo

  Numero di varianti, 1-4.

• placementstringfacoltativo

  Dove viene pubblicato, es. instagram_portrait, tiktok_story, facebook_feed, tiktok/reels/shorts per UGC.

• offer_idstringfacoltativo

  Offerta da presentare, da vibiz_list_offers (gruppo workspace). Facoltativa.

• durationstringfacoltativo

  Durata video / ugc. Predefinita 4s (video), 8s (ugc).

  Valori: 4s, 6s, 8s

• resolutionstringfacoltativo

  Qualità di generazione ugc (video: 720p o 1080p). Predefinita 720p.

  Valori: 480p, 720p, 1080p

• extra_fieldsobjectfacoltativo

  Campi iniziali specifici del formato (product_shot richiede productTitle, productImageUrl, recipeId).

Parametri

• toolstringobbligatorio

  Strumento che ha risposto approval_required, es. vibiz_social_publish.

• argumentsobjectobbligatorio

  Argomenti esatti per quello strumento (senza approval_token).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• statusstringfacoltativo

  Filtra per stato.

  Valori: draft, scheduled, published, failed

• platformstringfacoltativo

  Filtra per piattaforma.

• limitnumberfacoltativo

  Numero massimo di post (1-100, predefinito 10).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• contentstringobbligatorio

  Testo del post.

• platformsarrayobbligatorio

  Piattaforme + ID degli account.

• mediaUrlsarrayfacoltativo

  URL di immagini o video da allegare. Un URL che termina in .mp4 o .mov viene pubblicato come video (Reel, TikTok, Short se supportato); ogni altro come immagine. Carica prima i file locali con vibiz_gallery_upload e usa il suo publicUrl.

• scheduledForstringfacoltativo

  Data e ora ISO per la programmazione. Ometti per pubblicare subito.

• hashtagsarrayfacoltativo

  Hashtag.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• personIdstringobbligatorio
• genderstringfacoltativo

  Valori: female, male

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• videoUrlstringobbligatorio

  Video da guardare: un URL Vibiz o di una piattaforma pubblicitaria.

• mimeTypestringfacoltativo

  Solo se non è mp4 (es. video/webm).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• sourceAdIdstringobbligatorio

  ID campaign_ad dell’immagine statica esistente da animare (ricavalo dall’output di `vibiz_generate_image` (gruppo creatives) o dalla galleria creatività).

• sourceImageUrlstringobbligatorio

  URL dell’immagine di quell’annuncio (deve essere un URL https valido).

• promptstringfacoltativo

  Descrizione dell’animazione: come deve prendere vita l’immagine? Es. «lento avvicinamento della camera, il soggetto sorride e annuisce». Facoltativa: se omessa viene usato un valore sensato predefinito.

• aspectRatiostringfacoltativo

  Proporzioni del risultato. "auto" le deduce dall’immagine originale. Predefinito "auto".

  Valori: 16:9, 9:16, auto

• durationstringfacoltativo

  Durata del video. Predefinita "4s".

  Valori: 4s, 6s, 8s

• resolutionstringfacoltativo

  Predefinito "720p".

  Valori: 720p, 1080p

• generateAudiobooleanfacoltativo

  Predefinito true.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• photoUrlstringobbligatorio

  Fotografia su cui lavorare (https; Unsplash, Pexels o archiviazione Vibiz).

• headlinestringfacoltativo

  Da tre a sei parole.

• subheadstringfacoltativo

  Una breve riga di supporto.

• platformstringfacoltativo

  Valori: instagram_square, instagram_portrait, instagram_story, facebook_feed, landscape

• logoCornerstringfacoltativo

  Valori: top-left, top-right, bottom-left, bottom-right

• noScrimbooleanfacoltativo
• offerIdstringfacoltativo

  Offerta a cui si riferisce l’annuncio, da vibiz_list_offers (gruppo workspace).

• icpIdstringfacoltativo

  Pubblico a cui si riferisce l’annuncio, da vibiz_list_icps (gruppo workspace).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• creativeIdstringfacoltativo

  ID di una creatività. Restituisce provenienza completa e ipotesi.

• icpIdstringfacoltativo

  ID ICP da vibiz_list_icps (gruppo workspace). Restituisce tutto ciò che è stato creato per quel pubblico.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• adIdstringobbligatorio

  ID della creatività (annuncio).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• referenceImageUrlstringfacoltativo

  URL pubblico dell’immagine da modificare dalla galleria, oppure ometti se usi conversationImageId per un caricamento in chat.

• conversationImageIdstringfacoltativo

  Se l’utente ha allegato l’immagine della tela in chat, passa image-N dalle etichette della conversazione.

• promptstringobbligatorio

  Cosa cambiare nell’immagine. Specifica la modifica («rendi lo sfondo arancione tramonto», «rimuovi il watermark», «aggiungi un pulsante ACQUISTA ORA in basso a destra»). Evita prompt in stile storyboard o fotogrammi: è una modifica di una singola immagine, non un’animazione.

• platformstringfacoltativo

  Piattaforma di destinazione dell’immagine modificata. DEVE essere uno dei valori elencati. Predefinita: "instagram_portrait".

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

• aspectRatiostringfacoltativo

  Proporzioni del risultato facoltative. Se omesse, derivano da `platform`. Nota: cambiare proporzioni rispetto all’originale può ritagliare o estendere l’immagine.

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

• stylestringfacoltativo

  Chiave di stile per categoria. "hero-shot" è il valore predefinito; scegli la categoria il cui stile visivo corrisponde all’intento dell’utente.

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

• imageCountintegerfacoltativo

  Numero di VARIANTI della modifica da generare (1-4). Predefinito 1. Utile quando l’utente vuole confrontare più interpretazioni della stessa modifica.

• additionalReferenceImagesarrayfacoltativo

  URL Discover/galleria facoltativi da output precedenti. Gli allegati della chat usano conversationImageIds.

• conversationImageIdsarrayfacoltativo

  Riferimenti aggiuntivi ai caricamenti in chat (image-1, image-2, …).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• idstringobbligatorio

  ID del video meme da `videos[].id` di vibiz_produce_meme_videos (gruppo creatives).

• captionstringfacoltativo

  Nuova didascalia sul video. Ometti per mantenerla.

• templateIdstringfacoltativo

  ID del modello meme fornito dall’utente. Ometti per mantenere il meme attuale.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• adIdstringobbligatorio

  ID dell’annuncio video già generato da completare.

• subtitlesbooleanfacoltativo

  Aggiungi sottotitoli del parlato.

• subtitleStylestringfacoltativo

  Stile dei sottotitoli. Predefinito hormozi.

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

• subtitleLanguagestringfacoltativo

  Codice ISO 639-1 della lingua parlata, solo se l’utente l’ha indicata; omesso = rilevamento automatico.

• musicstringfacoltativo

  Aggiungi musica di sottofondo: come deve suonare nel tempo. Ometti per non aggiungere musica.

• musicDurationSecnumberfacoltativo

  Limite superiore facoltativo per il sottofondo; per impostazione predefinita, appena inferiore alla durata del video.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• promptstringobbligatorio

  Descrivi l’intero annuncio come UNA scena: soggetto, ambiente, presenza del brand, movimento e testo a schermo. NON fornire storyboard fotogramma per fotogramma.

• platformstringfacoltativo

  Piattaforma di destinazione. Associata lato server alle proporzioni video (9:16 per le piattaforme di storie, 16:9 altrimenti). Predefinita: "facebook_feed".

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

• videoDurationstringfacoltativo

  Durata del video. Predefinita "4s".

  Valori: 4s, 6s, 8s

• videoResolutionstringfacoltativo

  Predefinito "720p".

  Valori: 720p, 1080p

• generateAudiobooleanfacoltativo

  Predefinito true.

• useBrandbooleanfacoltativo

  Applica il kit del brand dello spazio di lavoro. Predefinito true.

• allowPartialBrandbooleanfacoltativo

  Eccezione per la bozza. Predefinito false. Imposta true solo se l’utente chiede esplicitamente di generare prima che onboarding, brand o configurazione del prodotto siano pronti; il risultato potrebbe non essere coerente con il brand.

• referenceImagesarrayfacoltativo

  URL Discover/galleria facoltativi da output precedenti. I caricamenti in chat devono usare conversationImageIds.

• conversationImageIdsarrayfacoltativo

  Riferimenti ai caricamenti in chat (image-1, image-2, …). Non copiare mai URL degli allegati in referenceImages.

• offerIdstringfacoltativo

  ID dell’offerta/prodotto a cui si riferisce il video. Ricavalo da `vibiz_list_offers[].id` (gruppo workspace). Se impostato, il copione di regia si basa su titolo, dettagli e immagine del prodotto. OBBLIGATORIO se l’utente dice «un video pubblicitario per il mio prodotto» / «video per questa offerta»: chiama prima `vibiz_list_offers` (gruppo workspace) e CHIEDI se esistono più offerte plausibili.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• promptstringobbligatorio

  Tema del carosello: argomento, approccio, messaggio principale. Il generatore scrive i testi per slide: descrivi la storia, non le singole slide.

• slideCountintegerfacoltativo

  Numero di slide (2-10). Predefinito 3. Più slide richiedono più crediti (1 per slide).

• platformstringfacoltativo

  Destinazione di pubblicazione. instagram_portrait=carosello feed IG 4:5; instagram_story=Storie/Reels IG 9:16; tiktok_story=TikTok 9:16; linkedin=1:1; facebook_feed=1:1. Deduci dal contesto o fai una domanda sul posizionamento se non è chiaro.

  Valori: instagram_portrait, instagram_story, linkedin, facebook_feed, tiktok_story

• aspectRatiostringfacoltativo

  Override facoltativo. Di solito ometti: deriva dalla piattaforma. Imposta solo se l’utente chiede esplicitamente proporzioni diverse dal valore predefinito.

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

• useBrandbooleanfacoltativo

  Applica il kit del brand dello spazio di lavoro (colori, font, logo, tono). Predefinito true.

• allowPartialBrandbooleanfacoltativo

  Eccezione per la bozza. Predefinito false. Imposta true solo se l’utente chiede esplicitamente di generare prima che onboarding, brand o configurazione del prodotto siano pronti; il risultato potrebbe non essere coerente con il brand.

• offerIdstringfacoltativo

  ID dell’offerta/prodotto a cui si riferisce il carosello. Ricavalo da `vibiz_list_offers[].id` (gruppo workspace). Se impostato, testi e immagini si basano sul prodotto. OBBLIGATORIO se l’utente dice «il mio prodotto» / «un carosello su [ciò che vendo]»: chiama prima `vibiz_list_offers` (gruppo workspace) e CHIEDI se più offerte potrebbero corrispondere.

• slidesarrayfacoltativo

  Slide del carosello già scritte, facoltative. Se impostate, la generazione usa questi titoli e testi senza ripianificare la storia.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• promptstringobbligatorio

  Descrivi l’IMMAGINE STATICA da generare. Non strutturare il prompt come storyboard o fotogrammi.

• platformstringfacoltativo

  Piattaforma di destinazione. DEVE essere uno dei valori elencati. Associazioni comuni: TikTok → "tiktok_story", feed Instagram → "instagram_portrait", storia Instagram → "instagram_story", Facebook → "facebook_feed", LinkedIn → "linkedin". Predefinita: "instagram_portrait".

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

• aspectRatiostringfacoltativo

  Facoltativo. Se omesso, deriva da `platform`. 9:16 = verticale, 1:1 = quadrato, 16:9 = orizzontale.

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

• stylestringfacoltativo

  Chiave di stile per categoria facoltativa. Ometti se l’utente non ha scelto o richiesto uno stile specifico. Usa hero-shot per una foto principale in studio centrata sul prodotto, lifestyle-shot per contesto reale pianificato, ugc per scatti nativi social da creator/telefono, hyperrealistic per realismo fotografico cinematografico, saas-demo per interfacce di prodotto, founder-portrait per costruire fiducia, infographic per diagrammi.

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

• useBrandbooleanfacoltativo

  Applica il kit del brand dello spazio di lavoro (colori, font, logo, tono). Predefinito true. Imposta false solo se l’utente vuole esplicitamente un aspetto generico.

• allowPartialBrandbooleanfacoltativo

  Eccezione per la bozza. Predefinito false. Imposta true solo se l’utente chiede esplicitamente di generare prima che onboarding, brand o configurazione del prodotto siano pronti; il risultato potrebbe non essere coerente con il brand.

• imageCountintegerfacoltativo

  Numero di VARIANTI della STESSA immagine da generare (1-4). Predefinito 1. NON per creare storyboard video: usa `vibiz_generate_ugc` (gruppo creatives) per contenuti in movimento.

• referenceImagesarrayfacoltativo

  URL Discover/galleria facoltativi da output precedenti (es. originalUrl di vibiz_get_for_you). Non incollare qui URL di allegati della chat: usa invece conversationImageIds.

• conversationImageIdsarrayfacoltativo

  Riferimenti ai caricamenti in chat (image-1, image-2, … dalle etichette della conversazione). Obbligatori se l’utente ha allegato immagini in chat.

• offerIdstringfacoltativo

  ID dell’offerta/prodotto a cui si riferisce la generazione. Ricavalo da `vibiz_list_offers[].id` (gruppo workspace). Se impostato, il generatore di prompt basa l’immagine su quel prodotto (titolo, prezzo, immagine, URL originale). OBBLIGATORIO se l’utente dice «il mio prodotto» / «questa offerta»: chiama prima `vibiz_list_offers` (gruppo workspace) e passa l’ID corrispondente. Se lo spazio di lavoro ha più offerte e l’utente non ha specificato, CHIEDI quale prima di chiamare lo strumento.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• productIdstringfacoltativo

  ID prodotto facoltativo da vibiz_list_offers (gruppo workspace).

• productTitlestringobbligatorio

  Titolo del prodotto nel catalogo.

• productImageUrlstringobbligatorio

  URL pubblico dell’immagine esatta del prodotto nel catalogo.

• productDescriptionstringfacoltativo

  Contesto facoltativo su materiali e costruzione del prodotto.

• vendorstringfacoltativo

  Fornitore del prodotto facoltativo.

• productTypestringfacoltativo

  Categoria del prodotto facoltativa.

• talentPresetIdstringfacoltativo

  Scheda del personaggio basata sullo stile, facoltativa, per ricette con una persona visibile.

  Valori: 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

• userNotesstringfacoltativo

  Rifinitura facoltativa subordinata alla ricetta selezionata.

• secondaryProductImageUrlstringfacoltativo

  Seconda vista del prodotto facoltativa per precisione costruttiva.

• allowPartialBrandbooleanfacoltativo

  Consenti la generazione prima che tutto il contesto di onboarding sia pronto.

• recipeIdstringobbligatorio

  ID esatto della ricetta Product Studio.

  Valori: 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

• aspectRatiostringfacoltativo

  Formato finale facoltativo. È preferibile il valore predefinito della ricetta.

  Valori: 1:1, 3:4, 9:16, 4:3, 16:9

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• productIdstringfacoltativo

  ID prodotto facoltativo da vibiz_list_offers (gruppo workspace).

• productTitlestringobbligatorio

  Titolo del prodotto nel catalogo.

• productImageUrlstringobbligatorio

  URL pubblico dell’immagine esatta del prodotto nel catalogo.

• productDescriptionstringfacoltativo

  Contesto facoltativo su materiali e costruzione del prodotto.

• vendorstringfacoltativo

  Fornitore del prodotto facoltativo.

• productTypestringfacoltativo

  Categoria del prodotto facoltativa.

• talentPresetIdstringfacoltativo

  Scheda del personaggio basata sullo stile, facoltativa, per ricette con una persona visibile.

  Valori: 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

• userNotesstringfacoltativo

  Rifinitura facoltativa subordinata alla ricetta selezionata.

• secondaryProductImageUrlstringfacoltativo

  Seconda vista del prodotto facoltativa per precisione costruttiva.

• allowPartialBrandbooleanfacoltativo

  Consenti la generazione prima che tutto il contesto di onboarding sia pronto.

• bundleIdstringobbligatorio

  launch_essentials, social_content, pdp_catalog, influencer_collection oppure model_collection.

  Valori: launch_essentials, social_content, pdp_catalog, influencer_collection, model_collection

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• productNamestringobbligatorio

  Nome breve del prodotto / brand / servizio del video (es. "Vibiz", «Abbonamento Acme Coffee»). Obbligatorio.

• productDetailsstringobbligatorio

  Paragrafo che descrive prodotto, pubblico, agganci, elementi distintivi e indicazioni di tono/stile. Obbligatorio. NON inviare uno storyboard: descrivi il prodotto e perché conta; l’attività scrive il proprio copione.

• scriptstringfacoltativo

  Copione UGC completo scritto da te, facoltativo: parlato tra virgolette, passaggi, camera, audio. Indica un’immagine di riferimento come Image 1. Se impostato, viene generato così com’è scritto (styleId, videoStyle, hook e creatorGender non vengono applicati).

• styleIdstringfacoltativo

  Stile UGC con nome (vedi `vibiz_list_ugc_styles` (gruppo creatives)). Preferiscilo a `videoStyle`.

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

• videoStylestringfacoltativo

  Stile precedente con persona in camera (ignorato se `styleId` è impostato). talking_head è l’aspetto predefinito con volto ripreso dal telefono.

  Valori: talking_head, review, unboxing, pov

• platformstringfacoltativo

  Piattaforma di destinazione per video brevi. Determina proporzioni e ritmo. Predefinita "tiktok".

  Valori: tiktok, reels, shorts

• durationstringfacoltativo

  Durata del video. Predefinita "8s".

  Valori: 4s, 6s, 8s

• resolutionstringfacoltativo

  Qualità di generazione. Predefinita "720p".

  Valori: 480p, 720p, 1080p

• creatorGenderstringfacoltativo

  Genere presentato dal creator AI / dalla persona in camera. Predefinito "female".

  Valori: female, male

• hookstringfacoltativo

  Frase iniziale di aggancio facoltativa (massimo 200 caratteri). Se omessa, l’attività la genera da productDetails.

• referenceImageUrlstringfacoltativo

  Riferimento facoltativo di prodotto, brand o stile da un URL restituito da uno strumento precedente. I caricamenti in chat devono usare invece conversationImageId.

• conversationImageIdstringfacoltativo

  Se l’utente ha allegato un’immagine di riferimento in chat, passa image-N dalle etichette della conversazione.

• conversationImageIdsarrayfacoltativo

  Riferimenti aggiuntivi ai caricamenti in chat (image-1, image-2, …).

• offerIdstringfacoltativo

  ID dell’offerta/prodotto a cui si riferisce la clip UGC. Ricavalo da `vibiz_list_offers[].id` (gruppo workspace). Se impostato, l’offerta scelta dall’agente viene registrata nella riga dell’annuncio per il riuso successivo. OBBLIGATORIO se l’utente dice «un UGC sul mio prodotto» / «video con portavoce per [ciò che vendo]»: chiama prima `vibiz_list_offers` (gruppo workspace) e CHIEDI se esistono più offerte plausibili.

• allowPartialBrandbooleanfacoltativo

  Eccezione per la bozza. Predefinito false. Imposta true solo se l’utente chiede esplicitamente di generare prima che onboarding, brand o configurazione del prodotto siano pronti; il risultato potrebbe non essere coerente con il brand.

• icpIdstringfacoltativo

  ID facoltativo del profilo cliente/ICP selezionato. Usalo se l’utente indica un pubblico o se un’offerta ha un ICP chiaramente collegato; orienta l’aggancio UGC e l’approccio del creator.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• displaybooleanfacoltativo

  Imposta true se l’utente deve vedere la galleria di ispirazione Discover integrata nella chat.

• limitnumberfacoltativo

  Numero massimo di elementi da restituire (1..48, predefinito 24).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• displaybooleanfacoltativo

  Imposta true per mostrare la galleria di anteprime degli stili UGC nella chat. Ometti per una ricerca silenziosa.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• imageUrlstringobbligatorio

  Creatività generata da osservare.

• logoUrlstringfacoltativo

  Logo ufficiale. Ometti per usare quello registrato nello spazio di lavoro.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• countintegerfacoltativo

  Numero di video, da 1 a 5. Predefinito 3.

• anglestringfacoltativo

  Richiesta dell’utente, con le sue parole: approcci, tema o tono (es. «scherza sul fare fatture a mano»). Ometti se ha chiesto solo video meme.

• templateIdsarrayfacoltativo

  Solo se l’utente ha fornito ID specifici di modelli meme, in ordine: il video 1 usa il primo. Gli altri ricevono meme scelti in base al contenuto. Non indovinare mai un ID.

Parametri

• platformstringobbligatorio

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

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

• levelstringobbligatorio

  "campaign" oppure "creative" (un singolo annuncio).

  Valori: campaign, creative

• idsarrayobbligatorio

  ID delle campagne sulla piattaforma (livello campaign) oppure ID interni degli annunci (livello creative).

• publisher_platformstringfacoltativo

  Solo Meta: dove viene pubblicata la campagna. Predefinito facebook.

  Valori: facebook, instagram

• vibizstringfacoltativo

  Slug del brand da list_vibiz, es. "acme". Ometti solo se il connettore è fissato a un brand.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• titlestringobbligatorio
• descriptionstringfacoltativo
• reasonstringfacoltativo

  Una frase breve: il motivo per agire ora.

• impactstringfacoltativo

  Risultato atteso breve, es. '+8-12 lead/settimana'.

• approveLabelstringfacoltativo
• sessionIdstringfacoltativo
• planDayintegerfacoltativo

  Piano mobile di 3 giorni: 1 = oggi, 2 = domani, 3 = dopodomani. Ometti per una proposta singola.

• toolsarrayfacoltativo

  Ogni strumento di scrittura o sottoagente che eseguirà la scheda; [] per lavoro in sola lettura. La piattaforma calcola `critical` da questo elenco.

• ownerstringfacoltativo

  Chi esegue la scheda: ads-operator per modifiche agli annunci, cto per il sito, researcher, video oppure ceo.

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

• planstringfacoltativo

  Solo per l’agente, mai mostrato al fondatore: il piano Markdown completo eseguito e usato per valutare il lavoro (ambito, criteri di accettazione, link, rischi).

• areastringfacoltativo

  Dominio della scheda.

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

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringobbligatorio

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

• objectivestringobbligatorio

  traffic = visite al sito, conversions = vendite/iscrizioni, lead_generation = moduli.

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

• daily_budgetnumberobbligatorio

  «$30 al giorno» → 30. Non presumere mai un importo.

• currencystringfacoltativo

  ISO-4217, predefinito USD.

• creative_idstringfacoltativo

  ID della creatività (Meta).

• image_urlstringfacoltativo

  URL pubblico dell’immagine quando non c’è creative_id.

• briefstringfacoltativo

  Cosa vende l’annuncio; la prima frase diventa titolo e il resto corpo se questi campi sono omessi.

• headlinestringfacoltativo
• bodystringfacoltativo
• link_urlstringfacoltativo

  Landing page.

• call_to_actionstringfacoltativo

  es. LEARN_MORE, SHOP_NOW, SIGN_UP.

• countriesarrayfacoltativo

  es. ["US","CA"]. Chiedi all’utente; non usare US come valore predefinito.

• audience_hintstringfacoltativo

  A chi è rivolto, nelle parole dell’utente. Un intervallo d’età ("25-45", "18+") diventa targeting per età dove supportato; il resto è mostrato come nota, senza targeting.

• age_minintegerfacoltativo
• age_maxintegerfacoltativo
• ad_account_idstringfacoltativo

  Obbligatorio fuori da Meta.

• social_account_idstringfacoltativo

  Da vibiz_social_list_accounts. Obbligatorio fuori da Meta.

• campaign_namestringfacoltativo
• extra_fieldsobjectfacoltativo

  Solo campi launch_create specifici della piattaforma.

• modestringfacoltativo

  Valori: plan, execute

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• campaignIdstringobbligatorio

  ID della campagna sulla piattaforma Meta (16-18 cifre) da vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId. NON un ObjectId Zernio o UUID Vibiz.

• adSetIdsarrayobbligatorio

  ID del gruppo di inserzioni sulla piattaforma Meta da vibiz_ads_campaigns (action "tree", platform "meta"), campo adSets[].platformAdSetId`.

• statusstringfacoltativo

  Predefinito "active". "paused" viene rifiutato per gli agenti.

  Valori: active, paused

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• sourcesarrayfacoltativo

  Ometti per creare ogni pubblico Vibiz costruibile. Valori: auto_site_visitors, auto_leads_list, auto_page_engagers, auto_ig_engagers oppure page_engagers:<pageId> / ig_engagers:<igUserId>.

• adAccountIdstringfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• adAccountIdstringfacoltativo

  Account pubblicitario Meta ("act_…"); predefinito quello selezionato.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• adAccountIdstringfacoltativo

  Account pubblicitario Meta ("act_…"); predefinito quello selezionato.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• campaignIdstringobbligatorio

  RICHIEDE: ID della campagna sulla piattaforma Meta (numerico di 16-18 cifre). Ricavalo da vibiz_ads_campaigns (action "list", platform "meta"), campo platformCampaignId.

• platformstringobbligatorio

  Valori: facebook, instagram

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• sourceCampaignIdstringobbligatorio

  Campagna attiva da copiare (platformCampaignId).

• namestringfacoltativo

  Nome della copia.

• adAccountIdstringfacoltativo

  Inserisci la copia in questo account pubblicitario Meta ('act_…').

• conversionEventstringfacoltativo

  Ottimizza la copia per questo evento.

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

• pixelIdstringfacoltativo
• dailyBudgetnumberfacoltativo

  Sostituisci il budget giornaliero (budget campagna per CBO, di ogni gruppo per ABO).

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• campaignIdstringobbligatorio

  ID della campagna sulla piattaforma Meta da vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId.

• adSetNamestringobbligatorio

  Nome del nuovo gruppo di inserzioni (massimo 255 caratteri).

• dailyBudgetnumberfacoltativo

  Obbligatorio per campagne ABO (budget del gruppo di inserzioni). Ometti se la campagna principale è CBO.

• goalstringfacoltativo

  Obiettivo di ottimizzazione del gruppo: scegli quello che corrisponde a ciò che l’attività vuole davvero, NON 'traffic' per impostazione predefinita. Per VENDITE/ACQUISTI (gran parte degli e-commerce e offerte a pagamento), usa 'conversions'. Per raccogliere LEAD (moduli, iscrizioni, richieste di preventivo), usa 'lead_generation'. Usa 'traffic' solo se l’utente vuole esplicitamente clic/visite: ottimizza per clic economici, non acquirenti, quindi di solito spreca budget per un’attività di vendita. 'engagement'/'awareness'/'video_views' sono solo per la parte alta del funnel.

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

• budgetTypestringfacoltativo

  Valori: daily, lifetime

• linkUrlstringfacoltativo

  URL di destinazione predefinito per creatività senza linkUrl.

• countriesarrayfacoltativo

  OBBLIGATORIO per una buona distribuzione: codici paese ISO-3166 alpha-2 (es. ['ES'], ['MX'], ['US'], ['GB']). NON lasciare vuoto: Meta usa gli Stati Uniti come valore predefinito, sprecando budget se annuncio o attività non sono rivolti agli USA. Se l’utente non ha già indicato dove pubblicare, CHIEDI prima del lancio: consiglia paesi in base alla geografia dell’ICP e al mercato dell’attività, offrendo anche tutto il mondo come opzione; non dedurre in silenzio. Abbina lingua della creatività e posizione del cliente: testo spagnolo per attività in Spagna → ['ES'], spagnolo per il Messico → ['MX'], attività statunitense in inglese → ['US']; non usare mai ['US'] come valore predefinito se il pubblico non è davvero negli USA.

• ageMinintegerfacoltativo
• ageMaxintegerfacoltativo
• interestsarrayfacoltativo

  Targeting per interessi facoltativo. Ogni `{id,name}` DEVE provenire da `vibiz_meta_ads_targeting_search` (gruppo ads) in questa sessione. Non inventare né riusare ID ricordati: Meta rifiuta quelli obsoleti (sottocodice 1487079) e il lancio fallisce. Ometti l’array per un lancio ampio / Advantage+ senza interessi.

• creativesarrayobbligatorio
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• campaignIdstringobbligatorio

  Campagna proprietaria del gruppo di inserzioni ORIGINALE. ID della campagna sulla piattaforma Meta (16-18 cifre) da vibiz_ads_campaigns (action "tree", platform "meta"), campo platformCampaignId. NON un ObjectId Zernio o UUID Vibiz.

• adSetIdstringobbligatorio

  Gruppo di inserzioni originale (o quello proprietario di `adId`). ID del gruppo sulla piattaforma Meta da vibiz_ads_campaigns (action "tree", platform "meta"), campo adSets[].platformAdSetId`.

• adIdstringfacoltativo

  Copia solo questo annuncio (ID della piattaforma o ID Zernio). Ometti per copiare l’intero gruppo di inserzioni.

• targetCampaignIdstringfacoltativo

  Campagna di destinazione. Per una copia del gruppo: dove inserirla (predefinito: stessa campagna). Per una copia dell’annuncio: obbligatoria con `targetAdSetId`.

• targetAdSetIdstringfacoltativo

  Solo copie di annunci: gruppo di inserzioni di destinazione (predefinito: stesso gruppo).

• platformstringfacoltativo

  Predefinito facebook.

  Valori: facebook, instagram

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• draftIdstringfacoltativo

  Nuova bozza di campagna (dal risultato di preparazione / copia).

• campaignIdstringfacoltativo

  platformCampaignId di una campagna Meta attiva (la sua tela nello studio).

• founderMessagestringfacoltativo

  Parole esatte del fondatore per QUESTA modifica («aggiungi persone che interagiscono su Facebook»). Necessarie quando si aggiunge un pubblico: gruppo separato, segnale iniziale per il gruppo esistente o pubblico esclusivo per quello esistente sono una SUA scelta. Dopo aver chiesto, usa le sue parole + una nuova riga + una riga per risposta ('<question> <chosen option>'). Non parafrasare e non aggiungere deduzioni.

• campaignobjectfacoltativo

  Modifiche a livello di campagna; cambiano solo i campi passati.

• adSetsarrayfacoltativo
• adsarrayfacoltativo

  Modifiche a livello di annuncio: testo, CTA, link, media (creativeId / imageUrl / videoUrl).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• adIdstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• adAccountIdstringfacoltativo
• namestringobbligatorio

  Nome della campagna (massimo 255).

• goalstringobbligatorio

  Obiettivo di ottimizzazione del gruppo: scegli quello che corrisponde a ciò che l’attività vuole davvero, NON 'traffic' per impostazione predefinita. Per VENDITE/ACQUISTI (gran parte degli e-commerce e offerte a pagamento), usa 'conversions'. Per raccogliere LEAD (moduli, iscrizioni, richieste di preventivo), usa 'lead_generation'. Usa 'traffic' solo se l’utente vuole esplicitamente clic/visite: ottimizza per clic economici, non acquirenti, quindi di solito spreca budget per un’attività di vendita. 'engagement'/'awareness'/'video_views' sono solo per la parte alta del funnel.

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

• budgetAmountnumberobbligatorio

  Budget giornaliero per l’intero gruppo di inserzioni. Minimo $10 al giorno.

• budgetTypestringfacoltativo

  Solo 'daily' può essere preparato nello studio.

  Valori: daily, lifetime

• currencystringfacoltativo
• creativesarrayobbligatorio
• countriesarrayfacoltativo

  OBBLIGATORIO per una buona distribuzione: codici paese ISO-3166 alpha-2 (es. ['ES'], ['MX'], ['US'], ['GB']). NON lasciare vuoto: Meta usa gli Stati Uniti come valore predefinito, sprecando budget se annuncio o attività non sono rivolti agli USA. Se l’utente non ha già indicato dove pubblicare, CHIEDI prima del lancio: consiglia paesi in base alla geografia dell’ICP e al mercato dell’attività, offrendo anche tutto il mondo come opzione; non dedurre in silenzio. Abbina lingua della creatività e posizione del cliente: testo spagnolo per attività in Spagna → ['ES'], spagnolo per il Messico → ['MX'], attività statunitense in inglese → ['US']; non usare mai ['US'] come valore predefinito se il pubblico non è davvero negli USA.

• ageMinintegerfacoltativo
• ageMaxintegerfacoltativo
• interestsarrayfacoltativo

  Targeting per interessi facoltativo. Ogni `{id,name}` DEVE provenire da `vibiz_meta_ads_targeting_search` (gruppo ads) in questa sessione. Non inventare né riusare ID ricordati: Meta rifiuta quelli obsoleti (sottocodice 1487079) e il lancio fallisce. Ometti l’array per un lancio ampio / Advantage+ senza interessi.

• audienceIdstringfacoltativo
• advantageAudienceintegerfacoltativo
• budgetLevelstringfacoltativo

  Valori: campaign, adset

• specialAdCategoriesarrayfacoltativo
• pixelIdstringfacoltativo
• conversionEventstringfacoltativo
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• messagestringfacoltativo

  Messaggio del fondatore, testuale.

• intentstringfacoltativo

  Valori: prospecting, retargeting

• goalstringfacoltativo
• conversionEventstringfacoltativo
• countriesarrayfacoltativo

  Codici paese ISO, es. ["US", "CA"].

• dailyBudgetnumberfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• adIdstringobbligatorio

  UUID `campaign_ad` di Vibiz.

• campaignIdstringobbligatorio

  platformCampaignId Meta.

• adSetIdstringobbligatorio

  platformAdSetId Meta.

• namestringfacoltativo
• linkUrlstringfacoltativo
• callToActionstringfacoltativo

  Solo Meta.

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

• headlinestringfacoltativo
• bodystringfacoltativo
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Predefinito facebook.

  Valori: facebook, instagram

• limitintegerfacoltativo

  Quanti restituire (predefinito 6).

• fromDatestringfacoltativo

  Data ISO (facoltativa).

• toDatestringfacoltativo

  Data ISO (facoltativa).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• pixelIdstringobbligatorio

  ID del pixel Meta (cifre).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• adAccountIdstringobbligatorio

  RICHIEDE: ID dell’account pubblicitario sulla piattaforma Meta (stringa che inizia con "act_"). Ricavalo da vibiz_ads_accounts (action "list", platform "meta"), campo id.

• namestringobbligatorio

  Nome leggibile del pixel mostrato in Gestione eventi Meta. Suggerimento: includi il nome dello spazio di lavoro per distinguere più pixel (es. 'NeceSera — Pixel sito principale').

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobbligatorio

  RICHIEDE: ID del tag di tracciamento Zernio (restituito come `tag.id` da `vibiz_meta_ads_pixels_create` (gruppo ads), oppure `data[].id` da `vibiz_meta_ads_pixels_list` (gruppo ads)).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• adAccountIdstringfacoltativo

  RICHIEDE: ID dell’account pubblicitario sulla piattaforma Meta (stringa che inizia con "act_"). Ricavalo da vibiz_ads_accounts (action "list", platform "meta"), campo id. FACOLTATIVO: ometti per elencare i pixel di tutti gli account pubblicitari di questo account social.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobbligatorio

  RICHIEDE: ID del tag di tracciamento Zernio (restituito come `tag.id` da `vibiz_meta_ads_pixels_create` (gruppo ads), oppure `data[].id` da `vibiz_meta_ads_pixels_list` (gruppo ads)).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobbligatorio

  RICHIEDE: ID del tag di tracciamento Zernio (restituito come `tag.id` da `vibiz_meta_ads_pixels_create` (gruppo ads), oppure `data[].id` da `vibiz_meta_ads_pixels_list` (gruppo ads)).

• adAccountIdstringobbligatorio

  RICHIEDE: ID dell’account pubblicitario sulla piattaforma Meta (stringa che inizia con "act_"). Ricavalo da vibiz_ads_accounts (action "list", platform "meta"), campo id. È l’account DESTINATARIO che deve ottenere l’accesso, NON quello su cui il pixel è stato creato.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobbligatorio

  RICHIEDE: ID del tag di tracciamento Zernio (restituito come `tag.id` da `vibiz_meta_ads_pixels_create` (gruppo ads), oppure `data[].id` da `vibiz_meta_ads_pixels_list` (gruppo ads)).

• aggregationstringfacoltativo

  Dimensione di aggregazione. Se omessa usa il valore predefinito lato server di Zernio (event).

  Valori: event, host, url, device_type

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobbligatorio

  RICHIEDE: ID del tag di tracciamento Zernio (restituito come `tag.id` da `vibiz_meta_ads_pixels_create` (gruppo ads), oppure `data[].id` da `vibiz_meta_ads_pixels_list` (gruppo ads)).

• adAccountIdstringobbligatorio

  RICHIEDE: ID dell’account pubblicitario sulla piattaforma Meta (stringa che inizia con "act_"). Ricavalo da vibiz_ads_accounts (action "list", platform "meta"), campo id.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID dell’account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id` o dall’antenato di vibiz_ads_accounts (action "list", platform "meta").

• pixelIdstringobbligatorio

  RICHIEDE: ID del tag di tracciamento Zernio (restituito come `tag.id` da `vibiz_meta_ads_pixels_create` (gruppo ads), oppure `data[].id` da `vibiz_meta_ads_pixels_list` (gruppo ads)).

• namestringfacoltativo
• enableAutomaticMatchingbooleanfacoltativo
• firstPartyCookieStatusstringfacoltativo
• dataUseSettingstringfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• namestringobbligatorio

  Nome della campagna come mostrato in Gestione inserzioni, es. "{Business} Campagna lead {date} - Vibiz".

• adAccountIdstringfacoltativo

  ID dell’account pubblicitario Meta ('act_…'); ometti per quello selezionato nello spazio di lavoro.

• goalstringobbligatorio

  Ciò che il fondatore vuole dalla campagna, mai presunto. Se manca, chiediglielo con le sue parole («Cosa vuoi da questa campagna?»). lead_conversion = Lead (Raccogli contatti di persone interessate all’offerta; ottimizza su Lead per impostazione predefinita, oppure registrazione completata / contatto / appuntamento / invio candidatura / abbonamento / inizio prova); conversions = Vendite (Trova persone propense ad acquistare il prodotto o servizio; ottimizza su Purchase per impostazione predefinita, oppure avvio checkout / aggiunta al carrello / aggiunta dati di pagamento / abbonamento / inizio prova / registrazione completata); signup = Iscrizioni (Ottieni registrazioni o nuovi account sul sito; ottimizza su registrazione completata per impostazione predefinita, oppure abbonamento / inizio prova); traffic = Traffico (Invia più persone possibili alla pagina); awareness = Notorietà (Raggiungi un pubblico ampio e fai conoscere il brand). lead_generation = un modulo istantaneo Meta i cui lead non arrivano al sito o CRM, solo se il fondatore chiede esplicitamente un modulo.

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

• conversionEventstringfacoltativo

  Evento pixel su cui ottimizzano i gruppi di inserzioni, predefinito per tutti (un gruppo può indicarne uno con adSets[].conversionEvent); ometti per il valore predefinito dell’obiettivo. Deve corrispondere all’obiettivo (Lead: LEAD, COMPLETE_REGISTRATION, CONTACT, SCHEDULE, SUBMIT_APPLICATION, SUBSCRIBE, START_TRIAL; Vendite: PURCHASE, INITIATED_CHECKOUT, ADD_TO_CART, ADD_PAYMENT_INFO, SUBSCRIBE, START_TRIAL, COMPLETE_REGISTRATION; Iscrizioni: COMPLETE_REGISTRATION, SUBSCRIBE, START_TRIAL); una mancata corrispondenza viene rifiutata. Solo un evento già ricevuto dal pixel può addestrare: controlla ads_pixel_events.

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

• pixelIdstringfacoltativo

  ID del pixel Meta dall’elenco dei pixel; l’account può averne diversi.

• specialAdCategoriesarrayfacoltativo

  OBBLIGATORIO per prestiti / credito / assicurazioni / investimenti / banche (FINANCIAL_PRODUCTS_SERVICES), lavoro (EMPLOYMENT), immobili (HOUSING). Meta impone quindi 18-65+ e tutti i generi.

• budgetLevelstringfacoltativo

  'campaign' (predefinito, CBO): un dailyBudget sulla campagna. 'adset' (ABO): un dailyBudget su ogni gruppo di inserzioni.

  Valori: campaign, adset

• dailyBudgetnumberfacoltativo

  Budget giornaliero della campagna (CBO), espresso in `currency`. Minimo 10: sotto questa soglia un gruppo non esce dall’apprendimento.

• currencystringfacoltativo

  Codice ISO in cui sono ESPRESSI i budget (predefinito USD). La bozza è conservata nella valuta dell’account pubblicitario, convertita una volta alla preparazione con i tassi del lancio: dailyBudget/currency del risultato sono quindi quelli mostrati nello studio ed eseguiti da Meta.

• landingPageUrlstringfacoltativo

  Destinazione predefinita degli annunci senza linkUrl. Risolvi prima il sito online; non presumere mai {slug}.vibiz.app.

• funnelIdstringfacoltativo

  Un funnel Vibiz (il suo ID) come destinazione: il lancio vi installa il pixel e aggiunge l’attribuzione, come la selezione del sito nella procedura guidata.

• dsaBeneficiarystringfacoltativo

  Meta DSA (UE): entità giuridica beneficiaria. Necessaria con dsaPayor quando il targeting include un paese UE/SEE (o tutto il mondo). Ometti entrambi se l’account ha un inserzionista predefinito: la bozza li compila da quello; chiedi al fondatore solo se manca. Non inventarlo mai.

• dsaPayorstringfacoltativo

  Meta DSA (UE): entità giuridica che paga. Di solito coincide con dsaBeneficiary.

• retargetKnownbooleanfacoltativo

  'Tutti quelli che ci conoscono già': al lancio associa ogni pubblico Vibiz PRONTO (visitatori del sito, lead, persone che interagiscono con pagina e Instagram) a ogni gruppo senza includeAudienceIds.

• adSetsarrayobbligatorio

  Gruppi di inserzioni della campagna: uno ampio è il valore predefinito; aggiungi un gruppo di retargeting (includeAudienceIds) o per interessi quando i pubblici differiscono.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• draftIdstringfacoltativo

  Nuova bozza di campagna (dal risultato di preparazione / copia).

• campaignIdstringfacoltativo

  platformCampaignId di una campagna Meta attiva (la sua tela nello studio).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• founderMessagestringfacoltativo

  Parole esatte del fondatore per QUESTA modifica («aggiungi persone che interagiscono su Facebook»). Necessarie quando si aggiunge un pubblico: gruppo separato, segnale iniziale per il gruppo esistente o pubblico esclusivo per quello esistente sono una SUA scelta. Dopo aver chiesto, usa le sue parole + una nuova riga + una riga per risposta ('<question> <chosen option>'). Non parafrasare e non aggiungere deduzioni.

• campaignIdstringobbligatorio

  Campagna attiva (platformCampaignId) su cui preparare le modifiche.

• addAdsarrayfacoltativo

  Annunci da aggiungere a gruppi esistenti.

• addAdSetsarrayfacoltativo

  Nuovi gruppi di inserzioni, ciascuno con pubblico e annunci propri.

• copyAdSetIdsarrayfacoltativo

  Gruppi di inserzioni attivi da copiare con i loro annunci.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• socialAccountIdstringobbligatorio

  RICHIEDE: ID account social Zernio (Mongo ObjectId esadecimale di 24 caratteri). Ricavalo da `vibiz_social_list_accounts[].id`. NON un ID Meta `act_…`.

• qstringobbligatorio

  Testo di ricerca, es. «scuola privata» o «São Paulo». Almeno 2 caratteri.

• dimensionstringfacoltativo

  Predefinito 'interest'. Usa 'geo' per cercare chiavi di regioni/città (abbina a geoType + countryCode).

  Valori: interest, geo, behavior, income

• geoTypestringfacoltativo

  Solo quando dimension=geo. Il valore predefinito 'all' cerca tutti i tipi geografici insieme.

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

• countryCodestringfacoltativo

  ISO-3166 alpha-2 che delimita la ricerca geografica, es. "BR". Ignorato per la ricerca di interessi.

• limitintegerfacoltativo

  Numero massimo di righe da restituire (predefinito 15).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• adIdstringobbligatorio
• headlinestringfacoltativo
• bodystringfacoltativo

  Testo principale.

• callToActionstringfacoltativo

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

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• proposalIdstringobbligatorio

  ID della scheda da vibiz_list_proposals (gruppo autonomy).

• statusstringfacoltativo

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

• rejectReasonstringfacoltativo

  Perché il fondatore l’ha rifiutata; obbligatorio con `rejected`.

• titlestringfacoltativo
• descriptionstringfacoltativo
• reasonstringfacoltativo
• impactstringfacoltativo
• approveLabelstringfacoltativo
• planDayintegerfacoltativo

  Piano mobile di 3 giorni: 1 = oggi, 2 = domani, 3 = dopodomani. Ometti per una proposta singola.

• toolsarrayfacoltativo

  Ogni strumento di scrittura o sottoagente che eseguirà la scheda; [] per lavoro in sola lettura. La piattaforma calcola `critical` da questo elenco.

• ownerstringfacoltativo

  Chi esegue la scheda: ads-operator per modifiche agli annunci, cto per il sito, researcher, video oppure ceo.

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

• planstringfacoltativo

  Solo per l’agente, mai mostrato al fondatore: il piano Markdown completo eseguito e usato per valutare il lavoro (ambito, criteri di accettazione, link, rischi).

• areastringfacoltativo

  Dominio della scheda.

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

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Piattaforma da analizzare. Ometti per tutte le piattaforme.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Filtra per una piattaforma. Ometti per un aggregato multipiattaforma.

• fromDatestringfacoltativo

  Data iniziale (YYYY-MM-DD). Predefinita: 30 giorni fa.

• toDatestringfacoltativo

  Data finale (YYYY-MM-DD). Predefinita: oggi.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Filtra per piattaforma (facebook, instagram, linkedin, tiktok ecc.). Ometti per tutte.

• sortBystringfacoltativo

  Metrica per l’ordinamento. Predefinita: engagement.

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

• fromDatestringfacoltativo

  Data iniziale (YYYY-MM-DD). Predefinita: 90 giorni fa.

• toDatestringfacoltativo

  Data finale (YYYY-MM-DD). Predefinita: oggi.

• limitnumberfacoltativo

  Numero massimo di post da restituire (1-100, predefinito 10).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• draftsarrayobbligatorio

  Una voce per ogni post da preparare.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Piattaforma facoltativa che l’utente vuole collegare (es. "x", "instagram"). Mostrata come etichetta; la pagina connettori gestisce tutte le piattaforme.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• recipientNamestringfacoltativo
• recipientCompanystringfacoltativo
• recipientRolestringfacoltativo
• recipientIndustrystringfacoltativo
• signalsstringfacoltativo

  Segnali di acquisto/contesto su cui personalizzare.

• senderProductstringfacoltativo

  Cosa offre questo spazio di lavoro, usato per impostare la proposta.

• channelstringfacoltativo

  Predefinito email.

  Valori: email, linkedin

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• cursorstringfacoltativo

  `nextCursor` della pagina precedente.

• unreadOnlybooleanfacoltativo
• searchstringfacoltativo
• mailboxIdstringfacoltativo

  Solo questa casella (da vibiz_email_status (gruppo comms)).

• limitintegerfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• threadIdstringobbligatorio

  Da vibiz_email_list_threads (gruppo comms).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• threadIdstringobbligatorio

  Da vibiz_email_list_threads (gruppo comms).

• bodystringobbligatorio

  Risposta in testo semplice.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• tostringobbligatorio
• subjectstringobbligatorio
• bodystringobbligatorio

  Email in testo semplice.

• mailboxIdstringfacoltativo

  Casella da cui inviare (da vibiz_email_status (gruppo comms)); ometti per la prima abilitata all’invio.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• mailboxIdstringobbligatorio

  Da vibiz_email_status (gruppo comms).

• senderNamestringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Filtra per piattaforma.

• sortBystringfacoltativo

  Ordina per data o numero di commenti.

  Valori: date, comments

• limitnumberfacoltativo

  Numero massimo di post da restituire (1-50, predefinito 10).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• platformstringfacoltativo

  Filtra per piattaforma (instagram, facebook, twitter ecc.).

• limitnumberfacoltativo

  Numero massimo di conversazioni da restituire (1-50, predefinito 10).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• accountIdstringobbligatorio

  Account Instagram/Facebook su cui eseguire l’automazione. Deve appartenere al vibiz di destinazione.

• namestringobbligatorio

  Etichetta dell’automazione.

• dmMessagestringobbligatorio

  Messaggio diretto inviato automaticamente a ogni autore di commento.

• commentReplystringfacoltativo

  Risposta pubblica facoltativa pubblicata sul commento stesso.

• keywordsarrayfacoltativo

  Parole chiave di attivazione. OMESSE o vuote = attivazione su QUALSIASI commento (rispondi a tutti).

• matchModestringfacoltativo

  Modalità di corrispondenza delle parole chiave. Predefinita "contains".

  Valori: exact, contains

• platformPostIdstringfacoltativo

  Limita a un post (ID media della piattaforma, da `vibiz_inbox_comments` (gruppo comms)). Ometti per l’intero account.

• triggerstringfacoltativo

  Predefinito "comment". "story_reply" si attiva sulle risposte alle storie IG.

  Valori: comment, story_reply

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• automationIdstringobbligatorio

  Automazione da eliminare. Da `vibiz_inbox_list_comment_automations` (gruppo comms).

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• postIdstringobbligatorio

  Post di cui leggere i commenti. Da `vibiz_inbox_comments` (gruppo comms).

• accountIdstringobbligatorio

  Account proprietario del post (da `vibiz_inbox_comments` (gruppo comms)). Deve appartenere al vibiz di destinazione.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• conversationIdstringobbligatorio

  Conversazione da leggere. Da `vibiz_inbox_conversations` (gruppo comms).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• postIdstringobbligatorio

  Post che contiene il commento.

• commentIdstringobbligatorio

  Commento a cui rispondere.

• accountIdstringobbligatorio

  Account social da cui rispondere. Deve appartenere al vibiz di destinazione.

• messagestringobbligatorio

  Testo della risposta.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• postIdstringobbligatorio

  Post ai cui commenti rispondere. Da `vibiz_inbox_comments` (gruppo comms).

• accountIdstringobbligatorio

  Account da cui rispondere. Deve appartenere al vibiz di destinazione.

• repliesarrayobbligatorio

  Una voce per commento (massimo 50). Ogni messaggio deve essere unico e contestuale.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• postIdstringobbligatorio

  Post che contiene il commento. Da `vibiz_inbox_comments` (gruppo comms).

• commentIdstringobbligatorio

  Commento al cui autore inviare il messaggio. Da `vibiz_inbox_get_comments` (gruppo comms).

• accountIdstringobbligatorio

  Account da cui inviare. Deve appartenere al vibiz di destinazione.

• messagestringobbligatorio

  Testo del messaggio diretto privato.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• conversationIdstringobbligatorio

  Conversazione in cui inviare.

• accountIdstringobbligatorio

  Account social da cui inviare. Deve appartenere al vibiz di destinazione.

• messagestringobbligatorio

  Testo del messaggio.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• automationIdstringobbligatorio

  Automazione da attivare/disattivare. Da `vibiz_inbox_list_comment_automations` (gruppo comms).

• activebooleanobbligatorio

  true = avvia/riprendi, false = ferma/sospendi.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• channelIdstringfacoltativo

  ID del canale Slack, es. C0ATX….

• limitintegerfacoltativo

  Numero massimo di messaggi per canale.

• daysintegerfacoltativo

  Intervallo retrospettivo in giorni.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• querystringfacoltativo

  Filtro sul nome del canale senza distinzione tra maiuscole e minuscole.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• channelIdstringobbligatorio

  ID del canale Slack.

• textstringobbligatorio
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• memberIdstringobbligatorio

  Da `teammates` in vibiz_slack_list_channels (gruppo comms).

• textstringobbligatorio
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• channelIdstringobbligatorio

  ID del canale Slack.

• tsstringobbligatorio

  ts del messaggio iniziale, es. 1760000000.123456.

• limitintegerfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• offerIdstringobbligatorio
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• imageUrlsarrayfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• refreshbooleanfacoltativo
• pageUrlsarrayfacoltativo

  Pagine specifiche da leggere. Implica un aggiornamento.

• confirmobjectfacoltativo
• dismissobjectfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• titlestringobbligatorio
• markdownstringobbligatorio

  Corpo in Markdown (titoli, elenchi, tabelle).

• documentIdstringfacoltativo

  Modifica questo documento esistente anziché crearne uno.

Parametri

• brandobjectobbligatorio

  Dati strutturati del brand sintetizzati dal repository locale. Obbligatorio: `companyName`. Gli altri campi popolano WorkspaceBranding.

• workspaceNamestringfacoltativo

  Nome esplicito dello spazio di lavoro, facoltativo. Se omesso, deriva da `brand.companyName`.

Parametri

• websiteUrlstringobbligatorio

  URL di un sito (https://example.com) o di un profilo Instagram (instagram.com/handle). L’URL viene validato recuperando il sito o leggendo il profilo IG; gli URL irraggiungibili falliscono.

• workspaceNamestringfacoltativo

  Nome esplicito facoltativo. Se omesso, deriva dall’URL o dai contenuti raccolti.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• namestringobbligatorio
• titlestringfacoltativo
• descriptionstringfacoltativo
• demographicsobjectfacoltativo
• painPointsarrayfacoltativo
• goalsarrayfacoltativo
• channelsarrayfacoltativo
• landingSlugstringfacoltativo

  Base facoltativa dello slug per la landing page dell’ICP.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• titlestringobbligatorio
• descriptionstringfacoltativo
• priceCentsintegerfacoltativo

  Importo Stripe nell’unità minore della valuta (2900 = $29 USD, 500 = ¥500 JPY). Imposta 0 oppure ometti per offerte non acquistabili.

• priceCurrencystringfacoltativo
• iconEmojistringfacoltativo
• imageUrlstringfacoltativo

  URL pubblico dell’immagine di anteprima dell’offerta.

• sourcestringfacoltativo

  Etichetta di origine. Predefinita 'agent_chat'. Passa 'manual' quando l’utente aggiunge direttamente un prodotto al catalogo.

• scrapeUrlstringfacoltativo

  URL della pagina prodotto di origine quando la riga è stata estratta da una pagina prodotto. Conservato in sourceData per la tracciabilità.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• offerIdstringobbligatorio
• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• namestringobbligatorio

  Nome breve della persona (es. «Fondatore SaaS», «Genitore impegnato», «Giocatore Gen-Z»). Obbligatorio.

• titlestringfacoltativo

  Titolo professionale / ruolo facoltativo mostrato sotto il nome (es. «Responsabile marketing in un SaaS B2B da 50 persone»).

• descriptionstringfacoltativo

  Riepilogo facoltativo di un paragrafo: chi è, cosa lo motiva e come il brand si inserisce nella sua vita.

• demographicsobjectfacoltativo

  Blocco demografico facoltativo. Tutti i campi sono stringhe libere.

• painPointsarrayfacoltativo

  Elenco facoltativo di problemi / frustrazioni.

• goalsarrayfacoltativo

  Elenco facoltativo di obiettivi / risultati desiderati.

• channelsarrayfacoltativo

  Elenco facoltativo dei canali frequentati dalla persona (es. "TikTok", "LinkedIn", "Reddit r/SaaS").

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• titlestringobbligatorio

  Nome breve e incisivo dell’offerta (massimo ~100 caratteri). Es. «50% di sconto su tutto», «Prova gratuita di 14 giorni», «Pacchetto iniziale da $99».

• descriptionstringfacoltativo

  Dettagli facoltativi dell’offerta: condizioni, contenuti inclusi, proposta di valore. Massimo ~500 caratteri.

• priceCentsintegerfacoltativo

  Importo Stripe nell’unità minore della valuta (9900 = $99.00 USD, 500 = ¥500 JPY). Ometti per offerte gratuite / lead magnet.

• priceCurrencystringfacoltativo

  Codice valuta ISO. Predefinito "USD".

• typestringfacoltativo

  Tipo di modello di business. Predefinito "generic" in caso di dubbio.

  Valori: software, service, ecommerce, agency, generic

• iconEmojistringfacoltativo

  Un solo emoji che rappresenta visivamente l’offerta. Es. "🎁", "💰", "🚀".

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• icpIdstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• querystringfacoltativo

  Cosa cercare nei documenti caricati, es. «politica di rimborso» o «prezzi enterprise». Ometti per ottenere solo riepilogo ed elenco documenti.

• limitnumberfacoltativo

  Numero massimo di passaggi da restituire (1..25, predefinito 8).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• offerIdstringobbligatorio
• icpIdstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• categorystringfacoltativo

  Valori: product, lifestyle, team, screenshot, abstract

• limitintegerfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• limitintegerfacoltativo

  Numero massimo di pagine da restituire (predefinito 20).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• offerIdstringfacoltativo

  Solo questa offerta (facoltativo).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• displaybooleanfacoltativo

  Imposta true se l’utente deve vedere la galleria Prodotti integrata nella chat.

• purposestringfacoltativo

  Quando display=true, catalog = esplora i prodotti; product_picker = scegli un prodotto prima della generazione.

  Valori: catalog, product_picker

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• keystringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• keystringobbligatorio
• valuestringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• hasProductGroundingbooleanfacoltativo

  Imposta true solo se la prossima generazione ha già un’offerta/prodotto/immagine di riferimento concreta. Lo stato del catalogo e-commerce diventa così informativo anziché bloccante.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• namestringobbligatorio
• bodyMdstringobbligatorio
• kindstringfacoltativo

  Valori: workflow, goal, lesson

• triggerstringfacoltativo

  Solo flusso di lavoro: quando si applica, in prosa.

• statusstringfacoltativo

  Valori: proposed, active, archived

Parametri

• tzstringfacoltativo

  Fuso orario IANA (es. "Asia/Kolkata", "Europe/Rome", "America/New_York"). Predefinito UTC.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• offerIdstringobbligatorio
• icpIdstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• companyNamestringfacoltativo
• headlinestringfacoltativo
• websiteUrlstringfacoltativo
• logoUrlstringfacoltativo
• logoConversationImageIdstringfacoltativo

  Se l’utente ha caricato un logo in chat, passa l’ID della conversazione indicato come image-N. Non copiare mai URL degli allegati in logoUrl.

• colorsobjectfacoltativo
• fontsobjectfacoltativo
• tonestringfacoltativo
• energystringfacoltativo
• targetAudiencestringfacoltativo
• languagestringfacoltativo
• formalitystringfacoltativo

  Valori: formal, informal, neutral

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• icpIdstringobbligatorio
• namestringfacoltativo
• titlestringnullfacoltativo
• descriptionstringnullfacoltativo
• demographicsobjectnullfacoltativo
• painPointsarraynullfacoltativo
• goalsarraynullfacoltativo
• channelsarraynullfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• sectionstringfacoltativo

  Titolo della sezione da sostituire. Ometti per sostituire l’intero riepilogo.

• contentstringobbligatorio

  Riepilogo completo rivisto, oppure nuovo corpo di `section` se indicata.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• offerIdstringobbligatorio
• titlestringfacoltativo
• descriptionstringfacoltativo
• priceCentsintegerfacoltativo

  Importo Stripe nell’unità minore della valuta (2900 = $29 USD, 500 = ¥500 JPY).

• priceCurrencystringfacoltativo
• iconEmojistringfacoltativo
• statusstringfacoltativo

  Valori: draft, published, active

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• docstringobbligatorio

  Valori: company, member

• memberIdstringfacoltativo

  Obbligatorio quando doc è 'member'.

• contentstringobbligatorio

  Markdown completo rivisto del documento scelto.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• competitorsarrayfacoltativo

  Nomi di brand o domini indicati dall’utente. Ometti per usare i concorrenti salvati (gratuito).

• maxCompetitorsintegerfacoltativo

  Numero di concorrenti. Predefinito 5; di più solo se richiesto dall’utente.

• adsPerCompetitorintegerfacoltativo
• countrystringfacoltativo

  Paese ISO per una ricerca per nome. Predefinito: mercato dello spazio di lavoro.

• includeImagesbooleanfacoltativo

  Allega le immagini degli annunci come contenuti immagine per poterle vedere. Predefinito true.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• refreshbooleanfacoltativo

  Forza una nuova ricerca anziché restituire l’elenco salvato. Costa crediti. Predefinito false.

• countriesarrayfacoltativo

  Codici paese ISO per la ricerca nella libreria annunci, es. ["US","GB"]. Usati solo in una nuova esecuzione. Predefinito ["US"].

• hintstringfacoltativo

  Indicazione facoltativa di posizionamento per orientare la ricerca, es. «concentrati sugli strumenti AI per creatività pubblicitarie». Usata solo in una nuova esecuzione.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• qstringfacoltativo

  Testo libero confrontato con descrizione, parlato, testo a schermo, archetipo, modalità espressiva ed etichette, es. «problema esplicito» o «cura della pelle».

• aspectstringfacoltativo

  Valori: 9:16, 1:1, 16:9

• limitintegerfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• querystringfacoltativo
• emotionstringfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• qstringfacoltativo
• limitintegerfacoltativo

Parametri

• symbolstringobbligatorio

  Ticker o simbolo della valuta (BTC, ETH, AAPL, TSLA, ...)

• kindstringfacoltativo

  Tipo di attività finanziaria. Predefinito "auto" (prova prima criptovalute, poi azioni).

  Valori: auto, crypto, stock

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• urlstringobbligatorio

  URL pubblico del post TikTok, Instagram, Facebook o X da leggere (es. https://www.tiktok.com/@user/video/123). Facebook accetta link a post, foto, reel/video e condivisioni (facebook.com/share/…, fb.watch/…), non link a pagine.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• querystringobbligatorio

  Nicchia / parola chiave da cercare nella libreria inserzioni Meta. Esempi: «cereali», «assicurazione animali», «barrette proteiche», «onboarding SaaS». Obbligatoria per discover; per scrape è obbligatoria SALVO se `pageId` è impostato.

• countrystringfacoltativo

  Codice paese ISO, es. 'US', 'GB', 'DE', 'IT'.

• modestringfacoltativo

  'discover' restituisce inserzionisti unici (economico, ~$4). 'scrape' restituisce righe complete di annunci (costoso, ~$7+ in base al limite).

  Valori: discover, scrape

• sampleSizeintegerfacoltativo

  Annunci da campionare in modalità discover. Più annunci = più inserzionisti unici, ma costo linearmente maggiore. Ignorato in modalità scrape.

• pageIdstringfacoltativo

  ID della pagina Facebook da una risposta `discover` precedente. Solo modalità scrape: se impostato, limita la raccolta agli annunci di quell’inserzionista (più efficiente per dollaro rispetto a una ricerca per parola chiave).

• limitintegerfacoltativo

  Numero massimo di annunci in modalità scrape. Costo lineare: limit * ~$0.14. Ignorato in modalità discover.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• querystringobbligatorio
• limitintegerfacoltativo
• orientationstringfacoltativo

  Valori: landscape, portrait, squarish

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• queriesarrayobbligatorio
• limitintegerfacoltativo
• tonestringfacoltativo

  Valori: light, dark

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• nichestringobbligatorio

  Tema/nicchia/parola chiave di cui cercare le tendenze (es. «cura della pelle maschile», «strumenti AI per la produttività»).

• platformsarrayfacoltativo

  Piattaforme da esaminare. Predefinite TikTok + Instagram.

• modestringfacoltativo

  discover = campione economico; deep = raccolta più ampia e costosa.

  Valori: discover, deep

• confirmbooleanfacoltativo

  Obbligatorio per una raccolta `deep`: conferma il costo della raccolta dati. Senza, una richiesta deep restituisce una verifica preventiva del costo senza spendere. Ignorato per `discover`.

• daysintegerfacoltativo

  Intervallo recente in giorni. Predefinito 14 (~2 settimane, consigliato). Amplia (es. 30) per nicchie lente o restringi (es. 3) per ciò che è in voga ora.

Parametri

• urlstringobbligatorio

  URL da recuperare (con o senza https://)

• includeScreenshotbooleanfacoltativo

  Indica se acquisire uno screenshot dell’area visibile. Predefinito true.

Parametri

• querystringobbligatorio

  Query di ricerca

• sourcesarrayfacoltativo

  Fonti da cercare. Predefinite ["web", "news"]. Usa solo ["web"] per ricerche non relative a notizie, per contenere la risposta.

• limitnumberfacoltativo

  Numero massimo di risultati da restituire (1-10). Predefinito 5.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• contact_job_titlearrayfacoltativo

  Ruoli professionali di destinazione, es. ["CEO", "CMO"].

• contact_not_job_titlearrayfacoltativo

  Ruoli professionali da escludere.

• seniority_levelarrayfacoltativo

  Livelli di anzianità, es. ["c_suite", "vp", "director"].

• contact_locationarrayfacoltativo

  Paesi / regioni di destinazione, es. ["United States"].

• company_industryarrayfacoltativo

  Settori (tassonomia LinkedIn). Per SaaS, passa ["computer software", "internet", "information technology & services"]: il valore letterale "saas" è documentato ma rifiutato dall’attore.

• company_keywordsarrayfacoltativo

  Parole chiave che descrivono l’azienda.

• company_domainarrayfacoltativo

  Domini aziendali specifici a cui rivolgersi.

• sizearrayfacoltativo

  Fasce di numero di dipendenti, es. ["11-50", "51-200"].

• min_revenuestringfacoltativo
• max_revenuestringfacoltativo
• fundingarrayfacoltativo
• email_statusarrayfacoltativo

  Valore predefinito ["validated"].

• fetch_countnumberfacoltativo

  Numero di lead da recuperare (10..10000). Le esecuzioni piccole sostengono un costo fisso sproporzionato; preferisci >=50.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• emailstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• leadIdstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• limitintegerfacoltativo

  Persone lette prima del raggruppamento (predefinito 500).

• topNintegerfacoltativo

  Righe per dettaglio (predefinito 12).

• sampleintegerfacoltativo

  Singole persone restituite (predefinito 25; 0 per soli conteggi).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• limitnumberfacoltativo

  Numero massimo di lead da mostrare (1..50, predefinito 24).

• displaybooleanfacoltativo

  Imposta true se l’utente deve vedere la bacheca lead integrata nella chat.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• scopestringfacoltativo

  upcoming = prima i più vicini (predefinito); past = prima i più recenti.

  Valori: upcoming, past

• limitintegerfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• meetingIdstringobbligatorio

  ID dell’incontro da vibiz_list_meetings (gruppo crm).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• daysintegerfacoltativo

  Intervallo in giorni (predefinito 30).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• leadIdstringobbligatorio
• statusstringobbligatorio

  Valori: new, qualified, contacted, replied, disqualified

• reasonstringobbligatorio

  Motivo dello stato: prove concrete mostrate nella cronologia CRM.

• notesstringfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• promptstringobbligatorio

  Descrivi la landing page: cosa vende, messaggio principale, CTA primaria, pubblico e tono. Il generatore scrive i testi: descrivi solo l’obiettivo. Massimo 500 caratteri conservati.

• qualificationbooleanfacoltativo

  Facoltativo. Imposta true per costruire un funnel di qualificazione lead (questionario in più passaggi + paywall/restrizioni di accesso) anziché una singola landing page. Predefinito: false.

• creativeIdstringfacoltativo

  ID campaign_ad facoltativo da usare come immagine principale/riferimento della pagina.

• creativeImageUrlstringfacoltativo

  URL immagine facoltativo da inserire come immagine principale (alternativa a creativeId).

• allowPartialBrandbooleanfacoltativo

  Eccezione per la bozza. Predefinito false. Imposta true solo se l’utente chiede esplicitamente di generare prima che onboarding, brand o configurazione del prodotto siano pronti; il risultato potrebbe non essere coerente con il brand.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• funnelIdstringobbligatorio

  ID del funnel esistente da riscrivere. Recuperalo dallo spazio di lavoro dell’utente (funnel recente) oppure chiedi di crearne prima uno tramite `vibiz_generate_funnel` (gruppo sites).

• promptstringobbligatorio

  Descrivi il flusso di qualificazione/accesso: campi da raccogliere, cosa limita il paywall, domande da porre e destinazione della CTA. Il generatore scrive il proprio HTML: descrivi l’obiettivo.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• intentstringobbligatorio

  Scopo della pagina, es. «Landing page per il programma di coaching di 12 settimane».

• labelstringfacoltativo

  Due o tre parole che nominano la pagina.

• headlinestringfacoltativo
• subheadlinestringfacoltativo
• ctaLabelstringfacoltativo

  Testo esatto del pulsante, es. «Prenota una chiamata».

• navLinksarrayobbligatorio

  Da due a quattro voci di navigazione, ciascuna per una sezione di QUESTA pagina.

• herostringobbligatorio

  La prima schermata intorno al titolo: posizione del testo e contenuto dello spazio restante.

• sectionsarrayobbligatorio

  Ogni sezione dopo quella iniziale, dall’alto in basso, fino alla fascia conclusiva con invito all’azione. Il piè di pagina viene aggiunto automaticamente.

• icpIdstringfacoltativo
• offerIdstringfacoltativo
• requestKeystringfacoltativo

  Chiave di idempotenza facoltativa: una chiamata ripetuta con la stessa chiave riusa l’immagine invece di generarne un’altra.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• sitestringfacoltativo

  Valori: source, workspace

• devicesarrayfacoltativo

  Formati di visualizzazione da restituire (predefiniti desktop e mobile).

• pageUrlstringfacoltativo

  Una pagina specifica del sito (es. la pagina Chi siamo). Predefinito: sito selezionato.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• includeInFlightbooleanfacoltativo
• includeFailedbooleanfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• funnelIdstringobbligatorio

  ID del funnel da vibiz_list_landing_pages (gruppo sites).

• pathstringfacoltativo

  Percorso pubblico sul dominio dell’organizzazione. `/` = homepage.

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• funnelIdstringobbligatorio

  Funnel da esaminare, da vibiz_list_landing_pages (gruppo sites).

• intentstringfacoltativo

  Cosa doveva fare la pagina, così il valutatore giudica rispetto all’obiettivo. In assenza usa il prompt del funnel.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• daysintegerfacoltativo

  Intervallo in giorni (predefinito 7), confrontato con il precedente della stessa durata.

• pageLimitintegerfacoltativo

  Quanti percorsi elencare con visualizzazioni e visitatori (predefinito 8). Aumenta per trovare una pagina specifica.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• namestringobbligatorio

  Etichetta breve, es. 'Verifica mattutina'.

• briefTemplatestringobbligatorio

  Cosa fa l’agente a ogni attivazione: solo istruzioni imperative, senza indicazioni di pianificazione temporale.

• assignedTostringfacoltativo

  ID dell’agente nell’organigramma che la esegue, es. 'cto'. Predefinito 'ceo'.

• presetstringfacoltativo

  Frequenza predefinita. Valore iniziale daily.

  Valori: hourly, daily, weekly, every_6h

• intervalSecondsintegerfacoltativo

  Intervallo personalizzato in secondi. Usa il valore predefinito O questo.

• firstRunLocalTimestringfacoltativo

  Ora locale in formato 24h della prima esecuzione, es. '10:00'.

• timezonestringfacoltativo

  Fuso IANA alternativo; predefinito quello dello spazio di lavoro. Impostalo solo se il fondatore ne indica uno.

• enabledbooleanfacoltativo

  Valore predefinito true.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• routineIdstringobbligatorio

  ID della routine da vibiz_list_routines (gruppo autonomy).

• approval_tokenstringfacoltativo

  Solo da vibiz_review_action, dopo che la chiamata ha risposto approval_required. Non inventarlo, riutilizzarlo o modificarlo.

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• taskIdstringobbligatorio

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• statusarrayfacoltativo

  Solo schede con questi stati (facoltativo).

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• assignedTostringfacoltativo

  Solo attività di questo agente, es. 'cto'.

• statusarrayfacoltativo

  Solo attività con questi stati.

• parentTaskIdstringnullfacoltativo

  ID di un’attività per le sue sottoattività, oppure null per le sole attività principali.

• planDayintegerfacoltativo

  Solo attività etichettate con questo giorno del piano.

• limitintegerfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• subjectstringobbligatorio

  Cosa viene testato, es. «oggetti delle email di benvenuto».

• axisstringobbligatorio

  Valori: creative, icp, email, offer

• variantsarrayobbligatorio
• panelSizeintegerfacoltativo

  Persone da intervistare. Ometti per adattare il numero al budget simulato.

• icpIdsarrayfacoltativo

  Limita il gruppo a questi ICP (da vibiz_list_icps (gruppo workspace)).

• budgetnumberfacoltativo

  Budget pubblicitario GIORNALIERO simulato in dollari interi.

• daysintegerfacoltativo

  Giorni di durata della campagna simulata (predefinito 7).

• platformstringfacoltativo

  Provenienza del traffico; modifica comportamento delle persone e CPM.

  Valori: tiktok, meta, linkedin, email, other

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• rationalestringobbligatorio

  Perché stai effettuando questa modifica.

• statusUpdatesarrayfacoltativo
• objectiveEditsarrayfacoltativo

Parametri

• targetobjectfacoltativo

  Brand su cui agire: {"vibiz":"<slug from list_vibiz>"}. Ometti se il connettore è fissato a un solo brand. Non ripiegare mai su un altro brand; per un brand non elencato serve vibiz_onboard_brand.

• organizationIdstringfacoltativo

  ID dell’organizzazione Clerk (facoltativo se l’autenticazione è limitata all’organizzazione)

• routineIdstringobbligatorio

  ID della routine da vibiz_list_routines (gruppo autonomy).

• enabledbooleanfacoltativo

  false sospende la routine, true la riprende.

• namestringfacoltativo
• briefTemplatestringfacoltativo

  Cosa fa l’agente a ogni attivazione: solo istruzioni imperative, senza indicazioni di pianificazione temporale.

• presetstringfacoltativo

  Valori: hourly, daily, weekly, every_6h

• intervalSecondsintegerfacoltativo