Herramientas de Meta
Campañas de Facebook e Instagram, conjuntos de anuncios, públicos, creatividades, resultados de formularios y estimaciones de alcance.
La integración de este canal está lista; la conexión se abrirá cuando la plataforma apruebe nuestra aplicación de desarrollador. Hasta entonces no se pueden conectar cuentas y las acciones descritas en esta página no están disponibles.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura32 herramientas
list_meta_ad_accounts
Lectura1 créditosCuentas publicitarias de Meta accesibles con el token de Meta conectado: id (act_…), nombre, moneda, estado, zona horaria, gasto acumulado, empresa y cuál está seleccionada. Solo lectura; connected=false si Meta no está vinculado.
Esta herramienta no recibe parámetros.
meta_insights_report
Lectura2 créditosRendimiento de Facebook + Instagram (Meta Insights) a nivel de campaña, conjunto de anuncios o anuncio para un rango de fechas, opcionalmente desglosado por edad, género, ubicación o dispositivo: gasto, impresiones, alcance, frecuencia, clics, CTR, CPM, CPC, conversiones, ingresos, ROAS (purchase_roas) y CPA (cost_per_action_type). Ordena por cualquier métrica y filtra con umbrales (p. ej. roas_below=3 ordenado por gasto, cpa_above=40). Solo datos reales.
| Parámetro | Tipo | Descripción |
|---|---|---|
levelOpcional | campaign | adset | ad | — |
daysOpcional | integer (1–1125) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
date_presetOpcional | today | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_month | instead of days/start_date/end_date |
breakdownOpcional | none | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | region | placement = publisher_platform + platform_position; device = impression_device |
conversion_eventOpcional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | tipo de resultado usado para conversiones y CPA (por defecto purchase) |
campaign_idsOpcional | array<string> | — |
adset_idsOpcional | array<string> | — |
ad_idsOpcional | array<string> | — |
sort_byOpcional | spend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc | — |
sort_orderOpcional | desc | asc | — |
min_spendOpcional | number | — |
roas_belowOpcional | number | — |
roas_aboveOpcional | number | — |
cpa_aboveOpcional | number | — |
cpa_belowOpcional | number | — |
frequency_aboveOpcional | number | — |
limitOpcional | integer (1–500) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_top_creatives
Lectura2 créditosAnuncios (creatividades) de Meta con mejor rendimiento en una ubicación como Instagram Reels, ordenados por ROAS, CPA, conversiones o CTR, con detalles de la creatividad (miniatura, vídeo, enlace permanente de Instagram) y los ids de sus conjuntos de anuncios para duplicarlos.
| Parámetro | Tipo | Descripción |
|---|---|---|
placementOpcional | string | all | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (se compara con publisher_platform:platform_position) |
metricOpcional | roas | cpa | conversions | ctr | spend | revenue | — |
conversion_eventOpcional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | tipo de resultado usado para conversiones y CPA (por defecto purchase) |
daysOpcional | integer (1–1125) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
limitOpcional | integer (1–25) | — |
min_spendOpcional | number | — |
campaign_idsOpcional | array<string> | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_audiences
Lectura1 créditosAudiencias personalizadas y similares de la cuenta publicitaria de Meta: id, nombre, subtipo, rango de tamaño aproximado, retención, estado de entrega.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
search_meta_interests
Lectura1 créditosBusca en la taxonomía de intereses de Meta (búsqueda de segmentación) por palabra clave: id del interés, nombre, ruta y rango de tamaño de audiencia. Usa los ids en targeting.interest_ids.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryOpcional | string | — |
limitOpcional | integer (1–100) | — |
localeOpcional | string | p. ej. tr_TR, en_US |
kindOpcional | interest | behavior | life_event | industry | family_status | income | demographic | interest (default) or a detailed-targeting category |
category_classOpcional | string | raw adTargetingCategory class, overrides kind |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_reach_estimate
Lectura2 créditosTamaño de audiencia estimado para una segmentación antes de gastar (estimación de entrega de Meta, con respaldo en la estimación de alcance): rango de usuarios activos mensuales y usuarios diarios.
| Parámetro | Tipo | Descripción |
|---|---|---|
targetingObligatorio | object | — |
optimization_goalOpcional | string | REACH (por defecto), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idOpcional | string | — |
custom_event_typeOpcional | string | p. ej. PURCHASE (con pixel_id) |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_ad_sets
Lectura1 créditosConjuntos de anuncios de Meta con estado, presupuesto diario/total (moneda de la cuenta), puja, objetivo de optimización, segmentación y calendario.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | — |
adset_idsOpcional | array<string> | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_instagram_posts
Lectura1 créditosPublicaciones recientes de Instagram de la cuenta de empresa conectada con me gusta, comentarios e interacción, ordenadas por interacción, para elegir una publicación que promocionar.
| Parámetro | Tipo | Descripción |
|---|---|---|
instagram_user_idOpcional | string | — |
limitOpcional | integer (1–100) | — |
sort_byOpcional | engagement | recent | — |
list_meta_conversations
Lectura1 créditosMessenger or Instagram Direct conversations of the Facebook Page (and its linked Instagram account): participants, unread count, last message preview. Read only; reply with reply_customer.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | — |
platformOpcional | messenger | instagram | — |
limitOpcional | integer (1–50) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_lead_forms
Lectura1 créditosFormularios de clientes potenciales (instantáneos) de la página de Facebook con estado y recuento de leads. No se admite la creación de formularios nuevos.
| Parámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_lead_form_summary
Lectura2 créditosRecuento de leads de un formulario durante los últimos N días, por día, por anuncio y por plataforma. Solo recuentos; nunca se devuelven respuestas personales.
| Parámetro | Tipo | Descripción |
|---|---|---|
form_idObligatorio | string | — |
page_idOpcional | string | — |
daysOpcional | integer (1–90) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_catalogs
Lectura1 créditosCatálogos de productos de las empresas de Meta del usuario (Commerce Manager): id, nombre, número de productos, sector, empresa. Requiere catalog_management; connected=false si Meta no está vinculado.
| Parámetro | Tipo | Descripción |
|---|---|---|
business_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_catalog_products
Lectura1 créditosProductos de un catálogo de Meta con id de minorista, precio, disponibilidad, estado, URL, imagen, estado de revisión y motivos de rechazo; filtra por estado de revisión o filtro Graph. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
catalog_idObligatorio | string | id del catálogo de productos de Meta (list_meta_catalogs) |
queryOpcional | string | el nombre contiene |
review_statusOpcional | approved | rejected | pending | outdated | — |
filterOpcional | object | filtro de productos Graph, p. ej. {"retailer_id": {"eq": "SKU1"}} |
limitOpcional | integer (1–1000) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_product_sets
Lectura1 créditosConjuntos de productos de un catálogo de Meta (id, nombre, número de productos, filtro) para conjuntos de anuncios de ventas del catálogo, más los feeds de productos del catálogo con el resultado de su última carga. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
catalog_idObligatorio | string | id del catálogo de productos de Meta (list_meta_catalogs) |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_pages
Lectura1 créditosPáginas de Facebook que gestiona el usuario de Meta conectado (id, nombre, categoría, tareas, cuenta de Instagram vinculada) o, con promotable_only, las páginas que la cuenta publicitaria puede promocionar. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
promotable_onlyOpcional | boolean | solo las páginas que puede promocionar la cuenta publicitaria seleccionada |
list_meta_campaigns
Lectura1 créditosCampañas existentes en la cuenta publicitaria de Meta (incluidas las creadas fuera de esta app): id, nombre, estado, objetivo, presupuesto diario/total en la moneda de la cuenta, estrategia de puja, calendario. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
effective_statusOpcional | array<string> | p. ej. ACTIVE, PAUSED |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_ads
Lectura1 créditosAnuncios de Meta de la cuenta, de un conjunto de anuncios o de una campaña: id, nombre, estado, estado efectivo, conjunto de anuncios, id de creatividad y miniatura. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idOpcional | string | — |
campaign_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_page_posts
Lectura1 créditosPublicaciones recientes de una página de Facebook con texto, imagen y enlace permanente, para reutilizar una publicación orgánica como anuncio (object_story_id). Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | — |
limitOpcional | integer (1–100) | — |
list_meta_pixels
Lectura1 créditosPíxeles de Meta (conjuntos de datos) de la cuenta publicitaria con nombre y hora de la última activación. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_insights_query
Lectura2 créditosLectura libre de la Meta Insights API para todo lo que no cubren los informes listos: cualquier campo, desglose, desglose de acciones, filtro e incremento temporal que admita Meta. Devuelve filas sin procesar. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
fieldsObligatorio | array<string> | campos de Insights, p. ej. spend, reach, actions, video_p75_watched_actions |
levelOpcional | account | campaign | adset | ad | — |
breakdownsOpcional | array<string> | p. ej. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone |
action_breakdownsOpcional | array<string> | p. ej. action_type, action_device |
daysOpcional | integer (1–1125) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
time_incrementOpcional | string | 1 = diario, 7 = semanal, monthly, all_days |
filteringOpcional | array<object> | filtros de Graph [{field, operator, value}] |
limitOpcional | integer (1–5000) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_instagram_accounts
Lectura1 créditosCuentas de Instagram utilizables en anuncios: las vinculadas a la cuenta publicitaria y las vinculadas a las páginas de Facebook del usuario (id, nombre de usuario, página). Solo lectura.
Esta herramienta no recibe parámetros.
list_meta_saved_audiences
Lectura1 créditosAudiencias guardadas (ajustes de segmentación reutilizables de Ads Manager) con su segmentación y tamaño aproximado. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
list_meta_custom_conversions
Lectura1 créditosConversiones personalizadas de la cuenta publicitaria: id, nombre, regla (URL / evento), tipo de evento, píxel, última activación, valor predeterminado. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
include_archivedOpcional | boolean | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
diagnose_meta_delivery
Lectura2 créditosDiagnóstico de entrega EN VIVO de una campaña de Meta. Llámala primero cuando el usuario informe de un estado o una advertencia (no se entrega, con problemas, en aprendizaje, limitada, rechazada). Devuelve la campaña, sus conjuntos de anuncios y sus anuncios con el estado efectivo, los problemas que Meta indica que bloquean la entrega (issues_info: nivel, código de error, resumen, mensaje), la fase de aprendizaje de cada conjunto, la estrategia de puja, el importe de la puja, el presupuesto y el presupuesto restante, el resultado de la revisión de cada anuncio y una lista de hallazgos. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Meta (list_meta_campaigns) o id de campaña de Tecrübe |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_change_history
Lectura2 créditosHistorial de actividad de la cuenta publicitaria de Meta: quién cambió qué y cuándo (presupuesto, estado, segmentación, ediciones de creatividades), con valores anteriores/nuevos cuando Meta los proporciona. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
sinceOpcional | string | YYYY-MM-DD |
untilOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–365) | — |
levelOpcional | string | filtrar por tipo de objeto: campaign | adset | ad | account … |
limitOpcional | integer (1–1000) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_delivery_estimate
Lectura1 créditosEstimación de entrega de Meta para la segmentación actual de un conjunto de anuncios existente: usuarios mensuales alcanzables, usuarios diarios y la curva de resultados esperados, sin gastar. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
optimization_goalOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
preview_meta_ad
Lectura1 créditosGenera una vista previa de una creatividad o anuncio de Meta en un formato de ubicación (feed, story, reels …) sin publicar; devuelve una URL de vista previa temporal. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
creative_idOpcional | string | — |
ad_idOpcional | string | — |
ad_formatOpcional | DESKTOP_FEED_STANDARD | MOBILE_FEED_STANDARD | INSTAGRAM_STANDARD | INSTAGRAM_STORY | INSTAGRAM_REELS | FACEBOOK_STORY_MOBILE | FACEBOOK_REELS_MOBILE | RIGHT_COLUMN_STANDARD | MARKETPLACE_MOBILE | AUDIENCE_NETWORK_OUTSTREAM_VIDEO | MESSENGER_MOBILE_INBOX_MEDIA | INSTAGRAM_EXPLORE_GRID_HOME | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
get_meta_ad_creative
Lectura1 créditosLee la creatividad actual de un anuncio: título, texto principal, descripción, imagen o vídeo, botón, enlace de destino, identidad de página / Instagram y qué funciones de creatividad Advantage+ están activadas. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
find_instagram_media_id
Lectura1 créditosResuelve el enlace de una publicación o Reel de Instagram a su id de medio (necesario para boost_instagram_post) recorriendo los medios de la cuenta de empresa de Instagram seleccionada. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
urlObligatorio | string | — |
ig_user_idOpcional | string | — |
instagram_follower_growth
Lectura1 créditosNuevos seguidores diarios de una cuenta de empresa de Instagram en los últimos 30 días como máximo, más el número actual de seguidores, para medir campañas de seguidores y visitas al perfil. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
ig_user_idOpcional | string | — |
daysOpcional | integer (1–30) | — |
download_meta_leads
Lectura1 créditosDescarga las respuestas enviadas a través de un formulario instantáneo de Meta (cada pregunta, además del anuncio, el conjunto de anuncios y la campaña de cada cliente potencial). Datos personales: requiere leads_retrieval; trátalos dentro del consentimiento del formulario. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
form_idObligatorio | string | — |
page_idOpcional | string | — |
limitOpcional | integer (1–2000) | — |
sinceOpcional | string | YYYY-MM-DD |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
meta_targeting_helper
Lectura1 créditosTres ayudas al crear la segmentación de Meta: sugiere intereses similares a los que ya tienes, comprueba si un id o un nombre de interés sigue siendo utilizable (un conjunto de anuncios con un interés no válido se rechaza) o lee los presupuestos diarios mínimos de la cuenta. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
modeOpcional | suggest | validate | minimum_budget | — |
interest_idsOpcional | array<string> | — |
namesOpcional | array<string> | — |
limit_typeOpcional | interests | behaviors | income | life_events | — |
is_exclusionOpcional | boolean | — |
bid_amountOpcional | integer | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramientas de escritura38 herramientas
select_meta_ad_account
Escritura1 créditosElige en qué cuenta publicitaria de Meta trabajan todas las herramientas Meta siguientes (agencia / multicuenta). Solo se aceptan cuentas a las que el usuario tiene acceso.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_website_audience
Escritura2 créditosCrea una audiencia personalizada de sitio web a partir del píxel de Meta (p. ej. añadieron al carrito en los últimos 30 días pero no compraron). Primero vista previa y aprobación; la audiencia se llena en horas.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
eventObligatorio | string | evento del píxel: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView … |
retention_daysOpcional | integer (1–180) | — |
exclude_eventOpcional | string | p. ej. Purchase para abandonos de carrito |
pixel_idOpcional | string | — |
descriptionOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_lookalike_audience
Escritura2 créditosCrea una audiencia similar de Meta (1–10 %) a partir de una audiencia personalizada en uno o varios países. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
source_audience_idObligatorio | string | — |
countriesObligatorio | array<string> | códigos ISO |
ratio_percentOpcional | number (1–10) | 1 = el 1 % más parecido |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_campaign
Escritura2 créditosCrea una campaña de Meta de principio a fin (campaña + conjunto de anuncios + anuncio cuando existen página y creatividad) como borrador pausado con objetivo, presupuesto diario y segmentación. Escribe un borrador en el libro y un elemento de aprobación; se envía a Meta solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
objectiveObligatorio | sales | traffic | engagement | messages | awareness | — |
daily_budgetOpcional | number | moneda de la cuenta |
goalOpcional | string | — |
special_ad_categoriesOpcional | array<string> | CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES |
audienceOpcional | object | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_meta_campaign
Escritura2 créditosCambia el presupuesto (diario/total), estado, nombre, estrategia de puja o límite de gasto de una campaña de Meta. Vista previa con antes → después; se bloquean los aumentos de presupuesto superiores al +50 % por paso. Se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Meta o id de campaña de Tecrube |
daily_budgetOpcional | number | ad account currency |
lifetime_budgetOpcional | number | — |
currencyOpcional | string | optional ISO check; must equal the ad account currency |
statusOpcional | ACTIVE | PAUSED | ARCHIVED | — |
nameOpcional | string | — |
bid_strategyOpcional | string | LOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS |
spend_capOpcional | number | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_meta_ad_set
Escritura2 créditosCambia el presupuesto, estado, segmentación (ubicaciones, edad, género, intereses, audiencias, ubicaciones de anuncio), puja o calendario de un conjunto de anuncios de Meta. Primero vista previa y aprobación; se aplica la barrera de presupuesto.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
daily_budgetOpcional | number | ad account currency |
lifetime_budgetOpcional | number | — |
currencyOpcional | string | optional ISO check; must equal the ad account currency |
statusOpcional | ACTIVE | PAUSED | ARCHIVED | — |
nameOpcional | string | — |
bid_strategyOpcional | string | — |
bid_amountOpcional | number | — |
targetingOpcional | object | — |
start_timeOpcional | string | ISO 8601 |
end_timeOpcional | string | ISO 8601 |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
duplicate_meta_ad_set
Escritura2 créditosDuplica un conjunto de anuncios ganador de Meta (con sus anuncios) como copia pausada y asígnale una nueva audiencia de intereses, segmentación o presupuesto para una prueba. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
interest_idsOpcional | array<string> | sustituye los intereses y conserva el resto de la segmentación |
targetingOpcional | object | — |
daily_budgetOpcional | number | — |
nameOpcional | string | — |
bid_amountOpcional | number | — |
start_timeOpcional | string | — |
end_timeOpcional | string | — |
deep_copyOpcional | boolean | — |
rename_suffixOpcional | string | — |
target_campaign_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
pause_meta_ad_sets_above_cpa
Escritura2 créditosEncuentra conjuntos de anuncios activos de Meta con CPA por encima de un umbral (o que gastaron al menos el umbral sin resultados), los pausa en una sola acción y traslada su presupuesto diario liberado al conjunto con mejor CPA dentro de la barrera del +50 %. Muestra la lista primero; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
cpa_thresholdObligatorio | number | moneda de la cuenta |
conversion_eventOpcional | purchase | lead | add_to_cart | complete_registration | messaging | app_install | link_click | tipo de resultado usado para conversiones y CPA (por defecto purchase) |
daysOpcional | integer (1–1125) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
min_spendOpcional | number | — |
campaign_idsOpcional | array<string> | — |
reallocateOpcional | boolean | trasladar el presupuesto diario de los conjuntos pausados al mejor conjunto (por defecto true) |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_carousel_ad
Escritura2 créditosCrea un anuncio de carrusel de Meta (2–10 tarjetas de imagen, p. ej. cinco imágenes de producto) en un conjunto de anuncios para Facebook e Instagram. Las imágenes del estudio se suben a Meta (adimages). Se crea pausado tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
nameOpcional | string | — |
linkObligatorio | string | — |
messageOpcional | string | texto principal |
cardsObligatorio | array<object> | — |
call_to_actionOpcional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
optimize_card_orderOpcional | boolean | — |
page_idOpcional | string | — |
instagram_user_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_video_ad
Escritura2 créditosCrea un anuncio de vídeo de Meta a partir de un id de vídeo existente en un conjunto de anuncios (la miniatura se toma del vídeo si no se indica). Se crea pausado tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
video_idOpcional | string | id del vídeo en la cuenta publicitaria de Meta |
video_urlOpcional | string | public https video URL; Meta fetches it (instead of video_id) |
linkObligatorio | string | — |
nameOpcional | string | — |
messageOpcional | string | — |
titleOpcional | string | — |
call_to_actionOpcional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
thumbnail_urlOpcional | string | — |
page_idOpcional | string | — |
instagram_user_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
boost_instagram_post
Escritura2 créditosConvierte una publicación de Instagram existente (source_instagram_media_id) o una publicación de página de Facebook (object_story_id) en un anuncio dentro de un conjunto de anuncios; pick_best elige la publicación reciente de Instagram con más interacción. Primero vista previa y aprobación; se crea pausado.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
instagram_media_idOpcional | string | — |
pick_bestOpcional | boolean | usar la publicación reciente de Instagram con más interacción |
lookback_postsOpcional | integer (1–100) | — |
facebook_post_idOpcional | string | {page_id}_{post_id} para promocionar una publicación de página en su lugar |
linkOpcional | string | — |
call_to_actionOpcional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
nameOpcional | string | — |
instagram_user_idOpcional | string | — |
page_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upsert_meta_catalog_product
Escritura2 créditosAñade un producto a un catálogo de Meta (POST /{catalog_id}/products; requiere retailer_id, name, url, image_url, price, currency, availability) o actualiza uno existente (POST /{product_id}). Primero vista previa y aprobación; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
catalog_idOpcional | string | id del catálogo de productos de Meta (list_meta_catalogs) |
product_idOpcional | string | id del producto de Meta existente a actualizar; omitir para crear |
retailer_idOpcional | string | — |
nameOpcional | string | — |
descriptionOpcional | string | — |
urlOpcional | string | — |
image_urlOpcional | string | — |
priceOpcional | number | — |
sale_priceOpcional | number | — |
currencyOpcional | string | ISO; por defecto: moneda de la cuenta publicitaria |
availabilityOpcional | in stock | out of stock | preorder | available for order | discontinued | — |
conditionOpcional | new | refurbished | used | — |
brandOpcional | string | — |
categoryOpcional | string | — |
gtinOpcional | string | — |
colorOpcional | string | — |
sizeOpcional | string | — |
item_group_idOpcional | string | — |
custom_label_0Opcional | string | — |
visibilityOpcional | published | staging | — |
custom_label_1Opcional | string | — |
custom_label_2Opcional | string | — |
custom_label_3Opcional | string | — |
custom_label_4Opcional | string | — |
genderOpcional | string | female | male | unisex |
materialOpcional | string | — |
patternOpcional | string | — |
product_typeOpcional | string | seller's own category path |
additional_image_urlsOpcional | array<string> | extra product image URLs |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_catalog_sales_campaign
Escritura2 créditosCrea una campaña de ventas del catálogo de Meta (objetivo OUTCOME_SALES con promoted_object.product_catalog_id) y un conjunto de anuncios que promociona un conjunto de productos (promoted_object.product_set_id, optimización de compras) como borrador pausado. Escribe un borrador en el libro y un elemento de aprobación; se envía a Meta solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
catalog_idObligatorio | string | id del catálogo de productos de Meta (list_meta_catalogs) |
product_set_idObligatorio | string | — |
daily_budgetOpcional | number | moneda de la cuenta |
countriesOpcional | array<string> | códigos ISO, por defecto TR |
pixel_idOpcional | string | — |
goalOpcional | string | — |
audienceOpcional | object | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
meta_page_subscription
Escritura1 créditosSi la página de Facebook está suscrita al webhook de Tecrübe y con qué campos (los mensajes nuevos de Messenger / Instagram y las respuestas de formularios solo llegan entonces); subscribe=true crea la suscripción (se puede repetir). Requiere pages_manage_metadata.
| Parámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | — |
subscribeOpcional | boolean | true = subscribe the Page now |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_meta_campaign
EscrituraIrreversible5 créditosElimina PERMANENTEMENTE una campaña de Meta (los informes siguen siendo legibles en Meta). Siempre espera aprobación explícita y no se puede deshacer. Si no estás seguro, mejor pausa.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_meta_adset
EscrituraIrreversible5 créditosElimina PERMANENTEMENTE un conjunto de anuncios de Meta. Siempre espera aprobación explícita y no se puede deshacer.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_meta_ad
EscrituraIrreversible5 créditosElimina PERMANENTEMENTE un anuncio de Meta. Siempre espera aprobación explícita y no se puede deshacer.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_meta_audience
EscrituraIrreversible5 créditosElimina PERMANENTEMENTE una audiencia personalizada o similar de Meta (duplicados, errores, solicitudes de privacidad). Siempre espera aprobación explícita y no se puede deshacer.
| Parámetro | Tipo | Descripción |
|---|---|---|
audience_idObligatorio | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_adset
Escritura5 créditosCrea en pausa un conjunto de anuncios en una campaña de Meta existente con objetivo de optimización, presupuesto, puja, calendario, objeto promocionado y segmentación completa (ubicaciones, datos demográficos, segmentación detallada, audiencias, ubicaciones de anuncios). Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | — |
nameObligatorio | string | — |
optimization_goalOpcional | LINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT | — |
billing_eventOpcional | IMPRESSIONS | LINK_CLICKS | THRUPLAY | — |
daily_budgetOpcional | number | moneda de la cuenta |
lifetime_budgetOpcional | number | — |
bid_strategyOpcional | string | — |
bid_amountOpcional | number | — |
targetingObligatorio | object | — |
start_timeOpcional | string | ISO 8601 |
end_timeOpcional | string | ISO 8601 |
pixel_idOpcional | string | — |
custom_event_typeOpcional | string | — |
page_idOpcional | string | — |
destination_typeOpcional | string | p. ej. WEBSITE, MESSENGER, WHATSAPP, ON_AD |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
copy_meta_entity
Escritura5 créditosDuplica una campaña, un conjunto de anuncios o un anuncio de Meta ('Duplicar' en Ads Manager), opcionalmente con sus elementos hijos y en otro elemento padre; la copia siempre queda en pausa. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
kindObligatorio | campaign | adset | ad | — |
entity_idObligatorio | string | — |
deep_copyOpcional | boolean | — |
rename_prefixOpcional | string | — |
rename_suffixOpcional | string | — |
target_parent_idOpcional | string | campaña para copiar un conjunto de anuncios, conjunto de anuncios para copiar un anuncio |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_link_ad
Escritura8 créditosCrea en un conjunto de anuncios un anuncio de enlace de Meta con una sola imagen (creatividad + anuncio) a partir de una URL de imagen, un hash de imagen subida o una imagen en base64, con texto principal, título y botón. Se crea en pausa tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
nameOpcional | string | — |
linkObligatorio | string | — |
messageOpcional | string | texto principal |
headlineOpcional | string | — |
descriptionOpcional | string | — |
image_urlOpcional | string | URL de imagen https pública o URL de medio de Studio |
image_hashOpcional | string | de upload_meta_image |
image_base64Opcional | string | imagen en base64, como máximo 5 MB |
call_to_actionOpcional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
page_idOpcional | string | — |
instagram_user_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_dynamic_ad
Escritura8 créditosCrea en un conjunto de anuncios de ventas del catálogo un anuncio dinámico de productos que se rellena a partir de un conjunto de productos del catálogo ({{product.name}}, {{product.price}}). Se crea en pausa tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
nameOpcional | string | — |
product_set_idObligatorio | string | — |
messageOpcional | string | — |
descriptionOpcional | string | texto de plantilla, por defecto {{product.price}} |
call_to_actionOpcional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
fallback_linkOpcional | string | — |
page_idOpcional | string | — |
instagram_user_idOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_meta_ad
Escritura5 créditosPausa, reanuda, archiva o renombra un anuncio de Meta. Vista previa con antes → después; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
statusOpcional | ACTIVE | PAUSED | ARCHIVED | — |
nameOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_meta_ad_creative
Escritura5 créditosSustituye la creatividad de un anuncio de enlace (imagen, texto, enlace, botón) sin borrar el anuncio: se crea una nueva a partir de la actual más tus cambios y se intercambia, así el anuncio conserva su id e historial. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
messageOpcional | string | — |
headlineOpcional | string | — |
descriptionOpcional | string | — |
linkOpcional | string | — |
image_urlOpcional | string | URL pública https de imagen o URL de medios de Studio |
image_hashOpcional | string | de upload_meta_image |
image_base64Opcional | string | imagen en base64, 5 MB como máximo |
call_to_actionOpcional | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | BOOK_TRAVEL | DOWNLOAD | GET_OFFER | ORDER_NOW | SUBSCRIBE | APPLY_NOW | MESSAGE_PAGE | WHATSAPP_MESSAGE | GET_QUOTE | BUY_NOW | — |
page_idOpcional | string | — |
nameOpcional | string | nuevo nombre de la creatividad |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_ab_test
Escritura5 créditosCrea una prueba A/B de Meta que ejecuta dos campañas existentes al 50/50 en audiencias sin solapamiento durante un periodo e informa de un ganador justo. Requiere un Business Manager. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
campaign_aObligatorio | string | — |
campaign_bObligatorio | string | — |
start_timeObligatorio | string | ISO 8601 (UTC si no hay desfase) |
end_timeObligatorio | string | ISO 8601 |
control_nameOpcional | string | — |
treatment_nameOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_meta_account_controls
Escritura2 créditosSeguridad de marca a nivel de cuenta: lee o establece las restricciones de audiencia y ubicación que afectan a TODAS las campañas de la cuenta publicitaria de Meta (edad mínima, países excluidos, ubicaciones excluidas como Audience Network o Marketplace). Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | get | set | — |
age_minOpcional | integer (13–65) | — |
placement_exclusionsOpcional | array<string> | ubicaciones a excluir: AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN |
countriesOpcional | array<string> | — |
excluded_countriesOpcional | array<string> | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_product_set
Escritura2 créditosCrea en un catálogo de Meta un conjunto de productos basado en reglas (marca, tipo de producto, precio, disponibilidad, etiquetas personalizadas…), para usarlo como conjunto de productos de un conjunto de anuncios de ventas del catálogo. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
catalog_idObligatorio | string | — |
nameObligatorio | string | — |
filterOpcional | object | regla, p. ej. {"product_type": {"i_contains": "camisa"}}; {} significa todos los productos |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_customer_file_audience
Escritura5 créditosCrea una audiencia personalizada de Meta a partir de una lista de clientes (customaudiences + users). Los valores se normalizan y se cifran con hash SHA-256 dentro de Tecrübe antes de guardar o enviar nada; la vista previa solo muestra recuentos. La cuenta publicitaria debe haber aceptado las Condiciones de Audiencias Personalizadas. Primero aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
id_typeOpcional | EMAIL | PHONE | EXTERN_ID | — |
identifiersObligatorio | array<string> | correos electrónicos, teléfonos con código de país o tus propios id de cliente; también se aceptan valores ya cifrados con SHA-256 |
descriptionOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_product_audience
Escritura5 créditosCrea una audiencia de retargeting a partir de un conjunto de productos del catálogo (p. ej. vieron un producto en los últimos 30 días pero no compraron). Se usa como audiencia de un conjunto de anuncios de ventas del catálogo. Primero aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
product_set_idObligatorio | string | — |
eventOpcional | string | ViewContent | AddToCart | Purchase (predeterminado ViewContent) |
exclude_eventOpcional | string | predeterminado Purchase; déjalo vacío para no excluir nada |
retention_daysOpcional | integer (1–180) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_pixel
Escritura2 créditosCrea un nuevo píxel de Meta (conjunto de datos) en la cuenta publicitaria y devuelve el pixel_id para instalarlo en el sitio web. Consulta primero list_meta_pixels: Meta limita cuántos píxeles puede tener una cuenta. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_custom_conversion
Escritura2 créditosCrea una conversión personalizada en un píxel de Meta a partir de una regla de URL y/o un evento (p. ej. la URL contiene /thank-you). Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
pixel_idOpcional | string | — |
url_containsOpcional | string | — |
eventOpcional | string | evento del píxel, p. ej. PageView, Purchase |
custom_event_typeOpcional | PURCHASE | LEAD | COMPLETE_REGISTRATION | ADD_TO_CART | INITIATED_CHECKOUT | ADD_PAYMENT_INFO | CONTENT_VIEW | SEARCH | ADD_TO_WISHLIST | CONTACT | SUBSCRIBE | START_TRIAL | SUBMIT_APPLICATION | SCHEDULE | OTHER | — |
default_conversion_valueOpcional | number | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_meta_custom_conversion
Escritura2 créditosRenombra una conversión personalizada de Meta o cambia su descripción / valor predeterminado. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
conversion_idObligatorio | string | — |
nameOpcional | string | — |
descriptionOpcional | string | — |
default_conversion_valueOpcional | number | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_engagement_audience
Escritura5 créditosCrea una audiencia de retargeting de Meta a partir de la interacción con una página de Facebook, un perfil de empresa de Instagram o un formulario de clientes potenciales (p. ej. lo abrió pero no lo envió). Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
sourceObligatorio | page | instagram | lead_form | — |
source_idOpcional | string | — |
eventOpcional | string | p. ej. page_engaged, ig_business_profile_engaged, lead_generation_opened |
retention_daysOpcional | integer (1–730) | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_lead_form
Escritura5 créditosCrea en una página de Facebook un formulario instantáneo (de clientes potenciales) con preguntas estándar y personalizadas, introducción, política de privacidad y pantalla de agradecimiento; devuelve el id del formulario para un anuncio de clientes potenciales. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | — |
nameObligatorio | string | — |
privacy_policy_urlObligatorio | string | — |
questionsObligatorio | array<object> | — |
follow_up_urlOpcional | string | — |
intro_headlineOpcional | string | — |
intro_descriptionOpcional | string | — |
thank_you_textOpcional | string | — |
localeOpcional | string | p. ej. tr_TR |
higher_intentOpcional | boolean | añade un paso de revisión (formulario de mayor intención) |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_meta_image
Escritura1 créditosSube una imagen a la biblioteca de imágenes de la cuenta publicitaria de Meta y obtiene su image_hash para reutilizarla en anuncios. Las URL externas solo se obtienen de internet público. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
image_urlOpcional | string | URL pública https de imagen o URL de medios de Studio |
image_base64Opcional | string | imagen en base64, 5 MB como máximo |
nameOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_meta_video
Escritura3 créditosAñade un vídeo a la cuenta publicitaria de Meta desde una URL pública (Meta lo descarga) y obtiene su video_id para create_meta_video_ad. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
video_urlObligatorio | string | URL pública https del vídeo; Meta la descarga |
nameOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
send_meta_conversion_event
Escritura1 créditosEnvía a Meta un evento de conversión del lado del servidor (Conversions API), p. ej. una venta offline o del CRM. El correo, el teléfono y el id externo se cifran con hash SHA-256 antes de guardarse o enviarse. Usa test_event_code para comprobarlo primero en Events Manager. Primero vista previa y aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
pixel_idOpcional | string | — |
event_nameObligatorio | string | — |
emailOpcional | string | — |
phoneOpcional | string | — |
external_idOpcional | string | — |
valueOpcional | number | — |
currencyOpcional | string | — |
event_idOpcional | string | id de deduplicación compartido con el píxel |
event_source_urlOpcional | string | — |
action_sourceOpcional | website | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other | — |
fbcOpcional | string | — |
fbpOpcional | string | — |
test_event_codeOpcional | string | — |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_meta_ad_account
EscrituraIrreversible2 créditosCreate a new Meta ad account under the user's Business Manager (for the user who has no ad account after OAuth). Needs a Business Manager (returns an honest note if none; lists them when there are several). Only call it when the user explicitly asked for it; the account is created at once and the connection is linked to it. Currency and time zone are permanent; a payment method must still be added in Business Manager.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | account name, e.g. “Acme Ads” |
currencyObligatorio | string | permanent; Meta-supported ISO code (TRY, USD, EUR…) |
business_idOpcional | string | Business Manager id the account belongs to; required when the user has several |
connection_idOpcional | string | optional: which Meta identity (connection) opens the account |
forceOpcional | boolean | create even though this identity already has an ad account |
account_idOpcional | string | optional: run in this Meta ad account (act_123… or 123…, from list_meta_ad_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.