İçeriğe geç
Tecrübetecrube.com
Asistan araçları · Optimizasyon ve koruma

Genel araçlar

Hesap durumu, kampanya özeti, raporlar, onay kuyruğu, marka profili ve kanaldan bağımsız değişiklik araçları.

Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.

Okuma araçları22 araç

get_status

Okuma1 kredi

Hesap özeti: marka, plan, bağlı platformlar, kampanyalar (7 gün), bekleyen onaylar, açık müşteri sohbetleri, harcama koruması. Bağlam bilinmiyorsa önce bu çağrılır.

Bu araç parametre almaz.

list_accounts

Okuma1 kredi

Bağlı reklam ve veri hesapları (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) ve durumları. 'sample' bağlantılar demo veridir, canlı değildir.

ParametreTipAçıklama
platformİsteğe bağlıstringoptional filter, e.g. google, meta, microsoft
all_accessibleİsteğe bağlıbooleanalso name the tool that lists every accessible account of each platform

list_campaigns

Okuma1 kredi

Son N güne ait harcama, tıklama, sipariş ve gelir verileriyle kampanyalar. Döndürülen kampanya id'leri update_campaign / add_negative_keywords için kullanılır.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—

get_report

Okuma1 kredi

Dönem raporu: harcama, sipariş, gelir, ROAS, önceki döneme göre değişim, öneriler. Salt okunur.

ParametreTipAçıklama
periodİsteğe bağlıday | week | month—
platformİsteğe bağlıstringall (default) | google | meta | microsoft | tiktok | linkedin | openai-ads | ga4 | search-console
accountİsteğe bağlıstringaccount id on platforms that take one per call (microsoft, linkedin, openai-ads, ga4 property, search-console site)
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
levelİsteğe bağlıstringcampaign | ad_group | adset | ad | keyword | location | device | age_gender (what the platform supports)
breakdownİsteğe bağlıstringplatform breakdown, e.g. device, age, placement
limitİsteğe bağlıinteger (1–500)—

search_terms_report

Okuma2 kredi

Son N güne ait harcama, tıklama ve dönüşüm verileriyle Google Ads arama terimleri ve boşa giden (sıfır dönüşümlü) terimler. Bağlı bir Google Ads hesabı gerektirir; aksi halde uydurma sayılar değil bir not döndürür.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—
campaign_idİsteğe bağlıstring—

account_audit

Okuma3 kredi

Önceliklendirilmiş bulgular halinde hesap sağlığı denetimi: sonuçsuz harcama, eksik bütçeler, harcama sınırı yokluğu, boşa giden arama terimleri, bekleyen onaylar. Salt okunur.

Bu araç parametre almaz.

list_pending_approvals

Okuma1 kredi

Kullanıcının onayını bekleyen değişiklikler (id, tür, başlık).

Bu araç parametre almaz.

get_brand_profile

Okuma1 kredi

Marka bilgi tabanı: sektör, konum, ürünler, hedef kitle, hedefler, ton, rakipler.

Bu araç parametre almaz.

research

Okuma4 kredi

Web araştırması (rakip, fiyat, sektör kuralı). Araştırma sağlayıcısı yapılandırılmamışsa bir not döndürür; asla sonuç uydurmaz.

ParametreTipAçıklama
queryZorunlustring—

list_customers

Okuma1 kredi

Gelen kutusundaki müşteri görüşmeleri (WhatsApp, Messenger, Instagram): kim yazdı, son mesaj, yanıt bekliyor mu.

ParametreTipAçıklama
stateİsteğe bağlıneeds_you | waiting | auto | done—
limitİsteğe bağlıinteger—

list_entities

Okuma1 kredi

Bağlı herhangi bir reklam platformunun kampanyalarını, reklam gruplarını / reklam setlerini, reklamlarını ya da anahtar kelimelerini id'leriyle, sayfalı olarak listeler — platforma özel liste aracını aramak yerine (sonuç kaynak aracın adını verir). Salt okunur.

ParametreTipAçıklama
platformİsteğe bağlıstringgoogle | meta | microsoft | tiktok | linkedin | openai-ads (boş = tüm platformların kayıt defteri kampanyaları)
entityİsteğe bağlıcampaigns | ad_groups | ads | keywords—
parent_idİsteğe bağlıstringreklam grupları için kampanya id'si, reklamlar/anahtar kelimeler için reklam grubu id'si (platform gerektiriyorsa)
accountİsteğe bağlıstringçağrı başına bir hesap alan platformlarda hesap id'si
daysİsteğe bağlıinteger (1–90)kayıt defteri kampanyaları: son N günün rakamları
limitİsteğe bağlıinteger (1–500)—
offsetİsteğe bağlıinteger (0–…)—

account_snapshot

Okuma1 kredi

Bir reklam hesabının (ya da tümünün) tek çağrıda resmi: bağlantılar, yayındaki/duraklatılmış kampanya sayıları, son harcama, siparişler, gelir, platform ve kampanya bazında ROAS, bekleyen onaylar ve son uygulanan değişiklikler. Her incelemeden önce kullanın. Salt okunur, dış çağrı yapmaz.

ParametreTipAçıklama
platformİsteğe bağlıstring—
accountİsteğe bağlıstringbağlantıları hesap id'sine göre süzer
recent_daysİsteğe bağlıinteger (1–90)—
include_inactiveİsteğe bağlıbooleanharcaması olmayan duraklatılmış/bitmiş kampanyaları da listeler

get_billing_status

Okuma0 kredi

Mevcut plan, hesap durumu, deneme bitiş tarihi ve kredi bakiyesi (dönem, limit, kullanılan, kalan, koltuklar).

Bu araç parametre almaz.

start_subscription

Okuma0 kredi

Kullanıcıya, ücretli bir planı seçip yasal koşulları kabul ettiği ve güvenli ödeme sayfasında ödemeyi kendisinin yaptığı panel bağlantısını verir. Sohbetten hiçbir ücret alınmaz ve kart bilgisi istenmez.

ParametreTipAçıklama
planİsteğe bağlıpro | agency | enterprise—

issue_status

Okuma0 kredi

Bildirilen bir sorunun durumu: açık/yanıtlandı/kapandı, ne zaman bildirildiği ve varsa destek ekibinin yanıtı.

ParametreTipAçıklama
issue_idİsteğe bağlıstringvarsayılan: en son kayıt

list_open_problems

Okuma1 kredi

Asistanın gece taramasının bu hesapta bulduğu ve henüz çözüldüğünü görmediği açık sorunlar, en önemlisi önce: sorun kodu, alan (yayın, onay, bütçe, teklif, takip, hesap, bağlantı, eşitleme, feed, arama dizini, üretim, plan), önem, platform, hedef adı, platformun kendi durum kodu, ilk ve son görülme zamanı ve her sorunun katalogdaki düzeltmeleri kipiyle (auto = güvenli bakım, ask = parayı ya da yayındaki reklamı etkilediği için kullanıcının onayı gerekir, manual = kullanıcı platformda yapar; where nerede olduğunu söyler). Salt okunur: hiçbir düzeltme uygulamaz ve dışarıya çağrı yapmaz. Boş liste, son taramanın açık sorun görmediği anlamına gelir.

ParametreTipAçıklama
severityİsteğe bağlıhigh | medium | lowisteğe bağlı süzgeç
platformİsteğe bağlıstringisteğe bağlı süzgeç, ör. google, meta, search-console
limitİsteğe bağlıinteger (1–25)—

describe

Okuma0 kredi

Araçları bulur ve tam girdi şemalarını okur. name/names ile: açıklama, şema, kredi, salt okunur/yıkıcı işaretleri. query/platform ile: sıralı kısa liste. Görünür listede olmayan araçlara ulaşmak için kullanın.

ParametreTipAçıklama
nameİsteğe bağlıstring—
namesİsteğe bağlıarray<string>—
queryİsteğe bağlıstringaraç adlarında ve açıklamalarında aranacak sözcükler
platformİsteğe bağlıstring—
read_onlyİsteğe bağlıboolean—
limitİsteğe bağlıinteger (1–100)—

list_brands

Okuma0 kredi

List the account's projects (brands): id, name, default flag, how many ad/analytics accounts each one uses, and which project the tools currently work with. Every tool also accepts an optional `brand` argument (project id or name) to run once in another project.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

Bu araç parametre almaz.

list_rules

Okuma0 kredi

Automation rules set up with create_rule: id, condition (if) and action (then), mode (ask = asks first, auto = applies itself, off = only watches), on/off, how often and when it last fired, plus the latest rule runs and their outcome. Read-only, free.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

Bu araç parametre almaz.

list_whatsapp_templates

Okuma1 kredi

Bağlı işletme hesabının onaylı WhatsApp mesaj şablonları: ad, dil ve kategori. 24 saatlik pencere dışındaki mesajlar için şablon gerekir. Salt okunur.

Bu araç parametre almaz.

community_summary

Okuma1 kredi

Topluluk özeti: her topluluğun durumu, fiyatı, etkin üye sayısı, açık içerik bildirimleri ve e-posta / WhatsApp izni veren üye sayısı, planın topluluk sınırı, bu ayın tahmini Tecrübe payı ve bağlı ödeme hesapları. Üyelerin kişisel bilgisi dönmez. Yalnız okur.

Bu araç parametre almaz.

list_integration_recipes

Okuma1 kredi

Entegrasyon reçeteleri: katalog (yeni lead → e-posta / Telegram / WhatsApp, yeni sipariş → bildirim, kampanya uyarısı → kanal, webhook, Slack gibi otomasyon reçeteleri ve kurulum kılavuzları), planın her birine izin verip vermediği ve hangi planın açtığı, hangilerinin 'yakında' olduğu, kurulu reçeteler ve son çalışmaları, bu ayın çalışma sayısı ve kanal hazırlığı. Yalnız okur.

Bu araç parametre almaz.

Yazma araçları21 araç

connect_account

Yazma0 kredi

Bir platform hesabının bağlanmasını başlatır. Kullanıcının açması gereken bir yetkilendirme bağlantısı (OAuth) döndürür; kullanıcı oturum açmadan hiçbir şey bağlanmaz.

ParametreTipAçıklama
providerZorunlugoogle | meta | microsoft | tiktok | linkedin | apple | ga4 | search-console | gbp | whatsapp | shopify | youtube | ikas | x | pinterest | snapchat | reddit | yandex | tiktok-social—
shopİsteğe bağlıstringstore address for shopify / ikas (e.g. store.myshopify.com)

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_campaign

Yazma2 kredi

Kampanya TASLAĞI oluşturur (duraklatılmış). Yayına alma ayrı bir adımdır: onay kapısından geçen update_campaign(op=publish). Canlı adaptörü olmayan platformlar adımlarla birlikte can_go_live=false döndürür.

ParametreTipAçıklama
nameZorunlustring—
platformZorunlugoogle | meta | microsoft | tiktok | linkedin | apple—
kindİsteğe bağlıstringsearch | pmax | display | message | traffic | conversion
daily_budgetİsteğe bağlınumber—
goalİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_campaign

Yazma2 kredi

Kampanyayı duraklatır / sürdürür / günlük bütçesini değiştirir / yayınlar. Önizleme ve durum döndürür: uygulandı, onay bekliyor veya deneme çalıştırması. Kullanıcının onay politikası izin vermeden hiçbir şey uygulanmaz.

ParametreTipAçıklama
campaign_idZorunlustring—
opZorunlupause | resume | budget | publish—
amountİsteğe bağlınumberop=budget için günlük bütçe
currencyİsteğe bağlıstringoptional ISO 4217 check; must equal the ad account currency

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_budget

Yazma2 kredi

Platform düzeyinde bütçe belirler (kampanya id'si gerekmez). Önizleme ve onaydan geçer; değişiklik başına %50'nin üzerindeki artışlar engellenir.

ParametreTipAçıklama
platformZorunlustring—
amountZorunlunumber—
campaign_idİsteğe bağlıstringrequired: budgets change per campaign (list_campaigns)
currencyİsteğe bağlıstringISO 4217; must equal the ad account currency (no conversion)
periodİsteğe bağlıday | week | month—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

add_negative_keywords

Yazma2 kredi

Bir Google Ads kampanyasına negatif anahtar kelimeler ekler. Önizlemeli bir onay öğesi oluşturur; Google'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır.

ParametreTipAçıklama
campaign_idZorunlustring—
keywordsZorunluarray<string>—
match_typeİsteğe bağlıBROAD | PHRASE | EXACT—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_rule

Yazma2 kredi

'eğer … ise …' biçimindeki bir cümleyi otomasyon kuralına dönüştürür (mode=ask her tetiklemeyi onaya gönderir, auto harcama koruması içinde uygular).

ParametreTipAçıklama
sentenceZorunlustring—
modeİsteğe bağlıask | auto—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_spend_guard

Yazma1 kredi

Kâr koruması değişikliği önerir: günlük/aylık harcama sınırları, hedef CPA, kâr marjı, ortalama sipariş değeri, otomatik pilot. Önizleme (eski → yeni) döner ve panelde kullanıcının onayını bekler; o zamana kadar hiçbir şey değişmez.

ParametreTipAçıklama
daily_cap_tryİsteğe bağlınumber (0–…)—
monthly_cap_tryİsteğe bağlınumber (0–…)—
target_cpa_tryİsteğe bağlınumber (0–…)—
margin_pctİsteğe bağlınumber (0–…)—
aov_tryİsteğe bağlınumber (0–…)—
autopilotİsteğe bağlıboolean—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

approve_action

YazmaGeri alınamaz5 kredi

Bekleyen bir değişikliği uygular. İki adımlıdır: confirm olmadan hiçbir şey uygulanmaz, kullanıcıya gösterilecek önizleme döner. confirm=true yalnız kullanıcı o önizlemeyi açıkça onayladıktan sonra verilir. Aynı bağlantının önerdiği değişiklik burada onaylanamaz: sonuç approve_url döner, kullanıcı panelde onaylar. Uygulandı / deneme çalıştırması / başarısız döndürür.

ParametreTipAçıklama
action_idZorunlustring—
confirmZorunlubooleantrue olmalıdır; yalnızca kullanıcı açıkça onayladıktan sonra

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

reject_action

Yazma0 kredi

Bekleyen bir değişikliği (list_pending_approvals) reddeder; asla uygulanmaz. Kullanıcı bir önizlemeyi geri çevirdiğinde kullanılır: hiçbir platforma istek gitmez ve değişiklik onay kuyruğundan kalkar.

ParametreTipAçıklama
action_idZorunlustring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_brand_profile

Yazma1 kredi

Kullanıcı işletmeyi anlattığında marka profili alanlarını yazar.

ParametreTipAçıklama
fieldsZorunluobjectbusiness.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone …

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

draft_ad_copy

Yazma2 kredi

Marka profilinden reklam metni taslakları (başlıklar, açıklamalar, eylem çağrısı).

ParametreTipAçıklama
platformİsteğe bağlıgoogle | meta | instagram—
kindİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

reply_customer

YazmaGeri alınamaz2 kredi

Kullanıcı adına bir müşteri sohbetine yanıt önerir (yalnızca kullanıcı metni dikte ettiğinde veya onayladığında). Gönderilen mesaj geri alınamadığı için kiracının müşteri mesajları onay tercihine uyar (varsayılan: önce sor — panelde onay bekler).

ParametreTipAçıklama
thread_idZorunlustring—
textZorunlustring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

report_issue

Yazma0 kredi

Kullanıcının karşılaştığı bir sorun (araç hatası, yanlış veri, eksik özellik) için destek talebi açar. Talep destek gelen kutusuna düşer; yanıt panelde görünür. issue_status için issue_id döndürür.

ParametreTipAçıklama
subjectZorunlustring—
descriptionİsteğe bağlıstring—
categoryİsteğe bağlıgenel | fatura | baglanti | kampanya | hata | oneri—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

upload_image

Yazma1 kredi

Bir görseli (base64 ya da herkese açık URL) image_url isteyen araçların kabul ettiği imzalı, süreli, herkese açık bir görsel URL'sine dönüştürür. Hesabın özel dosya alanında saklanır; en fazla 5 MB PNG, JPEG, WEBP ya da GIF.

ParametreTipAçıklama
image_base64İsteğe bağlıstringPNG/JPEG/WEBP/GIF, isteğe bağlı olarak data: URL'si biçiminde
source_urlİsteğe bağlıstringbunun yerine kopyalanacak herkese açık http(s) görsel URL'si
filenameİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

call_write_tool

Yazma0 kredi

Herhangi bir aracı adıyla çalıştırır — kısaltılmış araç listesinde görünmeyen yeteneklere açılan kapı. Adı verilen araç kendi kurallarını korur: değişiklikler yine önizleme döndürür ve onay bekler, salt okunur bağlantılar yazamaz ve adı verilen aracın kredisi uygulanır (kapının kendisi ücretsizdir).

ParametreTipAçıklama
nameZorunlustringaracın tam adı (bkz. describe)
argumentsİsteğe bağlıobjecto aracın argümanları

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

generate_content

Yazma3 kredi

Bir istekten düz görsel, kısa video, UGC video, seslendirme ya da senaryoyu tek adımda üretir: çağrıldığı an BAŞLAR ve üretimin kredisi fiyat onayı beklenmeden kullanılır (kalan kredi yetmezse hiçbir şey başlamaz: credits_exhausted). Kalite kademesi ve tarif yoktur. Fiyatı önce gösterip kullanıcının onayını almak ya da Üretim ekranının herhangi bir tarifi (ürün fotoğrafı, düzenleme, AI influencer / avatar, marka filmi, dublaj, paket, varyasyonlar) için quote_production ve ardından start_production kullanın. Senaryo hemen gelir; dosyalar dakikalar sürer, durum ve adres için list_productions.

ParametreTipAçıklama
kindZorunlustringimage | short_video | ugc_video | voice | script
briefİsteğe bağlıstring—
campaign_idİsteğe bağlıstring—
resolutionİsteğe bağlı1K | 2K | 4Kimages only

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

select_brand

Yazma0 kredi

Choose the project (brand) the tools work with from now on — reports, changes and drafts then use that project's own Google/Meta accounts, site and counters. The choice is kept for your next sessions; 'default' goes back to the default project. Use list_brands to see the names.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçıklama
brandZorunlustringproject id or name; 'default' returns to the default project

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_rule_status

Yazma0 kredi

Switch an automation rule on or off, or change its mode (ask first / apply automatically / only watch). Use it when a rule fires wrongly or the member wants to pause it. Free.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçıklama
rule_idZorunlustringid from list_rules
enabledİsteğe bağlıbooleanfalse switches the rule off, true back on
modeİsteğe bağlıask | auto | offask | auto | off

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

send_message_to_opted_in

YazmaGeri alınamaz2 kredi

Bir kanalda (WhatsApp, SMS veya e-posta) izin veren her müşteriye tek bir mesaj gönderir. Önce alıcı sayısını gösterir ve onaydan geçer. Gönderilen mesaj geri alınamaz. İzin vermeyen kişiler asla dahil edilmez. Kanalın taşıyıcısı bağlı değilse mesaj giden kutusunda bekler. Tek bir konuşmayı yanıtlamak için reply_customer kullanın.

ParametreTipAçıklama
channelZorunluemail | sms | whatsappwhatsapp, sms veya email
textZorunlustringmesaj metni, en çok 1600 karakter

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

send_community_announcement

YazmaGeri alınamaz2 kredi

Topluluk akışında duyuru yayınlar ve e-posta izni veren etkin üyelere gönderir (isteğe bağlı WhatsApp). Önce alıcı sayısını gösterir ve onaydan geçer; toplu e-posta hakkından düşer. Gönderilen mesaj geri alınamaz. İzin vermeyen üyeye asla gitmez.

ParametreTipAçıklama
community_idZorunlustringcommunity_summary'den
titleZorunlustringduyuru başlığı, en çok 200 karakter
bodyİsteğe bağlıstringdüz metin gövde, en çok 8000 karakter
whatsappİsteğe bağlıbooleanWhatsApp izni veren üyelere işletmenin kendi WhatsApp hesabından da gönder

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

install_integration_recipe

Yazma1 kredi

Tetikleyicisi olunca sahip ve yöneticilere (e-posta, Telegram, WhatsApp ya da panel) haber veren bir otomasyon reçetesi kurar. Onaydan geçer; önce planı denetler, kanal bağlı değilse uyarır. Webhook adresi ya da gizli anahtar isteyen reçeteler panelden kurulmalıdır.

ParametreTipAçıklama
recipe_keyZorunlustringlist_integration_recipes'ten otomasyon reçetesi anahtarı
channelİsteğe bağlıemail | panel | telegram | whatsappkanal reçeteleri için: email, telegram, whatsapp ya da panel

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.