Outils généraux
État du compte, résumé des campagnes, rapports, file de validation, profil de marque et outils de modification indépendants du canal.
Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.
Outils de lecture22 outils
get_status
Lecture1 créditsVue d'ensemble du compte : marque, forfait, plateformes connectées, campagnes (7 jours), approbations en attente, conversations clients ouvertes, garde-fou de dépenses. À appeler en premier lorsque le contexte est inconnu.
Cet outil ne prend aucun paramètre.
list_accounts
Lecture1 créditsComptes publicitaires et de données connectés (google, meta, microsoft, tiktok, linkedin, ga4, search-console, gbp, whatsapp) avec leur statut. Les connexions 'sample' sont des données de démonstration, pas des données réelles.
| Paramètre | Type | Description |
|---|---|---|
platformFacultatif | string | optional filter, e.g. google, meta, microsoft |
all_accessibleFacultatif | boolean | also name the tool that lists every accessible account of each platform |
list_campaigns
Lecture1 créditsCampagnes avec les dépenses, clics, commandes et revenus des N derniers jours. Utilisez les identifiants de campagne renvoyés pour update_campaign / add_negative_keywords.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
get_report
Lecture1 créditsRapport de période : dépenses, commandes, revenus, ROAS, variation par rapport à la période précédente, suggestions. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
periodFacultatif | day | week | month | — |
platformFacultatif | string | all (default) | google | meta | microsoft | tiktok | linkedin | openai-ads | ga4 | search-console |
accountFacultatif | string | account id on platforms that take one per call (microsoft, linkedin, openai-ads, ga4 property, search-console site) |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
levelFacultatif | string | campaign | ad_group | adset | ad | keyword | location | device | age_gender (what the platform supports) |
breakdownFacultatif | string | platform breakdown, e.g. device, age, placement |
limitFacultatif | integer (1–500) | — |
search_terms_report
Lecture2 créditsTermes de recherche Google Ads avec dépenses, clics et conversions des N derniers jours, ainsi que les termes gaspillés (zéro conversion). Nécessite un compte Google Ads connecté ; sinon renvoie une note, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
campaign_idFacultatif | string | — |
account_audit
Lecture3 créditsAudit d'hygiène du compte sous forme de constats priorisés : dépenses sans résultat, budgets manquants, absence de plafond de dépenses, termes de recherche gaspillés, approbations en attente. Lecture seule.
Cet outil ne prend aucun paramètre.
list_pending_approvals
Lecture1 créditsModifications en attente de l'approbation de l'utilisateur (id, type, titre).
Cet outil ne prend aucun paramètre.
get_brand_profile
Lecture1 créditsBase de connaissances de la marque : secteur, localisation, produits, audience, objectifs, ton, concurrents.
Cet outil ne prend aucun paramètre.
research
Lecture4 créditsRecherche web (concurrent, prix, règle sectorielle). Si aucun fournisseur de recherche n'est configuré, renvoie une note ; n'invente jamais de résultats.
| Paramètre | Type | Description |
|---|---|---|
queryObligatoire | string | — |
list_customers
Lecture1 créditsConversations clients dans la boîte de réception (WhatsApp, Messenger, Instagram) : qui a écrit, dernier message, en attente de réponse.
| Paramètre | Type | Description |
|---|---|---|
stateFacultatif | needs_you | waiting | auto | done | — |
limitFacultatif | integer | — |
list_entities
Lecture1 créditsListe avec leurs id, de façon paginée, les campagnes, groupes / ensembles d'annonces, annonces ou mots-clés de n'importe quelle plateforme publicitaire connectée — au lieu de chercher l'outil de liste propre à la plateforme (le résultat indique l'outil source). Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
platformFacultatif | string | google | meta | microsoft | tiktok | linkedin | openai-ads (vide = campagnes du registre de toutes les plateformes) |
entityFacultatif | campaigns | ad_groups | ads | keywords | — |
parent_idFacultatif | string | id de campagne pour les groupes d'annonces, id de groupe d'annonces pour les annonces/mots-clés (si la plateforme l'exige) |
accountFacultatif | string | id de compte pour les plateformes qui en prennent un par appel |
daysFacultatif | integer (1–90) | campagnes du registre : chiffres des N derniers jours |
limitFacultatif | integer (1–500) | — |
offsetFacultatif | integer (0–…) | — |
account_snapshot
Lecture1 créditsVue d'ensemble d'un compte publicitaire (ou de tous) en un seul appel : connexions, nombre de campagnes actives/en pause, dépenses récentes, commandes, chiffre d'affaires, ROAS par plateforme et par campagne, approbations en attente et dernières modifications appliquées. À utiliser avant toute revue. Lecture seule, aucun appel externe.
| Paramètre | Type | Description |
|---|---|---|
platformFacultatif | string | — |
accountFacultatif | string | filtre les connexions par id de compte |
recent_daysFacultatif | integer (1–90) | — |
include_inactiveFacultatif | boolean | liste aussi les campagnes en pause/terminées sans dépenses |
get_billing_status
Lecture0 créditsForfait actuel, statut du compte, date de fin d'essai et solde de crédits (période, limite, utilisés, restants, sièges).
Cet outil ne prend aucun paramètre.
start_subscription
Lecture0 créditsDonne à l'utilisateur le lien du tableau de bord où il choisit lui-même un forfait payant, accepte les conditions légales et paie sur la page de paiement sécurisée. Rien n'est débité depuis le chat et aucune donnée de carte n'est demandée.
| Paramètre | Type | Description |
|---|---|---|
planFacultatif | pro | agency | enterprise | — |
issue_status
Lecture0 créditsStatut d'un problème signalé : ouvert/répondu/fermé, date du signalement et réponse de l'équipe d'assistance dès qu'il y en a une.
| Paramètre | Type | Description |
|---|---|---|
issue_idFacultatif | string | par défaut : le dernier ticket |
list_open_problems
Lecture1 créditsProblèmes ouverts que l'analyse nocturne de l'assistant a trouvés dans ce compte et qu'elle n'a pas encore vus résolus, le plus grave en premier : code du problème, domaine (diffusion, validation, budget, enchères, suivi, compte, connexion, synchronisation, flux, indexation, production, forfait), gravité, plateforme, nom de la cible, code d'état propre à la plateforme, première et dernière observation, ainsi que les corrections du catalogue pour chaque problème avec leur mode (auto = maintenance sûre, ask = nécessite l'accord de l'utilisateur car cela touche à l'argent ou à une annonce en ligne, manual = l'utilisateur le fait sur la plateforme ; where indique où). Lecture seule : n'applique aucune correction et ne fait aucun appel externe. Une liste vide signifie que la dernière analyse n'a vu aucun problème ouvert.
| Paramètre | Type | Description |
|---|---|---|
severityFacultatif | high | medium | low | filtre facultatif |
platformFacultatif | string | filtre facultatif, p. ex. google, meta, search-console |
limitFacultatif | integer (1–25) | — |
describe
Lecture0 créditsTrouve des outils et lit leur schéma d'entrée complet. Avec name/names : description, schéma, crédits, indicateurs lecture seule/destructif. Avec query/platform : une courte liste classée. À utiliser pour atteindre les outils absents de la liste visible.
| Paramètre | Type | Description |
|---|---|---|
nameFacultatif | string | — |
namesFacultatif | array<string> | — |
queryFacultatif | string | mots à rechercher dans les noms et descriptions des outils |
platformFacultatif | string | — |
read_onlyFacultatif | boolean | — |
limitFacultatif | integer (1–100) | — |
list_brands
Lecture0 créditsList 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.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
Cet outil ne prend aucun paramètre.
list_rules
Lecture0 créditsAutomation 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.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
Cet outil ne prend aucun paramètre.
list_whatsapp_templates
Lecture1 créditsModèles de messages WhatsApp approuvés du compte professionnel connecté : nom, langue et catégorie. Les modèles sont nécessaires pour les messages hors de la fenêtre de 24 heures. Lecture seule.
Cet outil ne prend aucun paramètre.
community_summary
Lecture1 créditsVue d'ensemble des communautés : statut, prix, nombre de membres actifs, signalements de contenu ouverts et nombre de membres ayant donné leur accord e-mail / WhatsApp, limite de communautés du forfait, commission Tecrübe estimée du mois et comptes de paiement connectés. Aucune donnée personnelle des membres. Lecture seule.
Cet outil ne prend aucun paramètre.
list_integration_recipes
Lecture1 créditsRecettes d'intégration : le catalogue (recettes d'automatisation comme nouveau prospect → e-mail / Telegram / WhatsApp, nouvelle commande → notification, alerte de campagne → canal, webhook, Slack, et guides de configuration), si le forfait autorise chacune et quel forfait la débloque, celles « bientôt » disponibles, les recettes installées avec leur dernière exécution, les exécutions du mois et l'état des canaux. Lecture seule.
Cet outil ne prend aucun paramètre.
Outils d'écriture21 outils
connect_account
Écriture0 créditsLance la connexion d'un compte de plateforme. Renvoie un lien d'autorisation que l'utilisateur doit ouvrir (OAuth) ; rien n'est connecté sans que l'utilisateur se connecte lui-même.
| Paramètre | Type | Description |
|---|---|---|
providerObligatoire | google | meta | microsoft | tiktok | linkedin | apple | ga4 | search-console | gbp | whatsapp | shopify | youtube | ikas | x | pinterest | snapchat | reddit | yandex | tiktok-social | — |
shopFacultatif | string | store address for shopify / ikas (e.g. store.myshopify.com) |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_campaign
Écriture2 créditsCrée un BROUILLON de campagne (en pause). La mise en ligne est une étape distincte : update_campaign(op=publish), qui passe par le contrôle d'approbation. Les plateformes sans adaptateur en direct renvoient can_go_live=false avec les étapes à suivre.
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
platformObligatoire | google | meta | microsoft | tiktok | linkedin | apple | — |
kindFacultatif | string | search | pmax | display | message | traffic | conversion |
daily_budgetFacultatif | number | — |
goalFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_campaign
Écriture2 créditsMettre en pause / reprendre / modifier le budget quotidien / publier une campagne. Renvoie un aperçu et un statut : appliqué, en attente d'approbation ou simulation. Rien n'est appliqué sans que la politique d'approbation de l'utilisateur l'autorise.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
opObligatoire | pause | resume | budget | publish | — |
amountFacultatif | number | budget quotidien pour op=budget |
currencyFacultatif | string | optional ISO 4217 check; must equal the ad account currency |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_budget
Écriture2 créditsDéfinit un budget au niveau de la plateforme (aucun identifiant de campagne requis). Passe par l'aperçu et l'approbation ; les augmentations supérieures à 50 % par modification sont bloquées.
| Paramètre | Type | Description |
|---|---|---|
platformObligatoire | string | — |
amountObligatoire | number | — |
campaign_idFacultatif | string | required: budgets change per campaign (list_campaigns) |
currencyFacultatif | string | ISO 4217; must equal the ad account currency (no conversion) |
periodFacultatif | day | week | month | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_negative_keywords
Écriture2 créditsAjoute des mots-clés négatifs à une campagne Google Ads. Crée un élément d'approbation avec un aperçu ; appliqué sur Google uniquement après approbation et uniquement avec un compte connecté.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
keywordsObligatoire | array<string> | — |
match_typeFacultatif | BROAD | PHRASE | EXACT | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_rule
Écriture2 créditsTransforme une phrase « si … alors … » en règle d'automatisation (mode=ask soumet chaque déclenchement à approbation, auto applique dans les limites du garde-fou de dépenses).
| Paramètre | Type | Description |
|---|---|---|
sentenceObligatoire | string | — |
modeFacultatif | ask | auto | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_spend_guard
Écriture1 créditsPropose une modification du garde-fou de rentabilité : plafonds de dépenses quotidiens/mensuels, CPA cible, marge, panier moyen, pilote automatique. Renvoie un aperçu (ancien → nouveau) qui attend l'approbation de l'utilisateur dans le tableau de bord ; rien ne change d'ici là.
| Paramètre | Type | Description |
|---|---|---|
daily_cap_tryFacultatif | number (0–…) | — |
monthly_cap_tryFacultatif | number (0–…) | — |
target_cpa_tryFacultatif | number (0–…) | — |
margin_pctFacultatif | number (0–…) | — |
aov_tryFacultatif | number (0–…) | — |
autopilotFacultatif | boolean | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
approve_action
ÉcritureIrréversible5 créditsApplique une modification en attente. En deux étapes : sans confirm, rien n'est appliqué et l'aperçu à montrer à l'utilisateur est renvoyé. Passez confirm=true uniquement après que l'utilisateur a explicitement approuvé cet aperçu. Une modification proposée par cette même connexion ne peut pas être approuvée ici : le résultat contient approve_url, l'utilisateur l'approuve dans le tableau de bord. Renvoie appliqué / simulation / échec.
| Paramètre | Type | Description |
|---|---|---|
action_idObligatoire | string | — |
confirmObligatoire | boolean | doit être true ; uniquement après approbation explicite de l'utilisateur |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
reject_action
Écriture0 créditsRejette une modification en attente (issue de list_pending_approvals) afin qu'elle ne soit jamais appliquée. À utiliser lorsque l'utilisateur refuse un aperçu ; rien n'est envoyé à aucune plateforme et la modification disparaît de la file d'approbation.
| Paramètre | Type | Description |
|---|---|---|
action_idObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_brand_profile
Écriture1 créditsRenseigne les champs du profil de marque lorsque l'utilisateur décrit son activité.
| Paramètre | Type | Description |
|---|---|---|
fieldsObligatoire | object | business.sector, business.location, goals.target, products.list, audience.primary, competitors.list, brand.tone … |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
draft_ad_copy
Écriture2 créditsÉbauches de textes publicitaires (titres, descriptions, appel à l'action) à partir du profil de marque.
| Paramètre | Type | Description |
|---|---|---|
platformFacultatif | google | meta | instagram | — |
kindFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
reply_customer
ÉcritureIrréversible2 créditsPropose une réponse à un fil de discussion client au nom de l'utilisateur (uniquement lorsque l'utilisateur a dicté ou approuvé le texte). Un message envoyé ne peut pas être repris : la politique d'approbation du compte pour les messages clients s'applique (par défaut : demander d'abord — attend l'approbation dans le tableau de bord).
| Paramètre | Type | Description |
|---|---|---|
thread_idObligatoire | string | — |
textObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
report_issue
Écriture0 créditsOuvre un ticket d'assistance pour un problème rencontré par l'utilisateur (erreur d'outil, données erronées, fonctionnalité manquante). Il arrive dans la boîte de réception du support ; la réponse s'affiche dans le tableau de bord. Renvoie issue_id pour issue_status.
| Paramètre | Type | Description |
|---|---|---|
subjectObligatoire | string | — |
descriptionFacultatif | string | — |
categoryFacultatif | genel | fatura | baglanti | kampanya | hata | oneri | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_image
Écriture1 créditsTransforme une image (base64 ou URL publique) en URL d'image publique signée et à durée limitée, acceptée par les outils qui demandent image_url. Stockée dans l'espace de fichiers privé du compte ; PNG, JPEG, WEBP ou GIF jusqu'à 5 Mo.
| Paramètre | Type | Description |
|---|---|---|
image_base64Facultatif | string | PNG/JPEG/WEBP/GIF, éventuellement sous forme d'URL data: |
source_urlFacultatif | string | URL d'image http(s) publique à copier à la place |
filenameFacultatif | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
call_write_tool
Écriture0 créditsExécute n'importe quel outil par son nom — la passerelle vers les fonctionnalités absentes d'une liste d'outils réduite. L'outil nommé conserve ses propres règles : les modifications renvoient toujours un aperçu et attendent une validation, les connexions en lecture seule ne peuvent pas écrire et les crédits de l'outil nommé s'appliquent (la passerelle elle-même est gratuite).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | nom exact de l'outil (voir describe) |
argumentsFacultatif | object | les arguments de cet outil |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
generate_content
Écriture3 créditsGénère en une étape une image simple, une vidéo courte, une vidéo UGC, une voix off ou un script à partir d'une demande : il DÉMARRE DÈS l'appel et les crédits de la production sont utilisés sans confirmation du prix (si les crédits ne suffisent pas, rien ne démarre : credits_exhausted). Ni niveau de qualité ni recette. Pour montrer d'abord le prix et obtenir l'accord de l'utilisateur, ou pour toute recette de l'écran Production (photo produit, retouche, influenceur / avatar IA, film de marque, doublage, pack, variantes), utilisez quote_production puis start_production. Le script est immédiat ; les fichiers prennent quelques minutes, statut et adresse avec list_productions.
| Paramètre | Type | Description |
|---|---|---|
kindObligatoire | string | image | short_video | ugc_video | voice | script |
briefFacultatif | string | — |
campaign_idFacultatif | string | — |
resolutionFacultatif | 1K | 2K | 4K | images only |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
select_brand
Écriture0 créditsChoose 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.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
brandObligatoire | string | project id or name; 'default' returns to the default project |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_rule_status
Écriture0 créditsSwitch 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.
La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.
| Paramètre | Type | Description |
|---|---|---|
rule_idObligatoire | string | id from list_rules |
enabledFacultatif | boolean | false switches the rule off, true back on |
modeFacultatif | ask | auto | off | ask | auto | off |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
send_message_to_opted_in
ÉcritureIrréversible2 créditsEnvoie un message à chaque client ayant donné son accord sur un canal (WhatsApp, SMS ou e-mail). Affiche d'abord le nombre de destinataires et passe par l'approbation. Un message envoyé ne peut pas être annulé. Les personnes sans consentement ne sont jamais incluses. Si l'opérateur du canal n'est pas connecté, le message attend dans la boîte d'envoi. Pour répondre à une seule conversation, utilisez reply_customer.
| Paramètre | Type | Description |
|---|---|---|
channelObligatoire | email | sms | whatsapp | whatsapp, sms ou email |
textObligatoire | string | texte du message, 1600 caractères au maximum |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
send_community_announcement
ÉcritureIrréversible2 créditsPublie une annonce dans le fil de la communauté et l'envoie par e-mail aux membres actifs ayant donné leur accord (WhatsApp en option). Affiche d'abord le nombre de destinataires et passe par l'approbation ; décompté du quota d'e-mails groupés. Un message envoyé ne peut pas être annulé. Les membres sans accord ne le reçoivent jamais.
| Paramètre | Type | Description |
|---|---|---|
community_idObligatoire | string | issu de community_summary |
titleObligatoire | string | titre de l'annonce, 200 caractères au plus |
bodyFacultatif | string | corps en texte brut, 8000 caractères au plus |
whatsappFacultatif | boolean | envoyer aussi depuis le compte WhatsApp de l'entreprise aux membres ayant donné leur accord WhatsApp |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
install_integration_recipe
Écriture1 créditsInstalle une recette d'automatisation qui prévient les propriétaires et administrateurs (e-mail, Telegram, WhatsApp ou panneau) lorsque son déclencheur se produit. Passe par l'approbation ; vérifie d'abord le forfait et avertit si le canal n'est pas connecté. Les recettes qui demandent une adresse de webhook ou une clé secrète doivent être installées depuis le panneau.
| Paramètre | Type | Description |
|---|---|---|
recipe_keyObligatoire | string | clé d'une recette d'automatisation issue de list_integration_recipes |
channelFacultatif | email | panel | telegram | whatsapp | pour les recettes de canal : email, telegram, whatsapp ou panel |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.