PluggzyDocs

Ferramentas de anúncios

Três ferramentas para todas as redes de anúncios: encontrar uma operação, ler, mudar. Funcionam igual em Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads e ChatGPT Ads, sem limites próprios do Pluggzy: só valem os limites de taxa de cada rede.

Ferramentas

Exatamente o que seu app de IA recebe de tools/list. ads_write muda sua conta de anúncios: tudo o que pode gastar ou dar acesso precisa antes do sim do usuário.

3 ferramentas · 2 de leitura · 1 de escrita
Anúncios3

Finds ads operations for Meta Ads, Google Ads, LinkedIn Ads, TikTok Ads, Pinterest Ads, X Ads, Reddit Ads, Microsoft Ads, ChatGPT Ads (campaigns, budgets, boosts, targeting, audiences, conversions, creatives, leads, insights…) by words or group; with operation, its parameters and body.

Permissão View profiles
Entrada3 parâmetros · 0 obrigatórios
operationstring
querystring
words, e.g. "pause campaign"
groupstring
SaídastructuredContent
{
  "structuredContent": {
    "operations": [
      {
        "name": "update_ad_campaign_status",
        "summary": "Pause or resume a campaign",
        "kind": "write",
        "needs_user_confirmed": true
      },
      {
        "name": "bulk_update_ad_campaign_status",
        "summary": "Pause or resume many campaigns",
        "kind": "write",
        "needs_user_confirmed": true
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "2 operation(s)."
    }
  ]
}
O que a proteção fezExemplo09:41:02 → 09:41:02
  1. Recebida09:41:02
  2. RespondidaNenhuma chamada à rede
O conteúdo de texto começa com “2 operation(s).” · Pode recusar comnot_foundinvalid_requestpermission

Runs a read-only ads operation (see ads_operations): campaigns with spend and results, daily metrics, insights, audiences, leads. Money is in the account's currency.

Permissão View profilesLimite Sem limite próprio do Pluggzy · valem os limites de taxa da rede
Entrada4 parâmetros · 1 obrigatório
accountstring
ad account_id (list_accounts), when several
operationstringobrigatório
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
SaídastructuredContent
{
  "structuredContent": {
    "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e",
    "provider": "metaads",
    "operation": "get_ads_timeline",
    "result": {
      "rows": [
        {
          "date": "2026-11-16",
          "currency": "EUR",
          "spend": 112.4,
          "impressions": 18420,
          "clicks": 391,
          "ctr": 2.12,
          "conversions": 14
        },
        {
          "date": "2026-11-17",
          "currency": "EUR",
          "spend": 118.9,
          "impressions": 19105,
          "clicks": 402,
          "ctr": 2.1,
          "conversions": 16
        }
      ]
    }
  },
  "content": [
    {
      "type": "text",
      "text": "Meta Ads: get_ads_timeline done."
    }
  ]
}
O que a proteção fezExemplo09:41:02 → 09:41:03
  1. Recebida09:41:02
  2. Nenhum limite próprio do PluggzySó os limites da própria rede
  3. Enviada09:41:03
O conteúdo de texto começa com “Meta Ads: get_ads_timeline done.” · Pode recusar comnot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

Runs an ads operation that changes the account (see ads_operations): create, boost, pause, budgets, targeting, deletions. needs_user_confirmed ones spend money or grant access: tell the user what will run (budget, dates, audience) and set user_confirmed only once they agree. New ads can go live at once: send a paused status to review first.

Permissão Send messages & postsLimite Sem limite próprio do Pluggzy · valem os limites de taxa da redeConfirme com o usuário antes
Entrada5 parâmetros · 1 obrigatório
accountstring
ad account_id (list_accounts), when several
operationstringobrigatório
name from ads_operations
paramsobject
path and query parameters
bodyobject
JSON body
user_confirmedboolean
the user approved this change
SaídastructuredContent
{
  "structuredContent": {
    "account_id": "7c1e9a40-3b2d-4f6a-9e85-1d0c2b3a4f5e",
    "provider": "metaads",
    "operation": "update_ad_campaign_status",
    "result": {
      "success": true,
      "campaignId": "120214455667788990",
      "status": "PAUSED"
    }
  },
  "content": [
    {
      "type": "text",
      "text": "Meta Ads: update_ad_campaign_status done."
    }
  ]
}
O que a proteção fezExemplo09:41:02 → 09:41:03
  1. Recebida09:41:02
  2. Nenhum limite próprio do PluggzySó os limites da própria rede
  3. Enviada09:41:03
O conteúdo de texto começa com “Meta Ads: update_ad_campaign_status done.” · Pode recusar comconfirmation_requirednot_foundunsupportedinvalid_requestrate_limitedcooldownpermission

Erros

Toda recusa tem um code com que seu app de IA sabe lidar, e uma mensagem que diz o que fazer.

Recusas de anúncios

Nada é enfileirado nem repetido escondido: seu app de IA lê o código e a mensagem, e corrige a chamada ou pergunta a você.

confirmation_requiredSó ads_write. A operação pode gastar dinheiro ou dar acesso e user_confirmed não era true. Diga ao usuário o que vai rodar e chame de novo.
unsupportedA operação não funciona na rede dessa conta de anúncios (sem impulsionamento no Microsoft Ads nem no ChatGPT Ads). A mensagem diz para quais redes ela serve.
invalid_requestA rede recusou a chamada: a mensagem começa com o nome dela, e fields indica os valores a corrigir.
not_foundNenhuma operação com esse nome: a mensagem lista as mais próximas.
rate_limitedA própria rede pediu para ir mais devagar (o limite de taxa dela; o Pluggzy não tem nenhum nas contas de anúncios). retry_after_seconds é exatamente a espera pedida: chame de novo depois.
Exemplo de recusa
isError
{
  "error": "Meta Ads refused: the daily budget is below this ad account’s minimum.",
  "req_id": "req_7f3a9c21e4b8",
  "code": "invalid_request",
  "fields": {
    "budgetAmount": "below the ad account’s minimum daily budget"
  }
}
Os códigos de todos os canaiscooldown e permission funcionam como em todo o resto do Pluggzy.
Erros
Gerado a partir de pluggzy.com/api/docs · 42 ferramentasAlgo não ficou claro? Fale com o suporte · Status