Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Configuración y campañas

Herramientas de Meta

Campañas de Facebook e Instagram, conjuntos de anuncios, públicos, creatividades, resultados de formularios y estimaciones de alcance.

En proceso de aprobación — próximamente

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éditos

Cuentas 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éditos

Rendimiento 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ámetroTipoDescripción
levelOpcionalcampaign | adset | ad—
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
date_presetOpcionaltoday | yesterday | last_7d | last_14d | last_28d | last_30d | last_90d | this_month | last_monthinstead of days/start_date/end_date
breakdownOpcionalnone | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | regionplacement = publisher_platform + platform_position; device = impression_device
conversion_eventOpcionalpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clicktipo de resultado usado para conversiones y CPA (por defecto purchase)
campaign_idsOpcionalarray<string>—
adset_idsOpcionalarray<string>—
ad_idsOpcionalarray<string>—
sort_byOpcionalspend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc—
sort_orderOpcionaldesc | asc—
min_spendOpcionalnumber—
roas_belowOpcionalnumber—
roas_aboveOpcionalnumber—
cpa_aboveOpcionalnumber—
cpa_belowOpcionalnumber—
frequency_aboveOpcionalnumber—
limitOpcionalinteger (1–500)—
account_idOpcionalstringoptional: 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éditos

Anuncios (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ámetroTipoDescripción
placementOpcionalstringall | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (se compara con publisher_platform:platform_position)
metricOpcionalroas | cpa | conversions | ctr | spend | revenue—
conversion_eventOpcionalpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clicktipo de resultado usado para conversiones y CPA (por defecto purchase)
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
limitOpcionalinteger (1–25)—
min_spendOpcionalnumber—
campaign_idsOpcionalarray<string>—
account_idOpcionalstringoptional: 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éditos

Audiencias personalizadas y similares de la cuenta publicitaria de Meta: id, nombre, subtipo, rango de tamaño aproximado, retención, estado de entrega.

ParámetroTipoDescripción
account_idOpcionalstringoptional: 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éditos

Busca 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ámetroTipoDescripción
queryOpcionalstring—
limitOpcionalinteger (1–100)—
localeOpcionalstringp. ej. tr_TR, en_US
kindOpcionalinterest | behavior | life_event | industry | family_status | income | demographicinterest (default) or a detailed-targeting category
category_classOpcionalstringraw adTargetingCategory class, overrides kind
account_idOpcionalstringoptional: 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éditos

Tamañ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ámetroTipoDescripción
targetingObligatorioobject—
optimization_goalOpcionalstringREACH (por defecto), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS …
pixel_idOpcionalstring—
custom_event_typeOpcionalstringp. ej. PURCHASE (con pixel_id)
account_idOpcionalstringoptional: 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éditos

Conjuntos de anuncios de Meta con estado, presupuesto diario/total (moneda de la cuenta), puja, objetivo de optimización, segmentación y calendario.

ParámetroTipoDescripción
campaign_idOpcionalstring—
adset_idsOpcionalarray<string>—
account_idOpcionalstringoptional: 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éditos

Publicaciones 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ámetroTipoDescripción
instagram_user_idOpcionalstring—
limitOpcionalinteger (1–100)—
sort_byOpcionalengagement | recent—

list_meta_conversations

Lectura1 créditos

Messenger 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ámetroTipoDescripción
page_idOpcionalstring—
platformOpcionalmessenger | instagram—
limitOpcionalinteger (1–50)—
account_idOpcionalstringoptional: 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éditos

Formularios 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ámetroTipoDescripción
page_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Recuento 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ámetroTipoDescripción
form_idObligatoriostring—
page_idOpcionalstring—
daysOpcionalinteger (1–90)—
account_idOpcionalstringoptional: 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éditos

Catá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ámetroTipoDescripción
business_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Productos 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ámetroTipoDescripción
catalog_idObligatoriostringid del catálogo de productos de Meta (list_meta_catalogs)
queryOpcionalstringel nombre contiene
review_statusOpcionalapproved | rejected | pending | outdated—
filterOpcionalobjectfiltro de productos Graph, p. ej. {"retailer_id": {"eq": "SKU1"}}
limitOpcionalinteger (1–1000)—
account_idOpcionalstringoptional: 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éditos

Conjuntos 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ámetroTipoDescripción
catalog_idObligatoriostringid del catálogo de productos de Meta (list_meta_catalogs)
account_idOpcionalstringoptional: 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éditos

Pá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ámetroTipoDescripción
promotable_onlyOpcionalbooleansolo las páginas que puede promocionar la cuenta publicitaria seleccionada

list_meta_campaigns

Lectura1 créditos

Campañ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ámetroTipoDescripción
effective_statusOpcionalarray<string>p. ej. ACTIVE, PAUSED
account_idOpcionalstringoptional: 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éditos

Anuncios 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ámetroTipoDescripción
adset_idOpcionalstring—
campaign_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Publicaciones 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ámetroTipoDescripción
page_idOpcionalstring—
limitOpcionalinteger (1–100)—

list_meta_pixels

Lectura1 créditos

Píxeles de Meta (conjuntos de datos) de la cuenta publicitaria con nombre y hora de la última activación. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringoptional: 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éditos

Lectura 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ámetroTipoDescripción
fieldsObligatorioarray<string>campos de Insights, p. ej. spend, reach, actions, video_p75_watched_actions
levelOpcionalaccount | campaign | adset | ad—
breakdownsOpcionalarray<string>p. ej. age, gender, country, publisher_platform, hourly_stats_aggregated_by_advertiser_time_zone
action_breakdownsOpcionalarray<string>p. ej. action_type, action_device
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
time_incrementOpcionalstring1 = diario, 7 = semanal, monthly, all_days
filteringOpcionalarray<object>filtros de Graph [{field, operator, value}]
limitOpcionalinteger (1–5000)—
account_idOpcionalstringoptional: 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éditos

Cuentas 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éditos

Audiencias guardadas (ajustes de segmentación reutilizables de Ads Manager) con su segmentación y tamaño aproximado. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringoptional: 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éditos

Conversiones personalizadas de la cuenta publicitaria: id, nombre, regla (URL / evento), tipo de evento, píxel, última activación, valor predeterminado. Solo lectura.

ParámetroTipoDescripción
include_archivedOpcionalboolean—
account_idOpcionalstringoptional: 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éditos

Diagnó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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Meta (list_meta_campaigns) o id de campaña de Tecrübe
account_idOpcionalstringoptional: 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éditos

Historial 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ámetroTipoDescripción
sinceOpcionalstringYYYY-MM-DD
untilOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–365)—
levelOpcionalstringfiltrar por tipo de objeto: campaign | adset | ad | account …
limitOpcionalinteger (1–1000)—
account_idOpcionalstringoptional: 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éditos

Estimació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ámetroTipoDescripción
adset_idObligatoriostring—
optimization_goalOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Genera 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ámetroTipoDescripción
creative_idOpcionalstring—
ad_idOpcionalstring—
ad_formatOpcionalDESKTOP_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_idOpcionalstringoptional: 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éditos

Lee 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ámetroTipoDescripción
ad_idObligatoriostring—
account_idOpcionalstringoptional: 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éditos

Resuelve 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ámetroTipoDescripción
urlObligatoriostring—
ig_user_idOpcionalstring—

instagram_follower_growth

Lectura1 créditos

Nuevos 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ámetroTipoDescripción
ig_user_idOpcionalstring—
daysOpcionalinteger (1–30)—

download_meta_leads

Lectura1 créditos

Descarga 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ámetroTipoDescripción
form_idObligatoriostring—
page_idOpcionalstring—
limitOpcionalinteger (1–2000)—
sinceOpcionalstringYYYY-MM-DD
account_idOpcionalstringoptional: 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éditos

Tres 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ámetroTipoDescripción
modeOpcionalsuggest | validate | minimum_budget—
interest_idsOpcionalarray<string>—
namesOpcionalarray<string>—
limit_typeOpcionalinterests | behaviors | income | life_events—
is_exclusionOpcionalboolean—
bid_amountOpcionalinteger—
account_idOpcionalstringoptional: 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éditos

Elige 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ámetroTipoDescripción
account_idObligatoriostring—

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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
eventObligatoriostringevento del píxel: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView …
retention_daysOpcionalinteger (1–180)—
exclude_eventOpcionalstringp. ej. Purchase para abandonos de carrito
pixel_idOpcionalstring—
descriptionOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
source_audience_idObligatoriostring—
countriesObligatorioarray<string>códigos ISO
ratio_percentOpcionalnumber (1–10)1 = el 1 % más parecido
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
objectiveObligatoriosales | traffic | engagement | messages | awareness—
daily_budgetOpcionalnumbermoneda de la cuenta
goalOpcionalstring—
special_ad_categoriesOpcionalarray<string>CREDIT | EMPLOYMENT | HOUSING | ISSUES_ELECTIONS_POLITICS | FINANCIAL_PRODUCTS_SERVICES
audienceOpcionalobject—
account_idOpcionalstringoptional: 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éditos

Cambia 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Meta o id de campaña de Tecrube
daily_budgetOpcionalnumberad account currency
lifetime_budgetOpcionalnumber—
currencyOpcionalstringoptional ISO check; must equal the ad account currency
statusOpcionalACTIVE | PAUSED | ARCHIVED—
nameOpcionalstring—
bid_strategyOpcionalstringLOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS
spend_capOpcionalnumber—
account_idOpcionalstringoptional: 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éditos

Cambia 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ámetroTipoDescripción
adset_idObligatoriostring—
daily_budgetOpcionalnumberad account currency
lifetime_budgetOpcionalnumber—
currencyOpcionalstringoptional ISO check; must equal the ad account currency
statusOpcionalACTIVE | PAUSED | ARCHIVED—
nameOpcionalstring—
bid_strategyOpcionalstring—
bid_amountOpcionalnumber—
targetingOpcionalobject—
start_timeOpcionalstringISO 8601
end_timeOpcionalstringISO 8601
account_idOpcionalstringoptional: 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éditos

Duplica 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ámetroTipoDescripción
adset_idObligatoriostring—
interest_idsOpcionalarray<string>sustituye los intereses y conserva el resto de la segmentación
targetingOpcionalobject—
daily_budgetOpcionalnumber—
nameOpcionalstring—
bid_amountOpcionalnumber—
start_timeOpcionalstring—
end_timeOpcionalstring—
deep_copyOpcionalboolean—
rename_suffixOpcionalstring—
target_campaign_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Encuentra 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ámetroTipoDescripción
cpa_thresholdObligatorionumbermoneda de la cuenta
conversion_eventOpcionalpurchase | lead | add_to_cart | complete_registration | messaging | app_install | link_clicktipo de resultado usado para conversiones y CPA (por defecto purchase)
daysOpcionalinteger (1–1125)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
min_spendOpcionalnumber—
campaign_idsOpcionalarray<string>—
reallocateOpcionalbooleantrasladar el presupuesto diario de los conjuntos pausados al mejor conjunto (por defecto true)
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
adset_idObligatoriostring—
video_idOpcionalstringid del vídeo en la cuenta publicitaria de Meta
video_urlOpcionalstringpublic https video URL; Meta fetches it (instead of video_id)
linkObligatoriostring—
nameOpcionalstring—
messageOpcionalstring—
titleOpcionalstring—
call_to_actionOpcionalLEARN_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_urlOpcionalstring—
page_idOpcionalstring—
instagram_user_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Convierte 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ámetroTipoDescripción
adset_idObligatoriostring—
instagram_media_idOpcionalstring—
pick_bestOpcionalbooleanusar la publicación reciente de Instagram con más interacción
lookback_postsOpcionalinteger (1–100)—
facebook_post_idOpcionalstring{page_id}_{post_id} para promocionar una publicación de página en su lugar
linkOpcionalstring—
call_to_actionOpcionalLEARN_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—
nameOpcionalstring—
instagram_user_idOpcionalstring—
page_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
catalog_idOpcionalstringid del catálogo de productos de Meta (list_meta_catalogs)
product_idOpcionalstringid del producto de Meta existente a actualizar; omitir para crear
retailer_idOpcionalstring—
nameOpcionalstring—
descriptionOpcionalstring—
urlOpcionalstring—
image_urlOpcionalstring—
priceOpcionalnumber—
sale_priceOpcionalnumber—
currencyOpcionalstringISO; por defecto: moneda de la cuenta publicitaria
availabilityOpcionalin stock | out of stock | preorder | available for order | discontinued—
conditionOpcionalnew | refurbished | used—
brandOpcionalstring—
categoryOpcionalstring—
gtinOpcionalstring—
colorOpcionalstring—
sizeOpcionalstring—
item_group_idOpcionalstring—
custom_label_0Opcionalstring—
visibilityOpcionalpublished | staging—
custom_label_1Opcionalstring—
custom_label_2Opcionalstring—
custom_label_3Opcionalstring—
custom_label_4Opcionalstring—
genderOpcionalstringfemale | male | unisex
materialOpcionalstring—
patternOpcionalstring—
product_typeOpcionalstringseller's own category path
additional_image_urlsOpcionalarray<string>extra product image URLs
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
catalog_idObligatoriostringid del catálogo de productos de Meta (list_meta_catalogs)
product_set_idObligatoriostring—
daily_budgetOpcionalnumbermoneda de la cuenta
countriesOpcionalarray<string>códigos ISO, por defecto TR
pixel_idOpcionalstring—
goalOpcionalstring—
audienceOpcionalobject—
account_idOpcionalstringoptional: 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éditos

Si 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ámetroTipoDescripción
page_idOpcionalstring—
subscribeOpcionalbooleantrue = subscribe the Page now
account_idOpcionalstringoptional: 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éditos

Elimina 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ámetroTipoDescripción
campaign_idObligatoriostring—
account_idOpcionalstringoptional: 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éditos

Elimina PERMANENTEMENTE un conjunto de anuncios de Meta. Siempre espera aprobación explícita y no se puede deshacer.

ParámetroTipoDescripción
adset_idObligatoriostring—
account_idOpcionalstringoptional: 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éditos

Elimina PERMANENTEMENTE un anuncio de Meta. Siempre espera aprobación explícita y no se puede deshacer.

ParámetroTipoDescripción
ad_idObligatoriostring—
account_idOpcionalstringoptional: 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éditos

Elimina 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ámetroTipoDescripción
audience_idObligatoriostring—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
campaign_idObligatoriostring—
nameObligatoriostring—
optimization_goalOpcionalLINK_CLICKS | LANDING_PAGE_VIEWS | OFFSITE_CONVERSIONS | REACH | IMPRESSIONS | LEAD_GENERATION | CONVERSATIONS | THRUPLAY | POST_ENGAGEMENT | VALUE | QUALITY_LEAD | APP_INSTALLS | PROFILE_VISIT—
billing_eventOpcionalIMPRESSIONS | LINK_CLICKS | THRUPLAY—
daily_budgetOpcionalnumbermoneda de la cuenta
lifetime_budgetOpcionalnumber—
bid_strategyOpcionalstring—
bid_amountOpcionalnumber—
targetingObligatorioobject—
start_timeOpcionalstringISO 8601
end_timeOpcionalstringISO 8601
pixel_idOpcionalstring—
custom_event_typeOpcionalstring—
page_idOpcionalstring—
destination_typeOpcionalstringp. ej. WEBSITE, MESSENGER, WHATSAPP, ON_AD
account_idOpcionalstringoptional: 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éditos

Duplica 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ámetroTipoDescripción
kindObligatoriocampaign | adset | ad—
entity_idObligatoriostring—
deep_copyOpcionalboolean—
rename_prefixOpcionalstring—
rename_suffixOpcionalstring—
target_parent_idOpcionalstringcampaña para copiar un conjunto de anuncios, conjunto de anuncios para copiar un anuncio
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
adset_idObligatoriostring—
nameOpcionalstring—
product_set_idObligatoriostring—
messageOpcionalstring—
descriptionOpcionalstringtexto de plantilla, por defecto {{product.price}}
call_to_actionOpcionalLEARN_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_linkOpcionalstring—
page_idOpcionalstring—
instagram_user_idOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Pausa, reanuda, archiva o renombra un anuncio de Meta. Vista previa con antes → después; se aplica solo tras la aprobación.

ParámetroTipoDescripción
ad_idObligatoriostring—
statusOpcionalACTIVE | PAUSED | ARCHIVED—
nameOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Sustituye 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ámetroTipoDescripción
ad_idObligatoriostring—
messageOpcionalstring—
headlineOpcionalstring—
descriptionOpcionalstring—
linkOpcionalstring—
image_urlOpcionalstringURL pública https de imagen o URL de medios de Studio
image_hashOpcionalstringde upload_meta_image
image_base64Opcionalstringimagen en base64, 5 MB como máximo
call_to_actionOpcionalLEARN_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_idOpcionalstring—
nameOpcionalstringnuevo nombre de la creatividad
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
campaign_aObligatoriostring—
campaign_bObligatoriostring—
start_timeObligatoriostringISO 8601 (UTC si no hay desfase)
end_timeObligatoriostringISO 8601
control_nameOpcionalstring—
treatment_nameOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Seguridad 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ámetroTipoDescripción
actionOpcionalget | set—
age_minOpcionalinteger (13–65)—
placement_exclusionsOpcionalarray<string>ubicaciones a excluir: AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN
countriesOpcionalarray<string>—
excluded_countriesOpcionalarray<string>—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
catalog_idObligatoriostring—
nameObligatoriostring—
filterOpcionalobjectregla, p. ej. {"product_type": {"i_contains": "camisa"}}; {} significa todos los productos
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
id_typeOpcionalEMAIL | PHONE | EXTERN_ID—
identifiersObligatorioarray<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
descriptionOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
product_set_idObligatoriostring—
eventOpcionalstringViewContent | AddToCart | Purchase (predeterminado ViewContent)
exclude_eventOpcionalstringpredeterminado Purchase; déjalo vacío para no excluir nada
retention_daysOpcionalinteger (1–180)—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
pixel_idOpcionalstring—
url_containsOpcionalstring—
eventOpcionalstringevento del píxel, p. ej. PageView, Purchase
custom_event_typeOpcionalPURCHASE | 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_valueOpcionalnumber—
account_idOpcionalstringoptional: 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éditos

Renombra una conversión personalizada de Meta o cambia su descripción / valor predeterminado. Primero vista previa y aprobación.

ParámetroTipoDescripción
conversion_idObligatoriostring—
nameOpcionalstring—
descriptionOpcionalstring—
default_conversion_valueOpcionalnumber—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
sourceObligatoriopage | instagram | lead_form—
source_idOpcionalstring—
eventOpcionalstringp. ej. page_engaged, ig_business_profile_engaged, lead_generation_opened
retention_daysOpcionalinteger (1–730)—
account_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
page_idOpcionalstring—
nameObligatoriostring—
privacy_policy_urlObligatoriostring—
questionsObligatorioarray<object>—
follow_up_urlOpcionalstring—
intro_headlineOpcionalstring—
intro_descriptionOpcionalstring—
thank_you_textOpcionalstring—
localeOpcionalstringp. ej. tr_TR
higher_intentOpcionalbooleanañade un paso de revisión (formulario de mayor intención)
account_idOpcionalstringoptional: 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éditos

Sube 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ámetroTipoDescripción
image_urlOpcionalstringURL pública https de imagen o URL de medios de Studio
image_base64Opcionalstringimagen en base64, 5 MB como máximo
nameOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
video_urlObligatoriostringURL pública https del vídeo; Meta la descarga
nameOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Enví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ámetroTipoDescripción
pixel_idOpcionalstring—
event_nameObligatoriostring—
emailOpcionalstring—
phoneOpcionalstring—
external_idOpcionalstring—
valueOpcionalnumber—
currencyOpcionalstring—
event_idOpcionalstringid de deduplicación compartido con el píxel
event_source_urlOpcionalstring—
action_sourceOpcionalwebsite | app | phone_call | chat | email | physical_store | system_generated | business_messaging | other—
fbcOpcionalstring—
fbpOpcionalstring—
test_event_codeOpcionalstring—
account_idOpcionalstringoptional: 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éditos

Create 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ámetroTipoDescripción
nameObligatoriostringaccount name, e.g. “Acme Ads”
currencyObligatoriostringpermanent; Meta-supported ISO code (TRY, USD, EUR…)
business_idOpcionalstringBusiness Manager id the account belongs to; required when the user has several
connection_idOpcionalstringoptional: which Meta identity (connection) opens the account
forceOpcionalbooleancreate even though this identity already has an ad account
account_idOpcionalstringoptional: 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.