# OneClick Ads Docs — instructions for agents

> Central de ajuda do OneClick Ads: guias de integração de rastreamento de conversões, otimizações automáticas de campanhas Meta Ads, faturamento e muito mais.

O OneClick Ads é uma plataforma de otimização automática de campanhas Meta Ads. Esta documentação cobre: configuração do OneClick Tracking (integrações com Hotmart, Kiwify, Shopify, Pipedrive, HubSpot, Kommo, GoHighLevel e outras plataformas), otimizações automáticas de campanhas, gerenciamento de assinatura e faturamento, e controle de orçamento via OneClick Budget.

## When to use this

Reach for OneClick Ads Docs when you need to answer a question about how the OneClick Ads product works. Specifically:

- Configuring **OneClick Tracking**: which webhook or credential a given checkout, CRM or ecommerce platform needs, and what the attribution modes do.
- Understanding **automatic Meta Ads optimization** by OneClick Ads: the suffix system, pause/scale profiles, manual tags, target CPA and ROAS parameterization.
- Linking and troubleshooting **Meta ad accounts**: Business Manager permissions, account access status, why an account shows as disconnected.
- **Subscription and billing** questions: billing cycle, plan investment limits, upgrades, contracting without a sales call.
- **OneClick Budget**: monthly ad-account spend ceilings, the alerts they raise, and what happens when the ceiling is reached.
- Connecting an AI assistant to OneClick Ads over **MCP**, and what that assistant can read or change.
- **Validated campaign structures** (Campanhas Validadas): proven CBO/ABO scale and creative-testing blueprints for Meta Ads.

## When not to use this

- Meta Ads platform behaviour that is not OneClick Ads-specific — use Meta's own documentation.
- Account-specific data (a real campaign's spend, a user's conversions). This site is static documentation; query the MCP server at https://mcp.oneclickads.com.br/mcp instead.
- Internal API schemas or payload keys. The agent-facing contract is the MCP tool schema itself, not this site.

## Developer resources

- [OneClick Ads MCP server](https://mcp.oneclickads.com.br/mcp): OneClick Ads MCP (Model Context Protocol) server endpoint. Authenticate with OAuth or with an API key sent as `Authorization: Bearer <token>`.
- [OneClick Ads MCP — connection guide](https://docs.oneclickads.com.br/pt-br/mcp/conectar-um-assistente-de-ia/): How to connect an AI assistant to OneClick Ads over MCP — OAuth flow and API-key flow, with a curl example.
- [OneClick Ads MCP — capabilities](https://docs.oneclickads.com.br/pt-br/mcp/): What the OneClick Ads MCP server exposes: ad accounts, campaigns, ad sets, ads, optimizations and conversion logs.
- [OneClick Ads API keys & connected apps](https://app.oneclickads.com.br/user/connections): Create, review and revoke OneClick Ads API keys and connected apps.
- [OneClick Tracking — custom webhook integration](https://docs.oneclickads.com.br/pt-br/oneclick-tracking/integracao-customizada/): Send conversions from any platform into OneClick Tracking with a custom webhook payload.
- [OneClick Tracking — integration catalog](https://docs.oneclickads.com.br/pt-br/oneclick-tracking/): Every first-party OneClick Tracking integration (Hotmart, Kiwify, Shopify, Nuvemshop, HubSpot, Pipedrive, Kommo, RD Station CRM and more).
- [OneClick Ads — recursos para desenvolvedores](https://docs.oneclickads.com.br/pt-br/desenvolvedores/): Developer resources hub for OneClick Ads, in Portuguese.

## How to fetch this site

- Every HTML page has a raw Markdown twin at the same path with a `.md` suffix: `https://docs.oneclickads.com.br/pt-br/faq/` → `https://docs.oneclickads.com.br/pt-br/faq.md`.
- The Markdown twin is served as `text/markdown; charset=utf-8`. Prefer it over parsing the HTML.
- `https://docs.oneclickads.com.br/llms.txt` lists every page; `https://docs.oneclickads.com.br/llms-full.txt` is the whole corpus in one file.
- Unknown paths answer **HTTP 404** with a short recovery body — a 404 here means the page does not exist, not that the site is down.
- Content is written in pt-BR (Brazilian Portuguese).

## Machine-readable entrypoints

- [llms.txt](https://docs.oneclickads.com.br/llms.txt): Index of every documentation page (title, description, Markdown URL). Start here.
- [llms-full.txt](https://docs.oneclickads.com.br/llms-full.txt): Full text of every documentation page concatenated into a single Markdown file.
- [AGENTS.md](https://docs.oneclickads.com.br/AGENTS.md): These instructions: what this site covers, when to use it, and how to fetch it.
- [sitemap-index.xml](https://docs.oneclickads.com.br/sitemap-index.xml): XML sitemap index listing every canonical HTML page.
- [Documentation index](https://docs.oneclickads.com.br/pt-br/): Human documentation index (pt-BR).