Meta tools
Facebook and Instagram campaigns, ad sets, audiences, creatives, lead form results and reach estimates.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.
Outils de lecture10 outils
list_meta_ad_accounts
Lecture1 créditsMeta 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.
Cet outil ne prend aucun paramètre.
meta_insights_report
Lecture2 créditsFacebook + 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.
| Paramètre | Type | Description |
|---|---|---|
levelFacultatif | campaign | adset | ad | — |
daysFacultatif | integer (1–1125) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
breakdownFacultatif | none | age | gender | age_gender | publisher_platform | placement | placement_device | device | device_platform | country | region | placement = publisher_platform + platform_position; device = impression_device |
conversion_eventFacultatif | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default purchase) |
campaign_idsFacultatif | array<string> | — |
adset_idsFacultatif | array<string> | — |
ad_idsFacultatif | array<string> | — |
sort_byFacultatif | spend | roas | cpa | conversions | revenue | frequency | reach | impressions | clicks | ctr | cpm | cpc | — |
sort_orderFacultatif | desc | asc | — |
min_spendFacultatif | number | — |
roas_belowFacultatif | number | — |
roas_aboveFacultatif | number | — |
cpa_aboveFacultatif | number | — |
cpa_belowFacultatif | number | — |
frequency_aboveFacultatif | number | — |
limitFacultatif | integer (1–500) | — |
meta_top_creatives
Lecture2 créditsBest-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.
| Paramètre | Type | Description |
|---|---|---|
placementFacultatif | string | all | reels | instagram_reels | facebook_reels | instagram_stories | instagram_feed | feed … (matched against publisher_platform:platform_position) |
metricFacultatif | roas | cpa | conversions | ctr | spend | revenue | — |
conversion_eventFacultatif | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default purchase) |
daysFacultatif | integer (1–1125) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
limitFacultatif | integer (1–25) | — |
min_spendFacultatif | number | — |
campaign_idsFacultatif | array<string> | — |
list_meta_audiences
Lecture1 créditsCustom and lookalike audiences of the Meta ad account: id, name, subtype, approximate size range, retention, delivery status.
Cet outil ne prend aucun paramètre.
search_meta_interests
Lecture1 créditsSearch Meta's interest taxonomy (targeting search) by keyword: interest id, name, path and audience size range. Use the ids in targeting.interest_ids.
| Paramètre | Type | Description |
|---|---|---|
queryObligatoire | string | — |
limitFacultatif | integer (1–100) | — |
localeFacultatif | string | e.g. tr_TR, en_US |
meta_reach_estimate
Lecture2 créditsEstimated audience size for a targeting set before spending (Meta delivery estimate, falling back to reach estimate): monthly active users range and daily users.
| Paramètre | Type | Description |
|---|---|---|
targetingObligatoire | object | — |
optimization_goalFacultatif | string | REACH (default), LINK_CLICKS, OFFSITE_CONVERSIONS, IMPRESSIONS … |
pixel_idFacultatif | string | — |
custom_event_typeFacultatif | string | e.g. PURCHASE (with pixel_id) |
list_meta_ad_sets
Lecture1 créditsMeta ad sets with status, daily/lifetime budget (account currency), bid, optimisation goal, targeting and schedule.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | — |
adset_idsFacultatif | array<string> | — |
list_meta_instagram_posts
Lecture1 créditsRecent Instagram posts of the connected Instagram business account with likes, comments and engagement, sorted by engagement — to pick a post to boost.
| Paramètre | Type | Description |
|---|---|---|
instagram_user_idFacultatif | string | — |
limitFacultatif | integer (1–100) | — |
sort_byFacultatif | engagement | recent | — |
list_meta_lead_forms
Lecture1 créditsLead (instant) forms of the Facebook Page with status and lead counts. Creating new lead forms is not supported.
| Paramètre | Type | Description |
|---|---|---|
page_idFacultatif | string | — |
meta_lead_form_summary
Lecture2 créditsLead counts for one lead form over the last N days, by day, by ad and by platform. Counts only; personal answers are never returned.
| Paramètre | Type | Description |
|---|---|---|
form_idObligatoire | string | — |
page_idFacultatif | string | — |
daysFacultatif | integer (1–90) | — |
Outils d'écriture11 outils
select_meta_ad_account
Écriture1 créditsChoose which Meta ad account all further Meta tools work in (agency / multi-account). Only accounts the user can access are accepted.
| Paramètre | Type | Description |
|---|---|---|
account_idObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_meta_website_audience
Écriture2 créditsCreate 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.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
eventObligatoire | string | pixel event: AddToCart, InitiateCheckout, Purchase, ViewContent, Lead, PageView … |
retention_daysFacultatif | integer (1–180) | — |
exclude_eventFacultatif | string | e.g. Purchase for cart abandoners |
pixel_idFacultatif | string | — |
descriptionFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_meta_lookalike_audience
Écriture2 créditsCreate a Meta lookalike audience (1–10%) of a custom audience in one or more countries. Preview and approval first.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
source_audience_idObligatoire | string | — |
countriesObligatoire | array<string> | ISO codes |
ratio_percentFacultatif | number (1–10) | 1 = closest 1% |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_meta_campaign
Écriture2 créditsCreate 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.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
objectiveObligatoire | sales | traffic | engagement | messages | awareness | — |
daily_budgetFacultatif | number | account currency |
goalFacultatif | string | — |
audienceFacultatif | object | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_meta_campaign
Écriture2 créditsChange 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.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | Meta campaign id or Tecrube campaign id |
daily_budgetFacultatif | number | — |
lifetime_budgetFacultatif | number | — |
statusFacultatif | ACTIVE | PAUSED | ARCHIVED | — |
nameFacultatif | string | — |
bid_strategyFacultatif | string | LOWEST_COST_WITHOUT_CAP | LOWEST_COST_WITH_BID_CAP | COST_CAP | LOWEST_COST_WITH_MIN_ROAS |
spend_capFacultatif | number | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_meta_ad_set
Écriture2 créditsChange 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.
| Paramètre | Type | Description |
|---|---|---|
adset_idObligatoire | string | — |
daily_budgetFacultatif | number | — |
lifetime_budgetFacultatif | number | — |
statusFacultatif | ACTIVE | PAUSED | ARCHIVED | — |
nameFacultatif | string | — |
bid_strategyFacultatif | string | — |
bid_amountFacultatif | number | — |
targetingFacultatif | object | — |
start_timeFacultatif | string | ISO 8601 |
end_timeFacultatif | string | ISO 8601 |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
duplicate_meta_ad_set
Écriture2 créditsDuplicate 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.
| Paramètre | Type | Description |
|---|---|---|
adset_idObligatoire | string | — |
interest_idsFacultatif | array<string> | replace interests, keep the rest of the targeting |
targetingFacultatif | object | — |
daily_budgetFacultatif | number | — |
nameFacultatif | string | — |
bid_amountFacultatif | number | — |
start_timeFacultatif | string | — |
end_timeFacultatif | string | — |
deep_copyFacultatif | boolean | — |
rename_suffixFacultatif | string | — |
target_campaign_idFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
pause_meta_ad_sets_above_cpa
Écriture2 créditsFind 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.
| Paramètre | Type | Description |
|---|---|---|
cpa_thresholdObligatoire | number | account currency |
conversion_eventFacultatif | purchase | lead | add_to_cart | complete_registration | messaging | link_click | result type used for conversions and CPA (default purchase) |
daysFacultatif | integer (1–1125) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
min_spendFacultatif | number | — |
campaign_idsFacultatif | array<string> | — |
reallocateFacultatif | boolean | move the paused sets' daily budget to the best ad set (default true) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_meta_carousel_ad
Écriture2 créditsCreate 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.
| Paramètre | Type | Description |
|---|---|---|
adset_idObligatoire | string | — |
nameFacultatif | string | — |
linkObligatoire | string | — |
messageFacultatif | string | primary text |
cardsObligatoire | array<object> | — |
call_to_actionFacultatif | 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_orderFacultatif | boolean | — |
page_idFacultatif | string | — |
instagram_user_idFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_meta_video_ad
Écriture2 créditsCreate 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.
| Paramètre | Type | Description |
|---|---|---|
adset_idObligatoire | string | — |
video_idObligatoire | string | video id in the Meta ad account |
linkObligatoire | string | — |
nameFacultatif | string | — |
messageFacultatif | string | — |
titleFacultatif | string | — |
call_to_actionFacultatif | 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_urlFacultatif | string | — |
page_idFacultatif | string | — |
instagram_user_idFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
boost_instagram_post
Écriture2 créditsTurn 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.
| Paramètre | Type | Description |
|---|---|---|
adset_idObligatoire | string | — |
instagram_media_idFacultatif | string | — |
pick_bestFacultatif | boolean | use the most engaging recent Instagram post |
lookback_postsFacultatif | integer (1–100) | — |
facebook_post_idFacultatif | string | {page_id}_{post_id} to boost a Page post instead |
linkFacultatif | string | — |
call_to_actionFacultatif | 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 | — |
nameFacultatif | string | — |
instagram_user_idFacultatif | string | — |
page_idFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.