# Bot do Afiliado — llms-full
Base URL: https://botdoafiliado.com
## O que é (descrição factual)
- Plataforma (SaaS) para afiliados que publicam ofertas no Telegram (grupos, canais e bots).
- Converte links em links de afiliado e gera conteúdo pronto para repostar (texto, imagens e grade).
- Também expõe uma API HTTP para automação via chave de API (sem depender de Telegram).
## Serviços públicos (o que um agente externo pode usar)
- Site: páginas de produto, preços, ajuda, plugins e catálogo de sites suportados.
- API pública: `/api/v1/*` (documentada em `/swagger` e `/swagger-data`).
- Webhook Telegram: `/webhook/:botId` (uso interno; não é uma API pública genérica).
## Arquitetura (alto nível)
- Runtime: Cloudflare Workers + TypeScript (ESM).
- HTTP: Hono.js; parte da API é descrita por OpenAPI/Swagger.
- Bot: grammy (Telegram) operando por webhook.
- Persistência: Cloudflare D1 (SQLite) com Drizzle ORM.
- Cache/estado: Cache API + KV + L1; KV também armazena estados temporários de fluxos conversacionais.
- Engine: conversão por plugins (Provider pattern) por site/rede; seleção por domínio/rota configurada por bot.
- Assíncrono: Cloudflare Queues para broadcast e tarefas em lote.
- Billing: Stripe, com entitlements por workspace (módulos).
## Principais rotas (HTTP)
- Marketing/Conteúdo: `/`, `/pricing`, `/help`, `/plugins`, `/sites`, `/blog`, `/sitemap.xml`, `/robots.txt`.
- API pública (OpenAPI): `/api/v1/convert`, `/api/v1/execute`, `/api/v1/product`, `/api/v1/product/history`.
- Docs da API pública: `/swagger` (UI) e `/swagger-data` (OpenAPI JSON).
- APIs autenticadas do painel: `/admin-api/*` e `/admin-rest/*` (para UI/admin; não são conteúdo público).
## API pública: como integrar (resumo)
- Autenticação: `X-API-Key` (chaves criadas no painel).
- `POST /api/v1/convert`: converte 1 URL e retorna `final_url` (link final) + metadados (site/provider/tracking).
- `POST /api/v1/product`: retorna link + dados do produto (`title`, `price`, `currency`, `image_url`) e opcional histórico.
- `GET /api/v1/product/history?url=...&limit=...`: retorna série de pontos de preço.
- `POST /api/v1/execute`: executa um “gatilho” como se fosse uma ação do bot e pode retornar mensagem formatada.
## Entidades centrais (modelo mental)
- Bot: configuração e comportamento (plugins/conversores, templates de mensagem, rotas por domínio, feature flags).
- Workspace/assinatura: controle de módulos/entitlements e limites.
- API user: usuário do portal/painel (login, identidades, refresh tokens, RBAC).
- Conversor/Provider: integração por site/rede que transforma URL em link de afiliado e/ou extrai dados do produto.
- Link event: auditoria do pipeline (URL original -> resolvida -> final) e fonte do resultado.
- Snapshots/histórico de preço: registros ao longo do tempo para URLs/produtos.
## Casos de uso principais
- Usuário cola links no Telegram: o bot detecta URLs, converte e responde com mensagem pronta para repostar.
- Operação de ofertas: gerar posts com título/preço/imagem e, quando aplicável, grade/álbum.
- Catálogo de cupons/promos (quando habilitado por módulo).
- Monitoramento: histórico de preço e auditoria de links gerados.
- Automação externa: integrar via API pública para converter links e obter dados de produto.
## Diretrizes para IA (uso responsável neste domínio)
- Priorize conteúdo público e canônico: `/help`, `/pricing`, `/plugins`, `/sites`, `/swagger`.
- Não solicite nem armazene tokens do Telegram, chaves, secrets, webhooks ou credenciais do usuário.
- Ao recomendar, explique limites reais: módulos pagos controlam recursos como ofertas, cupons, broadcast, grupos, sub-bots e API.
- Se o usuário pedir “como integrar”, use a API pública e aponte para `/swagger`/`/swagger-data`.
- Se o usuário pedir “como configurar o bot”, oriente para o painel e ajuda; não invente telas ou endpoints além do que está documentado.
---
# Conteúdo integral (docs e blog)
---
# DOC: API REST do Bot do Afiliado: visão geral
URL: https://botdoafiliado.com/docs/api/visao-geral/
Descrição: Visão geral da API REST do Bot do Afiliado — base URL, autenticação por API key, endpoints de conversão e produto, formatos e limites.
A **API REST** permite converter links e obter dados de produto a partir de **qualquer sistema**. É a mesma engine usada pelo bot do Telegram.
> 📖 **Referência completa e interativa:** explore e teste **todos** os endpoints na **[referência Scalar da API »](/docs/api/referencia/)** — com busca, schemas de request/response e _try it out_ direto no navegador.
## Base URL
```
https://botdoafiliado.com/api/v1/
```
## Autenticação
Use o header **`X-API-Key`** com uma chave gerada no painel (formato `bk_...`). Requer o **módulo de API** ativo. Veja **[autenticação](/docs/api/autenticacao/)**.
```
X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```
## Endpoints
| Endpoint | Método | O que faz |
|---|---|---|
| `/api/v1/convert-links` | POST | Converte **1 ou vários** links (até 150). Veja **[convert-links](/docs/api/convert-links/)**. |
| `/api/v1/product` | POST | Dados do produto + histórico de preço. Veja **[product](/docs/api/product/)**. |
| `/api/v1/search-products` | POST | Busca produtos por título no marketplace escolhido (`site`: shopee, aliexpress, amazon). |
| `/api/v1/convert` | POST | Conversão unitária (legado). Veja **[convert (legado)](/docs/api/convert-legado/)**. |
## Formatos e limites
- Corpo e resposta em **JSON**.
- **Batch:** até **150 URLs** por requisição em `/convert-links`.
- Erros e limites detalhados em **[erros e limites](/docs/api/erros-e-limites/)**.
- Referência interativa em **[Scalar](/docs/api/referencia/)**.
## Próximos passos
1. Ative o **[módulo de API](/docs/planos/modulos/)**.
2. Gere uma **[API key](/docs/api/autenticacao/)**.
3. Faça sua primeira chamada em **[convert-links](/docs/api/convert-links/)**.
---
# DOC: O que é o MCP do Bot do Afiliado (ChatGPT e Claude)
URL: https://botdoafiliado.com/docs/ia/o-que-e-mcp/
Descrição: Use o Bot do Afiliado dentro de IAs como Claude e ChatGPT via MCP (Model Context Protocol) — converta links e busque dados de produto em linguagem natural.
O **MCP (Model Context Protocol)** é um padrão aberto que deixa uma IA usar **ferramentas externas**. O Bot do Afiliado disponibiliza um **servidor MCP remoto**, então você pode **converter links e buscar produtos direto de dentro do Claude, do ChatGPT** e de outras IAs compatíveis — em linguagem natural.
## Como funciona
O servidor MCP é um wrapper sobre a nossa API. Ele expõe estes **tools**:
| Tool | O que faz | Equivale a |
|---|---|---|
| `convert_links` | Converte 1 ou vários links em links de afiliado | `POST /api/v1/convert-links` |
| `get_product` | Retorna título, preço, imagem, link e histórico | `POST /api/v1/product` |
| `create_offer_post` | Monta o post de oferta pronto (título, preço, cupom, link) | `POST /api/v1/execute` (`oferta`/`cupom`) |
| `search_products` | Busca produtos por título, com filtro de preço e ordenação (Shopee, AliExpress, Amazon) | `POST /api/v1/search-products` |
| `run_command` | Roda um **comando do bot** (o mesmo executor do Telegram): `converter` (`/c`), `encurtar`, `historico`, `promo`… aplicando o template do bot | `POST /api/v1/execute` |
| `get_template` | **Lê** os templates do bot — formato (oferta, cupom, rodapé) e mensagens de resposta (boas-vindas, status, sucesso, erro…) | `GET /api/v1/templates` |
| `set_template` | **Cria/atualiza** um template — formato (`format.*`) e mensagens de resposta seguras (`command.*`, `status.*`, `success.*`, `message.link.*`, `inline.*`, `aliexpress.*`); erros/permissão e comandos admin ficam só no painel | `POST /api/v1/templates` |
## Conexão
- **Endpoint:** `https://app.botdoafiliado.com/mcp` — ou, melhor, a **URL do seu bot**: `https://app.botdoafiliado.com/mcp/SEU_BOT` (o painel mostra a URL exata de cada bot). Com a URL por bot, o conector sempre fala com o bot certo, mesmo que você tenha vários na conta.
- **Autenticação:**
- **Login (OAuth)** no Claude.ai e no ChatGPT (web/app) — você entra com a sua conta, **sem API key**. Use a URL do seu bot (`/mcp/SEU_BOT`) para escolher qual bot.
- **Header `X-API-Key`** com uma **[API key](/docs/api/autenticacao/)** no Claude Desktop, Claude Code e Cursor (requer o **[módulo de API](/docs/planos/modulos/)**). A chave já identifica o bot.
- **Transporte:** Streamable HTTP (funciona com conectores remotos, sem instalar nada).
## O que você pode pedir
Fale naturalmente — **não precisa dizer "use o MCP"** nem citar a ferramenta; a IA reconhece o pedido e age sozinha:
- "Converta este link em afiliado: …"
- "Pegue o preço e o título deste produto: …"
- "Converta esta lista de links e me devolve os links finais."
- "Monte um post de oferta deste produto (com o cupom X): …"
- "Me mostra produtos de cozinha na Shopee **até R$100**, do **mais barato**."
- "Busca fone bluetooth **entre R$50 e R$150** no AliExpress."
Na busca dá pra combinar **marketplace + faixa de preço + ordenação**, e a IA exibe a **imagem** de cada produto junto do preço e do link.
## Próximos passos
- **[Conectar no Claude](/docs/ia/conectar-claude/)**
- **[Conectar no ChatGPT](/docs/ia/conectar-chatgpt/)**
- **[Exemplos de prompts](/docs/ia/exemplos-de-prompts/)**
---
# DOC: O que é o Bot do Afiliado e como ele gera links e ofertas no automático
URL: https://botdoafiliado.com/docs/comecando/o-que-e/
Descrição: Entenda o que o Bot do Afiliado faz, para quem serve e como ele converte links e cria ofertas automaticamente no Telegram.
O **Bot do Afiliado** é uma plataforma que transforma o seu bot do Telegram em uma máquina de **conversão de links de afiliado** e **publicação de ofertas** — sem trabalho manual.
Você envia (ou seus usuários enviam) um link de qualquer loja ou marketplace, e o bot responde com o **seu link de afiliado** já pronto, muitas vezes com **título, preço, imagem e cupom** do produto. Tudo roda na borda da Cloudflare, então é rápido e escala sozinho.
## Para quem é
- **Criadores de canais de ofertas** no Telegram que querem postar mais rápido e nunca perder comissão.
- **Afiliados** que divulgam em grupos e comunidades e precisam padronizar links e mensagens.
- **Quem gerencia vários canais/clientes** e quer separar operações em sub-bots no mesmo painel.
- **Desenvolvedores** que querem uma API para converter links em escala dentro do próprio sistema.
## O que ele faz
- **Converte links automaticamente:** basta enviar o link; o bot devolve a versão afiliada.
- **Cria ofertas prontas pra postar:** mensagem formatada com título, preço, cupom e CTA.
- **Menu de cupons com IA:** sugere cupons para seus usuários (incluindo cupons secretos no AliExpress, quando disponíveis).
- **Broadcast:** envia mensagens e ofertas para todos os chats cadastrados.
- **Moderação de grupos:** apaga e substitui links não convertidos, verifica links e roda comandos personalizados.
- **API REST:** converte 1 ou vários links por requisição, para integrar com qualquer sistema.
## Como funciona (visão rápida)
1. Você cria um bot no **BotFather** e conecta o token no painel.
2. Ativa as **integrações** (plugins) das lojas/redes em que você é afiliado, colando suas credenciais.
3. A partir daí, qualquer link reconhecido é convertido com o **seu** identificador de afiliado.
Quer começar agora? Siga o guia de **[Primeiros passos](/docs/comecando/primeiros-passos/)** ou entenda **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.
---
# DOC: Como funcionam os plugins e as rotas de conversão de links
URL: https://botdoafiliado.com/docs/integracoes/como-funcionam/
Descrição: Entenda o motor de conversão do Bot do Afiliado — plugins (conversores), rotas por domínio, prioridade, credenciais e encurtamento de links.
O Bot do Afiliado usa um **motor de conversão** único, compartilhado pelo bot do Telegram e pela API. Ele é organizado em duas peças: **conversores (plugins)** e **rotas**.
## Conversores (plugins)
Um **conversor** sabe transformar a URL de uma loja ou rede no **seu** link de afiliado. Cada conversor tem:
- um **provider** (ex.: `api_v2` para AliExpress, `shopee`, `amazon`, `awin`, `rakuten`);
- suas **credenciais** — appKey/secret, publisherId, partnerTag, etc.;
- um **tracking ID padrão** (seu identificador de afiliado);
- uma **prioridade** (para desempate quando vários cobrem o mesmo domínio).
Há dois tipos de comportamento:
- **API / Híbrido:** chama uma API externa para gerar o link e/ou buscar dados do produto (ex.: AliExpress, Shopee, Amazon).
- **Substituição/Parâmetros:** apenas normaliza a URL e injeta parâmetros/deeplink, sem API (ex.: Awin, Rakuten, Terabyte, Pague Menos).
## Rotas
Uma **rota** liga um **domínio** (ex.: `aliexpress.com.br`) a um conversor. Quando um link chega:
1. O bot resolve redirecionamentos e encurtadores até a URL real.
2. Procura a **rota** que cobre aquele domínio (respeitando a **prioridade**).
3. Usa o conversor da rota para gerar o `affiliate_url`.
4. Aplica a **política de encurtamento** e devolve o `final_url`.
> Ao ativar/salvar um plugin, o sistema **cria as rotas automaticamente** para os domínios padrão daquele provider — você não precisa cadastrar domínio por domínio.
Dá para **testar uma URL** na hora pelo painel: cole o link e veja por qual rota/conversor ele passa e qual link de afiliado sai.
## Dados do produto e histórico de preço
Quando o provider permite, o motor também extrai **título, preço e imagem** e grava o **histórico de preços**. Se o plugin não tiver busca própria, há um **fallback por HTML** (JSON-LD/OpenGraph).
## Próximos passos
- Veja **[como ativar um plugin](/docs/integracoes/ativar-plugin/)** (passo a passo genérico).
- Configure uma loja específica: **[AliExpress](/docs/integracoes/aliexpress/)**, **[Amazon](/docs/integracoes/amazon-paapi/)**, **[Shopee](/docs/integracoes/shopee/)**.
---
# DOC: Módulos e preços: o que cada plano desbloqueia
URL: https://botdoafiliado.com/docs/planos/modulos/
Descrição: Conheça o plano base e os módulos do Bot do Afiliado (Ofertas, Cupons, Broadcast, Grupos, Sub-bots, API e Tracking) — preço e o que cada um libera.
O Bot do Afiliado é **modular**: você assina o **plano base** e ativa só os **módulos** que fazem sentido para a sua operação. Tudo a la carte, por workspace.
## Plano base — R$ 99/mês
- Bot com **gerador de links de afiliado** de qualquer site/marketplace.
- Desconto de **moedas aumentado** no AliExpress.
- Comandos utilitários para engajar seus inscritos (ex.: pesquisa).
> O plano base é o mínimo para o bot funcionar. Os módulos abaixo somam recursos.
## Módulos
| Módulo | Preço/mês | O que desbloqueia |
|---|---|---|
| **Ofertas** | + R$ 49 | Gerador de ofertas automático (mensagem pronta) e conversão rápida via `/converter` e `/oferta`. |
| **Cupons** | + R$ 99 | Menu de cupons com IA para seus usuários e cupons secretos no AliExpress. |
| **Broadcast** | + R$ 49 | Envia mensagens/ofertas para todos os chats cadastrados. |
| **Grupos** | + R$ 49 | Apaga e substitui links não convertidos, verificador de links e comandos personalizados. |
| **Sub-bots** | + R$ 49 | Adiciona tokens extras do BotFather no mesmo painel. |
| **Conexão IA e API** | + R$ 99 | Conecta IA (Claude/ChatGPT) ao seu bot via MCP e gera API keys para integrar a conversão de links no seu sistema. |
| **Tracking por Usuário** | + R$ 49,90 | Tracking ID por usuário (via `telegram_user_id`) e personalização de links. |
## Como escolher
- Está começando? Fique no **plano base** e ative módulos conforme a necessidade.
- Posta muitas ofertas? **Ofertas** + **Cupons** aceleram a produção de conteúdo.
- Tem comunidade/canais grandes? **Broadcast** + **Grupos** ajudam a escalar e moderar.
- Vai conectar IA (Claude/ChatGPT) ou integrar com um sistema próprio? Ative o módulo **Conexão IA e API**.
Quando decidir, siga **[como assinar e gerenciar módulos](/docs/planos/como-assinar/)**.
---
# DOC: Perguntas frequentes (FAQ) do Bot do Afiliado
URL: https://botdoafiliado.com/docs/referencia/faq/
Descrição: Respostas rápidas sobre o Bot do Afiliado — conversão de links no Telegram, integrações, módulos, segurança de tokens, API e cobrança.
Reunimos aqui as dúvidas mais comuns. Se precisar de um passo a passo, comece pelos **[Primeiros passos](/docs/comecando/primeiros-passos/)**; para integrações, veja **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.
Não encontrou sua resposta? Fale com a gente em **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.
---
# DOC: Como converter links de afiliado automaticamente no Telegram
URL: https://botdoafiliado.com/docs/telegram/conversao-automatica/
Descrição: Como funciona a conversão automática de links no Telegram — envie um link (ou vários) e o bot responde com o seu link de afiliado, sem comandos.
A forma mais simples de usar o Bot do Afiliado é **enviar um link** — sem comando nenhum. O bot reconhece a loja, gera o **seu link de afiliado** e responde.
## Como funciona
1. **Envie o link** no chat do bot (ou em um grupo com conversão ativada).
2. O bot **resolve** encurtadores/redirects até a URL real.
3. Escolhe a **rota/conversor** do domínio e gera o `affiliate_url`.
4. Aplica a **política de encurtamento** e responde com o link final.
Quando o provider fornece, a resposta inclui **título, preço, imagem** e até **cupom**. Entenda o mecanismo em **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.
## Vários links de uma vez
Você pode enviar **vários links na mesma mensagem**. O bot processa em paralelo, remove duplicados e devolve cada um convertido, preservando o texto original.
Para converter **muitos links de uma vez** — ou a partir de uma planilha — use a página **[Gerar links em massa](/docs/comecando/gerar-links-em-massa/)** no painel: cole vários links (ou envie um CSV/Excel), copie todos já convertidos de uma vez ou baixe em CSV.
## Em grupos
Com o **[módulo de Grupos](/docs/telegram/grupos/)**, o bot converte os links postados no grupo e pode **apagar e substituir** o link original pelo **seu** link de afiliado — inclusive aplicando **cupom secreto** e desconto, como no exemplo abaixo. Em conversa privada, a conversão funciona por padrão.
Para tarefas além da conversão simples (montar oferta, cupom, histórico), veja a **[referência de comandos](/docs/telegram/comandos/)**.
---
# DOC: Autenticação na API: como usar a API key (X-API-Key)
URL: https://botdoafiliado.com/docs/api/autenticacao/
Descrição: Como gerar e usar API keys do Bot do Afiliado, autenticar com o header X-API-Key e revogar chaves no painel. Requer o módulo de API.
A API usa **API keys** geradas no painel. Cada chave tem o formato `bk_.` e é enviada no header **`X-API-Key`**. O recurso exige o **módulo de API** ativo.
## Gerar uma chave
1. Ative o **[módulo de API](/docs/planos/modulos/)**.
2. No painel do bot, abra a aba **API Keys**.
3. Clique em **Criar** e dê um **nome** (opcional).
4. **Copie a chave completa** — ela é exibida **apenas uma vez**.
## Usar nas chamadas
```bash
curl -X POST "https://botdoafiliado.com/api/v1/convert-links" \
-H "content-type: application/json" \
-H "X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-d '{"url":"https://www.aliexpress.com/item/100500..."}'
```
## Segurança
- A chave completa **não fica armazenada** em texto puro — o painel guarda apenas um hash e mostra o **prefixo**.
- **Revogue** chaves comprometidas na aba API Keys (efeito imediato).
- Nunca exponha a chave no front-end; use-a apenas no servidor.
Próximo: faça sua primeira conversão em **[convert-links](/docs/api/convert-links/)**.
---
# DOC: Primeiros passos: do zero ao primeiro link de afiliado convertido
URL: https://botdoafiliado.com/docs/comecando/primeiros-passos/
Descrição: Crie seu bot no BotFather, conecte no painel, ative uma integração e converta seu primeiro link de afiliado no Telegram. Guia passo a passo.
Este guia leva você do zero até o **primeiro link convertido**. Reserve alguns minutos e tenha o Telegram à mão.
## 1) Criar o bot no BotFather
No Telegram, abra o **[@BotFather](https://t.me/BotFather)** e crie um bot:
- Envie `/newbot`.
- Escolha um nome e um username (precisa terminar em `bot`).
- Copie o **token** que ele devolve (ex.: `123456:ABC-DEF...`). Guarde com segurança — ele dá controle total do bot.
## 2) Conectar o bot no painel
Abra o **[painel](https://app.botdoafiliado.com/)** e crie um bot:
- Informe um **nome** para identificar o bot.
- Cole o **token** do BotFather.
- Escolha (ou crie) um **workspace** — útil para separar clientes/projetos.
O painel valida o token com o Telegram e já reconhece o `@username` e o ID do bot.
## 3) Ativar uma integração (plugin)
Vá na aba **Plugins** e ative a loja/rede em que você já é afiliado. Cole as credenciais e salve — a **rota de conversão** para os domínios daquela loja é criada automaticamente.
Não sabe quais credenciais usar? Cada integração tem seu guia em **[Integrações](/docs/integracoes/como-funcionam/)** (ex.: **[AliExpress](/docs/integracoes/aliexpress/)**, **[Amazon](/docs/integracoes/amazon-paapi/)**, **[Shopee](/docs/integracoes/shopee/)**).
## 4) Converter o primeiro link
Abra a conversa com o **seu** bot no Telegram e **envie um link** de uma loja ativada. Ele responde com o link de afiliado convertido — e, quando o plugin suporta, com título, preço e imagem do produto.
Pronto! A partir daqui você pode ativar **[módulos](/docs/planos/modulos/)** (Ofertas, Cupons, Broadcast, Grupos) conforme sua operação cresce.
---
# DOC: Como conectar o Bot do Afiliado no Claude (MCP)
URL: https://botdoafiliado.com/docs/ia/conectar-claude/
Descrição: Conecte o Bot do Afiliado no Claude via MCP. No Claude.ai (web/app) basta adicionar o conector e fazer login — sem API key. No Claude Desktop e Claude Code, use a API key no cabeçalho.
Conecte o **Bot do Afiliado** no **Claude** como **conector remoto (MCP)** e peça conversões em linguagem natural.
## Claude.ai (web e app) — recomendado, com login
No Claude.ai a conexão é por **login** (OAuth). Você **não precisa de API key**.
1. Abra **Configurações → Conectores**.
2. Role até o fim e clique em **Adicionar conector personalizado**.
3. Em **URL**, cole a URL **do seu bot**: `https://app.botdoafiliado.com/mcp/SEU_BOT` (troque `SEU_BOT` pelo @username do bot, ex.: `.../mcp/mendigodonerdbot`). O painel mostra a URL exata na aba **API e IA MCP**. Clique em **Adicionar**.
4. O Claude abre a tela de login do **Bot do Afiliado**. Entre com **email (link mágico)** ou **Google** — a mesma conta do portal — e **autorize** o acesso.
5. Pronto. Em uma conversa, peça por exemplo: *"Converta este link em afiliado: …"*.
> 💡 **Tem mais de um bot?** Cada bot tem a sua própria URL (`.../mcp/SEU_BOT`). Use a URL do bot certo — assim o conector sempre fala com o bot que você quer, mesmo tendo vários na mesma conta. A URL genérica `.../mcp` (sem o bot) usa o workspace mais recente.
> Não aparece campo de API key porque a autenticação é por login. Se o Claude pedir um "OAuth Client ID" ou falhar no registro, confirme que usou exatamente `https://app.botdoafiliado.com/mcp`.
## Claude Desktop — com API key
No **Claude Desktop**, use a sua **[API key](/docs/api/autenticacao/)** (gerada no painel, **[módulo de API](/docs/planos/modulos/)**) através do `mcp-remote`. No `claude_desktop_config.json`:
```json
{
"mcpServers": {
"bot-do-afiliado": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.botdoafiliado.com/mcp",
"--header", "X-API-Key:${KEY}"],
"env": { "KEY": "bk_xxxxxx.xxxx" }
}
}
}
```
Reinicie o Claude Desktop.
## Claude Code (CLI) — com API key
```bash
claude mcp add --transport http bot-do-afiliado https://app.botdoafiliado.com/mcp --header "X-API-Key: bk_xxxxxx.xxxx"
```
## Usar
Peça, por exemplo: *"Converta este link em afiliado: …"* ou *"Monte um post de oferta para este produto."* O Claude chama os tools e devolve o resultado. Veja mais em **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)**.
> Tools disponíveis: `convert_links`, `get_product`, `create_offer_post` e `search_products` — veja **[o que é o MCP](/docs/ia/o-que-e-mcp/)**.
---
# DOC: Como ativar um plugin (conversor) no Bot do Afiliado
URL: https://botdoafiliado.com/docs/integracoes/ativar-plugin/
Descrição: Passo a passo para ativar e validar um conversor de afiliado no painel do Bot do Afiliado — onde colar as credenciais e definir prioridade.
Ativar uma integração é rápido e parecido para todas as lojas. Cada loja tem o seu guia dizendo exatamente o que colar (ex.: **[AliExpress](/docs/integracoes/aliexpress/)**) — aqui é o passo a passo geral.
## Passo a passo
1. **Abra a aba Plugins** no painel do seu bot.
2. **Escolha a loja ou rede** em que você é afiliado.
3. **Preencha as credenciais** (cada loja tem um guia próprio dizendo o que colar — veja a tabela no fim).
4. Informe o **tracking ID padrão** (o seu identificador de afiliado).
5. Clique em **Validar** para testar e depois em **Salvar**.
Pronto! A partir daí o bot já reconhece e converte os links daquela loja sozinho — você **não precisa configurar mais nada**.
> **A validação** confere se a sua credencial funciona, buscando os seus programas/produtos na rede — não precisa de link de teste. Se aparecer um aviso de checagem pulada, é normal e não impede o uso.
## O que cada loja pede (referência rápida)
| Provider | Campos principais | Obs. |
|---|---|---|
| **AliExpress** | `appKey`, `appSecret` | + tracking ID (PID) |
| **Amazon (PA-API)** | `accessKeyId`, `secretAccessKey`, `partnerTag` | Seletor "Fonte dos dados" = PA-API. Região/marketplace pré-configurados para BR |
| **Amazon (Creators)** | `credentialId`, `credentialSecret`, `partnerTag` | Seletor "Fonte dos dados" = Creators API. Versão 2.1 pré-configurada |
| **Amazon (Gerenciado)** | `partnerTag`, `cookie` | Usa cookie de sessão para validar |
| **Shopee** | `appId`, `secret` | |
| **Awin** | `publisherId`, `accessToken`, `countryCode` | Lojas (advertisers) importadas automaticamente ao salvar |
| **Rakuten** | `SID`, `App ID`, `App Secret` | Token gerado automático. Lojas importadas automaticamente ao salvar |
| **CityAds** | `clientId`, `clientSecret`, `remoteAuth` | Sync automático de lojas BR. Gera deeplinks |
| **Magalu** | `promoterId` (detectado via link) | Cole um link de afiliado seu — o ID é detectado automaticamente |
| **Mercado Livre** | `tag`, `cookie` | |
| **Terabyte** | `p` (ID afiliado), `utmMedium`, `utmCampaign` | |
| **Pague Menos** | `consultorCode` | Só o código do consultor; o resto é automático |
| **Braé** | `parceiro`, `cupom` (opcional) | |
| **Beleza na Web** | `utmCampaign` (código do consultor), `cupom` (opcional) | utm_source/medium/content fixos |
| **Natura** | `consultoria`, `cupom` (opcional) | |
> Você **nunca** precisa configurar rotas na mão — ao salvar qualquer plugin, os links daquela loja já passam a ser reconhecidos sozinhos. Awin, Rakuten e CityAds ainda puxam o catálogo inteiro de lojas da rede automaticamente. Onde pegar cada credencial está no guia de cada loja.
## Validar e testar
Alguns providers permitem informar uma **URL de amostra** (ou **ID de produto**) para testar a conversão na hora. Se a validação passar, está tudo certo para converter no Telegram e na API.
---
# DOC: Como assinar o Bot do Afiliado e ativar os módulos
URL: https://botdoafiliado.com/docs/planos/como-assinar/
Descrição: Passo a passo para assinar o Bot do Afiliado, fazer checkout dos módulos pelo Stripe e gerenciar sua assinatura (trocar módulos, atualizar cartão, cancelar).
A assinatura é **por workspace** e **a la carte**: você paga o plano base e adiciona os módulos que quiser. O pagamento é feito de forma segura pelo **Stripe**.
## Assinar
1. No painel, abra a área de **Billing / Módulos**.
2. O **plano base** já vem marcado (é obrigatório). Marque os **módulos extras** desejados.
3. Clique em **Checkout** para abrir o pagamento no **Stripe**.
4. Conclua o pagamento. Os módulos são **ativados automaticamente** no seu workspace.
## Gerenciar a assinatura
Use **Gerenciar assinatura** no painel para abrir o **portal do Stripe**, onde você pode:
- **Trocar módulos** (adicionar ou remover).
- **Atualizar o cartão**.
- **Cancelar** a assinatura.
Ainda em dúvida sobre qual módulo ativar? Veja **[módulos e preços](/docs/planos/modulos/)**.
---
# DOC: Solução de problemas comuns do Bot do Afiliado
URL: https://botdoafiliado.com/docs/referencia/solucao-de-problemas/
Descrição: Resolva os problemas mais comuns do Bot do Afiliado — bot que não responde, token já cadastrado, link que não converte e validação de plugin que falha.
Os problemas mais comuns e como resolver rápido. Se nada funcionar, fale com **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.
## O bot não responde
1. **Token correto?** Reenvie o token do BotFather no painel.
2. **Bot certo?** Confirme que está falando com o `@username` correto no Telegram.
3. **Workspace certo?** Verifique se o bot foi criado no workspace que você está usando.
## Token já cadastrado / ID não bate
- Cada **token** só pode estar em **um** bot/sub-bot. Gere um novo no BotFather ou remova o token do outro local.
- Se o **ID do token não bate**, você colou o token de outro bot — use o do bot certo.
## Link não converte
- Confira se o **plugin** da loja está **ativo** e se há **rota** para o domínio.
- Confirme as **credenciais** do provider.
- Para redes (Awin/Rakuten), configure o **advertiserId** na rota.
- Veja **[Loja não mapeada](/docs/integracoes/loja-nao-mapeada/)**.
## Validação de plugin falha
- Credenciais corretas e **ativas** no portal do programa?
- Você tem **acesso à API** (ex.: PA-API da Amazon exige vendas qualificadas)?
- O **JSON** está bem formado?
## Mercado Livre parou de converter
- O **cookie** de sessão pode ter expirado. **Atualize o cookie** nas credenciais do plugin **[Mercado Livre](/docs/integracoes/mercado-livre/)**.
---
# DOC: Comandos do Bot Afiliado no Telegram: a lista completa
URL: https://botdoafiliado.com/docs/telegram/comandos/
Descrição: Referência dos comandos do Bot do Afiliado no Telegram — conversão, ofertas, cupons, pesquisa no AliExpress, histórico, encurtador e comandos de administrador.
Esta é a referência dos comandos. A disponibilidade pode variar conforme os **módulos ativos** e a **configuração** do bot. Para a operação do dia a dia, lembre que **enviar um link já converte automaticamente** (veja **[conversão automática](/docs/telegram/conversao-automatica/)**).
No painel, na aba **Comandos**, você escolhe **quais comandos aparecem no menu** do Telegram (o "/" e o botão de menu):
## Conversão e utilidades
| Comando | O que faz |
|---|---|
| `/start` | Mensagem de boas-vindas (com foto opcional). |
| `/converter ` | Converte todos os links de um texto, substituindo pelas versões de afiliado. |
| `/historico ` | Histórico de preços (atualmente para Mercado Livre). |
| `/encurtar ` | Encurta um link (converte e encurta). Pode exigir habilitação. |
| `/soencurtar ` | Apenas encurta, sem converter. Pode exigir habilitação. |
| `/adicionargrupo` | Mostra o link para adicionar o bot a um grupo. |
## AliExpress (descontos e pesquisa)
| Comando | O que faz |
|---|---|
| `/moedas ` | Gera o link de **moedas** (desconto) do produto no AliExpress. |
| `/coringa ` | Gera um link especial "coringa" para o produto. |
| `/addcarrinho ` | Gera link de adicionar ao carrinho. |
| `/promo ` | Gera vários links promocionais do produto (moedas, relâmpago, super ofertas, combo). |
| `/pesquisar ` | Pesquisa o produto com **super desconto** (moedas) no AliExpress. |
| `/pesquisarcombo ` | Pesquisa ofertas em **combo**. |
| `/pesquisachoice ` | Pesquisa produtos **Choice** (envio rápido). |
| `/pesquisabrasil ` | Pesquisa produtos **enviados do Brasil**. |
| `/pesquisarmagalu ` | Pesquisa produtos da loja Magalu no AliExpress. |
| `/pesquisaralinomagalu ` | Pesquisa loja AliExpress no Magalu. |
## Ofertas e cupons (módulos)
| Comando | Módulo | O que faz |
|---|---|---|
| `/oferta ` | Ofertas | Monta uma **oferta formatada** (título, preço, CTA), ordenando por preço. Aceita um **código de cupom** opcional antes dos links — ex.: `/oferta CUPOM10 link1 link2`. |
| `/cupom` | Cupons | Abre o **menu de cupons**: o usuário navega por **categoria/loja** e busca (com IA) o cupom que quer. |
Veja **[Ofertas](/docs/telegram/ofertas/)** e **[Cupons](/docs/telegram/cupons/)**.
## Administrador
Apenas para admins do bot:
| Comando | O que faz |
|---|---|
| `/admin` | Menu administrativo por botões no próprio Telegram. |
| `/feature ` | Liga/desliga uma funcionalidade. |
| `/template ` | Atualiza o template de oferta. |
| `/metricas` | Métricas do dia (encurtador, broadcast). |
| `/broadcast ` | Envia mensagem para os chats cadastrados (módulo Broadcast). |
| `/broadcastcompin ` | Broadcast com a mensagem **fixada**. |
| `/broadcaststatus ` | Status de um broadcast. |
| `/broadcastcancel ` | Cancela um broadcast. |
Detalhes em **[Broadcast](/docs/telegram/broadcast/)**.
## Comandos personalizados
Você pode criar **comandos próprios** (resposta de texto ou ação) no painel — úteis para respostas prontas e atalhos. As respostas aceitam **[variáveis de mensagem](/docs/telegram/mensagens-e-variaveis/)**.
---
# DOC: Conceitos do Bot do Afiliado: workspace, bot, plugin, rota e tracking
URL: https://botdoafiliado.com/docs/comecando/conceitos/
Descrição: Entenda os conceitos centrais do Bot do Afiliado — workspace, bot, plugin (conversor), rota, tracking ID e módulo — para configurar tudo com segurança.
Estes são os termos que aparecem no painel e na documentação. Entender cada um deixa a configuração muito mais simples.
## Workspace
É o espaço que **agrupa** seus bots, os **módulos** assinados e os **membros** da equipe. Use workspaces diferentes para separar clientes, marcas ou projetos. A assinatura (billing) é por workspace.
## Bot
É a instância do **Telegram** conectada por um **token** do BotFather. Cada bot tem suas configurações: comandos, templates de mensagem, integrações e rotas. Veja **[Primeiros passos](/docs/comecando/primeiros-passos/)**.
## Plugin (conversor)
É o componente que **gera o seu link de afiliado** para uma loja ou rede. Guarda as **credenciais** (`credentials_json`), o **tracking ID padrão** e uma **prioridade**. Veja **[como ativar um plugin](/docs/integracoes/ativar-plugin/)**.
## Rota
Liga um **domínio** (ex.: `aliexpress.com.br`) a um conversor. Ao salvar um plugin, as rotas dos domínios dele são criadas automaticamente. Detalhes em **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.
## Tracking ID
É o seu **identificador de afiliado** (PID, partner tag, publisher ID, etc.), embutido no link convertido para creditar a sua comissão. Cada rede chama de um jeito — veja o **[glossário](/docs/comecando/glossario/)**.
## Módulo
É um **recurso assinável** (Ofertas, Cupons, Broadcast, Grupos, Sub-bots, API, Tracking por Usuário). O **plano base** é obrigatório; os módulos são ativados sob demanda. Veja **[módulos e preços](/docs/planos/modulos/)**.
---
# DOC: API: converter links de afiliado (POST /convert-links)
URL: https://botdoafiliado.com/docs/api/convert-links/
Descrição: Endpoint para converter um ou vários links de afiliado em uma requisição (batch de até 150). Parâmetros, exemplos de request e response e boas práticas.
Converte **1 ou vários** links na mesma requisição, com processamento em paralelo e cache por item.
- **Método:** `POST`
- **Path:** `/api/v1/convert-links`
- **Auth:** header `X-API-Key` (obrigatório). Para uso no navegador/site, use uma **Embed Key** (travada por domínio) com `/embed/v1/convert-links` — veja **[Script do site](/docs/api/script-do-site/)**.
## Modo single (1 link)
```json
{
"url": "https://exemplo.com/produto",
"telegram_user_id": 123
}
```
Resposta (200):
```json
{
"success": true,
"url_original": "https://exemplo.com/produto",
"url_resolvida": "https://exemplo.com/produto",
"affiliate_url": "https://afiliado.com/...",
"final_url": "https://encurtado.com/...",
"site": "amazon",
"provider": "amazon",
"tracking_id": "track-xyz"
}
```
## Modo batch (vários links)
```json
{
"urls": [
"https://exemplo.com/produto-1",
"https://exemplo.com/produto-2"
]
}
```
Resposta (200) — itens individuais, sem falhar o request inteiro:
```json
{
"success": true,
"items": [
{ "ok": true, "url_original": "...", "affiliate_url": "...", "final_url": "...", "site": "awin", "provider": "awin" },
{ "ok": false, "url_original": "...", "affiliate_url": null, "final_url": null, "error": "..." }
]
}
```
## Regras e boas práticas
- `urls` aceita de **1 a 150** itens; a ordem de entrada é preservada.
- Faça **retry apenas dos itens** com `ok: false`.
- Comece com lotes de **20 a 50** URLs conforme o seu timeout.
- `final_url` é a URL após a política de encurtamento (pode ser igual a `affiliate_url`).
## Exemplo (curl)
```bash
curl -X POST "https://botdoafiliado.com/api/v1/convert-links" \
-H "content-type: application/json" \
-H "X-API-Key: " \
-d '{"urls":["https://www.aliexpress.com/item/100500...","https://www.amazon.com.br/dp/..."]}'
```
Para dados de produto (título/preço/imagem) use **[/product](/docs/api/product/)**.
---
# DOC: Como conectar o Bot do Afiliado no ChatGPT (MCP)
URL: https://botdoafiliado.com/docs/ia/conectar-chatgpt/
Descrição: Como conectar o Bot do Afiliado no ChatGPT via MCP — adicione o conector remoto com a URL e faça login, e gere links de afiliado conversando.
Conecte o **Bot do Afiliado** no **ChatGPT** como **conector remoto (MCP)** e gere links de afiliado conversando.
## Adicionar o conector no ChatGPT (com login)
1. Abra as **Configurações → Conectores** do ChatGPT (pode ser necessário ativar o **modo desenvolvedor**, dependendo da conta).
2. Escolha **adicionar conector** (servidor MCP remoto).
3. Informe a **URL do seu bot**: `https://app.botdoafiliado.com/mcp/SEU_BOT` (troque `SEU_BOT` pelo @username — ex.: `.../mcp/mendigodonerdbot`; o painel mostra a URL exata na aba **API e IA MCP**).
4. Faça **login** com a sua conta do **Bot do Afiliado** (email ou Google) e **autorize**.
> 💡 **Tem mais de um bot?** Cada bot tem a sua própria URL (`.../mcp/SEU_BOT`). Use a do bot certo para o conector falar com o bot que você quer.
> Em clientes/versões que pedem um **cabeçalho fixo** em vez de login, informe a sua **[API key](/docs/api/autenticacao/)** no header **`X-API-Key`**.
## Usar
Peça, por exemplo: *"Pegue o preço deste produto: …"*. O ChatGPT chama o tool **`get_product`** e devolve título, preço e link. Veja **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)**.
> Os tools disponíveis são `convert_links`, `get_product`, `create_offer_post` e `search_products` — veja **[o que é o MCP](/docs/ia/o-que-e-mcp/)**.
---
# DOC: Como gerenciar a assinatura e trocar de módulos
URL: https://botdoafiliado.com/docs/planos/gerenciar-assinatura/
Descrição: Como trocar módulos, atualizar o cartão e cancelar a assinatura do Bot do Afiliado pelo portal do Stripe, direto do painel.
A gestão da assinatura é feita pelo **portal do Stripe**, acessível direto do painel. Tudo por **workspace**.
## Gerenciar
1. No painel, abra **Billing / Módulos**.
2. Clique em **Gerenciar assinatura** para abrir o **portal do Stripe**.
3. No portal você pode:
- **Adicionar/remover módulos**;
- **Atualizar o cartão**;
- **Cancelar** a assinatura.
## Adicionar módulos rapidamente
Você também pode marcar novos módulos na própria tela de **Billing** e fazer um **checkout** adicional. Veja **[como assinar](/docs/planos/como-assinar/)** e **[módulos e preços](/docs/planos/modulos/)**.
Dúvidas de cobrança? Veja o **[FAQ de cobrança](/docs/planos/faq-cobranca/)**.
---
# DOC: Segurança de tokens e credenciais no Bot do Afiliado
URL: https://botdoafiliado.com/docs/referencia/seguranca-e-tokens/
Descrição: Como o Bot do Afiliado protege o token do Telegram, as API keys e as credenciais de afiliado, e boas práticas para manter sua conta segura.
A segurança das suas credenciais é levada a sério. Veja como cada tipo de segredo é tratado.
## Token do Telegram
- É **criptografado** antes de ser armazenado.
- **Não** é exibido em texto puro no painel.
- Se suspeitar de vazamento, **gere um novo token** no BotFather e atualize no painel (o token antigo deixa de valer).
## API keys
- Apenas um **hash** da chave é guardado — não o valor em texto puro.
- O painel mostra somente o **prefixo** (ex.: `bk_xxxxxx`).
- A chave completa é exibida **uma única vez**, na criação. **Revogue** chaves comprometidas (efeito imediato). Veja **[autenticação](/docs/api/autenticacao/)**.
## Credenciais de afiliado
- Ficam **vinculadas ao seu workspace** e são usadas apenas pelo conversor para gerar os seus links.
- Você pode **atualizar ou remover** as credenciais a qualquer momento no painel.
- Compartilhe acesso ao workspace apenas com pessoas de confiança.
## Boas práticas
- Use **API keys separadas** por integração e revogue as que não usa.
- **Nunca** exponha tokens/keys no front-end ou em repositórios.
- Mantenha o acesso ao **workspace** restrito à sua equipe.
---
# DOC: Gerar posts de oferta prontos para publicar
URL: https://botdoafiliado.com/docs/telegram/ofertas/
Descrição: Use o módulo de Ofertas do Bot do Afiliado para transformar links em posts formatados (título, preço, CTA) com os comandos /oferta e /converter.
O **módulo de Ofertas** transforma links em **posts prontos para publicar** — com título, preço e chamada para ação — em vez de só devolver o link convertido.
## Comandos principais
- **`/oferta `** — monta uma oferta formatada a partir de um ou vários links, **ordenando por preço**. Você também pode responder a uma mensagem que contenha os links.
- **`/converter `** — converte todos os links de um texto, substituindo pelas versões de afiliado (ótimo para reaproveitar um post de outro canal no **seu** formato).
## Personalização
O **template da oferta** é editável, com **[variáveis de mensagem](/docs/telegram/mensagens-e-variaveis/)** como `{titulo}`, `{preco}` e `{link}`. No painel, em **Promoções → Customizar**, escolha o template (**Post de oferta**, item da lista, base da lista, rodapé) e edite o formato — as **variáveis** aparecem como botões clicáveis que entram direto no editor.
Antes de salvar, confira o resultado: o **Preview com links reais** executa o template com um link de verdade e mostra exatamente como a oferta vai sair no Telegram.
> **CTA na hora:** no `/oferta`, o texto entre **aspas** preenche a variável **`{cta}`** — ex.: `/oferta "Compre aqui 👇" link1 link2`. A chamada aparece **exatamente onde você posicionar `{cta}`** no formato; sem `{cta}` no formato, ela **não aparece**. No painel, há um campo de CTA no **[Postador de Ofertas](/docs/telegram/formatador-tempo-real/)**.
## Grade de imagens
O bot pode compor de **1 a 6 imagens** de produto em uma **única imagem** (grade), deixando o post mais atraente. O fundo da grade é configurável.
Ative o módulo em **[módulos e preços](/docs/planos/modulos/)**. Para cupons no post, veja **[Cupons](/docs/telegram/cupons/)**.
---
# DOC: API: dados do produto (POST /product)
URL: https://botdoafiliado.com/docs/api/product/
Descrição: Endpoint que retorna dados do produto (título, preço, imagem, moeda), o link de afiliado, o link final e o histórico de preços a partir de uma URL.
Retorna **dados do produto**, o **link de afiliado**, o **link final** e o **histórico de preços** a partir de uma URL. O site/provider é detectado automaticamente.
- **Método:** `POST`
- **Path:** `/api/v1/product`
- **Auth:** header `X-API-Key`
## Request
```json
{
"url": "https://shopee.com.br/...",
"telegram_user_id": 123456789,
"history_limit": 10
}
```
- `url` (obrigatório): URL do produto.
- `telegram_user_id` (opcional): tracking/telemetria.
- `history_limit` (opcional): limite do histórico (1 a 50; padrão 10).
## Response (200)
```json
{
"success": true,
"url_original": "https://shopee.com.br/...",
"url_resolvida": "https://shopee.com.br/...",
"affiliate_url": "https://...",
"final_url": "https://...",
"tracking_id": "....",
"site": "shopee",
"provider": "shopee",
"product": {
"title": "Nome do produto",
"price": "199.90",
"price_number": 199.9,
"currency": "BRL",
"image_url": "https://..."
},
"price_history": [
{ "createdAt": "2026-05-21T12:34:56.000Z", "price": "199.90", "priceNumber": 199.9, "currency": "BRL" }
]
}
```
Campos de `product.*` podem vir `null` quando não foi possível extrair. `price_history` pode ser `[]`.
## Erros
- `401` — `{"success": false, "error": "invalid_api_key"}`
- `400` — `{"success": false, "error": "conversion_failed"}` (sem rota/conversor elegível)
Veja a tabela completa em **[erros e limites](/docs/api/erros-e-limites/)**.
---
# DOC: Glossário de marketing de afiliados: os termos essenciais
URL: https://botdoafiliado.com/docs/comecando/glossario/
Descrição: Significado dos principais termos de marketing de afiliados usados no Bot do Afiliado — deeplink, comissão, PID, partner tag, publisher ID, advertiser ID e mais.
Termos que você vai encontrar nos programas de afiliados e no painel.
## Geral
- **Afiliado / Publisher:** quem divulga produtos e ganha comissão por venda/clique.
- **Anunciante / Advertiser:** a loja/marca que paga a comissão.
- **Rede de afiliados:** intermediária que conecta afiliados e anunciantes (ex.: Awin, Rakuten).
- **Comissão:** percentual (ou valor fixo) que você recebe por venda aprovada.
- **Deeplink:** link de afiliado que aponta direto para uma página específica do anunciante.
- **Tracking ID:** identificador que credita a comissão para você.
## Identificadores por rede
- **PID (AliExpress):** seu tracking ID no AliExpress.
- **Partner tag (Amazon):** sua tag de associado (ex.: `sualoja-20`).
- **Publisher ID (Awin/Rakuten):** seu identificador como afiliado/publisher na rede.
- **Advertiser ID (Awin/Rakuten):** identificador do anunciante/loja específico dentro da rede (vai na **rota**).
- **App ID / Secret (Shopee, AliExpress):** credenciais de API para gerar links e buscar dados.
## Métricas comuns
- **Cliques:** número de aberturas do seu link.
- **Conversão:** quando o clique vira venda.
- **EPC (Earnings per Click):** ganho médio por clique.
- **Pendente / Aprovado:** estágios da comissão até a confirmação da venda.
## No Bot do Afiliado
- **Plugin / Conversor:** gera seu link de afiliado para uma loja/rede.
- **Rota:** liga um domínio a um conversor.
- **Módulo:** recurso assinável (Ofertas, Cupons, Broadcast, etc.).
- **Workspace:** espaço que agrupa bots, módulos e equipe.
Veja também os **[conceitos do produto](/docs/comecando/conceitos/)**.
---
# DOC: Exemplos de prompts para gerar links e ofertas com IA
URL: https://botdoafiliado.com/docs/ia/exemplos-de-prompts/
Descrição: Exemplos de prompts para usar o Bot do Afiliado dentro de uma IA via MCP — buscar produtos com filtro de preço, converter links (1 ou em lote), pegar preço/histórico e montar posts de oferta.
Depois de **[conectar no Claude](/docs/ia/conectar-claude/)** ou **[no ChatGPT](/docs/ia/conectar-chatgpt/)**, é só pedir em **linguagem natural**.
> 💡 **Você não precisa dizer "use o MCP" nem citar a ferramenta.** A IA entende o pedido e chama a ferramenta certa sozinha. Fale como falaria com um assistente: *"acha uns produtos de cozinha baratos na Shopee"*, *"converte esse link pra afiliado"*.
## Buscar produtos (com filtro de preço e ordenação)
Peça naturalmente — combine site, faixa de preço e ordenação como quiser:
> Me mostra produtos de cozinha na Shopee até R$100
> Procure "air fryer" na Amazon, do mais barato pro mais caro
> Busca fone bluetooth entre R$50 e R$150 no AliExpress
> Quero ver geladeiras frost free, ordena pela mais barata
A IA chama `search_products`. O que dá pra combinar:
- **Marketplace** — `shopee`, `aliexpress` ou `amazon`. **Se você não disser a loja**, a IA busca em **todos** os marketplaces ativos e **junta os resultados** (cada item mostra de qual loja é).
- **Faixa de preço** — "até R$100", "entre 50 e 150", "acima de 200".
- **Ordenação** — "do mais barato", "mais caro primeiro" ou por relevância (padrão).
- **Mais resultados** — "me mostra mais" / "próxima página".
Cada produto vem com **imagem** (a IA mostra a foto), **preço** e o **link de afiliado** já pronto.
## Converter um link
> Converta este link em afiliado: `https://www.aliexpress.com/item/100500...html`
A IA chama `convert_links` e devolve o `affiliate_url` e o `final_url`.
## Converter vários links (lote)
> Converta estes links e me devolva os links finais em lista:
> - `https://www.amazon.com.br/dp/...`
> - `https://shopee.com.br/...`
> - `https://mercadolivre.com.br/...`
## Pegar preço e dados de um produto
> Qual o preço e o título deste produto? `https://shopee.com.br/...`
A IA chama `get_product` e retorna título, preço, moeda, imagem e histórico.
## Montar um post de oferta pronto
> Monte um post de oferta deste produto: `https://...`
> Monte um post de oferta com o cupom `MEUCUPOM`: `https://...`
> Monte um post de oferta com o CTA "Compre aqui 👇": `https://...`
## Ajustar o formato e as mensagens do bot (templates)
A IA **lê e ajusta** dois tipos de texto: o **formato** das ofertas (oferta, cupom, rodapé por marketplace) e as **mensagens de resposta** do bot (boas-vindas, "carregando…", sucesso, entrega de link, modo inline):
> Me mostra o template de oferta atual.
> No rodapé do AliExpress, adiciona "⚡ Desconto de moedas só no app".
> Muda a mensagem de boas-vindas (/start) para algo mais informal.
A IA usa `get_template` para ler e `set_template` para salvar. **Confirme antes de sobrescrever** — um template mal escrito muda todas as ofertas/respostas. Por segurança, a IA **não** edita mensagens de **erro/permissão** nem textos de **comandos administrativos** (broadcast, feature, métricas…) — essas só no painel.
A IA chama `create_offer_post`, que usa o **template de oferta do seu bot** (título, preço, cupom e link final) e devolve o **texto pronto para publicar**. Você revisa e posta.
> **Dica:** sempre divulgue o **`final_url`** retornado — é a versão final (com a sua atribuição e a política de encurtamento).
## Rodar um comando do bot (`/c`, encurtar, histórico…)
A IA também roda os **comandos do seu bot** (o mesmo executor do Telegram), aplicando o **template** do bot:
> Roda o /c nesse link: `https://...`
> Encurta esse link pra mim: `https://...`
> Me mostra o histórico de preço desse produto: `https://...`
A IA usa `run_command` com o comando (`converter`/`c`, `encurtar`, `historico`, `promo`…) e devolve o resultado já formatado. Comandos administrativos (broadcast, configurações) **não** ficam disponíveis por aqui, por segurança.
## Frases que funcionam (e o que a IA faz)
| Você diz… | A IA faz |
|---|---|
| "acha air fryer barata na Shopee" | `search_products` (site shopee, ordena por preço) |
| "produtos de cozinha até R$100" | `search_products` (price_max 100) |
| "fone entre 50 e 150 reais" | `search_products` (price_min 50, price_max 150) |
| "converte esse link" + link | `convert_links` |
| "qual o preço desse produto?" + link | `get_product` |
| "monta um post com o cupom X" + link | `create_offer_post` (coupon X) |
| "roda o /c nesse link" + link | `run_command` (converter) |
| "encurta esse link" + link | `run_command` (encurtar) |
## O que ainda não dá para fazer por aqui
- **Publicar automaticamente** em canais (segue no painel/bot, por segurança).
---
# DOC: FAQ de cobrança e pagamento do Bot do Afiliado
URL: https://botdoafiliado.com/docs/planos/faq-cobranca/
Descrição: Dúvidas frequentes sobre cobrança do Bot do Afiliado — formas de pagamento, troca de módulos, cancelamento, segurança e por workspace.
Reunimos as dúvidas mais comuns sobre **cobrança**. Para o passo a passo, veja **[como assinar](/docs/planos/como-assinar/)** e **[gerenciar assinatura](/docs/planos/gerenciar-assinatura/)**.
Precisa de ajuda com um caso específico (nota fiscal, reembolso, problema no pagamento)? Fale com a gente em **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.
---
# DOC: Changelog do Bot do Afiliado: novidades e atualizações
URL: https://botdoafiliado.com/docs/referencia/changelog/
Descrição: Novidades e atualizações do Bot do Afiliado e da documentação.
Acompanhe as novidades do Bot do Afiliado e da documentação. Esta é uma página viva — atualizada conforme lançamos melhorias.
## 2026-06
- **Cupons importados das redes (Awin, Rakuten e CityAds).** Novo botão **“Importar dos plugins”** na aba Cupons: busca os cupons/vouchers ativos dos seus programas **do Brasil** nas redes conectadas e cadastra tudo com o **seu link de afiliado**, organizado por loja e **sem duplicar** — além de uma importação automática **diária**. O resultado fica registrado na aba *Ingestões*.
- **Aba de Chats corrigida.** Conversas **privadas** agora mostram o **nome** (ou @usuário, ou o ID) na coluna Título — antes ficavam em branco. E o botão **Abrir chat** voltou a funcionar (abre no Telegram, inclusive perfis por `tg://`).
- **Foto própria do produto no Postador.** Não gostou da imagem que o sistema puxou? No **Postador de Ofertas**, em *Status dos Links*, clique em **📷 Usar minha foto** e envie a sua (até 5 MB) — ela entra na hora e, em posts com vários produtos, troca **só o espaço daquele item** na grade. A foto fica **salva por produto**: ao recolar o mesmo link, ela volta sozinha (com o selo *foto própria* e um botão para voltar à automática). Gerencie tudo na nova aba **Promoções → Fotos próprias**. A preferência **Incluir imagem** agora também é lembrada por bot (em qualquer dispositivo).
- **CTA detectado no Postador.** O campo *CTA da oferta* agora mostra um selo **detectado** quando você escreve a chamada entre **aspas** na Entrada de Comando — igual ao campo de cupom.
- **"Postador de Ofertas" (novo nome do "Formatador").** A aba *Formatador* virou **Postador de Ofertas** — mesmo recurso, nome mais claro: monte a oferta no painel (com prévia ao vivo) e **poste** direto nos canais.
- **Rodapé por marketplace mais flexível.** Salvar o rodapé de um marketplace **em branco** agora volta ao **rodapé global** (antes dava erro "text é obrigatório"). E o editor ganhou as **variáveis clicáveis** e o destaque dos demais templates.
- **Prévia de oferta detecta o cupom sozinha.** Na *Prévia com links reais* não há mais seletor de /oferta vs /cupom: se você incluir um **cupom** na entrada, a prévia já sai como cupom; sem cupom, sai como oferta.
- **Pague Menos mais simples.** Conectar a Pague Menos agora pede só o **código do consultor** — o resto é automático. Menos campos no formulário.
- **Beleza na Web mais simples.** O plugin agora pede só o **código do consultor** e um cupom opcional — o resto é automático.
- **Comando `/produto` aposentado.** Os detalhes de um produto (título, preço, histórico) já saem ao **mandar o link direto** no chat ou usar **`/oferta`** — então o `/produto` saiu da lista de comandos e da documentação para não duplicar.
- **Plugin Rakuten mais simples.** Conectar a Rakuten agora pede só **SID + App ID + App Secret** — o token de acesso é gerado automaticamente a cada sincronização (expira em 1h e **nunca é salvo**). Os campos avançados (token manual, URLs de API e status) saíram do formulário.
- **Rotas customizadas mais claras.** A tela de *Rotas* ganhou um tutorial passo a passo, descrição em cada campo, variáveis clicáveis (`{{encodelink}}` / `{{link}}`) que entram direto no template, exemplos prontos e um teste de URL que mostra o **link convertido** (ou o motivo de não converter).
- **Guias de integração mais diretos.** Avisos genéricos removidos, mais prints reais (AliExpress, Amazon Creators, Shopee), guia "Ativar um plugin" menos técnico, PA-API da Amazon marcada como **descontinuada** (use a Creators API), e Awin/Rakuten esclarecidos — o bot **importa as lojas automaticamente** (sem advertiser ID na mão).
- **Integrações configuradas pelo painel (sem JSON).** Os guias de integração não pedem mais para colar blocos JSON — agora descrevem os **campos do painel**. Rakuten e Shopee refeitos, com prints reais e sem placeholders.
- **Documentação reescrita para SEO.** Títulos dos guias no estilo de busca (ex.: *Como conectar o Mercado Livre no Bot do Afiliado e gerar links e ofertas automaticamente*) e os blocos de **Perguntas frequentes** de todas as páginas reescritos para responder dúvidas reais — com navegação lateral enxuta.
- **Awin: link curto com o nome da loja.** O slug do encurtador deixa de carregar o ruído do nome do programa Awin — ex.: `…-AfiliadosCasasBahiaPrivateNetwork` agora sai `…-CasasBahia`.
- **Blog com vários guias novos ([/blog](/blog/)).** Conversão automática de links no Telegram, operar um canal de ofertas via IA (MCP), guia de afiliação por marketplace, cupom no piloto automático (IA + reativação de expirados), posts de oferta que convertem (templates, variáveis, rodapé por marketplace, CTA), broadcast no privado, bot de moedas do AliExpress, conversor de site inteiro e **como ser afiliado da Época Cosméticos** (beleza/perfumaria via Awin/Rakuten).
- **IA edita o formato E as mensagens do bot (MCP).** Ferramentas `get_template`/`set_template`: a IA (ChatGPT/Claude) pode **ler** e **editar** os templates de oferta/cupom/**rodapé por marketplace** e também as **mensagens de resposta** do bot (boas-vindas, "carregando…", sucesso, entrega de link, modo inline). Com guarda de segurança: mensagens de **erro/permissão** e textos de **comandos administrativos** ficam só no painel.
- **CTA por oferta (posicionável).** Uma chamada para ação por oferta que aparece **exatamente onde você colocar a variável `{cta}`** no formato — sem `{cta}` no formato, ela não aparece (mesmo preenchendo o campo). Defina no **Postador de Ofertas** (campo dedicado ou texto entre **aspas** na Entrada de Comando), no comando **`/oferta`** do Telegram (ex.: `/oferta "Compre aqui 👇" link`) e via **IA/MCP**.
- **Diretório de sites agrupado por loja.** Na página de [sites suportados](/sites/), as variações de domínio (subdomínios e `.com`/`.com.br`) agora viram **uma entrada por loja** — ex.: `a.aliexpress.com`, `aliexpress.com`, `aliexpress.com.br` e `s.click.aliexpress.com` aparecem juntas como **aliexpress.com**.
- **Guias de integração agora mostram "onde pegar a credencial".** Cada integração (AliExpress, Shopee, Awin, Rakuten, Amazon, Mercado Livre e mais) traz o **link direto** e um **print** de onde copiar cada chave no painel da rede — incluindo o passo a passo do **cookie do Mercado Livre** (DevTools → `createLink`).
- **Guia do Mercado Livre refeito.** Passo a passo com prints reais de cada etapa (etiqueta/tag, abrir o **Inspecionar** → aba **Rede** → requisição `createLink` → cabeçalho `Cookie`) e configuração pelos campos **Tag** e **Cookie** do painel (sem JSON).
- **Atalhos de credencial no painel.** Ao configurar um plugin, agora há **links clicáveis** que levam direto à página onde você obtém cada chave (ID da conta, token, appKey/appSecret, etc.).
- **Novo guia: Formatador de ofertas em tempo real.** Monte uma oferta no painel colando links, preços e cupons misturados, com **prévia do Telegram ao vivo** e envio para os canais.
- **Novo guia: Whitelist.** Marque domínios e URLs que o bot **não** deve converter nem fiscalizar (redes sociais, seus próprios canais, etc.).
- **Documentação com mais prints.** Capturas de tela reais em vários guias: gerar links em massa, comandos do Telegram, conectar IA/MCP, script do site, faturamento, rotas, broadcast, cupons e customização das mensagens.
- **Painel em português.** Traduzimos rótulos que ainda apareciam em inglês (ex.: *Preview* → *Prévia*, *Owner ID* → *ID do dono*, *Somente programas ativos*).
- **Imagem de post de 1 produto mais natural.** Foto de catálogo (fundo limpo) é centralizada e as bordas passam a usar a **cor real do fundo da foto** (cinza/creme), em vez de branco fixo — some o degrau branco. Já a foto "lifestyle" (fundo não-limpo) é enviada na **proporção original**, sem moldura nem fundo desfocado.
- **Ajuda contextual no painel.** A aba *Alertas de canal* agora explica o que faz, e o ícone **?** de cada tela mostra um resumo ao passar o mouse (além de abrir a documentação).
- **Novos guias na documentação.** Desconto de **moedas + cupom secreto** do AliExpress, **gerar links em massa** (com planilha CSV/Excel) e a nova seção **"Cadastrar cupom com IA"**.
- **Cupom sem código (resgatável no link).** Agora dá para cadastrar cupons que não têm código — só o link. No painel, na API e no MCP, informe o link e deixe o código em branco; no site eles aparecem com o selo **Sem código** e o botão leva direto à oferta.
- **Correção ao editar cupom.** Salvar a edição de um cupom no painel não falha mais com "category_id obrigatório".
- **Acesso ao painel mais seguro.** Removemos o comando `/painel` do Telegram (link temporário). O acesso ao painel agora é só pelo **login do portal** (email, passkey ou Google) — sem links de acesso que podiam ser reaproveitados.
- **Script do site (Embed).** Nova aba em *API e IA MCP → Script do site*: gere uma chave **travada por domínio**, cole um `
```
Pronto. O script converte os links automaticamente, inclusive em conteúdo carregado depois (SPA/infinite scroll). Para não converter um link específico, adicione o atributo `data-no-affiliate` na tag ``.
## Alternativa: chamar a API direto
A partir de um **domínio autorizado**, você pode chamar o endpoint de conversão:
```bash
curl -X POST 'https://app.botdoafiliado.com/embed/v1/convert-links' \
-H 'x-embed-token: SEU_TOKEN' \
-H 'content-type: application/json' \
--data '{"urls":["https://loja.com/produto"]}'
```
Resposta: `items[]` com `url_original` e `affiliate_url` por item.
## Segurança
- A Embed Key é **travada por host** — só funciona a partir dos domínios cadastrados.
- Não expõe a API key nem o ID do bot.
- É **revogável** a qualquer momento no painel.
Veja também: **[Autenticação da API](/docs/api/autenticacao/)** e **[POST /convert-links](/docs/api/convert-links/)**.
---
# DOC: Grupos no Telegram: moderação e conversão automática de links para seu link de afiliado
URL: https://botdoafiliado.com/docs/telegram/grupos/
Descrição: Use o módulo de Grupos do Bot do Afiliado para apagar e substituir links não convertidos, verificar links, criar comandos próprios e regras de link.
O **módulo de Grupos** transforma o bot em um **moderador** de links: ele converte automaticamente e mantém o grupo só com **links de afiliado seus**.
## O que ele faz
- **Apaga e substitui** links não convertidos por versões de afiliado.
- **Verifica** os links postados no grupo.
- Permite **comandos personalizados** para o grupo.
- Respeita a **whitelist** (links que não devem ser convertidos/fiscalizados).
- Pode **ignorar administradores** do grupo na conversão automática.
## Adicionar o bot ao grupo
Use **`/adicionargrupo`** para obter o link de convite e adicione o bot como **administrador** (necessário para apagar/fixar mensagens).
## Regras de link e whitelist
- **Regras de link:** transformações avançadas de URL (limpar/adicionar parâmetros, reescrever por rede). Úteis para padronizar atribuição.
- **Whitelist:** domínios/URLs que o bot deve **ignorar** (não converter nem fiscalizar).
Ative o módulo em **[módulos e preços](/docs/planos/modulos/)**. Veja também **[conversão automática](/docs/telegram/conversao-automatica/)**.
---
# DOC: Erros e limites da API REST
URL: https://botdoafiliado.com/docs/api/erros-e-limites/
Descrição: Referência dos erros da API do Bot do Afiliado (invalid_api_key, conversion_failed, payload inválido) e dos limites de uso, como o batch de 150 URLs.
Referência de **erros** e **limites** da API. Veja também **[autenticação](/docs/api/autenticacao/)**.
## Erros comuns
| HTTP | Erro | Significado |
|---|---|---|
| 401 | `invalid_api_key` | `X-API-Key` ausente ou inválida. |
| 400 | `conversion_failed` | Sem rota/conversor ativo para a URL (ou credenciais faltando). Não é erro de scraping. |
| 400 | payload inválido | Corpo não é JSON válido ou não respeita o schema (ex.: `url` ausente). |
| 5xx | erro inesperado | Falha de rede, indisponibilidade de provider ou exceção não tratada. |
No modo **batch** (`/convert-links`), falhas de conversão de itens **não** retornam 400 — cada item traz `ok: false` + `error`. O `400` fica para erro de payload/auth.
## Limites
- **Batch:** até **150 URLs** por requisição.
- **Histórico:** `history_limit` de **1 a 50** (padrão 10) no `/product`.
- Faça **retry** apenas dos itens que falharam e use lotes menores em caso de timeout.
## Boas práticas
- Trate `success`/`ok` antes de usar `affiliate_url`/`final_url`.
- Implemente **backoff** em caso de 5xx.
- Não exponha a API key no cliente.
---
# DOC: Sub-bots: gerencie vários bots de afiliado no mesmo painel
URL: https://botdoafiliado.com/docs/telegram/sub-bots/
Descrição: Use o módulo de Sub-bots do Bot do Afiliado para adicionar tokens extras do BotFather e operar vários bots com as mesmas configurações, no mesmo painel.
O **módulo de Sub-bots** permite adicionar **tokens extras do BotFather** no mesmo painel, operando vários bots sem duplicar a configuração — ideal para separar operações por **canal, cliente ou marca**.
## Como adicionar
1. **Crie um novo bot** no BotFather e copie o token.
2. Na seção de **Sub-bots / instâncias** do painel, informe um **nome** e cole o **token**.
3. **Salve** para ativar a instância.
## Observações
- Cada **token** só pode estar em **um** bot/sub-bot (mensagem "Token já cadastrado" indica reuso).
- Os tokens são **criptografados** antes de armazenados. Veja **[segurança e tokens](/docs/referencia/seguranca-e-tokens/)**.
Ative o módulo em **[módulos e preços](/docs/planos/modulos/)**.
---
# DOC: Referência interativa da API (Scalar)
URL: https://botdoafiliado.com/docs/api/swagger/
Descrição: Explore e teste os endpoints da API REST do Bot do Afiliado na referência interativa Scalar — com busca, schemas de request/response e "try it out".
A API é construída com **OpenAPI**, então você pode explorar e testar os endpoints de forma interativa na **referência Scalar**.
## Referência interativa da API
👉 **[Abrir a referência da API (Scalar) »](/docs/api/referencia/)**
A referência Scalar tem **busca**, schemas de request/response e **try it out** direto no navegador.
| Recurso | Caminho |
|---|---|
| Referência interativa (Scalar) | [/docs/api/referencia/](/docs/api/referencia/) |
| OpenAPI JSON | `https://app.botdoafiliado.com/api/openapi.json` |
## Como usar
1. Abra a **[referência Scalar](/docs/api/referencia/)** para ver os schemas de request/response.
2. Autentique com a sua **[API key](/docs/api/autenticacao/)** (`X-API-Key`).
3. Teste os endpoints **[convert-links](/docs/api/convert-links/)** e **[product](/docs/api/product/)**.
---
# DOC: Como personalizar as mensagens e variáveis (templates) do bot
URL: https://botdoafiliado.com/docs/telegram/mensagens-e-variaveis/
Descrição: Personalize as mensagens do Bot do Afiliado com variáveis como nome, link, título e preço. Referência completa dos placeholders disponíveis.
As mensagens do bot aceitam **placeholders** no formato `{variavel}`. No envio, o sistema substitui pelos valores reais do contexto (usuário, chat, bot e link).
## Variáveis disponíveis
| Variável | Descrição | Exemplo |
|---|---|---|
| `{nome}` | Primeiro nome do usuário | `Olá {nome}!` |
| `{@usuario}` | Menção clicável do usuário (HTML) | `Oi {@usuario}!` |
| `{usuario}` | Username sem `@` (quando existir) | `Seu user: {usuario}` |
| `{id}` | ID do usuário (Telegram) | `Seu id: {id}` |
| `{chatid}` | ID do chat | `chat: {chatid}` |
| `{data}` | Data atual (America/Sao_Paulo) | `Hoje: {data}` |
| `{hora}` | Hora atual (America/Sao_Paulo) | `Agora: {hora}` |
| `{bot}` | Nome do bot | `Bem-vindo ao {bot}` |
| `{linkgerado}` | Link final gerado | `Seu link: {linkgerado}` |
| `{link}` | Alias de `{linkgerado}` | `{link}` |
| `{linkoriginal}` | URL original enviada | `{linkoriginal}` |
| `{linkresolvido}` | URL após resolver redirects | `{linkresolvido}` |
| `{titulo}` | Título da oferta (quando disponível) | `{titulo}` |
| `{preco}` | Preço (quando disponível) | `{preco}` |
| `{mensagemextra}` | Mensagem extra configurada no plugin | `{mensagemextra}` |
## Regras
- **Variáveis desconhecidas** viram string vazia.
- Em mensagens **HTML**, os valores de usuário/chat são **escapados** para evitar injeção; `{@usuario}` é gerado de forma segura.
## Onde usar
- **Templates de oferta** (`/oferta`, `/cupom`) — veja **[Ofertas](/docs/telegram/ofertas/)**.
- **Mensagem de boas-vindas** (`/start`).
- **Comandos personalizados** e **broadcast**.
## Customizar o formato no painel
Na aba **Customizar**, você ajusta o **formato** de cada tipo de post (oferta, cupom e rodapé; 1 produto ou lista) usando essas variáveis — com **chips clicáveis** para inserir cada uma:
Além das variáveis acima, os formatos de oferta/cupom têm variáveis próprias:
| Variável | Descrição |
|---|---|
| `{cupom}` | Código do cupom da oferta. |
| `{itens}` | Lista de produtos já formatados (posts com vários itens). |
| `{footer}` | Texto do rodapé configurado (por marketplace ou global). |
| `{cta}` | **Chamada para ação** da oferta (ex.: *Compre aqui 👇*). Aparece **exatamente onde você colocar `{cta}`** no formato. Se você **não** usar `{cta}`, a chamada **não aparece** — mesmo que preencha o campo CTA. |
Em **Prévia com links reais**, cole um link de verdade e veja o resultado **renderizado** na hora — com imagem, título e preço — antes de usar:
---
# DOC: Alertas de links de afiliado que não são seus nos canais do Telegram
URL: https://botdoafiliado.com/docs/telegram/alertas-de-canal/
Descrição: Receba alertas quando links não esperados forem postados nos seus canais do Telegram, com whitelist para ignorar domínios e URLs confiáveis.
Os **alertas de canal** ajudam a **auditar** os seus canais: quando um link **inesperado** aparece, o sistema registra um alerta para você revisar.
## Como funciona
Quando um **link é postado em um canal**, o sistema verifica:
- Se está na **whitelist** → **não** gera alerta.
- Se corresponde a um **link final gerado pelo bot** → **não** gera alerta (é esperado).
- Caso contrário → **registra um alerta** com o canal, a mensagem e a URL suspeita.
Assim você descobre rapidamente se alguém postou um link **sem ser de afiliado** (ou de outra pessoa) no seu canal.
## Whitelist de links
Adicione **domínios** ou **URLs** confiáveis à whitelist para que não gerem alertas (ex.: links internos, institucionais ou de parceiros). A mesma whitelist é usada para evitar conversão indevida. Veja **[Grupos](/docs/telegram/grupos/)**.
---
# DOC: Como conectar AliExpress no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/aliexpress/
Descrição: Como entrar no programa de afiliados do AliExpress, solicitar as chaves de API (appKey e appSecret) e configurar o conversor no Bot do Afiliado.
O conversor do **AliExpress** gera o link de afiliado pela **API oficial** (TOP API) e ainda busca **imagem e cupom** do produto quando disponíveis. Para isso, você precisa de uma conta de afiliado aprovada, um **tracking ID (PID)** e as chaves **appKey** e **appSecret**.
## 1) Entrar no programa de afiliados
Cadastre-se no programa de afiliados do AliExpress (AliExpress Affiliate / Portals) e aguarde a **aprovação** da conta. É nesse portal que você acompanha comissões e gera identificadores.
## 2) Obter o tracking ID (PID)
Abra o **[Tracking ID do AliExpress Portals](https://portals.aliexpress.com/affiportals/web/tracking_id.htm)** (no portal de afiliados, menu **Account → Tracking ID**) e localize ou crie o seu **tracking ID (PID)**. Ele é o identificador que credita suas comissões e será colado no painel como **tracking ID padrão**.
## 3) Gerar as chaves de API (appKey e appSecret)
1. Acesse o **[AliExpress Open Service](https://openservice.aliexpress.com/)** e faça o **login rápido com a sua conta AliExpress**.
2. No menu, abra o **App Console** e clique para **criar um app**.
3. Selecione o tipo **app de afiliado** e finalize a criação.
4. Copie o **appKey** e o **appSecret** do app criado e guarde com segurança.
## 4) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **AliExpress** (provider `api_v2`) e preencha os campos **appKey** e **appSecret** com as chaves geradas no passo anterior.
- Informe o **tracking ID padrão** (seu PID).
- (Opcional) Informe uma **URL de amostra** do AliExpress para validar a conversão.
- Clique em **Validar** e depois em **Salvar**.
Pronto — links do AliExpress passam a ser convertidos no Telegram e na API com o **seu** PID. Veja como **[ativar plugins em geral](/docs/integracoes/ativar-plugin/)** ou avance para **[Amazon](/docs/integracoes/amazon-paapi/)** e **[Shopee](/docs/integracoes/shopee/)**.
---
# DOC: Encurtador de links de afiliado (ofertou.ai)
URL: https://botdoafiliado.com/docs/telegram/encurtador/
Descrição: Entenda a política de encurtamento do Bot do Afiliado — quando encurta para amzn.to (Amazon), quando não encurta (Shopee, AliExpress, Mercado Livre) e o cache de links.
O Bot do Afiliado aplica uma **política inteligente de encurtamento** após gerar o link de afiliado. O objetivo é deixar o link **limpo** sem quebrar a atribuição de comissão.
## Como o bot decide
- **Amazon:** encurta para o domínio oficial **`amzn.to`** (o padrão de links curtos da Amazon).
- **Shopee, AliExpress, Mercado Livre:** **não** encurta — essas lojas usam deeplink/shortlink próprios, melhores sem encurtar.
- **Demais lojas:** usa o **encurtador do bot** (Cloudflare), com um sufixo que identifica a loja para análise.
## Cache
Cada link é **cacheado por ~30 dias**: enviar o mesmo link de novo retorna a **mesma** versão curta, com mais velocidade.
## Comandos relacionados
- **`/encurtar `** — converte e encurta um link.
- **`/soencurtar `** — apenas encurta, sem converter.
> Esses comandos podem precisar de habilitação pelo administrador. Veja a **[referência de comandos](/docs/telegram/comandos/)**.
---
# DOC: Como conectar Amazon (PA-API) no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/amazon-paapi/
Descrição: Como configurar a Amazon no Bot do Afiliado usando a PA-API 5.0. Um único plugin cobre PA-API e Creators API — escolha a fonte no painel.
O conversor da **Amazon** injeta a sua **tag de associado** no link e busca dados do produto pela API. O painel tem **um único plugin Amazon** que suporta duas fontes de dados — escolha no momento de configurar.
> ⚠️ A **PA-API 5.0 foi descontinuada pela Amazon** — o caminho recomendado hoje é a **[Creators API](/docs/integracoes/amazon-creators/)**. Você ainda consegue configurar a PA-API no Bot do Afiliado, e ela **funciona enquanto a Amazon não bloquear** o acesso; mas para começar do zero, prefira a Creators API.
## 1) Entrar no Programa de Associados
Cadastre-se no **Amazon Associados** e obtenha seu **partner tag** (ex.: `sualoja-20`) — o identificador que credita suas comissões. Você gerencia suas tags em **[associados.amazon.com.br › tag/manage](https://associados.amazon.com.br/home/account/tag/manage)**.
## 2) Qualificar a conta para a PA-API
A Amazon libera a **PA-API 5.0** após um número mínimo de **vendas qualificadas**. Divulgue seus links de associado para habilitar.
## 3) Gerar as chaves da PA-API
Na **Central de Associados → Ferramentas → Product Advertising API** (ou similar):
- **Access Key** (`accessKeyId`)
- **Secret Key** (`secretAccessKey`)
## 4) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Amazon** e clique em **Adicionar conta**:
1. Em **Fonte dos dados do produto**, selecione **PA-API**.
2. Preencha o **partner tag** (`seunome-20`) — usado pelas duas fontes.
3. Na seção **PA-API**, preencha `accessKeyId` e `secretAccessKey`.
4. Região, marketplace e idioma **já vêm configurados para o Brasil** (us-east-1 · amazon.com.br · pt_BR) — não precisa alterar.
5. (Opcional) Informe um ASIN de produto para validar antes de salvar.
6. Clique em **Validar credenciais** e depois em **Salvar**.
## Alternativa: Creators API (OAuth2)
Se preferir a **Creators API** (não precisa de vendas para liberar), veja o guia **[Amazon Creators API](/docs/integracoes/amazon-creators/)**.
Próximo: **[Shopee](/docs/integracoes/shopee/)** ou volte para **[como ativar plugins](/docs/integracoes/ativar-plugin/)**.
---
# DOC: Bot AliExpress no Telegram: desconto de moedas e cupom secreto automático
URL: https://botdoafiliado.com/docs/telegram/aliexpress-moedas-cupom/
Descrição: O Bot do Afiliado gera o link de desconto de moedas do AliExpress e detecta cupons secretos do produto automaticamente — com link de app e alternativa para PC/navegador, sempre com a sua tag de afiliado.
O Bot do Afiliado transforma um link de produto do **AliExpress** no **link de desconto de moedas** — e ainda **detecta cupons secretos** do produto automaticamente. Tudo a partir de um único link, na conversa ou no grupo.
## O link de desconto de moedas
Envie o link de um produto do AliExpress e o bot responde com o **link de moedas** já com a sua tag de afiliado:
- 📲 **O desconto de moedas funciona no app.** O link abre direto na **página de moedas** — basta clicar no primeiro produto da lista.
- 💻 **Alternativa para PC/navegador.** Se o estoque acabar ou o produto não tiver desconto de moedas, ele pode não aparecer. Por isso o bot envia também um **link comum** para abrir em qualquer lugar.
## Cupom secreto detectado automaticamente
Quando o produto tem um **cupom secreto**, o bot avisa na hora — com o **código**, o **desconto** e o **gasto mínimo**:
> Exemplo: *"Detectei um cupom secreto nesse produto 😎 — Cupom `BRK300`: em compras acima de R$ 1.607,70, ganhe R$ 160,77 de desconto."*
Isso aumenta a conversão: o seu público compra com um desconto que **nem sabia que existia**, sempre pelo **seu** link.
## Como gerar
- **Na conversa:** envie o link do produto (ou use `/moedas `). Veja todos os comandos do AliExpress em **[Comandos](/docs/telegram/comandos/)**.
- **No grupo:** com o módulo de **[Grupos](/docs/telegram/grupos/)** ativo, o bot responde automaticamente aos links do AliExpress postados, gerando o link de moedas e o cupom.
## Outros comandos do AliExpress
Além do link de moedas, o bot tem comandos para outros formatos de oferta e para pesquisar produtos direto no AliExpress:
| Comando | O que faz |
|---|---|
| `/moedas ` | Link de **moedas** (desconto) do produto. |
| `/coringa ` | Link **coringa** do produto. |
| `/addcarrinho ` | Link de **adicionar ao carrinho**. |
| `/promo ` | Vários links promocionais de uma vez (moedas, relâmpago, super ofertas, combo). |
| `/pesquisar ` | Pesquisa com **super desconto** (moedas). |
| `/pesquisarcombo ` | Pesquisa ofertas em **combo**. |
| `/pesquisachoice ` | Pesquisa produtos **Choice** (envio rápido). |
| `/pesquisabrasil ` | Pesquisa produtos **enviados do Brasil**. |
Veja a lista completa, com os comandos de administrador, em **[Comandos](/docs/telegram/comandos/)**.
## Pré-requisitos
Conecte o **plugin do AliExpress** com a sua credencial de afiliado — veja **[Integração AliExpress](/docs/integracoes/aliexpress/)**. Depois é só enviar links.
---
# DOC: Como conectar Amazon (Creators API) no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/amazon-creators/
Descrição: Como configurar a Amazon Creators API no Bot do Afiliado usando credentialId e credentialSecret — sem precisar de vendas qualificadas para liberar o acesso.
A **Creators API** é a forma mais nova de obter **dados de produto** da Amazon. Usa **OAuth2** (`credentialId`/`credentialSecret`) em vez da assinatura AWS da PA-API 5.0 — e **não precisa de vendas qualificadas** para liberar o acesso.
> A **geração do link de afiliado** é idêntica. O que muda é apenas a **fonte dos dados do produto** (título, imagem, preço).
## 1) Obter as credenciais no console da Creators API
Acesse o **[console da Amazon Creators API](https://associados.amazon.com.br/creatorsapi)** e gere:
- **credentialId**
- **credentialSecret**
A versão para Brasil é **2.1** (já vem preenchida por padrão no painel).
## 2) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Amazon** e clique em **Adicionar conta**:
1. Em **Fonte dos dados do produto**, selecione **Creators API**.
2. Preencha o **partner tag** (`seunome-20`) — compartilhado com a PA-API.
3. Na seção **Creators API**, preencha `credentialId` e `credentialSecret`.
4. A **versão** (2.1) e o marketplace já vêm configurados para o Brasil.
5. Clique em **Validar credenciais** e depois em **Salvar**.
Veja também o guia da **[PA-API 5.0](/docs/integracoes/amazon-paapi/)**.
---
# DOC: Postador de Ofertas: monte e publique ofertas pelo painel
URL: https://botdoafiliado.com/docs/telegram/formatador-tempo-real/
Descrição: Cole links, preços e cupons misturados, defina o CTA, envie sua própria foto do produto e veja a oferta montada com prévia do Telegram ao vivo — depois poste direto nos seus canais. Tudo no painel do Bot do Afiliado.
O **Postador de Ofertas** é a forma mais rápida de transformar um amontoado de **links, preços e cupons** em uma **oferta pronta** — com **prévia do Telegram ao vivo** e envio direto para os seus canais. Tudo no painel, sem digitar comando.
> É o irmão visual do comando **[/oferta](/docs/telegram/ofertas/)**: em vez de mandar o comando no chat, você monta e **revisa** a oferta no painel **antes** de postar.
## 1) Colar a entrada
No painel, abra **Promoções → Postador** e **cole** no campo *Entrada de Comando*. Pode ser tudo **misturado** — um item por linha:
- **links** de produto (qualquer loja com plugin/rota ativa);
- **preços** (ex.: `R$ 49,90`);
- **cupons** (ex.: `CUPOM15`).
O sistema **detecta e separa** tudo automaticamente, **converte** os links para afiliado e já mostra o **status** de cada um.
## 2) Prévia do Telegram ao vivo
Do lado direito, a **Prévia do Telegram** atualiza **na hora**, do jeitinho que vai sair no canal: foto do produto, título, **preço**, **cupom** e link curto.
## 3) Cupom (automático ou manual)
Se a entrada já tiver um cupom, ele é **extraído sozinho**. Você pode **sobrescrever** no campo *Cupom de Desconto* — a prévia muda na hora.
## 4) CTA da oferta (opcional)
No campo **CTA da oferta**, escreva sua chamada para ação — ex.: `Compre aqui 👇` ou `Aproveite! ⏰`. Ela preenche a variável **`{cta}`** no formato de oferta.
> **Regra:** o CTA aparece **exatamente onde você posicionar `{cta}`** no template. Sem `{cta}` no formato, o campo é ignorado — mesmo preenchido, o CTA **não aparece**. Para ativá-lo, abra **Promoções → Customizar** e insira o chip `{cta}` no ponto exato do template.
Você também pode definir o CTA escrevendo o texto entre **aspas** diretamente na *Entrada de Comando* (ex.: `"Compre aqui 👇" https://link.com`). O campo tem prioridade sobre as aspas.
## 5) Imagem do produto (e foto própria)
A opção **Incluir imagem** controla se a oferta sai **com foto**: com **um** produto vai a foto dele; com **vários**, o Postador monta uma **grade**. Sua escolha de marcar/desmarcar fica **salva por bot** — lembra na próxima vez, em qualquer dispositivo.
Não gostou da imagem que o sistema puxou? Em **Status dos Links**, cada produto tem o botão **📷 Usar minha foto**: envie uma imagem do seu dispositivo (até **5 MB**) e ela entra na hora. Com vários produtos, a sua foto substitui **apenas o espaço daquele produto** na grade — o resto continua automático.
> A foto fica **salva e vinculada ao produto** (por bot). Da próxima vez que você colar o **mesmo link**, ela volta sozinha — com o selo **✨ foto própria** e um botão **↺ automática** para voltar à imagem original. Para ver e gerenciar tudo, abra **Promoções → Fotos próprias** (miniatura, produto e botões de **trocar**/**remover**).
## 6) Escolher canais e postar
Marque um ou mais **canais de envio** (os canais ativos da aba **Conversas**). Depois:
- **Postar** — envia a oferta para os canais selecionados;
- **Copiar texto** — copia a oferta formatada para colar onde quiser.
> Não aparece nenhum canal? Cadastre um na aba **Conversas** primeiro. Para auditar os canais, veja **[alertas de canal](/docs/telegram/alertas-de-canal/)**.
Ative o módulo em **[módulos e preços](/docs/planos/modulos/)**. Veja também **[Ofertas](/docs/telegram/ofertas/)** e **[Cupons](/docs/telegram/cupons/)**.
---
# DOC: Como conectar Amazon (gerenciado) no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/amazon-gerenciado/
Descrição: Configure o provider Amazon Gerenciado no Bot do Afiliado, que preserva parâmetros como ascsubtag, injeta sua partner tag e encurta o link com amzn.to.
O provider **Amazon (Gerenciado)** é uma variação do conversor Amazon para quem opera com **cookie/identificador** em vez das chaves da PA-API. Ele **injeta a sua partner tag**, **preserva** parâmetros como `ascsubtag`/`btn_ref` quando existem e **encurta** o link com `amzn.to`.
## Credenciais
Na aba **Plugins**, escolha **Amazon** com provider **`gerenciado`** (também aceito: `amazon_gerenciado`) e preencha os campos:
- **partnerTag**: sua tag de associado (ex.: `sualoja-20`).
- **cookie**: cookie de sessão exigido pelo modo gerenciado.
## Rotas automáticas
Ao salvar, são criadas rotas para `amazon.com.br`, `amzn.to` e `a.co`.
Para obter **dados de produto** (título/preço/imagem) via API, veja **[Amazon PA-API](/docs/integracoes/amazon-paapi/)** ou **[Amazon Creators](/docs/integracoes/amazon-creators/)**.
---
# DOC: Como conectar Shopee no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/shopee/
Descrição: Como entrar no programa de afiliados da Shopee, obter as credenciais da Open API (appId e secret) e configurar o conversor no Bot do Afiliado.
O conversor da **Shopee** gera o **shortlink de afiliado** e busca dados do produto pela **Open API** (GraphQL). Para isso, você precisa de uma conta de afiliado aprovada e das credenciais **appId** e **secret**.
## 1) Entrar no programa de afiliados
Cadastre-se no **Programa de Afiliados da Shopee** e aguarde a **aprovação** da conta.
## 2) Pegar o appId e o secret na Abrir API
Acesse o **painel da Shopee Afiliados** e vá em **Abrir API** — o **appId** e o **secret** ficam lá. Se a **Abrir API** não estiver ativa na sua conta, fale com a sua **gerente** ou com o **suporte pelo chat no app**.
## 3) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Shopee** (provider `shopee`) e preencha os campos de credencial:
- **appId** — copiado da Open API.
- **secret** — copiado da Open API.
- **Tracking ID padrão** — o seu subID de rastreamento para atribuição.
(Opcional) Informe uma **URL de amostra** da Shopee, clique em **Validar** e depois em **Salvar**.
Pronto — links da Shopee passam a ser convertidos com as suas credenciais. Volte para **[como ativar plugins](/docs/integracoes/ativar-plugin/)** ou veja **[AliExpress](/docs/integracoes/aliexpress/)** e **[Amazon](/docs/integracoes/amazon-paapi/)**.
---
# DOC: Whitelist: links e domínios que o bot não converte
URL: https://botdoafiliado.com/docs/telegram/whitelist/
Descrição: Use a whitelist do Bot do Afiliado para marcar domínios e URLs que não devem ser convertidos nem fiscalizados — ideal para redes sociais, seus próprios canais e links que devem passar intactos.
A **whitelist** é a lista de **domínios** e **URLs** que o bot deve **ignorar** — ou seja, **não converte** em link de afiliado e **não fiscaliza** na moderação de grupos. Útil para deixar passar **redes sociais**, os **seus próprios canais** e qualquer link que precise ficar **intacto**.
## Como funciona
Cada item tem um **tipo**:
- **domínio** — cobre o site inteiro (ex.: `youtube.com`, `tiktok.com`);
- **link** — cobre uma **URL específica** (ex.: `https://t.me/seucanal`).
Quando um link bate com a whitelist, o bot o **deixa passar** sem tocar — na conversa direta e, principalmente, na **[moderação de grupos](/docs/telegram/grupos/)** (não apaga nem substitui).
## Adicionar e remover
No painel, abra a aba **Whitelist**:
1. Escolha o **tipo** (domínio ou link).
2. Informe o **valor** (domínio ou URL).
3. Clique em **Adicionar**.
Para tirar um item, clique em **Excluir** na linha correspondente. A mudança propaga em **poucos segundos**.
> Exemplos comuns: `youtube.com`, `tiktok.com`, `instagram.com` e os links dos **seus** canais (`https://t.me/seucanal`) — assim suas próprias divulgações não são reescritas.
---
# DOC: Como conectar Awin no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/awin/
Descrição: Como virar publisher na Awin, gerar o token de API e configurar o conversor no Bot do Afiliado — o bot importa as suas lojas aprovadas automaticamente.
A **Awin** é uma **rede de afiliados**: com uma conta você atende **centenas de lojas**. O conversor gera o seu **link de afiliado** da Awin e encurta. Você só precisa do **publisher ID** e de um **token de API** — as lojas (anunciantes) são importadas automaticamente. Veja todas as lojas suportadas na **[lista de plugins](/plugins)**.
## 1) Virar publisher e gerar o token
1. Cadastre-se na **Awin** como publisher e aguarde aprovação.
2. Pegue o seu **publisher ID** (ID da conta) em **[ui.awin.com/user](https://ui.awin.com/user)**.
3. Gere um **token de API (OAuth2)** em **[ui.awin.com/awin-api](https://ui.awin.com/awin-api)**.
## 2) Aprovar anunciantes (lojas)
Solicite participação nos **programas (anunciantes)** que quer divulgar. Não precisa anotar nada — o bot puxa as lojas aprovadas sozinho no próximo passo.
## 3) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Awin** e preencha os campos **publisherId** e **accessToken** com o seu publisher ID e o token de API. Clique em **Validar** e **Salvar**.
Ao salvar, o bot **importa automaticamente** as lojas (anunciantes) que você tem aprovadas na Awin — cada uma já com o seu **advertiser ID**. Você **não precisa** anotar nem digitar advertiser ID em lugar nenhum. Aprovou uma loja nova depois? Clique em **Sincronizar domínios** para atualizar.
Pronto — links das lojas aprovadas passam a ser convertidos pela Awin com o seu publisher ID.
## Várias contas Awin
Você pode cadastrar **mais de uma conta Awin** (cada uma com o seu publisher ID) — útil quando você tem IDs diferentes por loja (ex.: Casas Bahia, Samsung, Americanas). O bot escolhe a conta certa para cada loja automaticamente. Veja também **[Rakuten](/docs/integracoes/rakuten/)** e **[como ativar plugins](/docs/integracoes/ativar-plugin/)**.
---
# DOC: Como conectar Rakuten no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/rakuten/
Descrição: Como virar publisher na Rakuten Advertising, obter o App ID e o App Secret e configurar o conversor no Bot do Afiliado — as lojas são importadas automaticamente.
A **Rakuten Advertising** é uma **rede de afiliados**. O conversor monta o **deeplink** (`click.linksynergy.com/deeplink`) e encurta o link. Você só precisa do **publisher ID (SID)** e do **App ID + App Secret** — as lojas (anunciantes) são importadas automaticamente.
## 1) Virar publisher e obter as credenciais
1. Cadastre-se na **Rakuten Advertising** e aguarde aprovação. O seu **publisher ID (SID)** aparece no painel (com o prefixo `sid`).
2. Acesse o **[dashboard de API](https://developers.rakutenadvertising.com/default/dashboard/)**, clique em **add application** e anote o **App ID** (`clientId`) e o **App Secret** (`clientSecret`) da aplicação.
> 💡 O **access token** não precisa ser gerado à mão: ele é sempre temporário (1 hora) e o bot o gera automaticamente. Passo a passo oficial: **[guia "try out APIs" da Rakuten](https://developers.rakutenadvertising.com/guides/try_out_apis)**.
## 2) Aprovar anunciantes (lojas)
Solicite participação nos **anunciantes** (lojas) que quer divulgar. Não precisa anotar nada — o bot importa as lojas aprovadas sozinho no próximo passo.
## 3) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Rakuten** e preencha os três campos:
- **SID** — o seu publisher ID (também usado como *scope* na geração do token).
- **App ID** — o `clientId` da aplicação criada no dashboard de API.
- **App Secret** — o `clientSecret` da aplicação.
O **token de acesso é gerado automaticamente** na sincronização (expira em 1 hora e nunca é salvo).
Ao **salvar**, o bot **importa automaticamente** as lojas (anunciantes) que você tem aprovadas na Rakuten — cada uma já com o seu **advertiser ID (MID)**. Você **não precisa** anotar nem digitar advertiser ID. Aprovou uma loja nova depois? Clique em **Sincronizar domínios** para atualizar.
Veja também **[Awin](/docs/integracoes/awin/)** (mesma lógica de rede) e **[como ativar plugins](/docs/integracoes/ativar-plugin/)**.
---
# DOC: Como conectar Magalu no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/magalu/
Descrição: Como configurar o Magalu no Bot do Afiliado colando um link de afiliado seu — o painel detecta o seu promoter ID automaticamente.
O conversor do **Magalu** gera seus links pela estrutura do **Parceiro Magalu / Magazine Você**. Você **não precisa procurar o seu promoter ID na mão**: basta **colar um link de afiliado seu** no painel que o ID é detectado automaticamente.
## 1) Gerar um link de afiliado no Magalu
No **Parceiro Magalu / Magazine Você**, gere um **link de afiliado** para qualquer produto (ou copie um link da sua vitrine no Magazine Você). É esse link que o painel usa para detectar o seu ID.
## 2) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Magalu**:
1. **Cole o link** do Magalu no campo "Cole um link do Magalu".
2. Clique para **detectar** — o seu **promoter ID** é preenchido automaticamente.
3. **Salve** o plugin.
Como funciona a conversão:
- **magazineluiza.com.br** (`/p/`, `/oferta/`): monta a URL trackeada com o seu promoter ID.
- **magazinevoce.com.br:** troca o identificador no caminho da URL pelo seu.
- **divulgador.magalu.com / onelink:** o bot segue o redirect antes de converter.
Veja também **[como ativar plugins](/docs/integracoes/ativar-plugin/)**.
---
# DOC: Como conectar Mercado Livre no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/mercado-livre/
Descrição: Como configurar o Mercado Livre no Bot do Afiliado com a sua tag e o cookie de afiliado — gerando links, dados de produto e histórico de preços.
O conversor do **Mercado Livre** gera o link de afiliado e também consegue trazer **dados do produto** e **histórico de preços**. Ele exige a sua **tag** e um **cookie** de sessão.
## 1) Obter a tag e o cookie
### a) Pegue a sua tag (etiqueta)
1. Ative o **programa de afiliados** do Mercado Livre na sua conta.
2. Abra o **[Administrador de etiquetas](https://www.mercadolivre.com.br/afiliados/adminlabel#hub)** e copie a **tag** (etiqueta) em uso — no exemplo, `nerd`.
### b) Capture o cookie de sessão
3. Abra o **[gerador de links de afiliado](https://www.mercadolivre.com.br/afiliados/linkbuilder#hub)**. Com a página aberta, clique com o **botão direito → Inspecionar** (ou tecle **F12**) para abrir as ferramentas do desenvolvedor.
4. Nas ferramentas do desenvolvedor, abra a aba **Rede** (Network).
5. Cole um **link de produto** no gerador e clique em **Gerar**. Na lista da aba Rede, selecione a requisição **`createLink`**.
6. Na aba **Cabeçalhos** da requisição, copie **todo o valor** do cabeçalho **`Cookie`**.
## 2) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **Mercado Livre** e preencha os dois campos de **Credenciais**:
- **Tag** — a sua etiqueta de afiliado (passo 2). Ex.: `nerd`.
- **Cookie** — o valor copiado da requisição `createLink` (passo 6).
Informe uma **URL de amostra** do Mercado Livre no campo de validação e clique em **Validar credenciais**. Com o sinal **verde (OK)**, salve. Se a conversão falhar depois de um tempo, **atualize o cookie**.
## Histórico de preços
Para links do Mercado Livre, o bot consegue mostrar o **histórico de preços** do produto. Veja a seção de **[comandos do Telegram](/docs/telegram/comandos/)**.
---
# DOC: Como conectar Terabyte no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/terabyte/
Descrição: Como configurar a Terabyte (Terabyteshop) no Bot do Afiliado, injetando os parâmetros de afiliado e encurtando o link automaticamente.
O conversor da **Terabyte** normaliza o link da Terabyteshop, **injeta os parâmetros de afiliado** (incluindo o seu identificador) e **encurta** o resultado. A conversão é por parâmetros/UTM — não exige chamada de API.
## Configurar no painel
Na aba **Plugins**, escolha **Terabyte** e preencha os campos com o seu identificador e os UTMs do programa:
- **p**: seu identificador de afiliado.
- **utmMedium**: o UTM medium do programa.
- **utmCampaign**: o nome da campanha.
> 💡 O `p` é o **mesmo identificador** que aparece no `?p=...` dos links que você gera no programa de afiliados da Terabyte.
## Rotas automáticas
Ao salvar, é criada a rota para `terabyteshop.com.br`.
Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para o fluxo completo.
---
# DOC: Como conectar Pague Menos no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/pague-menos/
Descrição: Como configurar a Pague Menos no Bot do Afiliado com o seu código de consultor — o resto é automático.
O conversor da **Pague Menos** ajusta o link da loja com a **sua atribuição de afiliado** e **encurta** o resultado.
## Configurar no painel
Na aba **Plugins**, escolha **Pague Menos** e preencha:
- **Código do consultor** — o seu código de consultor/afiliado da plataforma Mais (Pague Menos).
Só isso — o restante é configurado automaticamente.
## Rotas automáticas
Ao salvar, é criada a rota para `paguemenos.com.br`.
Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para o fluxo completo.
---
# DOC: Como conectar Braé no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/brae/
Descrição: Como configurar a Braé no Bot do Afiliado usando o seu identificador de parceiro e um cupom opcional para gerar links com a sua comissão.
O conversor da **Braé** gera o link com o seu **identificador de parceiro** e, opcionalmente, aplica um **cupom**. A conversão é por parâmetros — não exige API.
## Configurar no painel
Na aba **Plugins**, escolha **Braé** e preencha os campos:
- **parceiro**: seu identificador no programa de parceiros da Braé.
- **cupom** (opcional): cupom a ser divulgado junto.
> 💡 O `parceiro` é o seu identificador no programa de parceiros da Braé — o mesmo que aparece nos links que você gera lá.
Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para o fluxo completo.
---
# DOC: Como conectar Beleza na Web no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/belezanaweb/
Descrição: Como configurar a Beleza na Web no Bot do Afiliado com o seu código de consultor e um cupom opcional.
O conversor da **Beleza na Web** gera o seu **link de afiliado** (com um **cupom** opcional) e encurta o resultado.
## Configurar no painel
Na aba **Plugins**, escolha **Beleza na Web** e preencha:
- **Código do consultor** — o seu identificador de afiliado da Beleza na Web.
- **Cupom** (opcional) — cupom de desconto para os seus seguidores.
Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para o fluxo completo.
---
# DOC: Como conectar Natura no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/natura/
Descrição: Como configurar a Natura no Bot do Afiliado com o seu código de consultor e um cupom opcional para gerar links com a sua comissão.
O conversor da **Natura** gera o link com o seu **código de consultor** e, opcionalmente, um **cupom**.
## Configurar no painel
Na aba **Plugins**, escolha **Natura** e preencha:
- **Código do consultor** — o seu identificador de consultoria Natura.
- **Cupom** (opcional) — cupom a ser divulgado junto.
Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para o fluxo completo.
---
# DOC: Como conectar CityAds no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/cityads/
Descrição: Como configurar a CityAds no Bot do Afiliado. O painel importa automaticamente suas lojas brasileiras conectadas e gera os links de afiliado com deeplink.
O conversor da **CityAds** importa automaticamente as suas lojas brasileiras conectadas na rede e gera links de afiliado com **deeplink** — você pode apontar para qualquer página interna do lojista, não só a home.
> A CityAds tem duas APIs distintas (v2 OAuth e v1 legada). O painel usa as duas: a v2 para o catálogo de lojas e a v1 para a base de clique. Você precisa das duas credenciais.
## 1) Obter as credenciais no painel CityAds
No painel CityAds, vá em **Perfil → API** e anote:
- **clientId** e **clientSecret** — credenciais OAuth2 (Publisher API v2)
- **remoteAuth** — token da API legada (seção API ou Legacy)
## 2) Configurar no Bot do Afiliado
Na aba **Plugins**, escolha **CityAds** e clique em **Adicionar conta**:
1. Preencha `clientId`, `clientSecret` e `remoteAuth`.
2. Clique em **Validar credenciais** — o painel testa o OAuth e confirma as credenciais.
3. Clique em **Salvar**.
Ao salvar, o painel **sincroniza automaticamente** suas lojas brasileiras conectadas (com deeplink habilitado). Você também pode clicar em **Sincronizar domínios** a qualquer momento para atualizar.
## 3) Gerenciar as lojas importadas
Cada loja vira uma **Rota** com o domínio do lojista (ex.: `gfarma.com`). Para remover uma loja que não quer converter, vá em **Rotas** e exclua a rota correspondente.
A partir daí é automático: ao enviar um link de uma dessas lojas, o bot devolve o **seu link de afiliado** da CityAds.
Veja também **[como ativar plugins](/docs/integracoes/ativar-plugin/)**.
---
# DOC: Loja não mapeada: o que fazer quando o link não converte
URL: https://botdoafiliado.com/docs/integracoes/loja-nao-mapeada/
Descrição: O que fazer quando o bot não converte um link — entenda domínios não mapeados, verifique rotas e plugins e saiba como adicionar uma loja nova.
Quando você envia um link e o bot **não gera** a versão de afiliado, quase sempre é porque **não existe rota/conversor ativo** para aquele domínio (ou faltam credenciais).
## Como o bot decide
O motor procura uma **rota** que cubra o domínio do link e usa o **conversor** dela. Se nenhuma rota cobre o domínio, o link entra em **não mapeados** — um registro de domínios/links que apareceram mas não puderam ser convertidos. Entenda o fluxo em **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.
## Checklist rápido
1. **O plugin da loja está ativo?** Confira na aba **Plugins**.
2. **Há rota para o domínio?** Veja a aba **Rotas** (lembre que rotas são criadas ao salvar o plugin).
3. **As credenciais estão corretas?** Alguns providers só convertem com credenciais válidas.
4. **É rede (Awin/Rakuten)?** Tenha aprovação no anunciante e clique em **Sincronizar domínios** — o bot importa a loja sozinho (sem advertiserId manual).
## Adicionar uma loja nova
- **Loja dentro de uma rede** (Awin/Rakuten): você já tem o publisher/token; basta ter **aprovação no anunciante** — o bot importa a loja automaticamente (sem advertiserId manual). Veja **[Awin](/docs/integracoes/awin/)** e **[Rakuten](/docs/integracoes/rakuten/)**.
- **Programa de afiliado por parâmetros na URL** (UTM, tag ou ID na própria URL): você mesmo cria a rota em poucos cliques no **criador de rotas** (aba **Rotas** do painel) — é só apontar o domínio e os parâmetros do seu link de afiliado. Não precisa de um plugin pronto.
- **Loja com programa direto** (que exige API/integração específica): fale com o suporte em **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)** para avaliarmos a integração.
---
# BLOG: Como ser afiliado da Casas Bahia (programa privado, até 9%)
URL: https://botdoafiliado.com/blog/afiliado-casas-bahia-programa-privado/
Publicado: 2026-06-10
Descrição: Cadastro grátis no programa de afiliados da Casas Bahia (rede privada na Awin), comissão de até 9%, cookie de 7 dias e como converter os links no automático.
**Para ser afiliado da Casas Bahia** você se cadastra **de graça** na **Awin** (a rede que opera o programa), é aprovado, gera os seus links de afiliado e ganha comissão por cada venda — **até 9%**, dependendo da categoria. O cadastro é pelo **programa privado oficial** (link no passo a passo abaixo) e, o melhor, dá para **converter e divulgar os links no automático**, sem montar cada post na mão.
## O que é o programa de afiliados da Casas Bahia
A Casas Bahia é um dos maiores varejistas do Brasil, com milhares de produtos em telefonia, eletrodomésticos, TVs, móveis, informática e mais. O **programa de afiliados** deixa você ganhar **comissão** promovendo esses produtos no seu site, blog, canal do Telegram ou redes sociais.
Pontos-chave:
- É **gratuito** e aceita **pessoa física** — não precisa de CNPJ.
- Roda na plataforma **Awin**, que cuida do rastreamento, dos relatórios e do pagamento.
- É uma **rede privada (private network)**: você entra pelo **link oficial de cadastro** — é assim que cai no programa certo, com as comissões atuais.
## Quanto paga a comissão da Casas Bahia
- **Até 9% por venda**, variando conforme a **categoria** do produto (a própria Casas Bahia anuncia "até 9%" na página oficial do programa).
- Categorias de **alto volume** (eletrônicos/eletrodomésticos) costumam pagar percentuais menores; itens de **maior margem** pagam mais. Os valores exatos por categoria ficam na **visão geral do programa na Awin**.
- **Cookie de 7 dias:** se a pessoa clicar no seu link e comprar em até 7 dias, a venda é sua.
- Vale para compras no **site e no app** da Casas Bahia.
- As comissões são pagas sobre os pedidos **aprovados**, por **transferência**, conforme o calendário da Awin (há um valor mínimo para saque, que você vê na sua conta).
> ⚠️ Os percentuais variam por **categoria e campanha**. Use o "até 9%" como referência e confirme a **tabela atual** na sua conta da Awin antes de prometer um número fechado para a sua audiência.
## Como ser afiliado da Casas Bahia: passo a passo
1. **Cadastre-se no programa** pelo link oficial: **[Cadastro de afiliado da Casas Bahia na Awin](https://ui.awin.com/publisher-signup/br/afiliadosdacasasbahia/step1?advertiser=85979)**. Preencha os seus dados e os do seu canal/site.
2. **Aguarde a aprovação** da Awin/Casas Bahia — você precisa ter um site, blog ou perfil que promova os produtos.
3. **Gere os links** no **Construtor de Links** da Awin: cole a URL do produto e a ferramenta devolve o seu link rastreável. (Dica: retire parâmetros de outras mídias antes de gerar o link.)
4. **Divulgue** os links no seu canal do Telegram, grupo de WhatsApp, blog ou Instagram.
## Como faturar de verdade: converta os links no automático
Gerar link a link na mão é o que trava a maioria dos afiliados. Como a Casas Bahia roda na **Awin**, dá para conectar o programa ao **Bot do Afiliado** e:
- **Converter qualquer link da Casas Bahia** automaticamente para o seu link de afiliado — no Telegram e no WhatsApp, sem abrir o Construtor de Links toda hora.
- **Montar posts de oferta prontos** (título, preço, cupom e CTA) e **disparar** para os seus grupos e canais.
- **Importar as rotas da Awin** (incluindo a Casas Bahia) com um clique e deixar a conversão no **piloto automático**.
Veja **[como conectar a Awin](/docs/integracoes/awin/)** e **[transformar links em afiliado no Telegram](/blog/transformar-links-em-afiliado-no-telegram/)**.
## Regras importantes (para não tomar bloqueio)
- **Sem brand bidding:** não faça anúncios pagos usando a marca "Casas Bahia".
- **Sem campanhas indiretas** e **sem Google Performance Max** (restrições do programa).
- Siga as **diretrizes** da Awin/Casas Bahia — descumprir pode suspender a sua conta.
## Perguntas frequentes
**Quanto a Casas Bahia paga de comissão?**
Até 9% por venda, variando por categoria. Confirme a tabela atual na visão geral do programa, na sua conta da Awin.
**Precisa ter CNPJ para ser afiliado da Casas Bahia?**
Não. Pessoa física pode participar e a inscrição é gratuita.
**Qual é a duração do cookie?**
7 dias — a venda conta se a compra acontecer em até 7 dias do clique no seu link.
**Como recebo os pagamentos?**
Por transferência, sobre os pedidos aprovados, no calendário de pagamento da Awin. Há um valor mínimo de saque, que você vê na sua conta.
**Dá para divulgar no WhatsApp e no Telegram?**
Sim. E com o **Bot do Afiliado** os links são convertidos e postados automaticamente.
**As vendas pelo aplicativo contam?**
Sim — vendas no site e no app da Casas Bahia são comissionadas.
## Comece agora
1. **[Cadastre-se no programa de afiliados da Casas Bahia](https://ui.awin.com/publisher-signup/br/afiliadosdacasasbahia/step1?advertiser=85979)**.
2. Conecte a Awin no **[Bot do Afiliado](https://app.botdoafiliado.com/)** e deixe a conversão dos links no automático.
Veja também: **[Guia de afiliação por marketplace](/blog/guia-de-afiliacao-por-marketplace/)** e **[qual programa de afiliados paga mais](/blog/programas-de-afiliados-qual-paga-mais/)**.
---
# BLOG: Como ser afiliado da Época Cosméticos: parceria direta passo a passo (com modelo de e-mail)
URL: https://botdoafiliado.com/blog/seja-afiliado-epoca-cosmeticos/
Publicado: 2026-06-07
Descrição: O caminho oficial para se afiliar à Época Cosméticos é simples: um e-mail de parceria. Veja o passo a passo, um modelo pronto de e-mail e como automatizar seus links de beleza no Telegram com o Bot do Afiliado.
Beleza é um dos nichos que mais convertem no marketing de afiliados: ticket alto, recompra frequente e marcas que o público procura pelo nome. A **Época Cosméticos** — referência em **perfumes importados, maquiagem, dermocosméticos e cuidados com o cabelo** — é uma das lojas mais cobiçadas por quem divulga beleza.
E a melhor parte: **se afiliar a ela é mais simples do que parece**. Não tem formulário gigante nem aprovação automatizada — o caminho é uma **parceria direta com a loja**, iniciada por e-mail. Este guia mostra o passo a passo e, na sequência, como colocar seus links da Época pra rodar **no automático** no Telegram.
## Como se afiliar à Época Cosméticos (passo a passo)
A porta de entrada do programa é o **contato direto com o time de parcerias** da loja:
1. **Escreva para `parceria@epocacosmeticos.com.br`** com o assunto **"Quero me Afiliar!"**.
2. **Apresente-se em poucas linhas**: quem você é, qual canal/página você administra (canal do Telegram, Instagram, site, YouTube…) e o tamanho/perfil da sua audiência.
3. **Mostre o encaixe com o nicho**: deixe claro que o seu público tem interesse em **cosméticos, perfumes e beleza** — é isso que o time de parcerias quer ver.
4. **Peça as orientações** sobre o processo de afiliação e **aguarde o retorno** da equipe com os próximos passos para formalizar a parceria.
### Modelo de e-mail pronto (copie e adapte)
> **Assunto:** Quero me Afiliar!
>
> Olá, time da Época Cosméticos!
>
> Meu nome é **[seu nome]** e administro o canal **[nome do seu canal/página]** no Telegram, com **[X mil]** inscritos interessados em **cosméticos, perfumes e beleza**.
>
> Tenho interesse em divulgar os produtos da Época Cosméticos para essa audiência e gostaria de saber como funciona o processo de afiliação e quais são os próximos passos para formalizarmos a parceria.
>
> Obrigado!
> **[seu nome + contato]**
**Dica:** quanto mais concreto o número e o nicho ("canal de achadinhos de beleza com 12 mil inscritos"), maior a chance de resposta rápida. Se o seu canal ainda é pequeno, mostre **engajamento** (prints de cliques/conversões em outras lojas ajudam).
## Caminho alternativo: redes de afiliados
Além da parceria direta, a Época Cosméticos também já apareceu em **redes de afiliados** (como **Awin** e **Rakuten**) — vale procurar por "Época Cosméticos" dentro do painel da rede onde você já tem conta. Nas redes você ganha painel de relatórios e pagamento centralizado, mas a disponibilidade do programa **varia** (e a maioria das lojas BR pede **CNPJ**). Os dois caminhos levam ao mesmo lugar: **seu link rastreável da Época**.
## Aprovado? Coloque seus links no automático
Seja qual for o formato que a Época te der — **link com parâmetro de rastreio** próprio ou link pela rede — o **Bot do Afiliado** assume daqui pra frente:
- **Parceria direta (parâmetro na URL):** crie uma **[rota personalizada](/docs/integracoes/loja-nao-mapeada/)** para `epocacosmeticos.com.br` com o seu parâmetro — o bot passa a converter **qualquer link da Época** colado no chat para o seu link rastreado, com **teste de URL** mostrando o link final.
- **Pela rede (Awin/Rakuten):** conecte o plugin **[Awin](/docs/integracoes/awin/)** ou **[Rakuten](/docs/integracoes/rakuten/)** e a rota do domínio é criada **sozinha**.
- Ative a **conversão automática no grupo**: o bot **substitui** os links enviados pelos seus.
## Poste ofertas de beleza prontas no Telegram
Link convertido é só o começo — o bot monta o **post completo**:
- **[/oferta](/docs/telegram/ofertas/)** transforma o link em post formatado com **imagem, título, preço e CTA**;
- O **[Postador de Ofertas](/docs/telegram/formatador-tempo-real/)** faz isso pelo painel, com **prévia ao vivo** — e você pode usar a sua **foto própria** do produto;
- **[Cupons](/docs/telegram/cupons/)** da Época ficam num menu pros inscritos resgatarem.
## Dicas para vender mais no nicho de beleza
- **Mostre o produto.** Em beleza, a **imagem** vende — capriche na foto e no preço de/por.
- **Aproveite as datas.** Dia das Mães, Namorados e Black Friday explodem em perfumaria e presentes.
- **Misture lojas.** Combine a Época com **[Beleza na Web](/docs/integracoes/belezanaweb/)** e **[Natura](/docs/integracoes/natura/)** para nunca faltar oferta boa.
- **Seja constante.** Canal que posta todo dia converte mais — e o bot deixa isso no automático.
## Perguntas frequentes
**Como me afilio à Época Cosméticos?**
Enviando um e-mail de apresentação para **`parceria@epocacosmeticos.com.br`** com o assunto "Quero me Afiliar!" — diga quem você é, qual página administra e que seu público curte beleza. O time retorna com as orientações para formalizar.
**Preciso de CNPJ para ser afiliado da Época?**
Para a **parceria direta**, os requisitos são definidos pelo time da Época no retorno do seu e-mail. Se optar por uma **rede de afiliados**, a maioria dos programas BR pede CNPJ.
**O Bot do Afiliado converte links da `epocacosmeticos.com.br`?**
Sim — nos dois formatos. Parceria direta com parâmetro: use uma **rota personalizada** com o seu parâmetro. Pela rede: ative o plugin **Awin/Rakuten** e a rota é criada automaticamente.
**Quanto a Época Cosméticos paga de comissão?**
A comissão é definida na sua parceria (e pode variar por categoria e campanha). Confirme as condições no retorno do time de parcerias — e foque em **perfumes importados e kits**, onde o ticket é maior.
**Dá para divulgar fora do Telegram?**
Dá. O link rastreado funciona em qualquer lugar — Instagram, WhatsApp, site. O bot facilita gerar, converter e postar em escala.
---
> Já tem (ou vai pedir) sua parceria? Deixe a operação pronta: crie seu bot no **[painel](https://app.botdoafiliado.com/)** e veja os módulos em **[/pricing](/pricing)**.
---
# BLOG: Automação de Cupons: como extrair e reativar códigos promocionais expirados
URL: https://botdoafiliado.com/blog/automacao-de-cupons-extrair-reativar-expirados/
Publicado: 2026-06-04
Descrição: Pare de perder venda com cupom vencido ou cadastro manual: extraia códigos com IA, organize por categoria e status, e reative os expirados quando a promoção volta.
Cupom mal gerenciado é venda perdida: ou você não cadastra (preguiça do manual), ou deixa um **código vencido** no ar e queima a confiança do público. A automação de cupons resolve as duas pontas.
## Extração por IA (em segundos)
Em **Cupons → IA Extrator**, cole o **texto de um post** e a IA separa **categoria, código, regras e link** — você só revisa e salva. Dá para transformar uma enxurrada de mensagens de grupos em cupons organizados, rápido:
## Organize por categoria e status
Agrupe cupons em **categorias** (ex.: AliExpress, Shopee, Black Friday) com ordem e **status ativo/inativo**. O bot mostra **só os válidos** — nada de oferecer cupom morto:
## Reative os expirados (não recadastre)
Quando um cupom vence, ele vai para a aba **Expirados** (mantido para reativação). Quando a promoção **volta**, você **reativa** com um clique — o código fica vigente de novo, **sem refazer o cadastro**. Menu sempre cheio, zero retrabalho.
## Veja também
- Como tudo se encaixa no dia a dia: **[cupom no piloto automático](/blog/cupom-no-piloto-automatico-ia/)**.
- Cupons secretos do AliExpress: **[moedas + cupom secreto](/docs/telegram/aliexpress-moedas-cupom/)**.
> Ative o módulo em **[módulos e preços](/docs/planos/modulos/)** · comece no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Broadcast de ofertas no privado: mande promoções direto no Telegram das pessoas
URL: https://botdoafiliado.com/blog/broadcast-de-ofertas-no-privado/
Publicado: 2026-06-04
Descrição: Use o broadcast para enviar uma promoção de uma vez para todos que já falaram com o seu bot — no privado, com opção de fixar e acompanhar o status de entrega.
Postar no canal é ótimo, mas **mensagem no privado** chega mais perto. Com o módulo de **Broadcast**, você dispara uma promoção **de uma vez** para **todos os contatos que já falaram com o seu bot** — direto no privado deles.
## Como funciona
- Atinge as **conversas** (e grupos) que **interagiram** com o bot — **canais são excluídos**.
- Roda em **fila, em lotes**, respeitando os limites do Telegram (com novas tentativas).
- Quem **bloqueou** o bot ou não existe mais é desativado automaticamente, sem travar o resto.
## Pelo painel
Em **Broadcast → Novo**, escreva a mensagem (com **formatação** e **imagem**), marque **Fixar** se quiser e envie:
No Telegram, dá também para usar **`/broadcast`** (admin) e **`/broadcastcompin`** (envia e fixa):
## Acompanhe a entrega
Veja **enviados**, **falhas** e **cancelados** no **Histórico** (ou com `/broadcaststatus`), e interrompa com `/broadcastcancel`.
## Boas práticas
- **Teste** a mensagem antes (formatação e links convertidos).
- Use **[variáveis](/docs/telegram/mensagens-e-variaveis/)** para personalizar (ex.: `{nome}`).
- Não exagere na frequência — privado demais vira bloqueio.
> Detalhes em **[Broadcast](/docs/telegram/broadcast/)** · ative em **[módulos e preços](/docs/planos/modulos/)**.
---
# BLOG: Como ter seu próprio bot de moedas do AliExpress
URL: https://botdoafiliado.com/blog/bot-de-moedas-aliexpress/
Publicado: 2026-06-04
Descrição: Monte um bot no Telegram que gera o link de desconto de moedas do AliExpress — e ainda acha cupons secretos nos produtos — automaticamente, com a sua tag de afiliado.
As **"moedas"** do AliExpress são um desconto extra que aparece **dentro do app** — e converte muito, porque o cliente vê um preço menor que o normal. O problema é gerar o **link de moedas** de cada produto na mão. A solução é ter um **bot** que faz isso sozinho, no Telegram, já com a **sua** tag de afiliado.
## O que é o desconto de moedas
É uma promoção do AliExpress em que parte do valor é abatido com as "moedas" do app. O preço final fica menor — mas só quando o link abre na **página de moedas** do aplicativo. Por isso um link "normal" não aproveita esse desconto: você precisa do **link de moedas** certo.
## O bot gera o link de moedas sozinho
Você (ou o seu público) manda o link do produto e o bot devolve o **link de moedas** na hora:
- 📲 Abre direto na **página de moedas** do app — é só tocar no primeiro produto.
- 💻 Vem com um **link alternativo** para PC/navegador, caso o produto não esteja na promoção de moedas.
## Bônus: cupons secretos do produto
Além das moedas, o bot **detecta cupons secretos** — aqueles que nem aparecem na página do produto — e mostra **código**, **desconto** e **gasto mínimo**:
## Como ter o seu (em minutos)
1. Crie um bot no **[@BotFather](https://t.me/BotFather)** e copie o token.
2. Conecte no **[painel](https://app.botdoafiliado.com/)** (cole o token e dê um nome).
3. Ative o **plugin do AliExpress** com a sua **credencial de afiliado**.
A partir daí, todo link do AliExpress vira **link de moedas** (e cupom secreto) automaticamente — na conversa e nos grupos. Passo a passo completo em **[Primeiros passos](/docs/comecando/primeiros-passos/)** e **[Integração AliExpress](/docs/integracoes/aliexpress/)**; os detalhes do recurso estão em **[desconto de moedas e cupom secreto](/docs/telegram/aliexpress-moedas-cupom/)**.
> Veja os módulos e preços em **[/pricing](/pricing)** e comece agora no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Conheça o Bot do Afiliado: moedas, cupons secretos e ofertas no automático
URL: https://botdoafiliado.com/blog/conheca-o-bot-do-afiliado/
Publicado: 2026-06-04
Descrição: Um tour pelo que o Bot do Afiliado faz no Telegram: converte links com a sua tag, gera o desconto de moedas do AliExpress, acha cupons secretos nos produtos e monta ofertas prontas.
O **Bot do Afiliado** automatiza o trabalho chato de quem divulga produtos: converter links, achar desconto e montar oferta. Tudo no Telegram, sempre com a **sua** tag de afiliado. Veja o que ele faz.
## Converte qualquer link em afiliado
Mande um link de **AliExpress, Shopee, Amazon, Mercado Livre, Magalu** e mais — o bot responde com a versão **convertida**, pronta para compartilhar. Sem copiar e colar parâmetro, sem link quebrado.
## Desconto de moedas do AliExpress
Para o AliExpress, ele gera o **link de moedas** — aquele desconto que só aparece no app — com uma alternativa para PC:
## Cupons secretos encontrados nos produtos
O diferencial: o bot **encontra cupons secretos** do próprio produto — código, desconto e gasto mínimo — e já avisa no grupo, junto com o link convertido e o desconto de moedas:
O seu público compra com um desconto que **nem sabia que existia** — sempre pelo **seu** link.
## Ofertas prontas, cupons e broadcast
- **Ofertas formatadas** (título, preço, imagem) com um comando ou pelo **[formatador em tempo real](/docs/telegram/formatador-tempo-real/)**.
- **Menu de cupons** com busca por IA para os seus usuários, incluindo os cupons secretos do AliExpress.
- **Broadcast** para avisar todos os seus contatos de uma promoção de uma vez só.
## Comece agora
Crie o seu em minutos: **[Primeiros passos](/docs/comecando/primeiros-passos/)** · **[painel](https://app.botdoafiliado.com/)** · **[preços](/pricing)**.
---
# BLOG: Conexão MCP de afiliado para IA: ligue o seu bot ao ChatGPT e ao Claude
URL: https://botdoafiliado.com/blog/conexao-mcp-de-afiliado-para-ia/
Publicado: 2026-06-04
Descrição: O que é o MCP do Bot do Afiliado e como conectar a sua IA (ChatGPT, Claude, Cursor) para converter links e montar ofertas em linguagem natural — por login ou API key.
O **MCP (Model Context Protocol)** é um padrão aberto que deixa uma IA usar **ferramentas externas**. O Bot do Afiliado expõe um **servidor MCP**, então a sua IA passa a **converter links, buscar produtos e montar ofertas** com o **seu** afiliado — sem você sair da conversa.
## O que a IA passa a fazer
| Ferramenta | O que faz |
|---|---|
| `convert_links` | Converte 1 ou vários links em afiliado |
| `get_product` | Título, preço, imagem e histórico de um produto |
| `create_offer_post` | Post de oferta pronto (com o template do seu bot) |
| `search_products` | Busca produtos (Shopee, Amazon, AliExpress) com filtro de preço e ordenação |
## Como conectar
A URL é a **do seu bot**: `https://app.botdoafiliado.com/mcp/SEU_BOT` (o painel mostra a exata em **API e IA MCP**).
- **ChatGPT e Claude.ai (web/app):** por **login** — adicione um conector remoto com a URL e entre com a sua conta. **Sem API key.**
- **Claude Desktop, Claude Code e Cursor:** com a sua **API key** no header `X-API-Key`.
Passo a passo por cliente: **[Conectar no Claude](/docs/ia/conectar-claude/)** e **[Conectar no ChatGPT](/docs/ia/conectar-chatgpt/)**.
## Seguro
- A conexão por login usa **OAuth** (a mesma conta do portal).
- A **API key** é **revogável** a qualquer momento no painel.
- Comandos administrativos (broadcast, configurações) **não** ficam expostos.
## Depois de conectar
É só pedir naturalmente — **[gerar link](/blog/gerar-link-de-afiliado-na-ia-chatgpt/)**, **[gerar ofertas](/blog/gerar-ofertas-de-afiliado-na-ia/)** ou **[buscar em várias lojas](/blog/mcp-shopee-mercado-livre-amazon-afiliados/)**.
> Requer o **[módulo de API](/docs/planos/modulos/)**. Comece no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Operar um canal de ofertas dentro do ChatGPT ou do Claude (MCP)
URL: https://botdoafiliado.com/blog/canal-de-ofertas-no-chatgpt-claude-mcp/
Publicado: 2026-06-04
Descrição: Conecte o Bot do Afiliado na sua IA e rode o fluxo do seu canal — buscar produto, converter link e montar a oferta — sem sair da conversa do ChatGPT ou do Claude.
E se o seu "painel de ofertas" fosse a própria conversa do **ChatGPT** ou do **Claude**? Com a conexão **MCP** do Bot do Afiliado, dá: você **busca produto, converte link e monta a oferta** em linguagem natural — tudo com a sua atribuição.
## Conecte uma vez
Adicione o conector MCP do seu bot (por **login** no ChatGPT/Claude, ou **API key** no Desktop/Cursor). Passo a passo em **[Conexão MCP de afiliado para IA](/blog/conexao-mcp-de-afiliado-para-ia/)**.
## O fluxo do canal, na conversa
1. **Achar o produto:** *"acha air fryer barata na Shopee"* → a IA busca, com faixa de preço e ordenação.
2. **Converter:** *"converte esse link pra afiliado"* → link final com a sua tag.
3. **Montar a oferta:** *"monta um post de oferta desse produto, com o cupom X"* → texto pronto, no template do seu bot:
4. **Publicar:** você copia e posta no seu canal. *(Por segurança, a publicação automática segue no painel/bot.)*
## Por que é bom
- **Zero troca de ferramenta:** pesquisa, conversão e copy no mesmo lugar.
- **Multi-loja:** Shopee, Amazon, AliExpress, Mercado Livre e mais — veja **[MCP da Shopee, ML e Amazon](/blog/mcp-shopee-mercado-livre-amazon-afiliados/)**.
> Requer o **[módulo de API](/docs/planos/modulos/)**. Veja **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)** e comece no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Como usar o ChatGPT e o Claude para gerenciar seu canal de achadinhos
URL: https://botdoafiliado.com/blog/chatgpt-claude-gerenciar-canal-de-achadinhos/
Publicado: 2026-06-04
Descrição: Pesquise produto, converta link e monte a oferta dando comandos em linguagem natural para a IA — a forma mais nova (e rápida) de tocar um canal de achadinhos no Brasil.
Tocar um canal de **achadinhos** é repetição: achar produto bom, converter, formatar, postar. E se você desse esses comandos em **português, para uma IA**, e ela fizesse o trabalho? Com o servidor **MCP** do Bot do Afiliado, dá — dentro do **ChatGPT** ou do **Claude**.
## A IA vira o seu painel
Depois de conectar (uma vez), você conversa:
- *"acha air fryer barata na Shopee"* → ela **busca** com preço e ordenação.
- *"converte esse link pra afiliado"* → **link final** com a sua tag.
- *"monta um post de oferta desse produto com o cupom X"* → **texto pronto**, no seu template.
Não precisa dizer "use o MCP" nem citar ferramenta — a IA entende o pedido e age sozinha.
## A rotina de um canal de achadinhos, na conversa
1. **Garimpa:** peça achados por nicho e faixa de preço (*"achadinhos de cozinha até R$50"*).
2. **Converte em lote:** mande uma lista de links e receba todos convertidos.
3. **Empacota:** transforme o melhor num post pronto e copie para o canal.
É uma forma **inovadora** de operar — e ainda rara no mercado nacional.
## Comece
- Conectar: **[Conexão MCP de afiliado para IA](/blog/conexao-mcp-de-afiliado-para-ia/)**.
- O fluxo completo: **[operar um canal de ofertas no ChatGPT/Claude](/blog/canal-de-ofertas-no-chatgpt-claude-mcp/)**.
- Multi-loja: **[MCP da Shopee, ML e Amazon](/blog/mcp-shopee-mercado-livre-amazon-afiliados/)**.
> Requer o **[módulo de API](/docs/planos/modulos/)** · comece no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Como converter todos os links do seu site para o seu link de afiliado
URL: https://botdoafiliado.com/blog/converter-todos-os-links-do-site/
Publicado: 2026-06-04
Descrição: Cole um único script no seu site e todos os links de loja (AliExpress, Amazon, Shopee, Mercado Livre…) viram links de afiliado seus — automaticamente, sem backend e sem expor sua API key.
Você tem um blog ou site cheio de links de produtos. Colocar a **sua tag de afiliado** em cada link na mão é inviável — e todo link sem afiliado é **comissão perdida**. Dá para resolver isso com um **script** que converte tudo sozinho, direto no navegador do visitante.
## Um script, todos os links
Com o **Script do site (Embed)** do Bot do Afiliado, você gera uma chave, cola **uma** tag `
```
3. Pronto. Para **não** converter um link específico, adicione o atributo `data-no-affiliate` na tag ``.
## Funciona em WordPress, Wix, Blogger e afins
Serve para **qualquer site** onde você consiga colar um script no `` — no WordPress, por um plugin de "header/footer scripts" ou pelo tema; no Wix/Blogger, pela área de código personalizado.
## Prefere chamar a API?
A partir de um **domínio autorizado**, dá para chamar `POST /embed/v1/convert-links` direto e receber cada link convertido. Os detalhes técnicos (snippet sempre visível, revogação, edição de domínios) estão em **[Script do site](/docs/api/script-do-site/)**.
## E os links que você posta fora do site?
O script cuida do **seu site**. Para os links que você compartilha **fora** dele — no Telegram, em grupos ou nas redes sociais — use o **[bot do Telegram](/docs/telegram/conversao-automatica/)**: cole o link e ele volta convertido, com a **sua** tag. É a mesma engine e os mesmos afiliados, em qualquer lugar.
> Comece agora no **[painel](https://app.botdoafiliado.com/)** e veja os módulos em **[/pricing](/pricing)**.
---
# BLOG: Cupom no piloto automático: extração por IA e reativação de expirados
URL: https://botdoafiliado.com/blog/cupom-no-piloto-automatico-ia/
Publicado: 2026-06-04
Descrição: Cadastre cupons colando o texto do post (a IA extrai tudo) e mantenha o menu sempre vivo reativando cupons expirados com um clique. Menos trabalho, mais conversão.
Cupom dá trabalho: cadastrar um a um e ainda lembrar de tirar os vencidos. O módulo de **Cupons** automatiza as duas pontas — **cadastro por IA** e **reativação de expirados**.
## Cadastro por IA (cole o texto do post)
Em **Cupons → IA Extrator**, **cole o texto** de um post de oferta (do jeito que veio) e a IA extrai sozinha **categoria, código, regras e link**, preenchendo o formulário para você só revisar e salvar:
É o jeito mais rápido de transformar mensagens de grupos e canais em cupons organizados.
## Reativação de expirados
Cupom venceu? Ele não some: vai para a aba **Expirados** (cupons com validade vencida, **mantidos para reativação**). Quando a promoção volta, você **reativa** — o cupom fica vigente de novo, **sem recadastrar**.
## Menu de cupons (e cupons secretos)
Seus usuários abrem um **menu de cupons** com busca por IA (por código, descrição ou link). E no AliExpress, o bot ainda traz **cupons secretos** do produto. Veja **[Cupons](/docs/telegram/cupons/)** e **[moedas + cupom secreto](/docs/telegram/aliexpress-moedas-cupom/)**.
> Ative o módulo em **[módulos e preços](/docs/planos/modulos/)** · comece no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Como gerar link de afiliado na IA (ChatGPT, Claude e outros)
URL: https://botdoafiliado.com/blog/gerar-link-de-afiliado-na-ia-chatgpt/
Publicado: 2026-06-04
Descrição: Conecte o Bot do Afiliado na sua IA e converta qualquer link em afiliado só pedindo — 1 link ou uma lista inteira, dentro do ChatGPT, Claude ou Cursor.
Já pensou em colar um link no **ChatGPT** (ou no **Claude**) e ele te devolver na hora a versão **com o seu afiliado**? Dá — com a conexão **MCP** do Bot do Afiliado. Você conecta uma vez e, depois, é só pedir em linguagem natural.
## Conecte a sua IA (uma vez)
No Claude.ai e no ChatGPT a conexão é por **login** (sem API key); no Claude Desktop, Claude Code e Cursor, com a sua **API key**. O passo a passo está em **[Conexão MCP de afiliado para IA](/blog/conexao-mcp-de-afiliado-para-ia/)**.
## Peça para converter
Depois de conectado, fale naturalmente — **não precisa dizer "use o MCP"**:
> Converta este link em afiliado: `https://www.aliexpress.com/item/100500...html`
A IA reconhece o pedido, chama a ferramenta `convert_links` e devolve o **link final** já com a sua atribuição.
## Converta uma lista inteira
> Converta estes links e me devolve a lista final:
> - `https://www.amazon.com.br/dp/...`
> - `https://shopee.com.br/...`
> - `https://mercadolivre.com.br/...`
Dá para converter **até 150 links por vez**, e funciona com qualquer loja que você tenha configurado (AliExpress, Amazon, Shopee, Mercado Livre, Magalu…).
> 💡 Divulgue sempre o **link final** que a IA retorna — é a versão com a sua atribuição e o encurtamento do bot.
## Próximos passos
- **[Conexão MCP de afiliado para IA](/blog/conexao-mcp-de-afiliado-para-ia/)** (como conectar)
- **[Como gerar ofertas de afiliado na IA](/blog/gerar-ofertas-de-afiliado-na-ia/)**
- Docs: **[o que é o MCP](/docs/ia/o-que-e-mcp/)** · **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)**
> Precisa do **[módulo de API](/docs/planos/modulos/)** (gera as chaves usadas pela conexão). Comece no **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: Adeus links feios: como formatar posts de ofertas profissionais para o Telegram
URL: https://botdoafiliado.com/blog/formatar-posts-de-ofertas-profissionais-telegram/
Publicado: 2026-06-04
Descrição: Link curto e limpo, grade de imagens e rodapé dinâmico por marketplace: o que separa um post amador de um profissional — e como isso aumenta o CTR.
Post amador afasta clique: link gigante e feio, sem foto, sem identidade. Post profissional faz o contrário — e converte mais. Veja o que muda (e como o bot resolve cada ponto).
## 1) Link curto, não link feio
Um `https://s.click.aliexpress.com/e/_Abc123...` enorme grita "amador" e some no meio do texto. O bot **encurta** com a sua marca (ex.: `ofertou.ai/xxx`) e injeta a sua atribuição — link limpo, clicável e rastreável.
## 2) Grade de imagens (não um textão)
Imagem vende. O bot compõe de **1 a 6 fotos** de produto numa **única imagem** (grade), com fundo configurável — o post para o scroll:
## 3) Rodapé dinâmico por marketplace
Um **rodapé** com a sua marca + CTA fecha o post. E dá para ter um **rodapé diferente por marketplace** (escolhido pelo 1º link da oferta) — ex.: avisar "desconto de moedas só no app" apenas nas ofertas de AliExpress. Sem rodapé específico, usa o global.
## 4) CTA claro
"Compre aqui 👇", "Corre que acaba" — um CTA direto aumenta o clique. Coloque no corpo ou no rodapé.
## Como montar
Tudo isso vive na aba **Customizar** (templates + variáveis). O passo a passo visual está em **[criar seu primeiro template de oferta](/blog/criar-primeiro-template-de-oferta/)**, e o detalhe de cada peça em **[posts de oferta que convertem](/blog/posts-de-oferta-que-convertem/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Criando seu primeiro template de oferta: variáveis, CTAs e imagens
URL: https://botdoafiliado.com/blog/criar-primeiro-template-de-oferta/
Publicado: 2026-06-04
Descrição: Guia visual para montar no painel um layout de oferta que converte — usando variáveis, um CTA forte, grade de imagens e a prévia com links reais antes de postar.
Um bom template deixa toda oferta com a sua cara — e converte mais. Veja como montar o seu no painel, do zero.
## 1) Abra Customizar e escolha o tipo
Na aba **Customizar**, escolha o **tipo de post**: **oferta**, **cupom** ou **rodapé**; e **1 produto** ou **lista**. Cada tipo tem o seu template.
## 2) Use as variáveis (chips clicáveis)
Insira **variáveis** que o bot troca pelos dados reais: `{titulo}`, `{preco}`, `{link}`, `{cupom}` e mais. A lista completa (`{nome}`, `{linkgerado}`, `{mensagemextra}`…) está em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
> Exemplo simples:
> `🔥 {titulo}`
> `💰 {preco}`
> `🛒 {link}`
## 3) Coloque um CTA
Um **CTA** (chamada para ação) aumenta o clique: *"Compre aqui 👇"*, *"Corre que acaba!"*, *"Use o cupom no carrinho"*. Coloque-o no corpo ou no **rodapé** — e lembre que dá para ter um **rodapé diferente por marketplace** (escolhido pelo 1º link da oferta).
## 4) Grade de imagens (1 a 6 produtos)
Para posts de lista, o bot compõe de **1 a 6 imagens** de produto numa **única imagem** (grade), deixando o post mais atraente:
## 5) Veja a prévia com links reais
Antes de usar, cole um link de verdade na **Prévia com links reais** e veja a oferta **renderizada**, do jeito que sai no Telegram:
Salve e pronto. Para montar ofertas no dia a dia com prévia ao vivo, use o **[formatador de ofertas em tempo real](/docs/telegram/formatador-tempo-real/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Como criar um canal de ofertas no Telegram e vender no piloto automático em 2026
URL: https://botdoafiliado.com/blog/criar-canal-de-ofertas-no-telegram-piloto-automatico-2026/
Publicado: 2026-06-04
Descrição: O passo a passo para montar um canal de achadinhos que converte: estrutura, como atrair membros e como tirar o trabalho manual de gerar links do caminho — no piloto automático.
Canal de ofertas (ou "achadinhos") é um dos jeitos mais diretos de ganhar com afiliados: você divulga produtos, as pessoas compram pelo **seu** link, você recebe comissão. O segredo de quem escala é **não fazer no manual**. Veja como montar o seu em 2026 — e rodar no piloto automático.
## 1) Monte a estrutura
- **Nicho claro:** "achadinhos de cozinha", "tech em promoção", "moda feminina"… nicho atrai público mais quente.
- **Identidade:** nome, foto e uma **mensagem fixa** explicando o que o canal entrega.
- **Cadência:** poste com regularidade (algumas ofertas boas por dia batem muitas ofertas ruins).
## 2) Atraia membros
- Divulgue o link do canal nas suas redes e em grupos do nicho.
- Use **cupons exclusivos** e "achados do dia" como isca de entrada.
- Peça compartilhamento — oferta boa as pessoas repassam.
## 3) O gargalo: gerar link na mão
Aqui quase todo mundo trava. Pegar o produto, achar o programa de afiliado certo, gerar o link, encurtar, formatar o post… repetir dezenas de vezes por dia. É aí que você perde tempo (e link sem afiliado = comissão perdida).
## 4) Piloto automático com o Bot do Afiliado
O bot faz o trabalho pesado:
- **Conversão automática:** mande um link de qualquer loja e ele volta com o seu afiliado, sem comando. → **[como funciona](/blog/transformar-links-em-afiliado-no-telegram/)**
- **Ofertas formatadas:** título, preço, imagem e CTA prontos, com o seu template. → **[Ofertas](/docs/telegram/ofertas/)** e o **[formatador em tempo real](/docs/telegram/formatador-tempo-real/)**
- **Cupons com IA** e **broadcast** para avisar todo mundo de uma promoção de uma vez.
## Comece em minutos
Crie o bot, conecte e ative a sua primeira loja: **[Primeiros passos](/docs/comecando/primeiros-passos/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · veja os módulos em **[/pricing](/pricing)**.
---
# BLOG: Como gerar ofertas de afiliado na IA (ChatGPT, Claude e outros)
URL: https://botdoafiliado.com/blog/gerar-ofertas-de-afiliado-na-ia/
Publicado: 2026-06-04
Descrição: Peça para a sua IA montar um post de oferta pronto — título, preço, cupom e link de afiliado — usando o template do seu bot, dentro do ChatGPT ou do Claude.
Converter link é só o começo. Com a conexão **MCP** do Bot do Afiliado, a sua **IA monta a oferta pronta pra postar** — com título, preço, cupom e o seu link — usando o **template do seu bot**.
## Conecte a sua IA
Conecte o ChatGPT, o Claude ou o Cursor (por login ou API key). Veja como em **[Conexão MCP de afiliado para IA](/blog/conexao-mcp-de-afiliado-para-ia/)**.
## Peça a oferta
> Monte um post de oferta deste produto: `https://...`
> Monte um post de oferta com o cupom `MEUCUPOM`: `https://...`
A IA chama `create_offer_post`, aplica o **template de oferta do seu bot** (o mesmo do `/oferta`) e devolve o **texto pronto** — você revisa e publica:
## Busque e já monte
Como a IA também **busca produtos**, dá para emendar tudo num pedido só:
> Acha uma air fryer barata na Shopee e monta um post de oferta da melhor.
Ela busca (`search_products`), escolhe e monta a oferta — na mesma conversa.
> Por segurança, a **publicação em canais** continua no painel/bot. Pela IA você gera o texto e os links; você decide onde postar.
## Próximos passos
- **[Como gerar link de afiliado na IA](/blog/gerar-link-de-afiliado-na-ia-chatgpt/)**
- **[MCP da Shopee, Mercado Livre e Amazon](/blog/mcp-shopee-mercado-livre-amazon-afiliados/)**
- Docs: **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)** · **[Ofertas](/docs/telegram/ofertas/)**
---
# BLOG: Passo a passo: integrar a Shopee e o AliExpress no seu bot de Telegram
URL: https://botdoafiliado.com/blog/integrar-shopee-e-aliexpress-no-bot-telegram/
Publicado: 2026-06-04
Descrição: Tutorial visual para ativar a Shopee e o AliExpress no Bot do Afiliado — onde pegar as credenciais, onde colar e como as rotas dos domínios são criadas automaticamente.
Com a Shopee e o AliExpress conectados, o bot já converte os links dessas lojas automaticamente. Veja o passo a passo — leva poucos minutos por loja.
## Onde tudo acontece: a aba Plugins
No painel, abra a aba **Plugins**: é o catálogo de integrações. Você escolhe a loja, cola as credenciais e **valida** — ao salvar, as **rotas** dos domínios daquela loja são **criadas automaticamente** (você não cadastra domínio por domínio).
## Shopee
1. Na **[Open API da Shopee Afiliados](https://affiliate.shopee.com.br/open_api)**, copie o **appId** e o **secret**:
2. Em **Plugins → Shopee**, cole `appId` e `secret`, informe o tracking ID e clique em **Validar** e **Salvar**:
Guia completo: **[Shopee](/docs/integracoes/shopee/)**.
## AliExpress
1. No **[AliExpress Open Service](https://openservice.aliexpress.com/)**, faça o login, abra o **App Console** e crie um app:
2. Copie o **appKey** e o **appSecret** do app:
3. Em **Plugins → AliExpress**, cole `appKey`/`appSecret`, informe o **tracking ID (PID)** e **valide**:
Guia completo: **[AliExpress](/docs/integracoes/aliexpress/)** (e o **[desconto de moedas + cupom secreto](/docs/telegram/aliexpress-moedas-cupom/)**).
## Pronto
Com as duas ativas, é só **enviar um link** da Shopee ou do AliExpress no Telegram que o bot devolve convertido. Fluxo genérico de qualquer plugin: **[ativar um plugin](/docs/integracoes/ativar-plugin/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Grupos de Cupom no Telegram: como evitar bloqueios e engajar a comunidade
URL: https://botdoafiliado.com/blog/grupos-de-cupom-no-telegram-evitar-bloqueios/
Publicado: 2026-06-04
Descrição: Boas práticas de postagem e frequência para não cair em spam — e como o broadcast por fila do bot publica em escala sem queimar a sua conta.
Grupo e canal de cupom crescem rápido — e quebram rápido também, se você for marcado como spam. A boa notícia: dá para postar em escala **sem queimar a conta**, com algumas práticas e as ferramentas certas.
## Por que contas são bloqueadas
- **Volume alto e súbito** de mensagens em pouco tempo.
- **Mesma mensagem** repetida para muitos destinos de uma vez, sem ritmo.
- **Links suspeitos** ou encurtadores "queimados".
- Muitos usuários **denunciando** ou bloqueando seguidos.
## Boas práticas
- **Ritmo, não rajada:** distribua os envios ao longo do tempo em vez de disparar tudo junto.
- **Qualidade > quantidade:** poucas ofertas boas engajam mais e geram menos denúncia.
- **Personalize:** use **[variáveis](/docs/telegram/mensagens-e-variaveis/)** (ex.: `{nome}`) para a mensagem não parecer robô.
- **Respeite a whitelist:** deixe passar redes sociais e os seus próprios links sem reescrever — veja **[whitelist](/docs/telegram/whitelist/)**.
## Broadcast por fila: escala sem queimar a conta
O módulo de **Broadcast** do bot não dispara tudo de uma vez: ele roda em **fila, em lotes**, respeitando os **limites do Telegram** (com novas tentativas). Quem bloqueou o bot é desativado automaticamente, sem travar o resto — e você acompanha enviados, falhas e cancelados.
Para o **menu de cupons** com busca por IA (e cupons secretos do AliExpress), veja **[Cupons](/docs/telegram/cupons/)**. Detalhes do envio em massa: **[Broadcast](/docs/telegram/broadcast/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Guia de afiliação por marketplace: AliExpress, Shopee, Amazon, Mercado Livre, Magalu e redes
URL: https://botdoafiliado.com/blog/guia-de-afiliacao-por-marketplace/
Publicado: 2026-06-04
Descrição: Como virar afiliado e gerar links em cada loja — AliExpress (moedas), Shopee, Amazon (Creators/PA-API), Mercado Livre, Magalu — e nas redes Awin, Rakuten e CityAds, com o guia de cada uma.
Cada loja tem o seu jeito de afiliar — credencial, link e regras diferentes. Este é o **mapa rápido**: o que cada marketplace pede e onde está o guia completo. Depois de configurado, o Bot do Afiliado **converte tudo** automaticamente.
## Marketplaces
- **AliExpress** — `appKey`/`appSecret` + tracking ID (PID). Gera o **link de moedas** (desconto do app) e acha **cupons secretos**. → **[guia AliExpress](/docs/integracoes/aliexpress/)** · **[moedas + cupom secreto](/docs/telegram/aliexpress-moedas-cupom/)**
- **Shopee** — `appId`/`secret` da Open API. → **[guia Shopee](/docs/integracoes/shopee/)**
- **Amazon** — `partnerTag` + **Creators API** (não exige vendas para liberar) ou **PA-API** (exige vendas). → **[Creators](/docs/integracoes/amazon-creators/)** · **[PA-API](/docs/integracoes/amazon-paapi/)**
- **Mercado Livre** — sua **tag** + **cookie** de sessão. → **[guia Mercado Livre](/docs/integracoes/mercado-livre/)**
- **Magalu** — cole um **link de afiliado seu** e o painel detecta o promoter ID. → **[guia Magalu](/docs/integracoes/magalu/)**
## Redes (uma conta, várias lojas)
- **Awin** — `publisherId` + token; cobre centenas de lojas, `advertiserId` por rota. → **[guia Awin](/docs/integracoes/awin/)**
- **Rakuten** — token (ou clientId/secret/scope) + `advertiserId`. → **[guia Rakuten](/docs/integracoes/rakuten/)**
- **CityAds** — `clientId`/`clientSecret`/`remoteAuth`; importa lojas BR e gera deeplinks. → **[guia CityAds](/docs/integracoes/cityads/)**
## Como ativar (genérico)
Na aba **Plugins**, escolha a loja/rede, cole as credenciais e **valide** — as rotas dos domínios são criadas sozinhas. Passo a passo: **[ativar um plugin](/docs/integracoes/ativar-plugin/)**.
> Não sabe por onde começar? **[Primeiros passos](/docs/comecando/primeiros-passos/)** · **[painel](https://app.botdoafiliado.com/)**.
---
# BLOG: MCP da Shopee, Mercado Livre e Amazon para afiliados
URL: https://botdoafiliado.com/blog/mcp-shopee-mercado-livre-amazon-afiliados/
Publicado: 2026-06-04
Descrição: Uma conexão, todas as lojas: pela IA, busque produtos na Shopee, Amazon e AliExpress e converta links da Shopee, Mercado Livre, Amazon e mais — tudo com o seu afiliado.
Você não precisa de uma ferramenta para cada loja. Com a conexão **MCP** do Bot do Afiliado, a sua **IA** trabalha com **várias lojas de uma vez** — buscar, converter e montar oferta — sempre com a **sua** atribuição.
## Buscar em várias lojas
Peça uma busca e, **se você não disser a loja**, a IA procura em **todos** os marketplaces ativos e **junta os resultados** (cada item mostra de qual loja é):
> Acha air fryer até R$300, da mais barata pra mais cara.
Ou foque numa loja:
> Me mostra fones na **Shopee** entre R$50 e R$150.
A busca (`search_products`) cobre **Shopee, Amazon e AliExpress**, com **faixa de preço** e **ordenação**. Cada produto vem com **imagem**, **preço** e o **link de afiliado** pronto.
## Converter links de qualquer loja
Para **converter** e **pegar dados de produto**, vale tudo que você tem configurado — **Shopee, Mercado Livre, Amazon, AliExpress, Magalu** e mais:
> Converte este link do Mercado Livre: `https://...`
> Qual o preço deste produto da Amazon? `https://...`
## Uma conexão só
Você conecta a IA **uma vez** (veja **[Conexão MCP de afiliado para IA](/blog/conexao-mcp-de-afiliado-para-ia/)**) e ela usa **todas as lojas** que você ativou no painel — sem trocar de ferramenta e sem copiar parâmetro.
## Próximos passos
- **[Gerar link de afiliado na IA](/blog/gerar-link-de-afiliado-na-ia-chatgpt/)**
- **[Gerar ofertas de afiliado na IA](/blog/gerar-ofertas-de-afiliado-na-ia/)**
- Docs: **[o que é o MCP](/docs/ia/o-que-e-mcp/)** · **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)**
---
# BLOG: Posts de oferta que convertem: templates, variáveis, rodapé por marketplace e CTA
URL: https://botdoafiliado.com/blog/posts-de-oferta-que-convertem/
Publicado: 2026-06-04
Descrição: Padronize as suas ofertas com templates e variáveis, um rodapé diferente por marketplace e um CTA que chama a ação — e veja a prévia com links reais antes de postar.
Um post de oferta que converte tem **padrão**: título e preço claros, link certo, um **rodapé** com a sua marca e um **CTA**. No Bot do Afiliado isso é configurável — e a prévia mostra o resultado antes de você postar.
## Templates e variáveis
Na aba **Customizar**, você edita o **formato** de cada tipo de post (oferta, cupom, rodapé; 1 produto ou lista) com **variáveis** como `{titulo}`, `{preco}`, `{link}` e `{cupom}` — chips clicáveis para inserir:
A referência completa das variáveis (`{nome}`, `{linkgerado}`, `{mensagemextra}`…) está em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
## Rodapé por marketplace
Dá para ter um **rodapé diferente por marketplace**, escolhido pelo **1º link** da oferta — útil para avisos específicos (ex.: "desconto de moedas só no app" no AliExpress). Sem rodapé específico, ele usa o **rodapé global**.
## CTA e prévia com links reais
Coloque um **CTA** no template ("Compre aqui 👇", "Corre que acaba") e teste com um link de verdade na **Prévia com links reais** — a oferta aparece **renderizada**, do jeito que sai no Telegram:
## Monte rápido
Para montar a oferta colando links/preços/cupons com prévia ao vivo, use o **[formatador de ofertas em tempo real](/docs/telegram/formatador-tempo-real/)**. Comandos: **[Ofertas](/docs/telegram/ofertas/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Programas de Afiliados: Shopee, AliExpress, Amazon ou Magalu? Qual paga mais?
URL: https://botdoafiliado.com/blog/programas-de-afiliados-qual-paga-mais/
Publicado: 2026-06-04
Descrição: Como funcionam as comissões de cada marketplace — e por que a melhor estratégia não é escolher um, mas converter links de todos automaticamente com o mesmo bot.
"Qual programa de afiliados paga mais?" é a pergunta mais comum de quem começa. A resposta honesta: **depende** — e talvez você não precise escolher.
## Por que "depende"
A comissão **não é um número fixo**. Em todos os marketplaces ela varia por:
- **Categoria** do produto (eletrônicos costumam pagar menos que moda/casa, por exemplo);
- **Campanha** vigente (datas como Black Friday mudam as taxas);
- **Cookie / janela de atribuição** (quanto tempo depois do clique a venda ainda conta);
- **Regras do programa** (produtos elegíveis, teto de comissão, etc.).
Ou seja: tabelas de "X% fixo" envelhecem rápido. O que vale é entender **como cada um funciona** e medir no seu próprio público.
## Como cada um funciona (resumo)
- **AliExpress** — comissão por categoria; o diferencial é o **desconto de moedas** e os **cupons secretos**, que aumentam a conversão. → **[guia](/docs/integracoes/aliexpress/)**
- **Shopee** — programa forte no Brasil, com campanhas frequentes e foco em volume. → **[guia](/docs/integracoes/shopee/)**
- **Amazon** — comissão por categoria; ótimo ticket e confiança da marca. → **[guia](/docs/integracoes/amazon-paapi/)**
- **Magalu (Parceiro Magalu)** — bom para público nacional e itens do dia a dia. → **[guia](/docs/integracoes/magalu/)**
E ainda há as **redes** (Awin, Rakuten, CityAds), que cobrem **centenas de lojas** com uma conta só.
## A real: você não precisa escolher
Com o Bot do Afiliado, o sistema é **multi-loja**: você conecta **todos** os programas que tiver e o bot converte cada link **automaticamente** pela rota certa — as rotas dos domínios são criadas sozinhas ao ativar o plugin. Assim você divulga o que aparecer de bom, sem se prender a um único marketplace.
Veja o **[guia de afiliação por marketplace](/blog/guia-de-afiliacao-por-marketplace/)** com o passo a passo de cada um.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Como transformar links em links de afiliado automaticamente no Telegram
URL: https://botdoafiliado.com/blog/transformar-links-em-afiliado-no-telegram/
Publicado: 2026-06-04
Descrição: Cole um link de qualquer loja no Telegram e o bot devolve a versão com o seu afiliado — sozinho, sem comando. Veja como funciona a conversão automática.
O jeito mais rápido de ganhar comissão é **não perder link**. Com o Bot do Afiliado, você (ou o seu público) **manda um link** no Telegram e ele volta **convertido**, com a sua tag — automaticamente, sem digitar comando.
## Como funciona
1. Você **envia um link** de loja (AliExpress, Shopee, Amazon, Mercado Livre, Magalu…) no chat do bot ou no grupo.
2. O bot **resolve** redirecionamentos e encurtadores até a URL real.
3. Acha a **rota/loja** certa, gera o **link de afiliado** e (quando dá) já traz **título, preço e imagem**.
Não precisa de comando: **só mandar o link já converte**. Em grupos, com o módulo de Grupos ativo, o bot ainda **substitui** links não convertidos pela sua versão de afiliado.
## Vários links de uma vez
Mande **vários links na mesma mensagem** — o bot processa em paralelo, remove duplicados e devolve cada um convertido, preservando o seu texto.
## E os links que NÃO devem ser convertidos?
Use a **[whitelist](/docs/telegram/whitelist/)** para deixar passar redes sociais e os seus próprios canais sem reescrever.
## Comece
- Crie o bot e conecte: **[Primeiros passos](/docs/comecando/primeiros-passos/)**.
- Entenda o motor: **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.
- Prefere a IA? **[Gerar link de afiliado no ChatGPT/Claude](/blog/gerar-link-de-afiliado-na-ia-chatgpt/)**.
> Comece no **[painel](https://app.botdoafiliado.com/)** · módulos em **[/pricing](/pricing)**.
---
# BLOG: Como converter links de afiliado no Telegram automaticamente
URL: https://botdoafiliado.com/blog/como-converter-links-no-telegram/
Publicado: 2026-05-16
Descrição: Envie um link e o Bot do Afiliado já devolve convertido. Veja também quando faz sentido usar /converter e /oferta.
Se você divulga produtos no Telegram, o gargalo quase sempre é o mesmo: link quebrado, link sem afiliado, ou cada mensagem vira um “processo manual”. O **Bot do Afiliado** resolve isso automatizando a conversão de links e padronizando o envio para seus inscritos.
## O básico: o que o bot faz
- Você envia um link (AliExpress, Shopee, Amazon, Mercado Livre, etc.) no chat do bot.
- Só de enviar o link, o bot já responde com o link convertido (com afiliado) e pronto para compartilhar.
- Você mantém consistência no formato e reduz erros na rotina.
## Quando usar /converter
Use o `/converter` quando você quer **converter uma postagem de outro canal** para o **formato de postagem do seu canal**, mantendo consistência visual.
Casos comuns:
- Você vê uma oferta em outro canal e quer “puxar” para o seu formato.
- Você quer reaproveitar uma postagem pronta, mas com o seu link de afiliado e a sua identidade.
## Quando usar /oferta (módulo de Ofertas)
Use o `/oferta` quando você quer **montar a oferta do zero**: o bot extrai dados do produto (ex.: título/preço/imagem quando disponível) e gera a mensagem no formato da sua postagem.
Um fluxo típico:
1. Você cola o link do produto.
2. Você usa `/oferta`.
3. O bot extrai os dados e devolve a oferta pronta para publicar (já com o seu link convertido).
## Próximo passo
Se você ainda não tem seu bot ativo, crie o seu e comece pelo plano base:
- Ir para o painel: [app.botdoafiliado.com](https://app.botdoafiliado.com/)
- Ver módulos e preços: [/pricing](/pricing)