Meta tools
Facebook and Instagram campaigns, ad sets, audiences, creatives, lead form results and reach estimates.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son el texto original en inglés que ve el asistente.
Herramientas de lectura10 herramientas
list_meta_ad_accounts
Lectura1 créditosMeta ad accounts reachable with the connected Meta token: id (act_…), name, currency, status, timezone, lifetime spend, business, and which one is selected. Read only; connected=false when Meta is not linked.
Esta herramienta no recibe parámetros.
meta_insights_report
Lectura2 créditosFacebook + Instagram performance (Meta Insights) at campaign, ad set or ad level for a date range, optionally broken down by age, gender, placement or device: spend, impressions, reach, frequency, clicks, CTR, CPM, CPC, conversions, revenue, ROAS (purchase_roas) and CPA (cost_per_action_type). Sort by any metric and filter with thresholds (e.g. roas_below=3 sorted by spend, cpa_above=40). Real data only.
| 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 |
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 | link_click | result type used for conversions and CPA (default 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) | — |
meta_top_creatives
Lectura2 créditosBest-performing Meta ads (creatives) in a placement such as Instagram Reels, ranked by ROAS, CPA, conversions or CTR, with creative details (thumbnail, video, Instagram permalink) and their ad set ids for duplication.
| Parámetro | Tipo | Descripción |
|---|---|---|
placementOpcional | string | all | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (matched against publisher_platform:platform_position) |
metricOpcional | roas | cpa | conversions | ctr | spend | revenue | — |
conversion_eventOpcional | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default 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> | — |
list_meta_audiences
Lectura1 créditosCustom and lookalike audiences of the Meta ad account: id, name, subtype, approximate size range, retention, delivery status.
Esta herramienta no recibe parámetros.
search_meta_interests
Lectura1 créditosSearch Meta's interest taxonomy (targeting search) by keyword: interest id, name, path and audience size range. Use the ids in targeting.interest_ids.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryObligatorio | string | — |
limitOpcional | integer (1–100) | — |
localeOpcional | string | e.g. tr_TR, en_US |
meta_reach_estimate
Lectura2 créditosEstimated audience size for a targeting set before spending (Meta delivery estimate, falling back to reach estimate): monthly active users range and daily users.
| Parámetro | Tipo | Descripción |
|---|---|---|
targetingObligatorio | object | — |
optimization_goalOpcional | string | REACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idOpcional | string | — |
custom_event_typeOpcional | string | e.g. PURCHASE (with pixel_id) |
list_meta_ad_sets
Lectura1 créditosMeta ad sets with status, daily/lifetime budget (account currency), bid, optimisation goal, targeting and schedule.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | — |
adset_idsOpcional | array<string> | — |
list_meta_instagram_posts
Lectura1 créditosRecent Instagram posts of the connected Instagram business account with likes, comments and engagement, sorted by engagement — to pick a post to boost.
| Parámetro | Tipo | Descripción |
|---|---|---|
instagram_user_idOpcional | string | — |
limitOpcional | integer (1–100) | — |
sort_byOpcional | engagement | recent | — |
list_meta_lead_forms
Lectura1 créditosLead (instant) forms of the Facebook Page with status and lead counts. Creating new lead forms is not supported.
| Parámetro | Tipo | Descripción |
|---|---|---|
page_idOpcional | string | — |
meta_lead_form_summary
Lectura2 créditosLead counts for one lead form over the last N days, by day, by ad and by platform. Counts only; personal answers are never returned.
| Parámetro | Tipo | Descripción |
|---|---|---|
form_idObligatorio | string | — |
page_idOpcional | string | — |
daysOpcional | integer (1–90) | — |
Herramientas de escritura11 herramientas
select_meta_ad_account
Escritura1 créditosChoose which Meta ad account all further Meta tools work in (agency / multi-account). Only accounts the user can access are accepted.
| 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éditosCreate a website custom audience from the Meta pixel (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience populates within hours.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
eventObligatorio | string | pixel event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView … |
retention_daysOpcional | integer (1–180) | — |
exclude_eventOpcional | string | e.g. Purchase for cart abandoners |
pixel_idOpcional | string | — |
descriptionOpcional | string | — |
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éditosCreate a Meta lookalike audience (1–10%) of a custom audience in one or more countries. Preview and approval first.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
source_audience_idObligatorio | string | — |
countriesObligatorio | array<string> | ISO codes |
ratio_percentOpcional | number (1–10) | 1 = closest 1% |
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éditosCreate a Meta campaign end to end (campaign + ad set + ad when a page and creative exist) as a paused draft with objective, daily budget and targeting. Writes a ledger draft and an approval item; sent to Meta only after approval.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
objectiveObligatorio | sales | traffic | engagement | messages | awareness | — |
daily_budgetOpcional | number | account currency |
goalOpcional | string | — |
audienceOpcional | object | — |
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éditosChange a Meta campaign's budget (daily/lifetime), status, name, bid strategy or spend cap. Preview with before → after; budget increases above +50% per step are blocked. Applied only after approval.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Meta campaign id or Tecrube campaign id |
daily_budgetOpcional | number | — |
lifetime_budgetOpcional | number | — |
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 | — |
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éditosChange a Meta ad set's budget, status, targeting (locations, age, gender, interests, audiences, placements), bid or schedule. Preview and approval first; the budget guardrail applies.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
daily_budgetOpcional | number | — |
lifetime_budgetOpcional | number | — |
statusOpcional | ACTIVE | PAUSED | ARCHIVED | — |
nameOpcional | string | — |
bid_strategyOpcional | string | — |
bid_amountOpcional | number | — |
targetingOpcional | object | — |
start_timeOpcional | string | ISO 8601 |
end_timeOpcional | string | ISO 8601 |
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éditosDuplicate a winning Meta ad set (with its ads) as a paused copy and give it a new interest audience, targeting or budget for a test. Preview and approval first.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
interest_idsOpcional | array<string> | replace interests, keep the rest of the targeting |
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 | — |
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éditosFind active Meta ad sets whose CPA is above a threshold (or that spent at least the threshold with zero results), pause them in one action and move their freed daily budget to the best-CPA ad set within the +50% guardrail. Shows the list first; applied only after approval.
| Parámetro | Tipo | Descripción |
|---|---|---|
cpa_thresholdObligatorio | number | account currency |
conversion_eventOpcional | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default 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 | move the paused sets' daily budget to the best ad set (default true) |
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éditosCreate a Meta carousel ad (2–10 image cards, e.g. five product images) in an ad set for Facebook and Instagram. Studio images are uploaded to Meta (adimages). Created paused after approval.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
nameOpcional | string | — |
linkObligatorio | string | — |
messageOpcional | string | primary text |
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 | — |
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éditosCreate a Meta video ad from an existing video id in an ad set (thumbnail taken from the video when not given). Created paused after approval.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
video_idObligatorio | string | video id in the Meta ad account |
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 | — |
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éditosTurn an existing Instagram post (source_instagram_media_id) or Facebook Page post (object_story_id) into an ad in an ad set; pick_best chooses the most engaging recent Instagram post. Preview and approval first; created paused.
| Parámetro | Tipo | Descripción |
|---|---|---|
adset_idObligatorio | string | — |
instagram_media_idOpcional | string | — |
pick_bestOpcional | boolean | use the most engaging recent Instagram post |
lookback_postsOpcional | integer (1–100) | — |
facebook_post_idOpcional | string | {page_id}_{post_id} to boost a Page post instead |
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 | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.