# 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/*` (referência em `/docs/api/referencia/`, contrato em `/api/openapi.json`).
- 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/`, `/modulos/<módulo>/`, `/combos/<combo>/`, `/docs/`, `/plugins/`, `/sites`, `/blog/`, `/sitemap.xml`, `/robots.txt`.
- API pública (OpenAPI): `/api/v1/convert-links`, `/api/v1/execute`, `/api/v1/product`, `/api/v1/product/history`.
- Docs da API pública: `/docs/api/referencia/` (UI) e `/api/openapi.json` (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-links`: converte uma URL ou um lote de até 150. Retorna `affiliate_url` e `final_url`; no lote, confira o campo `ok` de cada item. `/convert` é a rota unitária legada.
- `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: `/docs/`, `/pricing/`, `/plugins/`, `/sites`, `/docs/api/referencia/`.
- 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 `/docs/api/referencia/` e `/api/openapi.json`.
- 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 (módulos, combos, docs, comparativos e blog)

---

# MÓDULO: Plano base
URL: https://botdoafiliado.com/modulos/plano-base/
Preço: R$ 99/mês
Descrição: Conversor de links de afiliado com as suas contas de Shopee, Amazon, Mercado Livre e AliExpress: pelo bot, pelo painel ou em planilha, com moedas no app.

O conversor de links de afiliado do Bot do Afiliado é o plano base para quem divulga produtos e quer gerar links com suas próprias contas, pelo bot, pelo painel ou em planilha. Inclui moedas do AliExpress, conversão em planilha, Página de chat e Vitrine.

- Link enviado, link convertido: Cole até 20 links em uma mensagem no privado do bot. Ele usa os plugins e as rotas configurados para devolver seus links de afiliado.
- Moedas do AliExpress: Gere o link de moedas de um produto para abrir no app, acompanhado do link normal para PC ou navegador. O desconto depende da disponibilidade no AliExpress.
- Planilhas com links convertidos: Em Gerar link, processe até 200 links por lote, colados ou importados de CSV e Excel. Copie os resultados ou baixe a planilha convertida.
- Seu link no lugar do link do membro: No grupo, o bot responde com o seu link de afiliado e apaga a mensagem original. Convite de outro grupo e link sem rota também saem, a não ser que estejam na Lista liberada.
- Seu bot em outras conversas: Use o modo inline: digite @seubot seguido de um link em outra conversa do Telegram e escolha o resultado convertido.
- Chat no seu site: A Página de chat recebe links pelo navegador e responde com seus afiliados. Personalize a identidade e incorpore a página como bolha ou iframe.
- Vitrine para divulgar produtos: Cadastre ofertas pelo painel e reúna foto, preço e link em uma página pública para usar na bio. Os itens podem ter data de expiração.

1. Entre e assine o base: Acesse o painel pela Central do Afiliado. Em Conta › Plano e módulos, o dono da organização contrata o plano base.
2. Conecte seu bot do Telegram: Crie o bot no BotFather e conecte o token pelo painel. Em Configuração › Configurações do bot, confira a conexão.
3. Cadastre suas contas de afiliado: Em Configuração › Plugins, informe as credenciais das lojas e valide a integração. Confira as rotas criadas em Configuração › Rotas.
4. Faça a primeira conversão: Envie um link de uma loja configurada ao privado do bot ou use Promoções › Gerar link. Confira o produto e o endereço devolvidos antes de divulgar.

## Como o conversor de links de afiliado usa suas contas?

O plano base reúne a conversão no seu próprio bot do Telegram. Você conecta as contas de afiliado e o sistema usa essas configurações quando alguém envia um link. No privado, basta colar a URL: o bot identifica o destino, procura uma rota ativa para aquela loja e devolve o resultado com o seu identificador de afiliado.

Esse fluxo atende quem recebe sugestões de produtos, prepara uma lista para divulgar ou deixa os membros consultarem links pelo bot. O nome e as mensagens podem seguir sua marca. O [guia de conversão automática](/docs/telegram/conversao-automatica/) detalha o uso no Telegram; para transformar o resultado em uma publicação com foto e preço, há o [módulo Ofertas](/modulos/ofertas/).

## Quais lojas podem ter seus links convertidos?

Shopee, AliExpress, Amazon, Mercado Livre e Magalu estão entre as integrações disponíveis. Também há plugins para outras lojas e para as redes Awin, Rakuten e CityAds. Nas redes, a operação depende dos programas em que você foi aprovado e das rotas importadas para o bot. O [catálogo de plugins](/plugins/) explica o que cada integração pede.

Uma URL de loja desconhecida não vira link de afiliado só por ser enviada ao bot. É preciso ter uma rota correspondente. Programas que permitem atribuição por parâmetro podem usar uma rota personalizada; os demais dependem da integração adequada. A documentação de [loja não mapeada](/docs/integracoes/loja-nao-mapeada/) ajuda a distinguir falta de configuração de uma loja ainda sem suporte.

## O que muda nos links de moedas do AliExpress?

Com o plugin do AliExpress configurado, um link de produto pode gerar o acesso à página de moedas no app. A resposta também inclui o link normal para abrir no computador ou navegador. Assim, quem recebe a mensagem tem os dois caminhos, sem precisar pedir outra conversão.

O desconto depende das condições do AliExpress e da disponibilidade do produto nessa área. Não há um percentual fixo prometido pelo bot. Além do link de moedas, comandos como `/promo`, `/addcarrinho` e `/pesquisar` oferecem os caminhos específicos do AliExpress descritos no [guia de comandos](/docs/telegram/comandos/). Quando a conversão não funciona, o retorno deve ser conferido antes de divulgar o produto.

## Como trabalhar com listas maiores e com o próprio site?

O privado aceita até 20 links em uma mensagem. Para uma lista maior, a tela **Promoções › Gerar link** recebe até 200 por lote e aceita arquivos CSV, XLSX e XLS. O painel extrai as URLs, mostra o resultado de cada conversão e permite baixar a planilha com os links substituídos. Isso atende, por exemplo, a seleção de produtos que você já organiza em uma planilha.

A Página de chat oferece a conversão a visitantes pelo navegador. Ela pode ser incorporada ao site como bolha ou iframe e aceita subdomínio próprio. A Vitrine tem outro papel: reunir ofertas cadastradas por você numa página pública para compartilhar na bio. Ambas fazem parte do base; são alternativas para quem quer divulgar e receber links fora de uma conversa do Telegram.

## Quando faz sentido acrescentar outros módulos?

O base atende a rotina de gerar links com suas contas. Em grupos, inclui converter o link de um membro, apagar a mensagem original e apagar o link que não converte, como o convite de outro grupo ou uma loja sem rota, a não ser que esteja na Lista liberada. O [módulo Grupos](/modulos/grupos/) acrescenta o Porteiro, o anti-spam, a reputação e os comandos próprios.

Quem também prepara e publica ofertas pode reunir esses recursos no [Combo Grupo de Ofertas](/combos/grupo-de-ofertas/). Já a conexão com assistentes de IA e sistemas próprios fica no módulo Conexão IA e API. Essa divisão permite escolher a ferramenta para a tarefa que existe hoje: converter links, produzir posts, administrar a comunidade ou integrar a operação a outro sistema.

P: Preciso saber programar para usar o plano base?
R: Não. A configuração das contas acontece no painel e a conversão pode ser feita enviando links ao bot. Para integrar um sistema por código, existe o módulo Conexão IA e API.
P: Posso usar as contas de afiliado que já tenho?
R: Sim. Os plugins usam as credenciais e identificadores das suas contas. Você precisa ter acesso ao programa da loja ou aprovação na rede correspondente.
P: O que faço quando uma loja não converte?
R: Confira se há plugin ou rota ativa para o domínio e se a credencial está válida. A tela Operação › Não mapeados reúne links e domínios sem rota; lojas de redes podem exigir a importação das rotas aprovadas.
P: O link de moedas funciona no computador?
R: O desconto de moedas é para o app do AliExpress. O bot também entrega um link normal para PC ou navegador, e o produto pode não aparecer na área de moedas quando não houver disponibilidade.
P: Preciso do módulo Grupos para converter links enviados por membros?
R: Não. Converter o link do membro, apagar a mensagem original e apagar o link que não converte (como o convite de outro grupo) pertencem ao plano base. O bot precisa ser administrador, com permissão de apagar mensagens, e ignora mensagens dos administradores do grupo.
P: O bot converte automaticamente os posts de um canal?
R: Não. Em canais, os posts alimentam os alertas de links para revisão. A conversão automática de mensagens acontece no privado e nos grupos, conforme a configuração do bot.
P: Existe teste grátis do plano base?
R: Não há teste grátis. O plano base é uma assinatura, e os módulos opcionais são acrescentados conforme os recursos de que sua operação precisa.
P: Posso instalar o painel no celular?
R: Sim. O painel pode ser instalado como PWA pelo navegador no celular ou no computador. As instruções estão na página Baixar app do site.

---

# MÓDULO: Conexão IA e MCP
URL: https://botdoafiliado.com/modulos/conexao-ia-e-mcp/
Preço: R$ 99/mês, somado ao plano base (R$ 99/mês)
Descrição: MCP para afiliados: conecte ChatGPT ou Claude ao seu bot para converter links, buscar produtos e montar ofertas com suas contas e permissões de acesso.

O MCP para afiliados do Bot do Afiliado conecta seu bot ao ChatGPT, Claude e outros clientes compatíveis, para quem quer preparar links e ofertas por conversa. A IA usa as contas de afiliado e os formatos que você configurou no bot.
Conexão IA e MCP e API de links são duas formas de uso do mesmo módulo, cobrado uma única vez.

- Links com suas contas: Peça a conversão de um link ou de um lote com até 150 URLs. O bot usa os plugins e as rotas configurados para suas contas de afiliado.
- Busca de produtos: Pesquise por termo, faixa de preço e ordenação nas lojas cobertas pela busca, desde que o conversor correspondente esteja ativo.
- Oferta no seu formato: Monte o texto de uma oferta com links, cupom e chamada para ação usando o formato do bot. O resultado volta à conversa para revisão e publicação por você.
- Cupons pela conversa: Com o módulo Cupons, consulte os registros e categorias. Cadastrar, remover e reativar cupons também exige permissão para gerenciar.
- Consultas da operação: Consulte campanhas, métricas e histórico de atividade já registrados na sua organização. As ferramentas de campanhas são de leitura.
- Acesso sob seu controle: Na conexão por login, escolha o bot e autorize as permissões. Consulte os apps conectados e desconecte cada um pelo painel.

1. Ative o módulo: Entre pela Central do Afiliado e abra Conta › Plano e módulos. O dono da organização seleciona Conexão IA e API junto do plano base.
2. Confira as contas do bot: Em Configuração › Plugins, conecte e valide as lojas que você pretende usar. A IA utiliza essas mesmas configurações para converter links.
3. Escolha o cliente de IA: Em Configuração › API e IA (MCP), abra IA (MCP) e copie a URL do servidor. Use o guia do cliente escolhido para adicionar o conector; apps locais também podem usar chave de API.
4. Autorize e faça um pedido: No fluxo por login, escolha o bot e confira as permissões na autorização. Envie um link de produto à IA e revise o resultado devolvido pela ferramenta.

## Como o MCP para afiliados participa da sua rotina?

O MCP é o protocolo que permite a um assistente de IA chamar ferramentas do seu bot. Na prática, você pode pedir a conversão de um produto durante a conversa e receber o resultado da integração com a loja. As contas de afiliado, as rotas e os formatos continuam sendo os que você configurou no Bot do Afiliado.

Isso ajuda quando a pesquisa, a escolha do produto e a preparação do texto já acontecem no ChatGPT ou no Claude. A conexão leva as tarefas do bot para essa conversa. O [guia sobre MCP](/docs/ia/o-que-e-mcp/) explica o funcionamento do conector, e o catálogo desta página mostra as ferramentas que o servidor oferece.

## Que tipo de pedido a IA consegue atender?

Um pedido como “busque garrafas térmicas na Shopee e ordene pelo menor preço” pode usar `search_products`. A busca aceita filtros e depende de um conversor ativo para a loja. Shopee, AliExpress e Amazon são as opções da busca geral; Kabum e Magalu podem ser solicitadas especificamente. O Mercado Livre participa da conversão de links e da consulta de produto por URL, mas não dessa busca.

Se você já tem os produtos, pode pedir “converta estes links com a minha conta” e usar `convert_links`, com até 150 URLs por chamada. A consulta por `get_product` traz os dados disponíveis para aquele produto. Preço, imagem e demais campos dependem do que a loja fornece; um dado ausente precisa continuar ausente, sem ser completado por suposição.

## O que acontece depois de montar uma oferta?

A ferramenta `create_offer_post` prepara o texto usando o formato do bot. Você pode informar os links, um código de cupom e a chamada para ação desejada. O retorno serve para revisar título, condições e endereço antes da divulgação. Os [exemplos de pedidos à IA](/docs/ia/exemplos-de-prompts/) mostram como dar esse contexto.

Essa ferramenta não envia a mensagem a um canal. Quando a rotina pede prévia visual e publicação em destinos autorizados, o [módulo Ofertas](/modulos/ofertas/) oferece o Postador do painel. Informar um código no texto da oferta também é diferente de cadastrar um cupom para o menu do bot: o cadastro usa as ferramentas próprias de Cupons.

## Qual é a diferença entre conectar por login e por chave?

No fluxo por login, o cliente abre a autorização, você entra pela Central do Afiliado e escolhe qual bot conectar. A tela informa o acesso solicitado. As permissões concedidas e o seu papel na organização definem o que o assistente pode consultar ou alterar. Senha e token do Telegram não precisam ser colados na conversa.

Uma API key é a alternativa para clientes que aceitam a credencial no cabeçalho da conexão. A mesma chave pode ser usada na API REST e no MCP; seu nível limita as operações permitidas. Essa escolha é útil para uma configuração local ou integração mantida por você. Para encerrar um acesso, desconecte o app autorizado por login ou revogue a chave utilizada naquele cliente.

## Todas as ferramentas ficam disponíveis para qualquer operação?

O catálogo reúne 23 ferramentas, mas ter a conexão não substitui módulos, permissões ou dados cadastrados. As cinco ferramentas de cupons dependem do [módulo Cupons](/modulos/cupons/); criar, remover ou reativar registros pede acesso de gerenciamento. A combinação está descrita no [Combo IA e Cupons](/combos/ia-e-cupons/).

As ferramentas do Puxador dependem do [módulo Puxador](/modulos/puxador/). Já as consultas de campanhas e atividade leem o que existe na sua organização. Elas ajudam a responder perguntas sobre a operação registrada, sem criar campanhas nem transformar uma consulta em envio de mensagens.

## Quando usar a API em vez da conversa com a IA?

A conversa atende pedidos que mudam conforme o contexto: selecionar produtos, preparar uma oferta ou consultar cupons. Um sistema próprio pode preferir enviar requisições com estrutura fixa e tratar cada resposta por código. É o caso de um site ou de uma automação que recebe listas de URLs.

A [API de links de afiliado](/modulos/api-de-links/) apresenta esse segundo caminho, com autenticação, lotes, script para sites e webhooks. Ela e a Conexão IA e MCP são duas formas de usar o mesmo módulo Conexão IA e API. Usar as duas interfaces não cria uma segunda cobrança pelo módulo.

P: Preciso saber programar para conectar a IA?
R: Não para usar um cliente com conector MCP por login. Você adiciona a URL do bot, autoriza o acesso e faz pedidos em linguagem natural.
P: Preciso colar uma API key no ChatGPT ou no Claude?
R: A conexão por login dispensa API key. A chave é uma alternativa para clientes que aceitam cabeçalhos, como as configurações de apps locais mostradas no painel.
P: Funciona em qualquer conta do ChatGPT?
R: A disponibilidade de conectores MCP depende da conta, do plano e das regras da organização no ChatGPT. Pode ser necessário habilitar o modo desenvolvedor; confira o guia de conexão antes de começar.
P: A IA publica a oferta ou dispara broadcast sozinha?
R: Não. As ferramentas preparam links e o texto da oferta, mas não publicam no canal nem disparam broadcast. A publicação é uma ação separada da sua operação.
P: Como a IA escolhe entre meus bots?
R: Na autorização por login, você escolhe o bot. O painel também mostra a URL específica dele; com essa URL, o acesso precisa corresponder ao bot autorizado.
P: Gerenciar cupons está incluído na conexão?
R: As ferramentas existem no servidor MCP, mas exigem o módulo Cupons. Alterar os registros também depende das permissões concedidas e do papel da pessoa ou nível da chave.
P: Como retiro o acesso de uma IA?
R: Em Configuração › API e IA (MCP), use Desconectar na seção Conexões de IA ativas para conexões por login. Se o cliente usa API key, revogue a chave correspondente.
P: MCP e API de links são cobrados separadamente?
R: Não. São duas formas de usar o mesmo módulo Conexão IA e API. Você escolhe a conversa com a IA, chamadas por código ou ambas, com o mesmo módulo.

---

# MÓDULO: Ofertas
URL: https://botdoafiliado.com/modulos/ofertas/
Preço: grátis, incluído no plano base
Descrição: Gerador de posts de oferta com foto, preço e cupom no seu formato. Revise a prévia no Postador e publique nos canais e grupos autorizados do seu bot.

O gerador de posts de oferta do Bot do Afiliado atende quem divulga produtos e quer preparar foto, título, preço, cupom e link em um formato próprio. O módulo Ofertas reúne o Postador do painel e a personalização dos posts para sua rotina de publicação.

- Postador com prévia: Cole links, preços e cupons no painel. A prévia acompanha as alterações e mostra o resultado antes de copiar o texto ou publicar.
- Posts pelo Telegram: O comando /oferta monta a mensagem com os links informados e responde no próprio chat. Aceita cupom, preços e chamada para ação.
- Formato da sua marca: Edite os modelos de oferta, preço, cupom e rodapé em Formato das ofertas. Use variáveis para manter o padrão com os dados de cada produto.
- Preço e condições legíveis: Mostre preço atual, preço anterior e parcelas quando os dados estiverem disponíveis. O preço anterior só fica riscado quando é maior que o de venda.
- Fotos e chamadas salvas: No Postador, use foto, título e CTA próprios por produto. As escolhas ficam salvas por bot e podem ser gerenciadas em Fotos e CTAs.
- Publicação nos canais do bot: Escolha entre os canais e supergrupos em que o bot está quais aparecem no Postador e marque os que recebem a oferta. Você revisa a prévia e aciona o envio.

1. Assine o plano base: O módulo Ofertas vem grátis com o plano base: entre pela Central do Afiliado e confira o base em Conta › Plano e módulos.
2. Prepare lojas e formato: Confira suas contas em Configuração › Plugins. Em Promoções › Formato das ofertas, ajuste o post, a linha de preço, a linha de cupom e o rodapé.
3. Escolha os destinos: No Postador, abra a aba Canais e grupos e deixe na lista os canais e supergrupos do bot que você usa para publicar.
4. Revise e publique: Em Promoções › Postador, cole os links e confira dados, status da conversão e prévia. Escolha os destinos e clique em Postar, ou use Copiar texto.

## Como o gerador de posts de oferta prepara uma publicação?

Uma oferta precisa apresentar o produto, suas condições e o endereço para comprar. O módulo Ofertas reúne a composição e o formato desse conteúdo no bot: os dados do produto entram no modelo que você escolheu, junto do seu link de afiliado. É a etapa seguinte à conversão de URLs oferecida pelo [plano base](/modulos/plano-base/).

No painel, a tela **Promoções › Postador** aceita links, preços e cupons na mesma entrada. Você acompanha a prévia do Telegram e o status dos links, ajusta os campos e decide entre copiar o texto ou enviar aos destinos escolhidos. Essa revisão permite perceber um título incompleto ou uma condição errada antes de acionar a publicação.

## Quando usar os comandos de oferta no Telegram?

O `/oferta` serve para preparar o post a partir de links enviados no privado ou em um grupo. Ele aceita até 10 links, monta a lista em ordem de preço e pode formar uma grade com até 6 fotos. O bot devolve o conteúdo naquele chat; o comando não publica diretamente em um canal.

O `/montaroferta` monta a oferta sem cupom, com preços e CTA opcionais. Já `/converter`, ou `/c`, atende a um texto que está pronto: troca os links pelos seus e aplica as regras de formatação configuradas. A documentação de [ofertas no Telegram](/docs/telegram/ofertas/) diferencia os comandos. Eles fazem parte do fluxo de preparação, enquanto o Postador concentra a revisão visual e o envio pelo painel.

## Como o preço anterior, as parcelas e o cupom aparecem?

A variável `{linhadopreco}` escolhe o formato adequado aos dados disponíveis. O preço anterior só aparece riscado quando é maior que o preço de venda. Parcelas dependem da quantidade e do valor informados; a indicação de juros também precisa estar presente nos dados. Dessa forma, um produto sem parcelamento pode usar o mesmo modelo de outro que tenha essa condição.

O cupom pode ser um código ou uma página de resgate. No segundo caso, a página também passa pela conversão de afiliado. A variável `{linhadocupom}` escolhe a apresentação correspondente e desaparece quando não há cupom. Se o resgate não puder ser convertido, o comando avisa em vez de montar a oferta com aquele endereço.

## O que o módulo Cupons acrescenta ao Postador?

Digitar um código na oferta é diferente de manter um cadastro de cupons. Com o [módulo Cupons](/modulos/cupons/), você registra as condições do cupom no bot. Ao reconhecer esse código, o Postador pode preencher o desconto, respeitar compra mínima e teto e recalcular o preço. Cashback aparece como informação, sem ser abatido do valor de compra.

Os campos de preço manual do Postador se aplicam ao primeiro produto e têm prioridade sobre o cálculo do campo Desconto. Por isso, a prévia continua sendo parte da conferência. O [Combo Canal de Ofertas](/combos/canal-de-ofertas/) reúne base, Ofertas e Cupons para quem trabalha com posts e também mantém o menu de cupons do bot.

## Como manter a identidade das ofertas recorrentes?

Em **Promoções › Formato das ofertas**, você ajusta modelos de post, linha de preço, cupom e rodapé. Uma chamada para ação só entra onde existe `{cta}` no formato. Também é possível definir um rodapé por loja; em ofertas com vários links, essa escolha segue o primeiro link colado, mesmo que a lista depois seja ordenada por preço.

No Postador, foto própria, título e CTA podem ficar salvos por produto e por bot. A foto aceita JPG, PNG, WebP ou GIF de até 5 MB e substitui apenas o espaço daquele produto na grade. **Fotos e CTAs** reúne essas escolhas para manutenção. Esses recursos de personalização por produto são do Postador e não devem ser presumidos no retorno do `/oferta` pelo Telegram.

## Quais destinos recebem a publicação do painel?

O Postador envia a canais e supergrupos ativos que você autorizou para o bot. Um grupo básico não aparece como destino desse envio. Depois de revisar, você marca um ou mais destinos e aciona **Postar**; o painel também oferece **Copiar texto** para usar o resultado em outra etapa da sua rotina.

Enquanto a prévia atualiza, os botões de postar e copiar ficam bloqueados para aguardar a versão atual do conteúdo. O [guia do Postador](/docs/telegram/formatador-tempo-real/) descreve essa conferência. Para quem prepara ofertas pela [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/), vale a mesma distinção entre tarefas: a IA devolve o texto, e publicar continua sendo uma ação separada.

P: O comando /oferta publica direto no meu canal?
R: Não. Ele responde no chat em que você enviou o comando, no privado ou no grupo. Para enviar diretamente aos destinos autorizados, use o Postador do painel.
P: Quantos produtos cabem em uma oferta?
R: O post em lista mostra até 10 produtos. A grade reúne até 6 fotos; o comando /oferta recebe até 10 links.
P: Posso usar um formato de post próprio?
R: Sim. Em Promoções › Formato das ofertas, edite os modelos com as variáveis disponíveis e confira a prévia antes de salvar. Há formatos para oferta, cupom, preço e rodapé.
P: Por que minha chamada para ação não aparece?
R: O texto do CTA só aparece onde o formato contém a variável {cta}. Preencher o campo sem incluir essa variável no modelo não acrescenta a chamada ao post.
P: O preço manual vale para todos os produtos no Postador?
R: Não. Os campos Preço de venda e Preço anterior valem para o primeiro produto. Quando há preço manual, o cálculo pelo campo Desconto do cupom não o substitui.
P: Preciso do módulo Cupons para escrever um código na oferta?
R: Você pode informar o código diretamente no post. O módulo Cupons serve para cadastrar e gerenciar os registros; com um cupom cadastrado, o Postador pode preencher o desconto e calcular o preço conforme as regras dele.
P: Minha foto será usada na próxima oferta do mesmo produto?
R: Sim, no Postador a foto própria fica vinculada ao bot e ao produto. Ela reaparece nessa superfície e pode ser trocada ou removida em Fotos e CTAs.
P: Consigo usar o Postador pelo celular?
R: Sim. A tela organiza composição, prévia, links e destinos para uso no celular. Não é necessário digitar comandos para montar e publicar pelo painel.

---

# MÓDULO: Grupos
URL: https://botdoafiliado.com/modulos/grupos/
Preço: R$ 49/mês, somado ao plano base (R$ 99/mês)
Descrição: Bot para grupo de ofertas no Telegram com Porteiro de canal, anti-spam de bots, reputação e comandos próprios para organizar sua comunidade.

O bot para grupo de ofertas no Telegram é uma ferramenta para administradores que precisam organizar a participação da comunidade. O módulo Grupos reúne Porteiro de canal, anti-spam de bots, reputação e comandos personalizados. A troca e a moderação de links já vêm no plano base.

- Porteiro de canal: Exige que o membro esteja no canal escolhido para falar no grupo. Você define o aviso e acompanha as infrações no painel.
- Anti-spam de bots: Identifica situações de spam de bots no grupo. A configuração permite banir o bot e a pessoa que o acionou.
- IA opcional do Porteiro: Analisa mensagens de pessoas barradas para distinguir falta de inscrição de spam, golpe ou divulgação. Vem desligada e tem limite diário de leituras.
- Reputação da comunidade: Separa XP por atividade dos votos de reputação. Permite configurar níveis, ranking e reconhecimento entre membros.
- Comandos com sua resposta: Crie respostas como /regras ou /site, com texto formatado, foto opcional e até seis botões de link.

1. Escolha o módulo: Entre pela Central do Afiliado e abra Conta › Plano e módulos. Selecione Grupos junto ao plano base.
2. Confira as permissões: Coloque o bot como administrador do grupo, com as permissões necessárias para apagar mensagens e restringir membros. Para o Porteiro, ele também precisa ser administrador do canal exigido.
3. Defina as regras: Em Operação › Comunidade › Porteiro, escolha o grupo, o canal e o aviso. Use Testar canal para conferir o acesso.
4. Prepare a participação: Configure os níveis em Comunidade › Reputação e as respostas em Operação › Comandos. Confira o comportamento com uma conta de membro, pois administradores do grupo são ignorados.

## O que fica no plano base e o que este módulo acrescenta?

Um grupo de ofertas recebe links de produtos, mensagens de conversa e divulgação de outros grupos. Desde 24/10/2026, tudo o que trata os links dos membros está no [plano base](/modulos/plano-base/): o bot troca o link pelo seu link de afiliado, apaga a mensagem original e apaga o link que não converte, como o convite de outro grupo, a não ser que esteja na Lista liberada. A verificação vale também para legendas, palavras clicáveis, encurtadores e mensagens editadas.

O módulo Grupos cuida de quem participa: o Porteiro, o anti-spam de bots, a reputação e os comandos próprios. Essa distinção ajuda a escolher o recurso necessário para o grupo: tratar links e organizar a comunidade são trabalhos diferentes. A [documentação de grupos](/docs/telegram/grupos/) detalha a configuração.

## Como exigir o canal antes de permitir conversa?

O Porteiro associa um canal obrigatório a cada grupo. Quando alguém que não participa desse canal tenta falar, a mensagem é apagada e o bot apresenta o aviso configurado. A regra também vale para mensagens sem link e comandos. Ela permite manter a conversa no grupo vinculada à audiência do canal.

O bot precisa ser administrador do grupo e do canal exigido. Administradores do grupo e posts do canal vinculado ficam isentos. O aviso pode mencionar a pessoa e incluir o botão de entrada; a lista de infratores permite revisar ocorrências, banir, desbanir e zerar contadores. Com [Sub-bots](/modulos/sub-bots/), a consulta ao canal continua sendo feita pelo bot principal.

## O que a proteção contra spam automatiza?

O anti-spam trata bots acionados no grupo, inclusive pelo modo inline. Entre os sinais considerados estão mensagens de bots com muitos botões e o acionamento por alguém fora do canal exigido. A opção de banir quem aciona bot de spam vem ligada; bots administradores e o próprio bot da operação ficam isentos.

A IA do Porteiro é uma configuração separada e opcional, desligada por padrão. Ela analisa mensagens de pessoas barradas para identificar spam, golpe ou divulgação. Quem apenas não entrou no canal recebe a orientação para entrar. Como essa opção pode aplicar punições, a revisão das ocorrências ajuda a acompanhar seu efeito na comunidade.

## Como organizar a participação depois da moderação?

Reputação e XP medem aspectos diferentes. A atividade gera XP e progressão de nível; os votos de outros membros formam a reputação. O sistema vem desligado para que você escolha os critérios antes de usá-lo. A [documentação de reputação](/docs/telegram/reputacao/) explica os votos, os níveis e os ajustes disponíveis.

Comandos personalizados tornam regras e links úteis acessíveis na própria conversa. Uma resposta de `/regras`, por exemplo, pode reunir orientações e botões definidos por você. Para uma operação que também envia avisos aos privados e grupos, o [Combo Comunidade](/combos/comunidade/) reúne plano base, Grupos e Broadcast; cada módulo atende uma parte desse trabalho.

P: Preciso deste módulo para trocar ou apagar os links dos membros?
R: Não. Converter o link do membro, apagar a mensagem original e apagar o link que não converte (convite de outro grupo, loja sem rota) pertencem ao plano base desde 24/10/2026. Grupos acrescenta o Porteiro, o anti-spam, a reputação e os comandos.
P: O bot precisa ser administrador do canal também?
R: Para o Porteiro de canal, sim: ele precisa consultar a participação no canal exigido. No grupo, precisa das permissões de apagar mensagens e restringir membros.
P: O aviso do Porteiro aparece só para a pessoa barrada?
R: O bot tenta enviar um aviso efêmero, visível só para ela. Se o Telegram não aceitar, responde no grupo; os avisos têm intervalo mínimo de 30 segundos por pessoa.
P: A IA pune pessoas assim que eu adiciono o módulo?
R: A opção de a IA ler e punir infratores vem desligada. Quando habilitada, analisa as mensagens de pessoas barradas pelo Porteiro, com teto de 1.500 leituras por dia por bot.
P: O Porteiro funciona com sub-bots?
R: Sim. O bot principal consulta a participação no canal e precisa ser administrador dele; o sub-bot precisa ser administrador do grupo.

---

# MÓDULO: Cupons
URL: https://botdoafiliado.com/modulos/cupons/
Preço: R$ 99/mês, somado ao plano base (R$ 99/mês)
Descrição: Bot de cupons de afiliado com menu por loja, vitrine de cupons e validade automática. Cadastre com IA no painel e importe os códigos das redes conectadas.

O bot de cupons de afiliado junta num cadastro só os códigos que você divulga. O seguidor encontra os cupons por loja no menu /cupom do bot e na vitrine de cupons do seu site. Você mantém o cadastro no painel, usa IA para extrair dados de textos e define quando cada cupom aparece.

- Menu por loja: O /cupom apresenta botões das lojas com cupons vigentes. O seguidor escolhe uma loja e encontra códigos copiáveis e links de resgate.
- Vigência do cadastro: Datas de início e expiração controlam a exibição. Cupons vencidos ficam guardados em Expirados para revisão e possível reativação.
- Extrair com IA: Cole o texto de um post no painel e receba os campos preenchidos para revisar. Você escolhe salvar um cupom ou o lote extraído.
- Importar das redes: O botão Importar dos plugins busca cupons com código nas contas conectadas de Awin, Rakuten e CityAds. Cada registro entra com o link de rastreio fornecido pela rede.
- Código ou link: Cadastre cupons de código ou de resgate por link, com descrição, desconto, mínimo e validade. A loja pode ser identificada pelo link ou escolhida por você.
- Cadastro usado nas ofertas: A Vitrine pode exibir os cupons cadastrados. Com o módulo Ofertas, o Postador preenche os dados do desconto ao receber um código desse cadastro.

1. Adicione Cupons: Entre pela Central do Afiliado e selecione Cupons em Conta › Plano e módulos, junto ao plano base.
2. Revise as lojas: Abra Promoções › Cupons › Sites. Confira as lojas preenchidas a partir dos plugins e rotas do bot e ajuste nome, ordem e situação.
3. Cadastre e confira: Use Novo cupom, Extrair com IA ou Importar dos plugins. Revise código, link, regras e datas antes de deixar o cupom ativo.
4. Confira no Telegram: Envie /cupom ao bot, escolha a loja e confira o que o seguidor recebe. Um comando personalizado com esse nome substitui o menu padrão.

## Como o bot de cupons de afiliado organiza os códigos?

O módulo concentra os cupons num cadastro por loja. Quando alguém envia `/cupom`, o bot mostra os sites que têm cupons ativos dentro da vigência. A pessoa escolhe um botão e recebe a lista daquela loja, com o código pronto para copiar ou a indicação de resgate pelo link.

Isso permite oferecer uma consulta dentro do bot sem depender de reenviar uma lista em toda conversa. As lojas podem ser preenchidas a partir dos plugins e rotas existentes ou cadastradas por você. A [documentação de cupons](/docs/telegram/cupons/) explica os campos do cadastro e o funcionamento do menu.

## Onde a IA ajuda no trabalho com cupons?

A IA atua no preparo do cadastro. Na aba Extrair com IA, você cola o texto de um post e recebe uma proposta com loja, códigos, regras, datas e link. Os campos ficam disponíveis para revisão antes de salvar um item ou o lote. O sistema descarta códigos que não constem no texto recebido.

A revisão continua necessária: uma compra mínima, um teto de desconto ou uma data incorreta mudam a oferta para o seguidor. Confira também o link extraído e sua atribuição de afiliado. O menu do Telegram é uma navegação por loja; ele não oferece busca por conversa com IA. Para trabalhar com cupons pelo ChatGPT ou Claude, existe a integração descrita em [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/).

## Como entram os cupons das redes de afiliados?

O botão Importar dos plugins consulta Awin, Rakuten e CityAds conectados ao bot. Entram cupons brasileiros com código e link de rastreio fornecido pela rede. Registros expirados são ignorados, e a combinação de loja e código permite atualizar um cupom existente em vez de criar outra cópia.

A importação é iniciada por você. A tela informa o resultado por rede e mantém a trilha na aba Importações. Ajustes manuais de desconto, mínimo, teto e cashback são preservados quando a atualização não fornece esses campos. A ausência de um cupom numa consulta posterior não confirma que a campanha acabou; a validade e as condições precisam continuar corretas no cadastro.

## Como lidar com validade, expiração e esgotamento?

Datas de início e fim definem a janela em que o cupom aparece no menu. Um código cadastrado hoje pode começar a valer mais tarde; um código vencido sai da consulta e fica guardado em Expirados. Isso mantém o registro disponível para uma campanha que volte a usar o mesmo código.

Ao reativar um cupom cuja validade passou, a data vencida é removida. Registre a nova data e confira se a loja voltou a aceitar o código. Marcar Esgotado serve ao acompanhamento no painel e a outros usos do cadastro, mas não retira o item do `/cupom`. Para interromper sua exibição no menu, deixe o cadastro inativo ou ajuste a vigência conforme a campanha.

## Como o mesmo cadastro ajuda na publicação de ofertas?

No [módulo Ofertas](/modulos/ofertas/), o Postador consulta o código digitado e preenche os dados do desconto cadastrados. O cálculo considera percentual ou valor fixo, compra mínima e teto quando aplicável. Cashback entra como uma observação, sem ser tratado como abatimento imediato no preço.

A [Vitrine pública](/docs/comecando/vitrine/) também pode apresentar os cupons, com filtro por loja, código copiável e link de saída. Para quem mantém um canal e prepara posts com esses dados, o [Combo Canal de Ofertas](/combos/canal-de-ofertas/) reúne plano base, Ofertas e Cupons. A manutenção do cadastro passa a atender a consulta no bot e o preparo das publicações.

P: O seguidor conversa com uma IA para encontrar cupom?
R: O /cupom abre um menu de botões por loja. A IA deste módulo está na aba Extrair com IA do painel, onde ajuda você a cadastrar cupons a partir de textos.
P: Os cupons vencidos deixam de aparecer sozinhos?
R: Sim, quando há uma data de expiração cadastrada. O menu mostra apenas cupons ativos dentro da vigência; os vencidos ficam na aba Expirados.
P: Reativar um cupom confirma que a loja voltou a aceitá-lo?
R: Não. Ativar altera o cadastro e remove a data vencida, quando houver. Confira a campanha na loja e registre a nova validade antes de divulgar.
P: A importação de Awin, Rakuten e CityAds roda sozinha?
R: Você inicia a importação pelo botão Importar dos plugins. Ela usa as redes conectadas, busca cupons com código e pula os que já estão expirados.
P: Posso cadastrar um cupom sem código?
R: Sim, desde que tenha um link de resgate. No Telegram ele aparece como resgate no link; um cadastro precisa ter código ou link.
P: O cupom secreto do AliExpress faz parte do /cupom?
R: Ele aparece na resposta de conversão de um produto quando a API do AliExpress o fornece. Não entra automaticamente no menu /cupom e não depende do módulo Cupons.
P: A lista da loja fica visível para todo o grupo?
R: O bot tenta abrir a lista como mensagem efêmera só para quem tocou no botão. Se o Telegram não aceitar, a lista aparece para os demais no próprio menu.
P: Existe limite de lojas e cupons no menu?
R: O menu apresenta até 60 lojas e consulta até 30 cupons por loja. O tamanho máximo da mensagem também pode limitar a lista exibida.

---

# MÓDULO: Broadcast
URL: https://botdoafiliado.com/modulos/broadcast/
Preço: grátis, incluído no plano base
Descrição: Broadcast de ofertas no Telegram para conversas privadas e grupos do seu bot. Envie mensagens em fila, acompanhe cada resultado e fixe avisos com permissão.

Broadcast de ofertas no Telegram é o módulo para afiliados que precisam enviar uma mensagem às conversas privadas e aos grupos que já interagiram com o bot. Prepare o conteúdo, coloque o envio na fila e acompanhe o resultado de cada conversa pelo painel ou pelos comandos.

- Audiência do próprio bot: Envia para as conversas privadas e grupos ativos registrados pelas interações com o bot. Canais do Telegram ficam fora do broadcast.
- Mensagem pronta com mídia: Responda a uma mensagem com /broadcast para reenviá-la com a mídia e a formatação. O modo /broadcastcompin também tenta fixá-la.
- Editor com prévia: No painel, escreva com formatação e imagem opcional e confira a prévia. A confirmação do envio exige digitar ENVIAR.
- Fila e novas tentativas: O processamento espera quando o Telegram pede uma pausa e faz novas tentativas para falhas recuperáveis, até o limite de três por conversa.
- Progresso por conversa: O histórico mostra total, enviados e erros. Os detalhes registram o resultado de cada conversa e permitem cancelar o que ainda está pendente.

1. Assine o plano base: O Broadcast vem grátis com o plano base: entre pela Central do Afiliado e confira o base em Conta › Plano e módulos.
2. Revise a audiência: Confira os registros em Operação › Chats. O broadcast alcança privados e grupos ativos que interagiram com o bot; canais não recebem.
3. Prepare a mensagem: Em Operação › Broadcast › Novo, escreva a mensagem com os links já convertidos, confira a prévia e escolha se quer fixá-la. Confirme digitando ENVIAR.
4. Acompanhe o resultado: Abra Histórico e os detalhes do envio. Pelo Telegram, o dono ou administrador do bot também pode consultar /broadcaststatus seguido do número do envio.

## Quem recebe o broadcast de ofertas no Telegram?

O público é formado pelas conversas privadas e pelos grupos que já interagiram com o bot e continuam ativos no cadastro. Esse registro acontece a partir das interações, inclusive antes da contratação do módulo. Você pode consultar a situação das conversas em Operação › Chats para entender de onde vem a audiência.

Canais ficam fora desse envio. Também não há uma seleção de pessoas ou segmentação na criação do broadcast: a mensagem segue para todos os destinatários elegíveis. Isso faz do módulo uma opção para avisos comuns à audiência, como uma promoção já revisada ou uma orientação sobre a comunidade. A [documentação de broadcast](/docs/telegram/broadcast/) reúne os comandos e o acompanhamento.

## Como uma oferta pronta vira uma mensagem para todos?

O conteúdo deve chegar ao broadcast com os links de afiliado já convertidos e as condições conferidas. Ele distribui a mensagem preparada por você. Para montar um post com produto, preço e cupom, o [módulo Ofertas](/modulos/ofertas/) oferece o Postador; o plano base também permite gerar os links antes de escrever o aviso.

Pelo Telegram, responder a uma mensagem pronta com o comando preserva o conteúdo e a mídia no reenvio. O bot tenta encaminhá-la e usa cópia caso o encaminhamento falhe. Pelo painel, o editor oferece formatação, imagem opcional e prévia. Esse caminho aceita até 4.096 caracteres; no comando com texto, o limite é de 3.500. A imagem do painel funciona como prévia da mensagem, com upload de até 5 MB.

## O que significa receber a confirmação de fila?

A resposta “Broadcast enfileirado” confirma a criação do trabalho de envio. Ela ainda não comprova que as mensagens chegaram a todas as conversas. O processamento acontece em fila, e o número recebido permite consultar o andamento, os enviados e as falhas.

Quando o Telegram solicita uma pausa, a fila espera o tempo indicado. Falhas recuperáveis podem ter até três tentativas por conversa. Quem bloqueou o bot, contas desativadas e chats inexistentes deixam de ser destinos ativos ao serem identificados no envio, sem impedir o processamento dos demais. O ritmo de fila não elimina a possibilidade de falhas, por isso o histórico faz parte da operação.

## Como interpretar fixação, falhas e cancelamento?

Uma mensagem enviada e uma mensagem fixada são resultados diferentes. Com a opção Fixar ou o comando `/broadcastcompin`, o bot tenta fixar o conteúdo após enviá-lo. Se não tiver permissão, registra a falha de fixação e mantém a mensagem contabilizada como enviada.

Os detalhes mostram o progresso, o último erro e o registro por conversa. Enquanto o envio está em andamento, a tela se atualiza automaticamente. O cancelamento interrompe somente as mensagens pendentes. Por isso, revisar texto, links e condições antes da confirmação evita precisar corrigir um conteúdo que já chegou a parte da audiência.

## Quando o broadcast complementa a comunidade?

O [Combo Comunidade](/combos/comunidade/) reúne plano base, Grupos e Broadcast. Grupos cuida de regras de participação e moderação; Broadcast distribui o aviso aos privados e grupos já registrados. Uma operação com conversas frequentes pode precisar das duas funções em momentos diferentes.

O envio não oferece agendamento nem saudação com o nome de cada destinatário. Para um aviso comum, escreva uma mensagem que faça sentido para toda a audiência. Se o objetivo é somente publicar num canal, o Postador atende esse destino. A comparação com o [módulo Grupos](/modulos/grupos/) ajuda a distinguir a organização da conversa do trabalho de distribuir mensagens.

P: O broadcast publica nos canais do Telegram?
R: Não. Os destinatários são conversas privadas e grupos ativos que já interagiram com o bot. Para publicar ofertas em canais, use o Postador do módulo Ofertas.
P: Ele converte os links da mensagem automaticamente?
R: Não. Os links precisam estar convertidos antes do envio. Você pode prepará-los em Gerar link ou montar o post no Postador e depois usá-lo no broadcast.
P: Posso agendar ou escolher um segmento de destinatários?
R: O envio entra na fila quando você o confirma e alcança todos os privados e grupos ativos registrados. O módulo não oferece agendamento nem segmentação.
P: A mensagem pode chamar cada pessoa pelo nome?
R: Não há personalização pelo nome do destinatário. As variáveis preenchidas no broadcast são {bot}, {chatid}, {data} e {hora}.
P: Quem da equipe pode enviar?
R: No Telegram, o dono e os administradores do bot. No painel, o dono e administradores da organização podem criar e cancelar envios; o papel membro apenas visualiza.
P: Cancelar apaga as mensagens já entregues?
R: Não. O cancelamento interrompe o que ainda não saiu e preserva o que já foi enviado. Um envio concluído não pode ser cancelado.
P: Posso pedir um broadcast pelo ChatGPT ou Claude?
R: Os comandos de broadcast não são disponibilizados pelo conector MCP. O envio é feito pelos comandos administrativos no Telegram ou pela tela Broadcast do painel.
P: O mesmo envio pode alcançar o WhatsApp?
R: Essa integração depende do módulo WhatsApp, cuja contratação ainda não está liberada. Ela contempla texto para grupos marcados como destino; mensagens reenviadas respondendo com um comando de broadcast não seguem para o WhatsApp.

---

# MÓDULO: API de links
URL: https://botdoafiliado.com/modulos/api-de-links/
Preço: R$ 99/mês, somado ao plano base (R$ 99/mês)
Descrição: API de links de afiliado para sites e automações: converta até 150 URLs por chamada, consulte dados de produtos e integre webhooks com chave por permissão.

A API de links de afiliado do Bot do Afiliado atende desenvolvedores e operadores que querem converter URLs e consultar produtos dentro dos próprios sistemas. Use as contas já configuradas no bot, com resultado por item e chaves com níveis de permissão.
Conexão IA e MCP e API de links são duas formas de uso do mesmo módulo, cobrado uma única vez.

- Conversão de links em lote: Envie de 1 a 150 URLs ao endpoint convert-links. Cada item retorna seu resultado, preservando a ordem de entrada.
- Dados de produto por URL: Consulte título, imagem, preço e link de afiliado. Campos como estoque, preço anterior e parcelas dependem das informações fornecidas pela loja.
- Texto no formato do bot: Use o executor de comandos para montar o texto de uma oferta com o formato configurado. Gerar esse texto não publica a oferta.
- Chaves com três níveis: Crie chaves de Leitura, Padrão ou Total. Você pode ajustar o nível sem trocar o segredo ou revogar uma integração individualmente.
- Conversão no seu site: O Script do site usa uma Embed Key própria, vinculada aos domínios cadastrados. Ele também trata links de conteúdo carregado depois.
- Webhooks da operação: Receba eventos de leads, grupos, números, campanhas e falhas de envio em até cinco URLs HTTPS por organização, com assinatura e histórico de entregas.

1. Ative Conexão IA e API: Entre no painel pela Central do Afiliado. Em Conta › Plano e módulos, o dono da organização seleciona o módulo junto do plano base.
2. Configure as lojas do bot: Em Configuração › Plugins, cadastre e valide suas contas de afiliado. A API usa os mesmos plugins e rotas do bot.
3. Crie a chave adequada: Abra Configuração › API e IA (MCP) e a aba Chaves de API. Para converter links, escolha Padrão e guarde a chave completa, exibida uma única vez.
4. Confira uma primeira chamada: Envie um link para POST /api/v1/convert-links com o cabeçalho X-API-Key. Confira o resultado de cada item antes de integrar lotes à sua rotina.

## Como funciona a API de links de afiliado em lote?

A API recebe URLs e aplica os plugins, as credenciais e as rotas do seu bot. O endpoint principal é `POST /api/v1/convert-links`: envie `urls` para um lote de até 150 itens ou `url` para uma conversão individual. A chave enviada em `X-API-Key` identifica o bot que vai executar o trabalho.

No lote, a resposta preserva a ordem de entrada e traz `ok` em cada item. Um HTTP 200 com `success: true` não significa que todos os links foram convertidos. Seu sistema precisa conferir cada resultado, guardar os que deram certo e tratar os erros antes de tentar novamente. O [contrato de conversão em lote](/docs/api/convert-links/) mostra as duas formas de chamada e seus campos.

`affiliate_url` contém o link de afiliado gerado. `final_url` contém o endereço após a política de encurtamento e pode ser igual a ele. Essa diferença permite usar o endereço de saída adequado sem presumir que todas as lojas terão um link curto no mesmo domínio.

## Qual endpoint atende cada etapa da integração?

Converter um endereço, consultar o produto e montar o texto da oferta são operações diferentes. Escolher a rota que atende à tarefa evita depender de campos que aquela resposta não promete entregar.

| Sua tarefa | Endpoint | O que considerar |
| --- | --- | --- |
| Converter uma lista de links | `POST /api/v1/convert-links` | Até 150 URLs, com resultado por item. |
| Consultar um produto por URL | `POST /api/v1/product` | Retorna os dados disponíveis e o link de afiliado. |
| Montar o texto de uma oferta | `POST /api/v1/execute` | Usa o formato do bot; a chamada não publica o texto. |
| Consultar cupons cadastrados | `GET /api/v1/coupons` | Exige o módulo Cupons e usa paginação. |
| Ler formatos de mensagens | `GET /api/v1/templates` | Serve para consultar os templates existentes. |

Há uma [referência interativa da API](/docs/api/referencia/) com os contratos registrados em OpenAPI. A especificação pública fica em `https://botdoafiliado.com/api/openapi.json`, para consulta e importação em ferramentas de desenvolvimento. Informações como preço anterior, parcelas e estoque dependem do retorno da loja; o sistema que consome a API deve aceitar sua ausência.

## Como escolher o nível de permissão da chave?

Uma chave **Padrão** atende à conversão e às consultas que devolvem link de afiliado. **Leitura** é destinada às consultas permitidas sem gerar esse link. **Total** acrescenta operações de gerenciamento, como alterar templates e manter cupons, respeitando também os módulos necessários.

É possível manter chaves separadas por integração e mudar o nível de cada uma sem substituir seu segredo. Isso permite, por exemplo, revogar o acesso de uma automação sem trocar a chave de outro sistema. O guia de [autenticação e permissões](/docs/api/autenticacao/) relaciona os níveis aos endpoints. Respostas de falta de permissão pedem revisão da chave; limites de requisições pedem controle de ritmo e novas tentativas com espera.

## Como converter links de um site sem expor a API key?

Chamadas com `X-API-Key` pertencem ao servidor da sua aplicação. Para o navegador, o módulo oferece o **Script do site**, que usa uma Embed Key própria e permite cadastrar os domínios autorizados. O script troca links de lojas na página, incluindo conteúdo carregado depois da abertura.

O atributo `data-no-affiliate` permite preservar um link específico. Também existe um endpoint de conversão para uso com a Embed Key. A configuração e os exemplos estão no [guia do Script do site](/docs/api/script-do-site/). Esse recurso atende a páginas que já contêm links; a Página de chat do [plano base](/modulos/plano-base/) atende ao visitante que prefere colar um endereço e receber a resposta.

## Como os eventos chegam ao n8n, Make ou Zapier?

Os webhooks de saída enviam JSON para uma URL HTTPS pública. Você escolhe entre os eventos disponíveis, como entrada ou saída de leads, mudanças em grupos e números, campanha sem grupo aberto e falha de envio. A integração depende de esses eventos ocorrerem nos recursos que sua organização utiliza.

As entregas reais passam por fila e pelo ciclo de envio de cinco minutos. O botão de teste envia na hora, portanto ele não representa o prazo dos eventos da operação. Cada entrega tem assinatura HMAC-SHA256 para validação no destino, histórico e novas tentativas quando há falha. A documentação de [webhooks de saída](/docs/api/webhooks/) explica o contrato de verificação e o tratamento das entregas.

## API REST e MCP precisam de assinaturas diferentes?

As duas interfaces fazem parte do mesmo módulo Conexão IA e API. A REST atende a sistemas que enviam requisições estruturadas e processam as respostas por código. A [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/) leva tarefas do bot a clientes como ChatGPT e Claude, para pedidos feitos durante uma conversa.

Você pode usar ambas sem contratar duas vezes o módulo. Recursos adicionais mantêm suas próprias condições: consultar e gerenciar cupons exige Cupons, por exemplo. O canal de acesso muda a forma de trabalhar; as contas de afiliado e a configuração usadas na conversão continuam sendo as do bot.

P: Posso converter links de Shopee, Amazon, AliExpress e Mercado Livre?
R: Sim, desde que os respectivos plugins e rotas estejam ativos com suas credenciais. A conversão usa a configuração do bot e depende do suporte da integração para o link enviado.
P: Preciso contratar API e MCP separadamente?
R: Não. API REST e conexão MCP são duas formas de usar o mesmo módulo Conexão IA e API. Ele é acrescentado ao plano base uma única vez.
P: É preciso mandar bot_id no corpo da chamada?
R: Não. A X-API-Key identifica o bot. O campo bot_id, se enviado no corpo, é ignorado.
P: Uma chave de Leitura consegue converter links?
R: Não. Operações que geram ou devolvem links de afiliado exigem ao menos o nível Padrão, inclusive consultas de produto que retornam esse link. Leitura atende às consultas permitidas sem essa geração.
P: Um link com erro faz o lote inteiro falhar?
R: Não no modo batch. Cada item tem seu próprio resultado; confira ok em cada registro e trate os erros individualmente.
P: Preço, estoque e parcelas sempre aparecem?
R: Não. Os campos dependem da loja e dos dados disponíveis para o produto consultado. Sua integração precisa lidar com campos ausentes.
P: Os webhooks avisam quando acontece uma venda?
R: Não. Os eventos disponíveis cobrem leads, grupos, números, campanhas sem grupo aberto e falhas de envio. Eles não são notificações de vendas, comissões ou cliques.
P: Consigo recuperar uma API key que perdi?
R: Não. A chave completa aparece somente na criação. Crie outra, atualize a integração e revogue a anterior quando ela deixar de ser necessária.

---

# MÓDULO: Shopee Live
URL: https://botdoafiliado.com/modulos/shopee-live/
Preço: R$ 299/mês, somado ao plano base (R$ 99/mês)
Descrição: Automação para Shopee Live reúne pedidos do Telegram e da página pública em uma fila. Copie produtos em lotes e mostre foto, nome e preço estimado no OBS.

A automação para Shopee Live organiza os pedidos de produtos para afiliados e criadores que apresentam lives na Shopee Brasil. A audiência envia códigos ou links, e você copia os produtos em lote para adicionar à transmissão.

- Fila de pedidos: Reúne códigos curtos e links da Shopee enviados pelo grupo do Telegram, pela página pública da live e pela Página de Chat do bot.
- Cópia em lote: Copia de 1 a 100 links por lote. Depois de colar na live, você marca os produtos como adicionados.
- Extração do chat colado: Resolve códigos e links de um texto que você cola no painel. Permite copiar o resultado ou adicionar os produtos à fila.
- Página com sua marca: Recebe pedidos e mostra o acompanhamento de cada espectador. Tem personalização de cores, logo, banner e subdomínio próprio.
- Avisos para espectadores: Na página pública, o espectador acompanha quando o pedido foi adicionado. As notificações do navegador dependem da permissão dele e de um aparelho compatível.
- Overlay para OBS: Exibe foto, nome e preço estimado dos produtos marcados como adicionados recentemente, em uma faixa com fundo transparente.

1. Escolha o módulo: Entre no painel pela Central do Afiliado. Em Conta › Plano e módulos, selecione Shopee Live junto do plano base.
2. Prepare os pedidos: Em Promoções › Shopee Live, configure a página pública e as instruções para a audiência. Confira as contas de afiliado do bot.
3. Abra a fila: Use Abrir Live e divulgue a página para receber pedidos. Mantenha a tela da live aberta enquanto apresenta.
4. Leve os produtos à live: Use Copiar lote, cole os links na live da Shopee e só então marque Pronto. Para mostrar os itens no OBS, use a URL do overlay como Fonte de Navegador.

## Como a automação para Shopee Live organiza os pedidos?

Durante uma transmissão, a audiência pede produtos enquanto você apresenta outro item. O módulo transforma esses pedidos em uma fila por bot: o produto fica aguardando até que o apresentador o adicione. Assim, o pedido não depende de continuar visível entre as mensagens do grupo.

A fila reúne três entradas: grupos do Telegram onde o bot está, a página pública da live e a Página de Chat. No grupo, o código curto precisa ocupar a mensagem inteira; links de produtos também são aceitos. A captura usa mensagens de texto de membros, não legendas de fotos nem mensagens de administradores. Ela vale para os grupos do bot, sem seleção de um único grupo da live.

## O que continua nas mãos do apresentador?

A fila prepara os links, mas adicionar produtos à transmissão continua sendo uma ação sua. O lote copiado contém um link por linha, pronto para colar na live da Shopee. Marcar **Pronto** registra a conclusão e retira aqueles itens da espera; por isso, essa confirmação deve acompanhar o que você realmente adicionou.

O bot também não acompanha o chat da Shopee sozinho. Quando os pedidos estão lá, a área **Resolver do chat da live** recebe o texto colado manualmente e extrai códigos e links. Você pode apenas copiar os resultados ou colocá-los na fila. A [documentação da Shopee Live](/docs/telegram/shopee-live/) detalha os controles de operação e do overlay.

## Como o espectador acompanha o próprio pedido?

Na página pública, cada espectador vê **Meus pedidos**, com os estados de espera e de produto adicionado. Isso dá uma referência durante a transmissão: enviar um pedido significa entrar na fila, não que o item já esteja disponível na live. A página aceita novos pedidos apenas enquanto a live está aberta.

Os avisos de produto adicionado e de início da live dependem das opções escolhidas pelo espectador. Notificações fora da página exigem permissão do navegador e suporte do aparelho. A página pode usar sua logo, cores e banner e também funcionar em um subdomínio próprio. Ela complementa a transmissão com uma entrada organizada para os pedidos.

## O que aparece no OBS e nos links?

O overlay mostra os produtos que você marcou como adicionados recentemente. Ele usa os dados disponíveis de foto, nome e preço estimado; se faltar informação, pode exibir apenas o código. A faixa acompanha o estado da fila, por isso uma marcação antecipada faria a tela indicar um produto antes de ele estar na live.

Os links de afiliado usam as configurações do bot, descritas no [guia de integração com a Shopee](/docs/integracoes/shopee/). A geração pode falhar; nesse caso, o acesso pode seguir pelo link do produto sem comissão. Conferir a conta e os links antes da transmissão evita tratar qualquer resposta do bot como prova de atribuição. O módulo trabalha com a Shopee Brasil e não garante o preço final nem a comissão de uma compra.

## Quando a fila precisa de atenção?

Existe uma live por bot e a fila comporta até 500 produtos aguardando. Pedidos repetidos não ocupam várias posições enquanto o item está pendente. Depois de adicionado, ele pode retornar para uma nova apresentação. Manter a tela da live aberta também importa: a ausência prolongada de consultas encerra a captura automaticamente.

Shopee Live complementa o [plano base de conversão de links](/modulos/plano-base/) para uma rotina específica de transmissão. Quem só precisa converter um link para compartilhar pode continuar pelo fluxo comum do bot; a fila faz sentido quando há pedidos simultâneos a organizar e produtos a apresentar.

P: O bot coloca os produtos na Shopee Live sozinho?
R: Não. Ele organiza e resolve os pedidos; o apresentador copia os links e os cola na live da Shopee. Não há integração oficial com o sistema de lives da Shopee.
P: Ele lê o chat da Shopee automaticamente?
R: Não. Em Resolver do chat da live, você cola o texto manualmente. A captura automática de pedidos acontece nas entradas do Bot do Afiliado enquanto a live está aberta.
P: O que acontece se várias pessoas pedirem o mesmo produto?
R: Enquanto o produto estiver aguardando, ele não ocupa novas posições na fila. Um produto já adicionado pode voltar à fila, inclusive pelo botão Repor na fila.
P: Posso receber pedidos com a live fechada?
R: Não. A página pública recusa pedidos com a live offline. No grupo do Telegram, os links voltam ao fluxo normal de conversão.
P: Quem pede no grupo recebe aviso quando o produto entra?
R: Esse aviso é da página pública, não do grupo do Telegram. Notificações com a página fechada dependem de permissão e suporte do navegador; no iPhone, a página precisa estar na Tela de Início.
P: Preciso manter o painel aberto?
R: Sim, mantenha aberta a tela da live. Após cerca de dez minutos sem consultas dessa tela à fila, a live é encerrada automaticamente.
P: O preço do overlay é o preço final da compra?
R: Não. É uma estimativa baseada nos dados disponíveis do produto, incluindo o ajuste de Pix usado pelo sistema. O comprador precisa conferir o valor e as condições na Shopee.
P: O módulo funciona sem o plano base?
R: Não. Shopee Live é um módulo adicional ao plano base do Bot do Afiliado.

---

# MÓDULO: WhatsApp
URL: https://botdoafiliado.com/modulos/whatsapp/
Preço: R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, somado ao plano base (R$ 99/mês)
Descrição: Bot de ofertas para WhatsApp: repasse do Telegram para grupos e canais com link convertido. R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão extra.

O módulo WhatsApp leva os posts dos seus canais do Telegram para os seus grupos e canais de WhatsApp, com cada link já convertido no seu link de afiliado. Você paga por número conectado: grupos, canais e mensagens não entram na conta.

- Campanhas de repasse: Reúne fontes do Telegram, destinos e regras de conteúdo. Cada campanha define filtros, substituições e conversão de links.
- Fila com ritmo: Organiza os envios pelo ritmo da campanha e do número. O painel mostra o andamento e os motivos de falha ou descarte.
- Vários números por grupo: Números conectados e autorizados no mesmo grupo dividem os envios. Se um cair, outro disponível pode assumir.
- Entrada nos grupos: Um link da campanha distribui visitantes entre grupos com vaga. A criação automática do próximo grupo depende da configuração e de um número disponível.
- Acompanhamento de envios: A tela Envios reúne status e ações como Reenviar e Apagar para todos, quando aplicáveis. Incidentes indicam problemas nos grupos e na distribuição.
- Aquecimento do número: Usamos métodos próprios para realizar o aquecimento do seu número.

1. Mapeie as fontes: Separe os canais ou grupos do Telegram que alimentariam as campanhas. O bot precisa estar cadastrado e ser administrador dessas fontes.
2. Planeje números e destinos: Defina um número dedicado à operação e os grupos ou canais de WhatsApp onde ele pode publicar. A conexão usa aparelho vinculado.
3. Prepare as regras: Organize as fontes, os destinos e os filtros de cada campanha. Considere que os envios seguem uma fila com ritmo.
4. Contrate e conecte: Em Planos & Faturamento, escolha de 1 a 20 números. Depois, em Módulos › WhatsApp, conecte cada número por QR Code ou código de pareamento.

## Como funciona o bot de ofertas para WhatsApp?

O conteúdo parte de uma fonte do Telegram e passa por uma campanha, que reúne os destinos e suas regras. Um post novo recebido pelo bot é avaliado pelos filtros, tem o texto ajustado quando há substituições e segue para a fila.

Cadastrar uma fonte não inicia o repasse sozinho. Ela precisa estar ligada a uma campanha ativa, dentro do período definido, com destinos habilitados para receber ofertas. A [documentação de campanhas](/docs/whatsapp/criar-campanha/) explica essa organização. Se a origem for o [Postador do módulo Ofertas](/modulos/ofertas/), o envio para a campanha é escolhido no próprio Postador.

## Como o número se conecta e quais cuidados exige?

A conexão é feita como aparelho vinculado. O número continua associado ao celular do responsável, e a sessão pode precisar de novo pareamento quando cair. Não se trata da API oficial do WhatsApp Business. Um número dedicado ajuda a separar a rotina de ofertas do uso pessoal, mas não elimina a possibilidade de bloqueio pelo WhatsApp.

Conectar números, alterar campanhas e executar ações de envio são tarefas do dono ou de administradores da organização. Membros têm acesso de leitura. O [guia de conexão do WhatsApp](/docs/whatsapp/conectar-whatsapp/) descreve QR Code, código de pareamento e reconexão. A disponibilidade de um número deve ser acompanhada durante a operação, especialmente quando ele é o único apto a publicar em um grupo.

## O que a fila muda na entrega das ofertas?

Cada número tem um intervalo entre saídas, e a campanha também define seu ritmo. Por isso, grupos distintos podem receber a mesma oferta em momentos diferentes. Quando há vários números aptos no mesmo grupo, a fila considera a carga de cada um; se um desconectar, outro pode assumir. Em grupos onde só administradores publicam, o número precisa ter essa permissão.

Com a conversão de links ligada, uma falha impede que o post siga com a URL original. O motivo fica visível para correção. O estado **enviado** indica confirmação de envio, enquanto entrega e leitura dependem dos recibos do WhatsApp. Essa diferença importa para avaliar uma campanha: entrar na fila não significa chegar ao destinatário, e chegar não comprova leitura.

## Fotos, álbuns e edições chegam iguais?

Texto, foto, vídeo e outros formatos suportados passam por adaptações. Links escondidos atrás de palavras ficam visíveis como URLs. Um álbum leva somente a primeira mídia, então um post que depende de uma sequência de imagens precisa ser revisto antes de alimentar a campanha. Documentos não são repassados como arquivos, e enquetes não acompanham o espelho.

Edições de texto e de legenda de foto podem ser propagadas; trocar a mídia não substitui o arquivo no destino. **Apagar para todos** também tem prazo e depende do estado do envio. A referência de [mídia e formatação no WhatsApp](/docs/whatsapp/o-que-chega/) ajuda a escolher um formato que preserve a informação essencial da oferta.

## Como distribuir participantes entre os grupos?

O link de entrada pertence à campanha. A cada acesso, ele busca um grupo saudável, ativo e com vaga conforme as regras definidas. Quando a criação automática está configurada, o sistema pode abrir o próximo grupo e incluí-lo na distribuição, sem trocar o endereço divulgado. Sem condições para receber novos participantes, a campanha registra o problema.

Esse fluxo é diferente do envio de posts para canais de WhatsApp: canais recebem conteúdo, mas não entram nessa distribuição por convite. Os números de cliques também precisam ser interpretados com cuidado. Um clique não comprova que alguém entrou no grupo, e a atribuição de entrada no WhatsApp é provável. Os [incidentes e alertas](/docs/whatsapp/incidentes-e-alertas/) ajudam a acompanhar falhas operacionais sem confundir atividade com resultado.

P: Quanto custa o módulo WhatsApp?
R: R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, somado ao plano base. Grupos e canais são ilimitados por número, e posts, edições e reenvios não são contados.
P: A conexão usa a API oficial do WhatsApp Business?
R: Não. O número entra como aparelho vinculado, por QR Code ou código de pareamento, usando o mecanismo de conexão do WhatsApp Web.
P: Meu número pode ser bloqueado?
R: Pode. Não há garantia contra bloqueio ou limitação pelo WhatsApp, mesmo com os envios organizados em fila e com ritmo.
P: Preciso de um número separado?
R: É recomendado usar um número dedicado à operação. O celular continua sendo o dono da conta e precisa mantê-la ativa.
P: O módulo repassa o histórico do Telegram?
R: Não. O espelho trabalha com posts novos recebidos das fontes configuradas. Cadastrar um canal não importa suas publicações antigas.
P: O que acontece se um número desconectar?
R: Outro número disponível no mesmo grupo pode assumir os envios. Sem nenhum disponível, o envio falha e o motivo aparece no painel; as falhas não são reenviadas automaticamente após reconectar.
P: A quantidade é calculada por grupo ou por número?
R: Por número cadastrado, de 1 a 20 por organização, além do plano base. Um número pendente de pareamento ou offline também ocupa uma vaga.
P: Também funciona com canais de WhatsApp?
R: Canais podem receber posts quando o número tem permissão para publicar neles. Eles não participam do link de entrada que distribui visitantes entre grupos.

---

# MÓDULO: Sub-bots
URL: https://botdoafiliado.com/modulos/sub-bots/
Preço: grátis, incluído no plano base
Descrição: Vários bots de afiliado no mesmo painel, com nomes próprios no Telegram e as configurações do principal. Adicione tokens do BotFather sem refazer as rotas.

O módulo Sub-bots reúne vários bots de afiliado no mesmo painel para quem opera canais ou marcas com as mesmas contas de afiliado. Cada bot tem seu próprio @ no Telegram e reaproveita as rotas, mensagens, comandos e formatos do bot principal.

- Identidade no Telegram: Cada sub-bot usa um token e um @ próprios. Isso permite ter nomes diferentes para os canais ou marcas da mesma operação.
- Configuração compartilhada: Os sub-bots usam as mensagens, comandos, cupons, formatos, rotas e contas de afiliado do bot principal. Uma configuração atende os bots ligados a ele.
- Token validado no cadastro: Ao adicionar, o sistema consulta o Telegram para validar o token e identificar o @ do bot. Tokens inválidos ou já cadastrados são recusados.
- Conexão automática: O webhook, conexão que entrega as mensagens do Telegram ao sistema, é configurado ao cadastrar. O painel oferece Reativar webhook para reaplicar essa conexão.
- Gestão no painel: Consulte o último sinal de cada sub-bot, remova cadastros e aplique as permissões de administrador sugeridas. Os tokens são armazenados com criptografia.

1. Assine o plano base: O Sub-bots vem grátis com o plano base: entre pela Central do Afiliado e confira o base em Conta › Plano e módulos.
2. Crie outra identidade: No BotFather do Telegram, crie o bot que será adicionado e obtenha o token próprio dele. Defina um @ adequado ao canal ou à marca.
3. Cadastre o token: Abra Configuração › Configurações do bot › Gerenciar sub-bots. Cole o token e clique em Adicionar; o sistema identifica o @ e configura o webhook.
4. Confira o atendimento: Abra o sub-bot no Telegram e teste uma conversa. Se ele atuar em grupos, confira as permissões necessárias; a ação Permissões sugeridas ajuda a preparar o convite como administrador.

## Quando usar vários bots de afiliado no mesmo painel?

O módulo atende operações que precisam de nomes diferentes no Telegram e mantêm a mesma configuração de conversão. Uma marca pode ter um bot associado ao canal de tecnologia e outro ao canal de casa, por exemplo. Ambos usam as contas de afiliado, as rotas e os textos definidos no principal.

Esse é um exemplo ilustrativo: o que muda para o seguidor é a identidade do bot que ele abre. Para quem administra, o cadastro de mensagens, comandos e formatos continua compartilhado. A [documentação de Sub-bots](/docs/telegram/sub-bots/) descreve o vínculo entre essas identidades e o bot principal.

## O que muda e o que é compartilhado?

Token, @, conexão de recebimento e último sinal pertencem a cada sub-bot. Já os cupons, as contas de afiliado, os formatos de oferta e os comandos vêm do principal. Uma alteração nessa configuração compartilhada passa a ser usada pelos sub-bots ligados a ela, sem precisar repetir o ajuste para cada identidade.

Essa estrutura serve quando todos devem seguir a mesma operação. Se cada cliente precisa de integrações próprias, mensagens diferentes ou outra conta para receber a atribuição de afiliado, será preciso separar a configuração em outro bot. Os [conceitos de bot e organização](/docs/comecando/conceitos/) ajudam a escolher a divisão adequada antes de adicionar tokens.

## Como manter a identidade de cada marca?

Cada sub-bot nasce de um bot criado no BotFather e tem seu próprio token. Ao cadastrá-lo, o sistema valida esse token e identifica o @. Depois, as conversas recebidas por aquela identidade usam a configuração do principal. Isso evita repetir o trabalho de conectar lojas apenas para oferecer outro nome de entrada no Telegram.

Nome, foto, descrição e menu de comandos próprios do sub-bot são ajustados no BotFather. A edição de perfil e o botão de aplicar o menu no painel atuam sobre o principal. Já o texto das respostas aos comandos continua compartilhado. Essa diferença importa ao preparar a apresentação de cada marca: aparência no Telegram e conteúdo das respostas têm lugares distintos de configuração.

## Como ficam grupos, canais e o Postador?

Para atuar num grupo, o sub-bot precisa ter as permissões exigidas pelas ações que realizará. A opção de aplicar permissões sugeridas prepara o convite como administrador; confira também os direitos concedidos no grupo em uso. Com o [módulo Grupos](/modulos/grupos/), o Porteiro consulta a participação no canal pelo bot principal, que precisa ser administrador desse canal. O sub-bot atua como administrador do grupo.

O envio direto do Postador utiliza o bot principal. Ter apenas o sub-bot como administrador de um canal não basta para publicar ali por esse caminho. Para planejar a produção de posts e os destinos, a página do [módulo Ofertas](/modulos/ofertas/) explica o papel do Postador na operação.

## Como acompanhar um sub-bot que parou de responder?

A tabela de gerenciamento mostra o último sinal e oferece a ação Reativar webhook. Webhook é a conexão usada pelo Telegram para entregar mensagens ao sistema; reaplicá-la é uma das verificações possíveis quando um sub-bot deixa de atender. Também é necessário conferir se o token continua válido e se o módulo permanece ativo.

Tokens são credenciais de acesso ao bot e ficam armazenados com criptografia. A [documentação de segurança e tokens](/docs/referencia/seguranca-e-tokens/) explica os cuidados com esse acesso. O gerenciamento fica com o dono e administradores da organização. Se a operação também utiliza ofertas, cupons e integração por IA, o [Combo Operação Completa](/combos/operacao-completa/) inclui Sub-bots entre os módulos reunidos.

P: Cada sub-bot pode usar uma conta de afiliado diferente?
R: Não. As contas e rotas são as do bot principal. Para separar clientes com contas próprias, é necessário outro bot com configuração independente ou outra organização, conforme a operação.
P: Posso cadastrar o mesmo token duas vezes?
R: Não. Cada token só pode estar ligado a um bot ou sub-bot por vez. A mensagem Token já cadastrado indica que ele está em uso.
P: Preciso informar o nome e configurar o webhook à mão?
R: No cadastro por Gerenciar sub-bots, o @ é identificado pelo token e o webhook é configurado automaticamente. O botão Reativar webhook permite reaplicar a conexão depois.
P: O Postador publica usando o sub-bot?
R: O envio direto do Postador sai pelo bot principal. Para publicar num canal por esse caminho, confira as permissões do principal naquele canal.
P: O painel altera a foto e o menu de comandos de cada sub-bot?
R: A edição de perfil e a aplicação do menu de comandos pelo painel usam o bot principal. Nome, foto, descrição e menu próprio do sub-bot são ajustados pelo BotFather.
P: O que acontece ao desativar o módulo?
R: Os sub-bots param de atender, mas seus cadastros não são apagados pela cobrança. O funcionamento do bot principal continua sujeito ao plano base e aos módulos que permanecerem ativos.
P: A cobrança é por sub-bot adicionado?
R: Não. Sub-bots vem grátis com o plano base, sem cobrança por sub-bot adicionado.

---

# MÓDULO: Tracking por usuário
URL: https://botdoafiliado.com/modulos/tracking-por-usuario/
Preço: R$ 49,90/mês, somado ao plano base (R$ 99/mês)
Descrição: Sub ID por divulgador nos links de afiliado: cada postador da sua equipe gera link com o próprio código por marketplace, e você vê as vendas de cada um.

Sub ID por divulgador é um código aplicado aos links de cada pessoa que posta por você, para afiliados que trabalham com equipe ou com membros de uma comunidade. O módulo Tracking por usuário guarda esses códigos por marketplace e aplica o de quem gerou o link: no Telegram, no painel, no Postador e na extensão.

- Colaborador postador: Convide a pessoa para o bot com o papel Postador e defina o código dela em cada loja, em Configurar › Colaboradores. Tudo o que ela gera no painel, no Postador ou na extensão do Chrome sai com o código dela, sem escolher nada.
- Código por usuário do Telegram: Associa campos de rastreio ao usuário do Telegram em cada marketplace compatível. O cadastro exige que a pessoa já tenha iniciado conversa privada com o bot. Um postador vinculado ao Telegram usa o mesmo código nos dois lugares.
- Campos de cada rede: Trabalha com sub_id, clickref, u1, sa, trackingId, tag ou etiqueta, conforme a integração. Awin e CityAds permitem campos adicionais por pessoa.
- Vendas por colaborador: Com as vendas importadas do Painel do Afiliado, o Bot soma pedidos e comissão de cada colaborador pelo código que veio na venda.
- Conversão por integração: API e ferramentas MCP compatíveis aceitam a identificação do usuário para gerar o link com seu rastreio. Cada integração mantém seus requisitos de acesso.

1. Ative o módulo: Em Conta › Plano e módulos, ative o Tracking por usuário. Sem ele, todo link sai com o rastreio padrão da conta.
2. Convide quem posta: Em Organização, aba Bot e membros, convide cada pessoa com o papel Postador. Postador gera link, oferta e cupom, sem acesso à configuração do bot.
3. Defina o código de cada um: Em Configurar › Colaboradores, preencha o código de cada pessoa por loja. No AliExpress, use trackingIds já criados no portal da rede.
4. Acompanhe as vendas: Vincule o Painel do Afiliado para importar as vendas. Na mesma tela, as vendas e a comissão aparecem por colaborador, em 7, 30 ou 90 dias.

## O que muda com um sub ID por divulgador?

Uma conta de afiliado pode ser usada numa operação com várias pessoas divulgando produtos. Quando todos geram links com o mesmo código de rastreio, esse campo não distingue a contribuição de cada divulgador. O Tracking por usuário associa um código à pessoa que gera o link e ao marketplace utilizado.

Em um exemplo fictício, uma pessoa usa o código `equipe-a` e outra usa `equipe-b`. Os links gerados por cada uma carregam o valor correspondente, onde a integração permite. O [guia de conceitos do Bot](/docs/comecando/conceitos/) explica a diferença entre conta, rota e tracking.

## Quais campos são usados em cada integração?

As redes usam nomes diferentes para o campo de rastreio. O módulo segue o formato de cada integração, por isso vale planejar os códigos considerando onde você consultará os resultados.

| Integração | Campo aplicado ao link |
| --- | --- |
| Shopee | Primeiro `sub_id` para o código da pessoa |
| Awin | `clickref`, com campos adicionais até `clickref6` |
| Rakuten | `u1` |
| CityAds | `sa`, com campos adicionais até `sa5` |
| AliExpress | `trackingId` previamente criado |
| Amazon | `tag`, a partir do `partnerTag` cadastrado |
| Mercado Livre | Etiqueta de afiliado |

Na Awin e na CityAds, campos adicionais permitem combinar informações, como pessoa e grupo, no link. O que aparece no relatório depende das regras da rede. No AliExpress, o valor precisa existir antes e ser conhecido pelo bot. Na Shopee, este fluxo aplica apenas um sub ID personalizado; os campos extras não devem entrar no planejamento como códigos disponíveis.

## Como funciona o colaborador postador?

O dono do bot convida a pessoa com o papel Postador. Ela entra no painel e gera link, oferta e cupom, sem acesso à configuração. Em Configurar › Colaboradores, o dono define o código dela em cada loja. A partir daí, o Gerar link, o Postador e a extensão do Chrome usam esse código automaticamente para ela; ela não escolhe outro.

Se o postador também usa o bot no Telegram, vincule o usuário do Telegram dele na mesma tela. O código passa a valer quando ele manda o link direto para o bot. Admins convidados seguem o mesmo caminho e ainda podem usar a opção Gerar como usuário.

## Quem pode receber um código pelo Telegram?

O cadastro pelo Telegram é vinculado ao usuário que já iniciou uma conversa privada com o bot. Um nome visível no grupo, por si só, não basta. Essa configuração fica na edição da conta em Configurar › Lojas, na seção Tracking por usuário, para marketplaces compatíveis.

O código é consultado quando a conversão identifica quem pediu o link. Isso inclui mensagens no privado e mensagens de membros no grupo; administradores do grupo são ignorados nesse último caminho. Quem não tem valor cadastrado mantém o rastreio padrão da conta.

## Como o tracking entra em posts e integrações?

No Postador, o dono e os admins têm a opção Gerar como usuário para preparar a oferta com o rastreio da pessoa escolhida. Esse uso também depende do [módulo Ofertas](/modulos/ofertas/). O teste de URL das rotas aceita a identificação do usuário para conferir o link resultante antes da divulgação; os detalhes estão na [documentação de plugins e rotas](/docs/integracoes/como-funcionam/).

A [API de links](/modulos/api-de-links/) e a [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/) são duas formas de usar o mesmo módulo de integração. Nas operações compatíveis, a identificação do usuário acompanha o pedido de conversão. Esse campo informa de quem é o rastreio a aplicar; o acesso à integração continua dependendo da autenticação e das permissões correspondentes.

## Onde consultar os resultados e quais são os limites?

Com as vendas importadas do Painel do Afiliado, Configurar › Colaboradores mostra pedidos e comissão de cada colaborador: a venda conta para quem tem o código que veio no sub_id dela, naquela loja. Os cliques de cada código ficam nos relatórios da rede, como o relatório por Sub ID da Shopee e o de etiquetas do Mercado Livre. O Bot não confirma uma compra só porque o link foi gerado.

Também é necessário conferir a cobertura antes de planejar o uso: Magalu, Pague Menos, Braé, Beleza na Web, Natura e Terabyte não têm tracking por usuário.

P: Já posso contratar Tracking por usuário?
R: Sim. O módulo custa R$ 49,90 por mês, somado ao plano base, e é ativado em Conta › Plano e módulos.
P: O postador consegue gerar link com o código de outra pessoa?
R: Não. Quem tem o papel Postador gera sempre com o próprio código. O dono e os admins podem usar a opção Gerar como usuário no Postador para preparar uma oferta com o código de alguém.
P: Sub ID identifica o divulgador ou quem comprou?
R: Neste módulo, o código é associado à pessoa que gera o link. Ele identifica a origem da divulgação; não é um cadastro de compradores.
P: O postador precisa ter Telegram?
R: Não. O código dele vale no painel, no Postador e na extensão. Se você vincular o Telegram dele, o mesmo código vale também quando ele manda o link direto para o bot.
P: O que acontece com quem não tem um código próprio?
R: A conversão continua usando o rastreio padrão da conta. Um código por pessoa é uma configuração específica para quem você precisa distinguir.
P: Posso inventar um trackingId para o AliExpress?
R: Não. O trackingId precisa ter sido criado no portal do AliExpress e estar entre os valores conhecidos pelo bot, como o padrão de uma conta ou um valor já cadastrado.
P: Quantos sub IDs personalizados entram no link da Shopee?
R: O código da pessoa ocupa o primeiro sub_id. O segundo é reservado ao identificador do Bot do Afiliado; campos adicionais de sub_id não são aplicados por esse fluxo.
P: O recurso atende Magalu e Natura?
R: Não. Magalu, Natura, Pague Menos, Braé, Beleza na Web e Terabyte não têm suporte a tracking por usuário.
P: O Bot mostra as vendas de cada divulgador?
R: Mostra as vendas e a comissão de cada colaborador quando as vendas vêm do Painel do Afiliado e o código dele aparece no sub_id da venda. Os cliques de cada código ficam no relatório da própria rede, como o relatório por Sub ID da Shopee.

---

# MÓDULO: Puxador
URL: https://botdoafiliado.com/modulos/puxador/
Preço: R$ 99,90/mês, somado ao plano base (R$ 99/mês)
Descrição: Monitorar canais de promoções no Telegram com o Puxador: as ofertas chegam com os seus links de afiliado e no formato do seu /oferta, para aprovar e repostar.

Para monitorar canais de promoções no Telegram, o Puxador lê os canais que a sua conta acompanha, troca os links pelos seus de afiliado e entrega cada oferta numa fila de aprovação. Você escolhe se sai o texto do canal ou o formato do seu /oferta, com a mesma foto, e para qual canal ela vai.

- Fontes escolhidas por você: Acompanha canais cadastrados e ativos dos quais sua conta do Telegram participa. A captura roda no servidor.
- Conversão dos links: Usa as Rotas e os Plugins do seu bot para gerar os links de afiliado. Remove do texto convites e menções do canal de origem.
- Fila de aprovação: Entrega cards no grupo de aprovação do Telegram e em Promoções › Puxador. Você aprova, descarta ou corrige antes de publicar.
- Conversor ou Loja: Publica o texto do canal só com os links trocados, ou monta o post como o seu /oferta: título do produto, o seu formato e a mesma foto em grade com a sua marca d'água. A fila já mostra a versão escolhida, e dá para trocar em cada card.
- Destino por palavra-chave: Manda a oferta para um canal pelo título do produto, por palavras do texto, pela quantidade de links ou quando o post é de cupom. Também aplica formatação, substituições e palavras de descarte por origem.
- Post de cupom: Reconhece o post de cupom pelo código e pela falta de preço de produto: ganha selo na fila, pode ir para um canal próprio e, ao aprovar, o código entra no módulo Cupons.
- Correção com prévia: A correção com IA prepara um rascunho sem alterar links. Sugestões de regra só passam a valer depois da sua confirmação.
- Já publicado no destino: Barra por duas horas a oferta cujo link ou produto (ASIN, item da Shopee e outros) já saiu no mesmo canal, inclusive em post feito à mão. Preço menor passa. Edição na origem e envio incerto também pedem sua decisão.

1. Ative o módulo: Em Conta › Plano e módulos, marque o Puxador e conclua o checkout. Ele soma ao plano base e às Rotas e Plugins de afiliado que o bot já usa.
2. Conecte a conta do Telegram: Em Promoções › Puxador › Configuração, faça o login guiado com telefone, código e, se houver, a senha de duas etapas. Considere antes o risco de limitação pelo Telegram.
3. Escolha fontes e destinos: Cadastre os canais de origem dos quais a sua conta participa, o grupo de aprovação e o canal de destino. Regras por palavra-chave mandam cada assunto para o canal certo.
4. Aprove e publique: As ofertas chegam já convertidas na aba Aprovação e no grupo do Telegram. Escolha Conversor ou Loja em cada card, aprove, corrija ou descarte.

## Como monitorar canais de promoções no Telegram com revisão?

O Puxador separa a captura da decisão de publicar. Sua conta acompanha os canais cadastrados, e as ofertas recebidas passam pela conversão de links e pelas regras de texto. O resultado chega a uma fila de aprovação, onde você decide o que merece ir para o seu canal.

Ele usa os canais escolhidos como origem e precisa que a conta conectada participe deles. A proposta é reduzir o trabalho repetido de preparar uma oferta, mantendo a curadoria com um responsável. O [guia do Puxador](/docs/telegram/userbot/) descreve cada tela.

Na fila, cada oferta pode sair de dois jeitos. **Conversor** publica o texto e a foto do canal, só com os links trocados pelos seus. **Loja** monta o post como o seu `/oferta`: título do produto, o seu [formato das ofertas](/modulos/ofertas/) e a mesma foto em grade, com a sua marca d'água. Dá para combinar texto de um e foto do outro em cada card.

## O que precisa estar certo antes de aprovar?

Uma oferta pronta para revisão ainda exige conferir produto, preço, cupom, mídia e destino. Os links são gerados pelas mesmas Rotas e pelos mesmos Plugins do [plano base](/modulos/plano-base/). Isso evita cadastrar contas de afiliado novamente para cada fonte, mas também significa que uma configuração incompleta pode impedir a conversão.

É possível revisar pelo grupo de aprovação do Telegram ou pela aba **Aprovação** em **Promoções › Puxador**. A pré-aprovação antecipa sua decisão enquanto os links são gerados; quando essa etapa termina, o post pode sair sem outro clique. Portanto, ela deve ser usada somente quando você já decidiu publicar aquela oferta. Se nenhuma conversão produzir link de afiliado, a falha fica disponível para análise.

## Como as regras escolhem o destino?

Cada canal de origem pode ter ajustes próprios de formatação, trocas de texto e palavras que descartam mensagens. As regras de destino olham o título do produto, palavras do texto, a quantidade de links ou se o post é de cupom. Uma regra `rtx, placa de video` no título manda a oferta para o canal de hardware; a regra de cupom separa os posts de cupom num canal próprio. Vale a primeira regra compatível na ordem definida; sem correspondência, o sistema considera o destino da origem e depois o destino padrão.

Essa organização permite separar assuntos sem criar um processo de revisão diferente para cada nicho. O destino calculado aparece antes da aprovação. Com a opção correspondente ligada, a oferta aprovada também pode entrar na [Vitrine pública do bot](/docs/comecando/vitrine/), reaproveitando os dados do post. Nenhuma dessas regras substitui a decisão humana sobre a publicação.

## O que acontece com post de cupom?

Post com código de cupom e sem preço de produto chega com o selo **Cupom** e a lista dos códigos. Ele não tenta virar produto com os dados da loja. Com o módulo [Cupons](/modulos/cupons/) e a opção ligada, o código aprovado entra na lista de cupons da loja, com o seu link e validade de 7 dias; código que já existe não é repetido.

## O que acontece com repetição, edição ou envio incerto?

No mesmo destino, o link ou o produto publicado nas últimas duas horas bloqueia uma repetição, inclusive quando o post foi feito à mão no canal. O produto é reconhecido pela chave da loja (o ASIN da Amazon, o item da Shopee e assim por diante), mesmo que o link venha de outro canal ou outro encurtador. Preço novo menor não conta como repetição. Existe confirmação para publicar novamente depois de um envio concluído, mas ela não libera uma publicação que ainda esteja em andamento ou sem confirmação. Isso evita que uma dúvida sobre a entrega seja tratada como permissão para repetir o post.

Se a origem editar uma oferta pendente, o card é atualizado. Quando a oferta já está publicada, você escolhe se atualiza o destino ou mantém o texto. Uma exclusão na origem gera aviso para revisar a validade do que já saiu. Envios incertos também ficam visíveis e pedem conferência, sem repetição automática. São situações diferentes, cada uma com uma decisão operacional própria.

## Que acesso o Puxador pede à conta?

A sessão conectada dá acesso à sua conta do Telegram, embora o Puxador processe apenas os canais cadastrados e ativos. Código e senha de login não ficam guardados; a sessão é armazenada criptografada e pode ser apagada ao desconectar. Ainda assim, esse acesso merece avaliação antes de usar a conta principal, e o Telegram pode limitar contas que usam automação.

Quem também usa [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/) pode consultar configurações e preparar regras pelas ferramentas do Puxador, conforme as permissões do bot. Configurar por IA não elimina a revisão das ofertas nem transforma o recurso em publicação sem aprovação.

P: Já posso contratar o Puxador?
R: Sim. O módulo custa R$ 99,90 por mês, somado ao plano base, e é ativado em Conta › Plano e módulos.
P: O post sai igual ao do canal de origem?
R: Você escolhe. Conversor mantém o texto e a foto do canal, só com os seus links. Loja monta como o seu /oferta: título do produto, o seu formato e a mesma foto em grade com a sua marca d'água. O preço e o cupom continuam os do canal, porque a loja costuma devolver o preço de tabela.
P: E se a oferta já saiu no meu canal?
R: Ela chega com o selo Já postado e a hora em que saiu. O Puxador compara o link e o produto no mesmo destino nas últimas duas horas (ou na janela que você escolher, de 30 minutos a 24 horas), inclusive posts feitos à mão no canal. Se o preço novo for menor, não conta como repetida. Você escolhe se ela fica marcada na fila, com Postar mesmo assim, ou se sai da fila sozinha.
P: Vai algo ao ar sem minha aprovação?
R: Não. Aprovar ou pré-aprovar é uma decisão sua. Na pré-aprovação, o envio ocorre quando a conversão termina, usando a autorização que você já deu.
P: O Puxador tem acesso à minha conta inteira?
R: A sessão dá acesso à conta do Telegram. O processamento do Puxador fica restrito aos canais que você cadastrou e manteve ativos; isso não torna a sessão uma credencial limitada a esses canais.
P: Preciso passar meu código ou senha para o suporte?
R: Não. O login guiado acontece no painel com telefone, código e senha de duas etapas, se houver. Não envie essas informações ao suporte.
P: Posso ter a conta limitada pelo Telegram?
R: Sim. O uso de automação em uma conta de usuário pode levar a limitações pelo Telegram. Essa possibilidade deve ser considerada antes de conectar sua conta.
P: Preciso deixar o computador ligado?
R: Não. A captura roda no servidor, usando a sessão conectada da sua conta.
P: Dá para buscar publicações anteriores?
R: O comando /puxar permite a um administrador buscar mensagens recentes de um canal ativo no Puxador. O máximo é 100 por busca; ele não importa todo o histórico do canal.
P: A IA aplica correções sozinha?
R: Não. Ela prepara um rascunho que você pode revisar. Uma regra sugerida só é aplicada ao canal depois da sua confirmação, e a correção não pode trocar os links.

---

# MÓDULO: Rastreamento de vendas avançado
URL: https://botdoafiliado.com/modulos/rastreamento-avancado/
Preço: em breve, fora do checkout público (previsto: R$ 99/mês)
Descrição: Saiba de qual grupo veio cada clique e case a venda importada do Painel do Afiliado com ele. Conheça o funcionamento e os limites: contratação em breve.

O Rastreamento de vendas avançado conta o clique de cada oferta por grupo e, com as vendas importadas do Painel do Afiliado, liga a venda ao clique que a originou. É para quem precisa saber qual grupo vende, e não só qual grupo recebe mais posts. A contratação ainda não está liberada.

- Clique por grupo: Os links das campanhas saem pelo ofertou.ai ou pela página da oferta e registram de qual grupo ou canal veio cada clique.
- Identificador do clique no link: Na Shopee e em redes como Awin, Rakuten e CityAds, o identificador do clique vai junto no link de afiliado, no campo que a loja devolve no relatório.
- Venda ligada ao clique: Com as vendas importadas do Painel do Afiliado, a venda cujo sub-id traz o identificador do clique é exata. Sem ele, o casamento por produto e janela de 72 horas é marcado como provável.
- Pedidos e comissão por campanha: A atribuição mostra pedidos distintos, comissão estimada e taxa de conversão, com filtro de status e os produtos e Sub IDs que mais venderam.

1. Importe as vendas: As vendas chegam pelo Painel do Afiliado. Sem uma importação concluída, os cartões de vendas aparecem como indisponíveis, não como zero.
2. Publique pelas campanhas: Os posts precisam sair por uma campanha, para que o link carregue o grupo ou canal de origem. Link direto da loja colado à mão não registra o clique.
3. Confira as lojas: A venda exata depende de a loja devolver o identificador do clique no sub-id. Nas outras, a atribuição fica provável ou sem origem.
4. Acompanhe a disponibilidade: O módulo ainda não aparece para contratação em Planos & Faturamento. Sem ele, os botões da página da oferta levam direto ao link do post.

## O que o rastreamento avançado mede?

Quem posta a mesma oferta em vários grupos costuma ver as vendas chegarem no relatório da loja sem saber de onde vieram. O Rastreamento de vendas avançado resolve a primeira metade disso no Bot: cada link publicado por uma campanha passa pelo ofertou.ai ou pela página da oferta, e o clique fica registrado com o grupo ou canal de origem.

A segunda metade vem das vendas. Com as vendas importadas do [Painel do Afiliado](https://paineldoafiliado.com), o Bot procura, em cada venda, o identificador do clique que foi junto no link. Quando ele aparece no sub-id, a venda é ligada àquele clique e, por ele, ao grupo. A [referência de atribuição](/docs/referencia/atribuicao-campanhas/) descreve cada regra.

## Exata, provável ou sem origem

A venda é **exata** quando o identificador do clique volta no sub-id do relatório da loja. Isso acontece na Shopee e nas redes que aceitam o parâmetro no link, como Awin, Rakuten e CityAds.

Quando o identificador não volta, o Bot tenta o casamento por produto dentro de 72 horas do clique. Essa ligação é **provável**: depende de um clique registrado e pode errar. Com mais de uma campanha concorrendo pelo mesmo grupo, a venda fica **sem origem** em vez de ser creditada a uma delas. Links diretos da loja, colados sem passar pela campanha, não geram clique e por isso não entram nessa conta.

## O que aparece no painel

A atribuição mostra pedidos distintos, comissão estimada e taxa de conversão, com filtro de status e os cinco produtos e Sub IDs que mais venderam. Um pedido com vários itens conta uma vez no total; a comissão soma os itens pendentes e confirmados, sem os cancelados. "Concluído" quer dizer confirmado na importação, não que a comissão já foi paga.

A taxa de conversão divide pedidos válidos por cliques registrados no período. Como ela compara atividades, e não as mesmas pessoas do clique até a compra, pode passar de 100%. Sem cliques no período, ela fica indisponível.

## Limites antes de contar com o módulo

O módulo ainda não está à venda: o preço previsto é R$ 99 por mês, somado ao plano base, e a contratação não aparece no painel. Sem ele, as ofertas saem normalmente e os botões da página da oferta levam direto ao link do post.

Mesmo com o módulo, nenhum sinal sozinho prova qual anúncio trouxe o comprador. Registros antigos já classificados não são recalculados, e custos de mídia ainda não entram na conta. O [Tracking por usuário](/modulos/tracking-por-usuario/) é outra coisa: ele separa os links por divulgador, não liga venda a grupo.

P: Já posso contratar o Rastreamento de vendas avançado?
R: Ainda não. O módulo está em breve, com preço previsto de R$ 99 por mês, e não aparece para contratação no painel.
P: Preciso do Painel do Afiliado?
R: Sim, para ver vendas. O Bot conta o clique; a venda vem da importação do Painel do Afiliado. Sem importação concluída, os cartões de vendas ficam indisponíveis.
P: Toda venda fica ligada a um grupo?
R: Não. A venda é exata quando a loja devolve o identificador do clique no sub-id. Sem isso, o casamento por produto e janela de 72 horas é provável, e com campanhas concorrentes a venda fica sem origem.
P: Um clique registrado prova que a pessoa comprou?
R: Não. O clique mostra o acesso ao link. Só a venda importada, casada com esse clique, indica o resultado; nenhum sinal sozinho confirma qual anúncio trouxe o comprador.
P: O que acontece sem o módulo?
R: As ofertas continuam saindo normalmente, e os botões da página da oferta levam direto ao link do post, sem passar pela contagem do clique.
P: A taxa de conversão pode passar de 100%?
R: Pode. Ela divide pedidos válidos por cliques registrados no período e compara atividades, sem acompanhar as mesmas pessoas do clique até a compra.

---

# MÓDULO: Alertas
URL: https://botdoafiliado.com/modulos/alertas/
Preço: R$ 49/mês, somado ao plano base (R$ 99/mês)
Descrição: Seus seguidores dizem o que procuram na sua vitrine e recebem um aviso no celular quando você posta a oferta. R$ 49 por mês, somados ao plano base.

O módulo Alertas deixa quem visita a sua vitrine criar alertas como "air fryer" ou "iphone 15 -usado", com preço máximo se quiser. Quando você posta uma oferta que casa com o pedido, o seguidor recebe uma notificação no navegador ou no app instalado da vitrine.

- Regras simples: Palavras separadas por espaço precisam aparecer todas; o sinal de menos exclui ("-usado"); a vírgula aceita alternativas ("ps5, xbox"). Acentos e plural não atrapalham.
- Preço máximo: Cada alerta pode ter um teto. Quando o preço do post é lido e passa do teto, o seguidor não é avisado.
- Não perturbe: O seguidor escolhe um horário sem notificação. A oferta casada nesse horário vai para a lista de recebidos sem tocar o celular.
- Recebidos: As ofertas que casaram com os alertas ficam na lista de recebidos por 14 dias, mesmo quando a notificação não chegou.

1. Ative o módulo: Com o módulo ativo, a vitrine passa a mostrar a área de alertas. Sem ele, nada muda para quem visita.
2. Publique como sempre: Toda oferta nova da vitrine é comparada com os alertas dos seguidores. Não há post separado para quem tem alerta.
3. O seguidor permite as notificações: O aviso depende de o seguidor permitir notificações no navegador ou instalar a vitrine como app. Sem a permissão, a oferta fica só nos recebidos.
4. Acompanhe os pedidos: O painel mostra quantos seguidores têm alerta e o que eles mais procuram, para guiar o que vale postar.

## O que o Alertas faz?

Uma vitrine com muitas ofertas por dia esconde o produto que cada pessoa procura. Com o Alertas, quem visita a sua vitrine escreve o que quer, por exemplo "air fryer" ou "iphone 15 -usado", e pode pôr um preço máximo. Quando você posta uma oferta que casa com o pedido, o Bot avisa aquele seguidor por notificação.

## Como a regra casa com a oferta

O Bot compara o alerta com o título, a chamada, o cupom e o texto do post. Todas as palavras precisam aparecer, inteiras; acentos e plural não contam. O sinal de menos tira a oferta ("-usado"), e a vírgula separa alternativas ("ps5, xbox series"). Cada oferta avisa cada seguidor uma vez só, mesmo que case com mais de um alerta dele.

## Limites antes de contar com o módulo

O módulo custa R$ 49 por mês, somado ao plano base. O aviso é só por notificação no navegador ou no app instalado da vitrine; não há envio por Telegram ou WhatsApp. A entrega da notificação depende do aparelho do seguidor e não é garantida, por isso as ofertas casadas também ficam na lista de recebidos por 14 dias.

P: Já posso contratar o Alertas?
R: Sim. No painel, abra Conta › Plano e módulos e marque Alertas: são R$ 49 por mês, somados ao plano base.
P: O aviso chega pelo Telegram ou WhatsApp?
R: Não. O Alertas funciona só no navegador e no app instalado da vitrine, por notificação. Ele não manda mensagem em Telegram nem WhatsApp.
P: O seguidor precisa criar conta?
R: Não. Os alertas ficam ligados ao aparelho. Quem troca de celular ou limpa os dados do navegador começa uma lista nova.
P: A notificação sempre chega?
R: Não há garantia. Ela depende da permissão do seguidor, do navegador e do sistema do celular, que pode adiar ou bloquear avisos. A oferta casada fica nos recebidos de qualquer forma.
P: Quantos alertas cada seguidor pode ter?
R: Até 40, cada um com até 5 alternativas separadas por vírgula.

---

# MÓDULO: Histórico de Preços
URL: https://botdoafiliado.com/modulos/historico-de-precos/
Preço: em breve, fora do checkout público (previsto: R$ 499/mês)
Descrição: Mostre na página de cada oferta o histórico de 90 dias do preço na loja e o menor preço já registrado, e consulte pelo Claude e pelo ChatGPT. Contratação em breve.

O módulo Histórico de Preços põe na página de cada oferta da sua vitrine o gráfico dos últimos 90 dias do preço na loja e o menor preço já registrado, e leva a mesma informação ao alerta. No Claude e no ChatGPT, o conector do Bot consulta o histórico de um produto. O acesso é limitado de propósito: não há API. A contratação ainda não está liberada.

- Gráfico de 90 dias na oferta: A página de cada oferta da vitrine mostra a variação do preço na loja nos últimos 90 dias, com o menor, o maior e a média do período.
- Menor preço já registrado: Quando o preço do post é o menor do histórico, a oferta ganha o selo Menor preço no card da vitrine e a frase na página.
- Histórico no alerta: O aviso que o seguidor recebe leva uma linha com o veredito do preço: menor já registrado, menor do período ou a média.
- Consulta pela IA: No Claude e no ChatGPT, o conector do Bot devolve o histórico do produto de um link, junto com os posts que você já fez dele.

1. Publique pela vitrine: O histórico é lido uma vez, quando a oferta entra na vitrine. Ofertas publicadas antes do módulo ficam sem o gráfico.
2. Use o link do produto: O histórico é do produto, achado pelo link da loja. Post de cupom, sem produto, não tem histórico.
3. Conecte o Claude ou o ChatGPT: A consulta pela IA vale pelo conector oficial com login, no aplicativo do Claude ou do ChatGPT. Por chave de API não há histórico de preço.
4. Respeite o limite: São 10 consultas por minuto e 20 por dia por bot. Acima disso a resposta traz só os seus posts e diz quando o limite volta.

## O que o módulo mostra

Quem recebe uma oferta quer saber se o preço é bom mesmo. O Histórico de Preços responde com dado: a página da oferta na sua vitrine ganha o gráfico do preço do produto na loja nos últimos 90 dias, o menor, o maior e a média do período, e o menor preço já registrado para aquele produto.

Quando o preço do seu post empata ou fica abaixo do menor do histórico, o card da vitrine leva o selo **Menor preço**. Os preços dos seus posts anteriores do mesmo produto entram no mesmo gráfico: no dia em que você postou, vale o menor entre o preço da loja e o do post, que pode ter cupom.

## No alerta

Com o módulo [Alertas](/modulos/alertas/), o aviso que o seguidor recebe leva uma linha do histórico: "Menor preço já registrado", "Menor preço dos últimos 90 dias" ou o menor e a média do período.

## No Claude e no ChatGPT

O conector do Bot ([Conexão IA e MCP](/modulos/conexao-ia-e-mcp/)) devolve o histórico quando você pede os detalhes de um produto. A consulta vale quando feita pelo aplicativo do Claude ou do ChatGPT, com login. O limite é de 10 consultas por minuto e 20 por dia por bot. Acima disso a resposta não dá erro: traz os seus posts e diz quando o histórico volta.

## Limites antes de contar com o módulo

O módulo ainda não está à venda: o preço previsto é R$ 499 por mês, somado ao plano base, e a contratação não aparece no painel.

Não existe acesso por API nem por script. Chamadas com chave de API, mesmo de quem tem o módulo, não trazem histórico de preço: o campo vem vazio. O histórico é lido uma vez, quando a oferta entra: a página mostra o histórico daquele momento, e ofertas antigas ficam sem o gráfico. Produto que a base de preços ainda não conhece sai sem histórico.

P: Já posso contratar o Histórico de Preços?
R: Ainda não. O módulo está em breve, com preço previsto de R$ 499 por mês, somado ao plano base, e não aparece para contratação no painel.
P: Tem acesso por API?
R: Não. O histórico aparece na sua vitrine e nas consultas feitas pelo Claude e pelo ChatGPT com login. Chamadas por chave de API não trazem histórico de preço nenhum.
P: Quais são os limites de uso?
R: Pela IA, 10 consultas por minuto e 20 por dia por bot. Ao passar do limite, a resposta traz só os posts da vitrine e informa quando o histórico volta. A vitrine não entra nesse limite.
P: De quanto tempo é o histórico?
R: Dos últimos 90 dias, com um ponto por dia, além do menor preço já registrado para o produto, mesmo que seja mais antigo.
P: E se o produto não tiver histórico?
R: A oferta sai normalmente, sem o gráfico. Se você já postou o mesmo produto antes, os preços dos seus posts aparecem no lugar.
P: O que aparece sem o módulo?
R: Só os preços dos seus próprios posts do mesmo produto, quando há pelo menos dois dias com preço. O histórico da loja fica de fora.

---

# COMBO: Combo Grupo de Ofertas
URL: https://botdoafiliado.com/combos/grupo-de-ofertas/
Módulos: Plano base (R$ 99/mês) + Ofertas (grátis, incluído no plano base) + Grupos (R$ 49/mês)
Total: R$ 148/mês (soma dos módulos; não é um pacote com desconto)
Descrição: Para automatizar grupo de ofertas no Telegram, reúna conversão de links, Postador e moderação. Entenda como Base, Ofertas e Grupos dividem a operação.
O combo para automatizar grupo de ofertas no Telegram reúne Base, Ofertas e Grupos para quem publica e modera no mesmo espaço. Você prepara os posts no painel e define as regras para as mensagens dos membros.

- Converta com suas contas: O plano base usa as Rotas e os Plugins do bot para gerar links de afiliado. Trocar o link do membro pelo seu e apagar o convite de outro grupo já fazem parte dessa base.
- Prepare e publique a oferta: No Postador do módulo Ofertas, revise texto, imagem e preço antes de enviar ao grupo autorizado como destino.
- Modere a participação: O módulo Grupos acrescenta Porteiro de canal, anti-spam de bots, reputação e comandos personalizados.

## Como automatizar grupo de ofertas no Telegram?

Um grupo de ofertas tem duas rotinas: as publicações que você prepara e as mensagens que os membros enviam. O combo atende às duas. O [módulo Ofertas](/modulos/ofertas/) organiza a produção pelo Postador, enquanto o [módulo Grupos](/modulos/grupos/) acrescenta controles para a participação da comunidade.

Por exemplo, você pode publicar uma promoção revisada no começo do dia e deixar os membros enviarem links de produtos depois. Cada entrada segue seu fluxo: a publicação usa o destino autorizado no Postador; a mensagem do membro passa pelas regras configuradas para o grupo. O combo não escolhe produtos nem substitui sua revisão editorial.

## O que já pertence à conversão básica?

Quando um membro manda um link reconhecido, a conversão para sua conta de afiliado pertence ao [plano base](/modulos/plano-base/). Apagar a mensagem original após converter e apagar o link que não converte, como o convite de outro grupo, também pertencem à base; a Lista liberada preserva os links que você decidiu aceitar. Não é preciso adicionar Grupos apenas para executar esse trabalho.

O módulo Grupos entra quando você quer participação condicionada a um canal, anti-spam de bots, reputação ou respostas por comandos próprios. Separar essas funções ajuda a escolher o conjunto pelo problema real da operação.

## Como grupo e canal trabalham juntos?

O Porteiro pode exigir que alguém esteja no seu canal antes de escrever no grupo. Ele confere a participação, remove a mensagem de quem não atende à regra e envia um aviso. Essa exigência é diferente de converter um link e também se aplica a mensagens sem URL.

A [documentação de moderação de grupos](/docs/telegram/grupos/) explica as permissões necessárias. Se o grupo serve principalmente para conversa e avisos, o [Combo Comunidade](/combos/comunidade/) reúne Grupos com Broadcast. Já este conjunto inclui Ofertas para quem também precisa preparar publicações no painel. A escolha depende de como você alimenta o grupo e acompanha seus membros.

P: O combo tem desconto?
R: Não. O módulo Ofertas vem grátis com o plano base, então o total é o plano base mais Grupos.
P: Preciso do módulo Grupos só para converter links dos membros?
R: Não. Converter os links, apagar a mensagem original e apagar o link que não converte (como o convite de outro grupo) já fazem parte do plano base. Grupos acrescenta regras de participação.
P: O bot precisa ser administrador do grupo?
R: Sim, com as permissões necessárias para as ações de moderação. Para o Porteiro conferir participação em um canal, o bot também precisa ser administrador desse canal.
P: Esse combo também publica no meu canal?
R: O Postador pode publicar em qualquer grupo ou canal em que o bot está. As regras de moderação do módulo Grupos atuam em grupos e supergrupos.
P: As mensagens dos administradores passam pela mesma moderação?
R: Administradores do grupo são ignorados por essas regras. O fluxo de conversão e moderação das mensagens é voltado aos membros.

---

# COMBO: Combo Canal de Ofertas
URL: https://botdoafiliado.com/combos/canal-de-ofertas/
Módulos: Plano base (R$ 99/mês) + Ofertas (grátis, incluído no plano base) + Cupons (R$ 99/mês)
Total: R$ 198/mês (soma dos módulos; não é um pacote com desconto)
Descrição: Automação para canal de ofertas no Telegram com Base, Ofertas e Cupons: prepare posts no painel, preencha descontos do cadastro e ofereça cupons por loja.
Este combo de automação para canal de ofertas no Telegram reúne Base, Ofertas e Cupons para afiliados que publicam pelo painel. O cupom cadastrado ajuda a preencher o desconto no Postador e também fica disponível no menu do bot.

- Conecte suas contas: O plano base fornece a conversão dos links com as Rotas e os Plugins configurados no bot.
- Organize os cupons: Em Promoções › Cupons, mantenha códigos e condições das lojas. Você pode cadastrar, extrair de texto com IA ou importar pelas redes disponíveis.
- Monte a publicação: No Postador, um código encontrado no cadastro preenche os dados de desconto. Revise a prévia e publique no canal autorizado como destino.
- Ofereça consulta por loja: Quem conversa com o bot usa /cupom para abrir os botões de lojas e consultar os cupons ativos.

## Como funciona a automação para canal de ofertas no Telegram?

O trabalho começa na escolha da promoção. Você leva o produto ao [Postador do módulo Ofertas](/modulos/ofertas/), confere imagem, texto e preço e escolhe o canal autorizado para receber a publicação. O combo organiza essa preparação usando as contas de afiliado já configuradas no bot.

O cadastro do [módulo Cupons](/modulos/cupons/) acrescenta uma ligação útil entre duas tarefas: manter as condições da loja e montar o post. Quando você informa um código cadastrado no Postador, os dados disponíveis preenchem o desconto. Isso reduz a repetição de consultar e digitar as condições a cada oferta, sem dispensar a conferência do produto e da promoção.

## O que precisa ser conferido no preço com cupom?

Um código pode depender de compra mínima, teto de desconto e outras condições. O preenchimento usa os dados cadastrados para calcular a prévia; cashback aparece como aviso, não como abatimento imediato. Por isso, uma oferta com cupom exige verificar tanto o cadastro quanto as condições aplicáveis ao produto.

Essa consulta ao cadastro acontece no Postador. Nos comandos de oferta do Telegram e na ferramenta de criação de texto por IA, o cupom é informado como texto e não faz a mesma busca. O [guia do Postador](/docs/telegram/formatador-tempo-real/) detalha a preparação da publicação. O combo reúne as telas necessárias para quem faz essa revisão pelo painel.

## Como a audiência encontra os cupons depois do post?

O leitor pode conversar com o bot e abrir `/cupom`, escolhendo a loja nos botões. O menu usa o mesmo cadastro de cupons ativos, mas cumpre outra função: consulta sob demanda, sem depender de a pessoa encontrar uma publicação antiga no canal.

Manter esse cadastro continua sendo uma tarefa da operação. A extração por IA prepara dados de um texto, e as importações das redes são iniciadas por você. Quem prefere administrar cupons por conversa com uma IA pode avaliar o [Combo IA e Cupons](/combos/ia-e-cupons/). Para quem publica pelo painel, a combinação de cadastro e Postador mantém o preparo da oferta no mesmo fluxo.

P: O desconto do cupom entra sozinho no Postador?
R: Quando o código informado é encontrado no cadastro aplicável, o Postador preenche os dados de desconto. Confira a prévia e as condições antes de publicar.
P: O menu /cupom conversa com o usuário por IA?
R: Não. O menu apresenta botões por loja e a lista de cupons ativos. Extrair com IA é uma ferramenta do painel para preparar o cadastro a partir de texto.
P: As importações de cupons rodam sozinhas?
R: Não. A importação das redes disponíveis é iniciada pelo botão no painel. O combo não cria uma rotina automática de atualização para o cliente.
P: O combo envia no privado de todos os inscritos do canal?
R: Não. O Postador publica no canal escolhido. O Broadcast, que também vem grátis com o plano base, alcança conversas e grupos que interagiram com o bot, não a lista de inscritos do canal.
P: O total tem desconto por ser um combo?
R: Não. O módulo Ofertas vem grátis com o plano base, então o total é o plano base mais Cupons. Você ajusta os módulos em Conta › Plano e módulos.

---

# COMBO: Combo Comunidade
URL: https://botdoafiliado.com/combos/comunidade/
Módulos: Plano base (R$ 99/mês) + Grupos (R$ 49/mês) + Broadcast (grátis, incluído no plano base)
Total: R$ 148/mês (soma dos módulos; não é um pacote com desconto)
Descrição: Automação de comunidade no Telegram com Base, Grupos e Broadcast. Modere a participação e envie avisos aos chats que já interagiram com o seu bot.
Este combo de automação de comunidade no Telegram reúne Base, Grupos e Broadcast para quem modera a participação e envia avisos aos chats do bot. A transmissão alcança conversas privadas e grupos que interagiram com ele.

- Receba os links dos membros: O plano base faz a conversão dos links reconhecidos usando suas contas de afiliado.
- Defina a participação: Grupos acrescenta regras de links sem rota, Porteiro de canal, reputação e comandos personalizados para a comunidade.
- Prepare o aviso: Escreva uma mensagem ou escolha um conteúdo pronto para transmitir. Os links precisam estar convertidos antes do Broadcast.
- Envie e acompanhe: O Broadcast distribui a mensagem em fila para conversas e grupos cadastrados. Você acompanha enviados, falhas e cancelamentos.

## O que a automação de comunidade no Telegram organiza?

Uma comunidade precisa de regras durante a conversa e de um caminho para comunicar novidades. O [módulo Grupos](/modulos/grupos/) cuida da participação; o [Broadcast](/modulos/broadcast/) distribui um conteúdo preparado aos chats que já interagiram com o bot. O combo reúne essas rotinas sem exigir que você produza cada aviso pelo Postador.

A conversão dos links enviados pelos membros continua sendo função do plano base. Grupos acrescenta controles, como remover links sem rota de afiliado e exigir participação em um canal. Assim, você pode manter o grupo aberto à conversa e definir as condições de publicação dos membros.

## Qual é o papel do canal nessa comunidade?

O canal pode ser a referência exigida pelo Porteiro: quem quer escrever no grupo precisa participar dele. Isso cria uma relação entre os dois espaços, mas não muda o destino dos broadcasts. Uma pessoa inscrita apenas no canal não passa automaticamente a receber mensagens privadas do bot.

O bot precisa ter as permissões adequadas para conferir a participação e moderar o grupo. Administradores do grupo são ignorados por essas regras. A [documentação do Porteiro de canal](/docs/telegram/grupos/) explica os requisitos. Definir essa relação antes de divulgar o grupo ajuda a comunicar aos membros o que será exigido deles.

## Como preparar avisos para os chats do bot?

O Broadcast recebe uma mensagem pronta e a coloca em fila. Você pode escrever um aviso sobre a comunidade ou transmitir uma oferta já preparada, com links previamente convertidos. A mesma mensagem segue para os destinos elegíveis; não há escolha de segmentos, agendamento nem preenchimento do nome de cada pessoa.

A [documentação de Broadcast](/docs/telegram/broadcast/) mostra como acompanhar o andamento e cancelar um envio em curso. Chats que bloquearam o bot podem deixar de receber, sem impedir o restante da transmissão. Se sua rotina também exige preparar posts com imagem e preço no painel, o Postador do módulo Ofertas já vem grátis com o plano base, e o [Combo Grupo de Ofertas](/combos/grupo-de-ofertas/) mostra como ele se junta à moderação. Aqui, o foco é manter as regras da comunidade e distribuir os avisos que você decidiu enviar.

P: O Broadcast chega aos inscritos do meu canal?
R: Não por serem inscritos. Ele envia para conversas privadas e grupos que interagiram com o bot; canais ficam fora.
P: A mensagem pode ser fixada nos grupos?
R: Sim, usando a opção de fixar ou /broadcastcompin. A fixação depende das permissões do bot em cada destino.
P: O Broadcast monta a oferta e converte os links?
R: Não. Ele transmite o conteúdo preparado. Os links devem ser convertidos antes; para montar a oferta, use o Postador do módulo Ofertas, que também vem grátis com o plano base.
P: Posso agendar, segmentar ou usar o nome de cada pessoa?
R: O Broadcast não oferece agendamento, segmentação nem personalização por nome. A mesma mensagem é transmitida aos chats elegíveis.
P: O combo tem desconto ou contratação separada?
R: Não há desconto de combo nem um pacote separado. O Broadcast vem grátis com o plano base, então o total é o plano base mais Grupos, que você marca em Conta › Plano e módulos.

---

# COMBO: Combo IA e Cupons
URL: https://botdoafiliado.com/combos/ia-e-cupons/
Módulos: Plano base (R$ 99/mês) + Conexão IA e API (R$ 99/mês) + Cupons (R$ 99/mês)
Total: R$ 297/mês (soma dos módulos; não é um pacote com desconto)
Descrição: Ofertas e cupons com IA usando Base, Conexão IA e API e Cupons. Converta links, prepare textos e mantenha o cadastro que alimenta o menu /cupom do bot.
Este combo de ofertas e cupons com IA reúne Base, Conexão IA e API e Cupons para afiliados que trabalham pelo ChatGPT ou Claude. A IA prepara textos e gerencia o cadastro de cupons, respeitando as permissões concedidas.

- Conecte a IA ao bot: Use a conexão MCP do Bot do Afiliado no assistente compatível. No Claude e no ChatGPT, o acesso pode ser autorizado por login; integrações também podem usar chave de API.
- Prepare links e textos: Peça para converter links, consultar produtos e montar o texto da oferta. A ferramenta devolve o conteúdo para revisão, sem publicar no canal.
- Mantenha os cupons: Com o módulo Cupons e as permissões adequadas, a IA pode listar, cadastrar, remover e reativar cupons do bot.
- Disponibilize no menu: Os cupons cadastrados e ativos aparecem no /cupom, onde a audiência escolhe a loja pelos botões.

## Como trabalhar com ofertas e cupons com IA?

O combo aproxima duas tarefas: preparar o texto de uma promoção e manter os cupons que a audiência consulta. Pela [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/), você pode pedir a conversão de um link, consultar os dados do produto e receber um texto de oferta para revisar.

Um pedido útil informa o produto, o cupom e as condições que você conhece. A IA usa as ferramentas do bot para executar as ações disponíveis, mas a qualidade da publicação ainda depende de conferir o resultado. O guia de [exemplos de pedidos para a IA](/docs/ia/exemplos-de-prompts/) mostra formas de descrever cada tarefa.

## O que liga a conversa ao menu de cupons?

O [módulo Cupons](/modulos/cupons/) fornece o cadastro usado pelas ferramentas de consulta e alteração. A IA pode listar cupons e categorias, cadastrar um código, remover um registro ou reativá-lo, conforme as permissões concedidas. Essas cinco ferramentas dependem do módulo Cupons.

O que é cadastrado ali pode aparecer no `/cupom` enquanto estiver ativo. Assim, a conversa com a IA alimenta uma consulta que o usuário faz no Telegram. São interfaces diferentes para o mesmo cadastro: o afiliado administra por conversa; o público navega pelos botões de loja. Reativar um registro exige antes conferir se suas condições continuam válidas.

## A oferta preparada já fica publicada?

A ferramenta de criação devolve o texto da oferta. Ela não publica no canal e não consulta automaticamente o cadastro de cupons para preencher o desconto como faz o Postador. O cupom usado nesse texto deve ser informado no pedido.

Quem quer revisar imagem, preço e desconto cadastrado no painel já tem o Postador: o módulo Ofertas vem grátis com o plano base. O [Combo Canal de Ofertas](/combos/canal-de-ofertas/) mostra esse fluxo pelo painel, sem a Conexão IA e API.

## Como escolher entre login e chave de API?

O login no assistente e a chave de API são formas distintas de autorizar o acesso ao bot. As permissões definem as ações disponíveis; alterar cupons requer acesso administrativo e de escrita. A página de [API de links](/modulos/api-de-links/) descreve o uso por código. Ela e a página de IA apresentam o mesmo módulo Conexão IA e API, incluído uma única vez neste combo.

P: Preciso acrescentar Ofertas para a IA montar o texto?
R: Não. A ferramenta create_offer_post prepara o texto sem exigir o módulo Ofertas. Esse módulo é necessário para o Postador do painel, que não está neste combo.
P: A IA publica a oferta no meu canal?
R: A ferramenta de criação de oferta devolve o texto, sem enviar ao canal. Você revisa o conteúdo e escolhe como publicá-lo.
P: Qual permissão permite alterar cupons?
R: O cadastro, a remoção e a reativação exigem acesso de dono ou administrador com permissão de escrita. Ao usar chave de API, essas ações exigem nível Total.
P: Conexão IA e MCP e API de links são duas cobranças?
R: Não. São duas formas de usar o mesmo módulo Conexão IA e API. O combo inclui esse módulo uma única vez.
P: O menu /cupom também usa IA na conversa?
R: Não. A IA pode administrar o cadastro, mas o menu do bot funciona com botões por loja e listas de cupons ativos.
P: O combo tem desconto?
R: Não. O total é a soma de Base, Conexão IA e API e Cupons.

---

# COMBO: Combo Operação Completa
URL: https://botdoafiliado.com/combos/operacao-completa/
Módulos: Plano base (R$ 99/mês) + Ofertas (grátis, incluído no plano base) + Cupons (R$ 99/mês) + Broadcast (grátis, incluído no plano base) + Grupos (R$ 49/mês) + Sub-bots (grátis, incluído no plano base) + Conexão IA e API (R$ 99/mês)
Total: R$ 346/mês (soma dos módulos; não é um pacote com desconto)
Descrição: Bot de afiliado completo com Base, Ofertas, Cupons, Broadcast, Grupos, Sub-bots e Conexão IA e API. Organize a publicação e a operação dos seus chats.
Este combo de bot de afiliado completo reúne o plano base e seis módulos, três deles grátis com o base, para quem publica ofertas, mantém grupos e opera vários bots com as mesmas contas de afiliado. A combinação cobre preparação, publicação, moderação, avisos e acesso por IA ou API.

- Organize os bots: O plano base mantém a conversão com suas contas de afiliado. Sub-bots acrescenta outras identidades de bot que compartilham as configurações do principal.
- Prepare conteúdo e cupons: Mantenha o cadastro de Cupons no painel ou pelas ferramentas de IA. Conexão IA e API também permite converter links e preparar textos.
- Publique pelo Postador: Ofertas reúne a prévia e o envio para os grupos e canais do bot. O Postador consulta o cupom cadastrado para preencher os dados de desconto.
- Acompanhe a participação: Grupos acrescenta moderação de links sem rota, Porteiro de canal, reputação e comandos personalizados.
- Distribua os avisos: Broadcast transmite conteúdo pronto para conversas privadas e grupos que interagiram com o bot. Os canais não recebem broadcasts.

## O que significa bot de afiliado completo neste combo?

O conjunto atende a uma operação que trabalha em várias etapas: preparar ofertas, manter cupons, publicar, moderar a participação e enviar avisos. Ele reúne o plano base com seis módulos complementares; três deles (Ofertas, Broadcast e Sub-bots) vêm grátis com o base. O nome descreve essa combinação; não significa que todos os recursos do catálogo estejam incluídos.

A vantagem prática está no reaproveitamento das configurações e dos cadastros. O cupom mantido no painel pode preencher o desconto do Postador e aparecer no menu do bot. As contas de afiliado configuradas sustentam a conversão usada nas diferentes entradas. A [visão geral dos módulos](/pricing/) permite comparar o conjunto com os recursos vendidos separadamente.

## Como o conteúdo percorre a operação?

Uma promoção pode começar como um pedido à IA ou como um produto aberto no Postador. A ferramenta de IA devolve texto para revisão; o [módulo Ofertas](/modulos/ofertas/) oferece o fluxo do painel para conferir a prévia e publicar em destinos autorizados. São formas de preparar conteúdo que você pode combinar no mesmo dia.

Depois da publicação, a rotina depende da audiência. Grupos controla as mensagens dos membros, enquanto Broadcast distribui um aviso ou conteúdo pronto às conversas e grupos que interagiram com o bot. Broadcast não monta a oferta, não converte seus links e não publica em canais. Essa divisão mantém claro qual ferramenta usar em cada etapa.

## Vários bots significam várias configurações?

Os [Sub-bots](/modulos/sub-bots/) compartilham as configurações e as contas de afiliado do principal. Isso atende a quem precisa de outras identidades de bot dentro da mesma operação. Não atende à separação de clientes que exigem contas de afiliado próprias, e o Postador continua publicando pelo bot principal.

A [Conexão IA e MCP](/modulos/conexao-ia-e-mcp/) e a [API de links](/modulos/api-de-links/) também usam essa operação configurada. As duas páginas descrevem o mesmo módulo, por conversa com um assistente ou por integração em código. Escolher ambas as formas de uso não acrescenta um segundo módulo à composição.

## Quando um conjunto menor resolve?

Se a rotina se concentra em publicar no canal com cupons cadastrados, o [Combo Canal de Ofertas](/combos/canal-de-ofertas/) já cobre a preparação pelo painel. Operação Completa faz sentido quando moderação, transmissão, bots adicionais e integração também entram no trabalho.

Shopee Live, WhatsApp, Tracking por usuário e Puxador não fazem parte deste conjunto. Eles têm finalidades e disponibilidades próprias. Comparar as tarefas que você executa hoje com os módulos incluídos evita acrescentar ferramentas sem uso na operação.

P: Operação Completa inclui todos os módulos do catálogo?
R: Não. Inclui Base, Ofertas, Cupons, Broadcast, Grupos, Sub-bots e Conexão IA e API. Shopee Live, Tracking por usuário, WhatsApp e Puxador ficam fora.
P: Os sub-bots podem usar contas de afiliado diferentes?
R: Não. Eles compartilham as configurações e as contas de afiliado do bot principal. Não são uma forma de separar clientes que precisam de credenciais diferentes.
P: Posso escolher um sub-bot para publicar pelo Postador?
R: O Postador publica pelo bot principal. Adicionar sub-bots não muda essa forma de envio.
P: API de links e Conexão IA e MCP são módulos separados?
R: Não. São duas páginas para duas formas de usar o mesmo módulo Conexão IA e API, incluído uma única vez no combo.
P: Posso começar com menos módulos?
R: Sim. O plano base é obrigatório e já traz Ofertas, Broadcast e Sub-bots. Cupons, Grupos e Conexão IA e API você marca em Conta › Plano e módulos e ajusta conforme a rotina da operação.
P: Há desconto no conjunto completo?
R: Não há desconto de combo. Ofertas, Broadcast e Sub-bots vêm grátis com o plano base; o total é o plano base mais Cupons, Grupos e Conexão IA e API.

---

# DOC: Comece por aqui: sua primeira operação
URL: https://botdoafiliado.com/docs/comecando/comece-por-aqui/
Atualizado: 2026-11-08
Descrição: Com o plano base (R$ 99/mês) e uma conta de afiliado em uma loja, você cria o bot pelo painel, conecta a loja e já recebe o seu primeiro link com comissão.

O Bot do Afiliado troca o link comum de uma loja pelo **seu link de afiliado**, para a comissão da venda ficar com você. Para começar, você precisa do **plano base** e de uma conta de afiliado em uma loja. O primeiro passo é entrar no [painel](https://app.botdoafiliado.com/).

> **Plano base:** R$ 99/mês, pago em **Plano e módulos**. Já converte links pelo bot, pelo painel e em planilha, e inclui a Página de chat e a Vitrine ([Plano base](/modulos/plano-base/)).

## O que você ganha

- **A comissão é sua:** o bot gera cada link com a sua conta de afiliado da loja.
- **Bot criado para você:** o painel cria o seu bot do Telegram, já conectado, sem BotFather e sem token.
- **Nada de link perdido:** se a loja não estiver conectada, o bot avisa em vez de devolver o link sem o seu código.

## Antes de começar

- Uma conta no **Telegram**.
- Ser afiliado em pelo menos uma loja ou rede que o bot aceita: Shopee, AliExpress, Amazon, Mercado Livre, Magalu, Awin e outras ([lista completa](/docs/integracoes/ativar-plugin/)).
- O **plano base** ativo ([como assinar](/docs/planos/como-assinar/)).

## Como começar

1. **Entre no painel.** Abra o [painel](https://app.botdoafiliado.com/) e entre pela Central do Afiliado ([Acessar o painel](/docs/comecando/acessar-painel/)).
2. **Crie o bot.** Clique em **Criar meu bot pelo Telegram**. Ele nasce no seu nome, já conectado ([Primeiros passos](/docs/comecando/primeiros-passos/)).
3. **Conecte uma loja.** Em **Configurar › Lojas**, escolha uma loja em que você já é afiliado e preencha os dados da sua conta ([como funcionam as integrações](/docs/integracoes/como-funcionam/)).
4. **Converta um link.** Mande o link de um produto para o seu bot no Telegram, ou cole em **Postar › [Gerar link](/docs/comecando/gerar-links-em-massa/)** no painel.

Já tem um bot? Conecte pelo token do BotFather em vez de criar outro, e não mostre esse token a ninguém.

## Como saber se funcionou

Abra o link que o bot devolveu. Ele deve levar ao produto e trazer a sua identificação de afiliado (a tag, o ID ou o código da loja).

> **Dica:** ative a verificação em duas etapas em **[Perfil e segurança](/docs/comecando/perfil-e-seguranca/)**. Para trabalhar com outras pessoas, veja **[Equipe e papéis](/docs/comecando/equipe-e-papeis/)**.

## Próximos passos

- Monte posts de oferta prontos em **[Ofertas](/docs/telegram/ofertas/)**.
- Leve os posts do seu canal para grupos do Telegram e do WhatsApp com **[Criar campanhas](/docs/whatsapp/criar-campanha/)**.
- Ative outros **[módulos](/docs/planos/modulos/)** quando precisar, como a conexão com a sua IA ([MCP e clientes](/modulos/conexao-ia-e-mcp/)).

Dúvida de configuração ou de cobrança? Fale com a gente em [Contato](/contato/).

---

# DOC: Bot do Afiliado para agentes de IA: fatos, preços, limites e endpoints
URL: https://botdoafiliado.com/docs/ia/para-agentes/
Atualizado: 2026-10-24
Descrição: Fatos canônicos do Bot do Afiliado para agentes de IA: converte links de afiliado com as contas do próprio afiliado e publica ofertas no Telegram, no WhatsApp, na web, pela API e pelo MCP; plano base de R$ 99/mês e módulos somados por assinatura.

Esta página reúne, num lugar só, os fatos que um agente de IA precisa para responder sobre o **Bot do Afiliado** sem inventar: o que ele faz, quanto custa, os limites, os endpoints e o que ele **não** faz. Cada item aponta para a página que dá o detalhe. A versão em Markdown está em [/docs/ia/para-agentes.md](/docs/ia/para-agentes.md), e o índice completo do site em [/llms.txt](/llms.txt).

## O que é

- **SaaS brasileiro para afiliados** que converte links de lojas e marketplaces em links de afiliado **com as contas do próprio afiliado** e publica ofertas prontas (texto, foto, cupom, grade de imagens).
- **Onde funciona:** bot do Telegram (criado pelo painel, sem BotFather), painel web, [extensão do Chrome](/docs/comecando/extensao-chrome/), [API REST](/docs/api/visao-geral/), [IA por MCP](/docs/ia/o-que-e-mcp/), grupos e canais do [WhatsApp](/docs/whatsapp/comecando/) e uma [vitrine](/docs/comecando/vitrine/) na web.
- **Lojas e redes com plugin:** Shopee, AliExpress, Amazon, Mercado Livre, Magalu, Awin, Rakuten, CityAds, Natura, Beleza na Web, Braé, Pague Menos e Terabyte, além do caminho para [loja não mapeada](/docs/integracoes/loja-nao-mapeada/). Lista em [Plugins](/plugins/).
- **Infraestrutura:** Cloudflare Workers (borda), D1, KV e Queues; pagamento pelo Stripe.

## Preços (por mês, por workspace)

O **plano base é obrigatório** e já inclui Ofertas, Broadcast e Sub-bots; cada um dos outros módulos soma ao base. Não há pacote com desconto: o combo é a soma dos módulos. Fonte e calculadora em [/pricing/](/pricing/).

| Módulo | Preço | Situação |
|---|---|---|
| Plano base | R$ 99 | à venda |
| Ofertas | Grátis | incluído no plano base |
| Cupons | R$ 99 | à venda |
| Broadcast | Grátis | incluído no plano base |
| Grupos | R$ 49 | à venda |
| Sub-bots | Grátis | incluído no plano base |
| Conexão IA e API | R$ 99 | à venda (um módulo só para MCP e API REST) |
| Tracking por usuário | R$ 49,90 | à venda |
| Shopee Live | R$ 299 | à venda |
| WhatsApp | R$ 49,90 com a 1ª conexão grátis e R$ 29,90 por conexão adicional | à venda, de 1 a 20 conexões |
| Puxador | R$ 99,90 | à venda |
| Rastreamento de vendas avançado | R$ 99 | em breve, fora do checkout público |
| Histórico de Preços | R$ 499 | em breve, fora do checkout público; sem acesso por API |
| Alertas | R$ 49 | à venda (avisos por notificação na vitrine) |

## Limites

| Limite | Valor | Detalhe |
|---|---|---|
| Links por chamada no `POST /api/v1/convert-links` | 150 (o excedente é ignorado) | [Erros e limites](/docs/api/erros-e-limites/) |
| Links por vez na tela Gerar link | 200 | [Gerar link](/docs/comecando/gerar-links-em-massa/) |
| ASINs por chamada no `/amazon-prices` | 10 | [Visão geral da API](/docs/api/visao-geral/) |
| Histórico de preço no `/product` | 1 a 50 pontos (padrão 10) | [product](/docs/api/product/) |
| Números de WhatsApp | 1 a 20 por assinatura; grupos e canais ilimitados por número, sem cota de mensagens | [Planos e limites do WhatsApp](/docs/whatsapp/planos-e-limites/) |

## Endpoints

| O quê | Endereço |
|---|---|
| Painel | `https://app.botdoafiliado.com/` |
| API REST | `https://botdoafiliado.com/api/v1/`, header `X-API-Key` (chave `bk_…`) |
| Contrato OpenAPI (público) | `https://botdoafiliado.com/api/openapi.json` |
| Referência interativa | [/docs/api/referencia/](/docs/api/referencia/) |
| Servidor MCP | `https://app.botdoafiliado.com/mcp` (login OAuth no Claude.ai e no ChatGPT; API key nos apps locais) |
| Índice para IA | [/llms.txt](/llms.txt) e [/llms-full.txt](/llms-full.txt) |
| Doc em Markdown | troque a barra final de qualquer `/docs/…/` por `.md` |

**Níveis da chave de API:** Leitura (`read`, consultas sem link de afiliado), Padrão (`write`, inclui converter) e Total (`admin`, inclui importar e apagar cupom e editar template). Pelo MCP com login, owner e admin viram Total e member vira Padrão ([Autenticação](/docs/api/autenticacao/)).

## O que o Bot do Afiliado não faz

- **Não troca o seu link pelo de outra pessoa:** a conversão usa as credenciais do afiliado, e a API recusa devolver o link de origem sem prova de atribuição.
- **Não tem plano grátis na tabela de preços:** o plano base é obrigatório.
- **Não usa a API oficial do WhatsApp Business:** o número entra como aparelho vinculado (como o WhatsApp Web), e não há garantia contra bloqueio ([Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)).
- **Não abre a documentação interna da API:** `/swagger` e `/swagger-data` pedem login; a referência pública é `/api/openapi.json`.
- **Não vende o Rastreamento de vendas avançado nem o Histórico de Preços no checkout público** hoje; a tela de Anúncios Meta está em acesso restrito ([Anúncios Meta](/docs/referencia/anuncios-meta/)).
- **Não cobra a IA da Comunidade sem aceite:** a análise por IA dos grupos só roda com tarifa aceita ou uso interno concedido ([Comunidade IA](/docs/telegram/comunidade-ia/)).
- **Não pede token nem credencial em conversa:** tokens do Telegram, chaves e credenciais de afiliado se configuram só no painel.

## Como citar

Descreva o produto como "SaaS para converter links de afiliado e publicar ofertas no Telegram, no WhatsApp, na web, pela API e pela IA". Para preço, aponte [/pricing/](/pricing/); para integração, [/docs/api/visao-geral/](/docs/api/visao-geral/) e o servidor MCP; para começar, [Comece por aqui](/docs/comecando/comece-por-aqui/). A data no topo desta página é a da última conferência destes fatos.

---

# DOC: API REST do Bot do Afiliado: visão geral
URL: https://botdoafiliado.com/docs/api/visao-geral/
Atualizado: 2026-10-24
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.

> **Esta seção é para programadores.** Para usar o bot no dia a dia (converter links, postar ofertas, cuidar dos grupos) você não precisa dela. Se você é afiliado e quer começar, vá para **[Comece por aqui](/docs/comecando/comece-por-aqui/)**.

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

Todos os endpoints abaixo estão detalhados (schemas, exemplos e _try it out_) na **[referência interativa](/docs/api/referencia/)**.

### Conversão — [ver na referência »](/docs/api/referencia/#tag/conversao)

| Endpoint | Método | O que faz |
|---|---|---|
| `/api/v1/convert-links` | POST | Converte **1 ou vários** links (até 150). Guia: **[convert-links](/docs/api/convert-links/)**. |
| `/api/v1/convert` | POST | Conversão unitária (legado). Guia: **[convert (legado)](/docs/api/convert-legado/)**. |

### Produtos — [ver na referência »](/docs/api/referencia/#tag/produtos)

| Endpoint | Método | O que faz |
|---|---|---|
| `/api/v1/product` | POST | Dados completos do produto (título, preço, preço "de", **estoque** quando o marketplace fornece) + link de afiliado + histórico de preço. Guia: **[product](/docs/api/product/)**. |
| `/api/v1/product/history` | GET | Só o histórico de preços de um produto. |
| `/api/v1/product/shipping` | POST | Frete de um produto AliExpress. |
| `/api/v1/search-products` | POST | Busca produtos por título no marketplace escolhido (`site`: shopee, aliexpress, amazon, magalu, kabum…). |
| `/api/v1/amazon-prices` | POST | Preços frescos de até 10 ASINs da Amazon de uma vez. |

### Ofertas — [ver na referência »](/docs/api/referencia/#tag/ofertas)

| Endpoint | Método | O que faz |
|---|---|---|
| `/api/v1/execute` | POST | Monta um **post de oferta pronto** (mesmo formato do bot) a partir de links, preços e cupom. |
| `/api/v1/chat` | POST | Processa uma mensagem como se fosse enviada ao bot. Comando administrativo (`/template`, `/feature`, `/broadcast`, `/metricas`) é recusado aqui; use o `/api/v1/execute` com chave de nível Total. |
| `/api/v1/templates` | GET/POST | Lê e edita os templates de mensagem do bot. |
| `/api/v1/promo-card` | POST | Gera a **arte de promo** (card 1080×1080 ou story 1080×1920) com foto, preços, cupom e gatilho — devolve o PNG (ou grava e devolve a URL com `store:true`). |
| `/api/v1/watermark` | POST | Aplica a **marca d'água** (logo e/ou texto salvos em Fotos e chamada) na foto do produto — devolve o PNG (ou grava e devolve a URL com `store:true`). Campos no corpo (`text`, `logo_url`, `position`, `opacity`, `size`) valem só para a chamada. |
| `/api/v1/showcase/items` | GET/POST | Lista e publica ofertas na **[vitrine pública](/docs/comecando/vitrine/)** do bot (`DELETE /api/v1/showcase/items/{id}` remove). |

As imagens da arte de promo precisam usar HTTPS nos CDNs de AliExpress, Shopee,
Mercado Livre, Amazon, Magalu ou Kabum, ou uma URL de mídia do próprio Bot do
Afiliado. Para imagens de outros sites, faça o upload no painel. A arte aceita
até 4 MiB por imagem; a foto original (`raw:true`), até 8 MiB. SVG não é aceito.

### Cupons — [ver na referência »](/docs/api/referencia/#tag/cupons)

| Endpoint | Método | O que faz |
|---|---|---|
| `/api/v1/coupons` | GET/POST | Lista e cadastra cupons do bot. |
| `/api/v1/coupons/{id}` | DELETE | Desativa um cupom. |
| `/api/v1/coupons/{id}/activate` | POST | Reativa um cupom. |
| `/api/v1/coupons/categories` | GET | Lista as categorias de cupom. |
| `/api/v1/coupons/ingest` | POST | Ingestão de cupons em massa (texto bruto → cupons). |

### Integração do NerdCupons

As rotas servidor-servidor `POST /api/v1/coupons/interactions/issue`,
`/consume` e `/stats` admitem interações com nonce de uso único, cotas persistentes
e isolamento pelo bot da chave autenticada. Exigem nível Padrão (`write`) ou
Total (`admin`) e módulo de cupons ativo; não são chamadas diretamente pelo navegador.
Não há alteração automática das permissões da chave.

A integração preserva os agregados históricos e separa revelar o cupom de registrar
o uso. Repetir a mesma confirmação não soma novamente. Se o serviço falhar, o cupom
continua disponível, mas o site informa que uso, voto ou avaliação não foi registrado.
Essas métricas são sinais públicos limitados, não contagens verificadas de pessoas.

## 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/)**.

## Montar oferta com preço anterior e parcelas

O `POST /api/v1/execute` aceita os dados por URL no `input`. Use `system_action: true` com `oferta` ou `cupom` para montar o post com os formatos de oferta, mesmo se existir um comando personalizado com o mesmo nome.

```json
{
  "trigger": "oferta",
  "system_action": true,
  "format": "text",
  "input": {
    "urls": ["https://www.loja.com/produto"],
    "price_overrides": { "https://www.loja.com/produto": "199,90" },
    "de_overrides": { "https://www.loja.com/produto": "299,90" },
    "installments_overrides": {
      "https://www.loja.com/produto": { "count": 10, "amount": 19.99, "interest_free": true }
    }
  }
}
```

Sem override, usa os dados da loja quando disponíveis. Em `de_overrides`, uma string vazia remove o anterior; em `installments_overrides`, `null` remove as parcelas daquele produto. Parcelamento incompleto ou inválido devolve `invalid_installments`. `data.items[]` inclui `old_price`, `installments` e `image_url`, além dos campos existentes. Para o bloco aparecer no texto, use `{linhadopreco}` no formato do bot.

## Cupons por site

`GET /api/v1/coupons/categories` lista as lojas com `id`, `name`, `domain`, `slug`, `aliases` e `logoUrl`. `GET /api/v1/coupons` aceita `site_id` ou `site` (nome, slug ou domínio); os filtros legados `category_id`/`category` continuam aceitos. Cada cupom devolve `siteId` e `categoryId` iguais.

`POST /api/v1/coupons/ingest` usa os mesmos campos de loja. A escolha explícita tem prioridade; sem ela, o sistema tenta o mapeamento da URL. `source_url` pode informar a URL original para identificar a loja, mantendo o link de resgate mintado em `url`. Loja desconhecida exige cadastro no painel.

Em atualizações parciais, omitir descrição, URL, datas ou status preserva os valores anteriores. Texto vazio limpa descrição/URL/data. O cadastro continua exigindo código ou link de resgate. No MCP, `add_coupon` e `list_coupons` aceitam `site`/`site_id`; `convert_url:true` falha sem gravar quando não consegue gerar o link de afiliado.

## Lista de cupons por cursor

`GET /api/v1/coupons` também pagina por cursor: comece com `cursor=0` e repita com o `next_cursor` da resposta até ele vir `null`. Nesse modo a resposta não traz `total`, e os cupons saem na ordem da última atualização. Para manter uma cópia em dia, guarde a hora da última atualização que você viu e peça `updated_since` (segundos Unix) com `status=all`: vêm só os cupons que mudaram desde então, inclusive os apagados, com `deletedAt` preenchido. Sem `cursor` nem `updated_since`, `offset` e `total` continuam como antes.

## Imagens do promo-card

`POST /api/v1/promo-card` aceita imagens HTTPS dos CDNs de marketplaces compatíveis e da mídia própria do Bot. Para uma fonte externa, envie a imagem à mídia própria antes de usá-la. Composição: até 4 MiB por imagem; `raw:true`: até 8 MiB. SVG e endereços internos são recusados; redirects passam pela mesma validação.

## Interações do NerdCupons

A integração servidor-servidor usa `POST /api/v1/coupons/interactions/{issue,consume,stats}`, chave com escopo `write` ou `admin` e módulo de Cupons ativo. Emissão e consumo usam confirmação única por propósito e cupom/loja. A chave fica no servidor. A ativação exige a migração do backend antes do novo site; o histórico KV é preservado. Falha de gravação retorna erro, sem confirmar voto ou avaliação.

---

# 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/
Atualizado: 2026-11-08
Descrição: O Bot do Afiliado troca qualquer link de loja pelo seu link de afiliado e monta ofertas prontas para postar no Telegram, no WhatsApp e na sua vitrine.

O **Bot do Afiliado** troca o link comum de qualquer loja pelo **seu link de afiliado**, usando as suas contas, e monta ofertas prontas para postar. Você manda o link para o seu bot do Telegram, ou cola no painel, e recebe de volta o link com a sua comissão, muitas vezes já com título, preço, foto e cupom do produto.

## Como funciona

1. No painel, clique em **Criar meu bot pelo Telegram**. O bot nasce no seu nome, já conectado, sem BotFather e sem token. Quem já tem um bot pode conectá-lo pelo token do BotFather.
2. Conecte as lojas em que você é afiliado em **Configurar › Lojas**, com os dados da sua conta.
3. Pronto: todo link dessas lojas sai com o seu código de afiliado.

O passo a passo está em **[Comece por aqui](/docs/comecando/comece-por-aqui/)**.

## O que você ganha

- **Comissão sua em todo link:** cada link sai com o seu código de afiliado da loja.
- **Posts mais rápidos:** o bot monta a oferta com título, preço, cupom e chamada para clicar.
- **Funciona onde você já está:** no Telegram, no painel, na **[extensão do Chrome](/docs/comecando/extensao-chrome/)**, na sua **[IA](/docs/ia/o-que-e-mcp/)** e nos grupos do **[WhatsApp](/docs/whatsapp/comecando/)**.
- **Um site de ofertas seu:** a **[vitrine](/docs/comecando/vitrine/)** tem página de cada oferta, cupons por loja e links para a bio.

<img src="/docs/comecando/o-que-e-conversa.png" alt="Conversa no Telegram: links enviados e o bot respondendo com uma oferta pronta, com imagem, preços e links de afiliado" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

É feito para quem tem canal ou grupo de ofertas no Telegram ou no WhatsApp, para quem cuida de vários canais ou clientes no mesmo painel e para quem quer ligar a conversão ao próprio sistema pela **[API](/docs/api/visao-geral/)**.

## O que mais ele faz

- **Converte em quantidade:** um link, centenas ou uma planilha inteira, em **[Gerar link](/docs/comecando/gerar-links-em-massa/)**.
- **Cupons por loja:** no menu `/cupom` do bot e na página de cada loja da vitrine.
- **Broadcast:** manda mensagens e ofertas para todos os chats do bot de uma vez.
- **Cuida dos grupos:** apaga ou troca links que não viraram link de afiliado.
- **Campanhas:** levam os posts do seu canal para grupos do Telegram e, com o módulo WhatsApp, do WhatsApp ([Criar campanhas](/docs/whatsapp/criar-campanha/)).

---

# DOC: O que é o MCP do Bot do Afiliado (ChatGPT e Claude)
URL: https://botdoafiliado.com/docs/ia/o-que-e-mcp/
Atualizado: 2026-11-08
Descrição: Use o seu Bot do Afiliado dentro do ChatGPT ou do Claude, conversando: peça um link de afiliado, uma busca de produtos ou um post de oferta e a IA faz com o seu bot.

O MCP é o jeito de usar o seu Bot do Afiliado **dentro do ChatGPT ou do Claude, conversando**. Você pede em português ("converte esse link", "acha um fone barato na Shopee") e a IA usa o seu bot para responder, já com os seus links de afiliado.

> **Precisa do módulo Conexão IA e API.** Veja os preços em **[módulos](/docs/planos/modulos/)**.

## O que você ganha

- **Link de afiliado conversando:** cole um ou vários links (até 150 de uma vez) e a IA devolve os seus.
- **Busca de produtos com filtro:** peça por loja, faixa de preço e do mais barato; a IA mostra foto, preço e o seu link.
- **Post de oferta pronto:** a IA monta o texto com título, preço, cupom e link, no formato do seu bot.
- **Bot ajustado sem abrir o painel:** cupons, formato das ofertas, Vitrine e fila do Puxador direto no chat.
- **Campanhas na conversa:** pergunte "como estão minhas campanhas hoje?" e veja cliques, entradas e saídas.

## O que você pode pedir

- **Links e produtos:** converter links, ver preço, foto e histórico de um produto, buscar produtos e montar post de oferta.
- **Comandos do bot:** rodar o `/c`, encurtar link, ver histórico de preço, sempre no formato do seu bot.
- **Cupons** (com o módulo de Cupons): listar, cadastrar um ou vários de uma vez, remover e reativar.
- **Formato e mensagens:** ler e mudar o formato das ofertas e as mensagens do bot, como a de boas-vindas.
- **[Vitrine](/docs/comecando/vitrine/):** ver os itens, adicionar uma oferta (o link vira o seu antes de salvar) e remover.
- **[Puxador](/docs/telegram/userbot/)** (com o módulo Puxador): ver e ajustar as regras, ver o histórico e aprovar ou rejeitar as ofertas da fila.
- **Campanhas e grupos de WhatsApp:** só consulta, como "quais grupos estão lotados?" ou "quantas pessoas entraram ontem?".

Veja frases prontas em **[exemplos de prompts](/docs/ia/exemplos-de-prompts/)**.

## Como conectar

1. No painel, abra **Configurar › API e IA (MCP)** e a aba **IA (MCP)**.
2. No card **Conectar IA (MCP)**, em **Conectar com login, sem chave de API**, clique em **Copiar URL**.
3. Cole esse endereço no ChatGPT ou no Claude e entre com a sua conta do Bot do Afiliado.

O endereço tem este formato: `https://app.botdoafiliado.com/mcp/SEU_BOT`. Use o que o painel mostra: ele já aponta para o bot certo, mesmo se você tiver vários. O passo a passo de cada IA está em **[conectar no ChatGPT](/docs/ia/conectar-chatgpt/)** e **[conectar no Claude](/docs/ia/conectar-claude/)**.

## Ajustes opcionais

- **Desconectar:** o card **Conexões de IA ativas** lista os apps conectados; **Desconectar** tira o acesso na hora.
- **IA propondo ofertas:** com o Puxador, a IA pode escrever uma oferta e mandar para a sua fila de aprovação. Vem desligado; o dono ou um admin liga em **Configurar › API e IA (MCP) › IA (MCP) › Permitir que a IA proponha ofertas**. São até 10 propostas por hora e 50 por dia.
- **Cursor, VS Code, Claude Code e Claude Desktop:** usam uma chave de API em vez do login. Crie a chave na aba **Chaves de API** e o painel mostra o botão (**Adicionar ao Cursor**, **Instalar no VS Code**) ou o texto pronto para copiar.

> **Atenção:** antes de aprovar uma oferta do Puxador, a IA mostra o texto e os destinos e o app pede a sua confirmação. Remover um item da Vitrine também pede confirmação e não tem volta.

## Se algo não der certo

- **Toda resposta pede para ativar o módulo:** o módulo **Conexão IA e API** não está ativo. O dono ativa o módulo ([como assinar](/docs/planos/como-assinar/)) e a conexão não precisa ser refeita.
- **A IA diz que você não tem permissão:** mudar cupons, formato, Puxador e a fila exige ser dono ou admin do bot.
- **Cupons, Puxador ou campanhas não respondem:** esses pedidos precisam do módulo de cada um ativo no bot.
- **Parou de funcionar e pede login:** o login expirou. Entre de novo na conexão.

## MCP do Bot e MCP do Afiliado

O **MCP do Afiliado** ([mcpdoafiliado.com](https://mcpdoafiliado.com)) é outro produto, grátis e só para consulta: converte links e busca produtos com as contas que você cadastrou lá, sem cupons, formato, Puxador nem campanhas. Se os dois estiverem ligados no mesmo app, podem aparecer duas opções de converter link: cada uma usa a sua própria conta.

## Próximos passos

- **[Conectar no ChatGPT](/docs/ia/conectar-chatgpt/)**
- **[Conectar no Claude](/docs/ia/conectar-claude/)**
- **[Exemplos de prompts](/docs/ia/exemplos-de-prompts/)**

---

# DOC: Como funcionam os plugins e as rotas de conversão de links
URL: https://botdoafiliado.com/docs/integracoes/como-funcionam/
Atualizado: 2026-11-08
Descrição: Um plugin liga o bot à sua conta de afiliado de uma loja. Com ele ativo, todo link daquela loja sai com o seu código, e o bot cuida do resto.

Um **plugin** liga o bot à sua conta de afiliado de uma loja ou rede, como Shopee, Amazon, AliExpress ou Awin. Com o plugin ativo, todo link daquela loja que passa pelo bot sai com o **seu código de afiliado**.

## O que você ganha ao ativar um plugin

- **Comissão em todo link:** o link da loja sai com o seu código, sem você editar nada.
- **Vale no bot e na API:** a mesma conta serve para o bot do Telegram e para a API.
- **Ofertas montadas sozinhas:** quando a loja permite, o bot puxa nome, preço e foto do produto e guarda o histórico de preço.
- **Sem cadastrar link por link:** ao salvar, o bot já reconhece os links da loja.
- **Mais de uma conta:** dá para ter várias contas na mesma loja e escolher qual o bot usa primeiro.

## Como ativar

Cada loja pede as chaves da sua conta de afiliado. O passo a passo geral está em **[Como ativar um plugin](/docs/integracoes/ativar-plugin/)**, e cada loja tem o seu guia.

## E as rotas?

Uma rota diz ao bot qual plugin usar para os links de um site. O bot cria as rotas sozinho quando você salva um plugin, então você não precisa mexer nelas. Elas só servem para casos próprios, como uma loja sem plugin, em **Configurar › Rotas próprias**.

<img src="/docs/integracoes/rotas.webp" alt="Card Todas as rotas do painel: cada site com a loja que cuida dele" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Na mesma tela, **Testar um link** mostra se um link converte, sem postar nada no Telegram. Cole o link e clique em **Testar**: aparece o **Link convertido** ou **Não converteu**, com o motivo.

<video src="/docs/integracoes/rotas-testar.mp4" poster="/docs/integracoes/rotas-testar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Configurar › Rotas próprias, descer até Testar um link, colar o link de um produto da Shopee, clicar em Testar e ver o Link convertido" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/integracoes/rotas-testar.gif" alt="Vídeo: em Configurar › Rotas próprias, descer até Testar um link, colar o link de um produto da Shopee, clicar em Testar e ver o Link convertido" /></video>

## Próximos passos

- **[Ative o seu primeiro plugin](/docs/integracoes/ativar-plugin/)**.
- Configure uma loja: **[Shopee](/docs/integracoes/shopee/)**, **[Amazon](/docs/integracoes/amazon/)** ou **[AliExpress](/docs/integracoes/aliexpress/)**.
- Link que não converteu: **[Loja não mapeada](/docs/integracoes/loja-nao-mapeada/)**.

---

# DOC: Referência dos módulos: recursos e configuração no painel
URL: https://botdoafiliado.com/docs/planos/modulos/
Atualizado: 2026-11-08
Descrição: Veja o que cada módulo do Bot do Afiliado faz, quanto custa e o que ele resolve no seu dia a dia, para ligar só o que vai usar.

O Bot do Afiliado funciona por partes: você paga o **plano base** e liga só os **módulos** que vão ajudar no seu dia a dia. A assinatura vale por bot. Para comparar combinações, veja **[módulos e preços](/pricing/)**.

## [Plano base](/modulos/plano-base/): R$ 99/mês

Obrigatório, é o mínimo para o bot funcionar: **gerador de links de afiliado** para as lojas conectadas no painel, **link de moedas do AliExpress** para abrir a oferta no app e comandos para engajar os inscritos, como pesquisa.

## Módulos

- **[Ofertas](/modulos/ofertas/)** · grátis, no plano base. O **Postador** e a **Aparência das ofertas** montam o post com texto, preço, foto e link e publicam onde você escolher. *Para você:* post de oferta pronto, sem montar à mão.
- **[Cupons](/modulos/cupons/)** · + R$ 99/mês. Menu `/cupom` por loja, cadastro e importação de cupons e leitura de cupons com IA no painel. *Para você:* os seus inscritos acham o cupom de cada loja direto no bot.
- **[Broadcast](/modulos/broadcast/)** · grátis, no plano base. Manda uma mensagem para as conversas privadas e os grupos que já falaram com o bot. Não envia para canais. *Para você:* avisa todo mundo de uma vez.
- **[Grupos](/modulos/grupos/)** · + R$ 49/mês. Traz Porteiro de canal, proteção contra spam de robôs, reputação e comandos personalizados. *Para você:* grupo organizado e protegido sem moderar à mão.
- **[Sub-bots](/modulos/sub-bots/)** · grátis, no plano base. Adiciona outros bots (tokens extras do BotFather) com as mesmas configurações e contas de afiliado do principal. *Para você:* mais de um bot sem configurar tudo de novo.
- **Conexão IA e API** · + R$ 99/mês. Liga o ChatGPT e o Claude ao seu bot e gera chaves de API para usar a conversão de links no seu próprio sistema. Veja [IA e MCP](/modulos/conexao-ia-e-mcp/) e [API de links](/modulos/api-de-links/). *Para você:* gera links e ofertas conversando com a IA.
- **[Tracking por Usuário](/modulos/tracking-por-usuario/)** · + R$ 49,90/mês. Código de rastreio por pessoa e por loja, seja um usuário do Telegram ou um colaborador postador do painel (**Configurar › Colaboradores**), com as vendas de cada colaborador. *Para você:* sabe quanto cada pessoa da equipe vendeu.
- **[Puxador](/modulos/puxador/)** · + R$ 99,90/mês. Conecta a sua conta do Telegram para acompanhar canais de promoções: troca os links pelos seus, monta a oferta como o seu `/oferta` (ou mantém o texto do canal), separa o destino por palavra-chave, barra o que já saiu no seu canal e entrega para você aprovar. *Para você:* as ofertas de outros canais chegam prontas, com os seus links, só esperando o seu OK.
- **[Shopee Live](/modulos/shopee-live/)** · + R$ 299/mês. Organiza os pedidos de produtos em fila; o apresentador copia o lote e adiciona à live. *Para você:* pedidos da live em ordem, prontos para copiar.
- **[WhatsApp](/modulos/whatsapp/)** · + R$ 49,90/mês com a 1ª conexão grátis e + R$ 29,90 por conexão adicional. Leva os posts dos seus canais do Telegram para grupos e canais de WhatsApp, com o link convertido. Grupos e canais ilimitados, sem limite de mensagens. *Para você:* posta uma vez no Telegram e a oferta chega também no WhatsApp.
- **[Alertas](/modulos/alertas/)** · + R$ 49/mês. Quem visita a sua vitrine cria alertas do que procura (como "air fryer" ou "iphone 15 -usado", com preço máximo se quiser) e recebe um aviso no celular, pelo navegador ou pelo app da vitrine, quando você posta a oferta que casa com o pedido. *Para você:* o seguidor volta sozinho quando sai o produto que ele queria.
- **[Histórico de Preços](/modulos/historico-de-precos/)** · em breve (previsto + R$ 499/mês). Mostra na página da oferta da vitrine e no alerta o histórico de 90 dias do preço na loja e o menor preço já registrado, e deixa o Claude e o ChatGPT consultarem o histórico pelo conector do Bot, com limite de 10 consultas por minuto e 20 por dia. Não tem acesso por API. Ainda não dá para contratar pelo painel.
- **[Rastreamento de vendas avançado](/modulos/rastreamento-avancado/)** · em breve (previsto + R$ 99/mês). Conta o clique de cada oferta por grupo e liga a venda importada do Painel do Afiliado a esse clique. Ainda não dá para contratar pelo painel. *Para você:* saber qual grupo trouxe cada venda.

<img src="/docs/planos/plano-e-modulos.webp" alt="Tela Plano e módulos: um quadro por módulo, com caixa para marcar, preço e o que faz; Ofertas, Broadcast e Sub Bots aparecem como Incluído no plano base; no fim, o Total mensal e o botão Assinar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como escolher

- **Começando?** Fique no plano base e ligue módulos conforme precisar.
- **Posta muitas ofertas?** Acrescente **Cupons**; o **Ofertas** já vem no plano base ([combo Canal de Ofertas](/combos/canal-de-ofertas/)).
- **Tem comunidade em grupos?** Acrescente **Grupos**; o **Broadcast** já vem no plano base ([combo Comunidade](/combos/comunidade/)).
- **Reposta ofertas de outros canais?** **Puxador**.

Os [combos prontos](/pricing/#combos) mostram o preço somado, já sem os módulos grátis.

> **Atenção:** enquanto o bot não confirma a sua assinatura, os recursos pagos (como o Puxador) ficam bloqueados. Eles liberam assim que a confirmação chega.

Decidiu? Veja **[como assinar](/docs/planos/como-assinar/)**.

---

# DOC: Perguntas frequentes (FAQ) do Bot do Afiliado
URL: https://botdoafiliado.com/docs/referencia/faq/
Atualizado: 2026-11-10
Descrição: Respostas rápidas para quem está começando no Bot do Afiliado: como gerar links, quais lojas funcionam, quanto custa, segurança e o que fazer quando algo para.

As dúvidas mais comuns de quem está começando, com respostas curtas. As perguntas estão logo abaixo.

- Quer o passo a passo do zero? Comece pelos **[Primeiros passos](/docs/comecando/primeiros-passos/)**.
- Vai conectar uma loja? Veja **[como funcionam os plugins](/docs/integracoes/como-funcionam/)**.
- Algo parou de funcionar? Veja **[Solução de problemas](/docs/referencia/solucao-de-problemas/)**.
- Dúvida sobre cobrança? Veja o **[FAQ de cobrança](/docs/planos/faq-cobranca/)**.

Não achou a resposta? Escreva para **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.

---

# DOC: Conversão automática e o comando /c: links de afiliado no Telegram
URL: https://botdoafiliado.com/docs/telegram/conversao-automatica/
Atualizado: 2026-11-08
Descrição: Mande um link de loja para o seu bot e ele responde com o seu link de afiliado, sem comando. Com o /c, ele troca todos os links de um post inteiro de uma vez.

Mande um link de loja para o seu bot no Telegram e ele responde com o **seu link de afiliado**, sem precisar de comando. Para trocar todos os links de um post inteiro de uma vez, use o comando **/c**.

O mesmo vale fora do Telegram: em **[Gerar link](/docs/comecando/gerar-links-em-massa/)**, no painel, e na **[extensão do Chrome](/docs/comecando/extensao-chrome/)**.

## O que você ganha

- **Sem comando:** é só colar o link no chat do bot.
- **Vários links de uma vez:** o bot tira os repetidos e devolve cada um convertido, mantendo o seu texto.
- **Post inteiro convertido:** o **/c** troca todos os links de um post e devolve ele formatado.
- **Produto junto:** quando a loja informa, a resposta traz título, preço, imagem e até cupom.
- **Também em grupos:** com o módulo de Grupos, o bot troca o link que alguém postou pelo seu.

## Como converter um link

1. Abra o chat do seu bot no Telegram.
2. Cole o link do produto e envie. Pode mandar vários links na mesma mensagem.
3. O bot responde com o seu link de afiliado.

<img src="/docs/telegram/conversao-link-unico.png" alt="Conversa no Telegram: o usuário envia um link da Magazine Luiza e o bot responde com o link de afiliado encurtado e o card do produto" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Para converter muitos links de uma vez, ou uma planilha, use a tela **[Gerar link](/docs/comecando/gerar-links-em-massa/)** do painel.

<img src="/docs/telegram/gerar-varios-links.webp" alt="Tela Gerar link do painel: três links colados, o botão Gerar 3 links e a tabela Resultados com o link de afiliado de cada um, pronto para copiar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

**Post inteiro:** mande **`/c`** seguido do texto do post. O bot devolve o post com todos os links trocados pelos seus.

## Em grupos

Com o **[módulo de Grupos](/docs/telegram/grupos/)** e a conversão no grupo ligada, o bot converte os links postados no grupo. Ele pode apagar o link original e colocar o **seu** no lugar, inclusive com cupom secreto e desconto.

<img src="/docs/telegram/conversao-auto.png" alt="Grupo no Telegram: um membro posta um link e o bot responde com o produto convertido, preço, cupom secreto e instruções de desconto" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Personalizar o /c (opcional)

Aqui você muda como o **/c** devolve o post: rodapé, negrito e emoji antes do título e do link. O texto do **/oferta** e do Postador fica em outra aba, a **[Texto e rodapé](/docs/telegram/ofertas/)**.

1. No painel, abra **Configurar › Aparência das ofertas**, aba **Resposta do /c**.
2. Em **Prévia**, cole em **Texto de entrada** um post do jeito que ele chega. Em **Como sai no Telegram** aparece o resultado.
3. No card **Customização**, ligue **Ativar customização**.
4. Ajuste o **Rodapé** e a **Formatação**, ou use **Gerar a configuração com IA**: cole até 5 exemplos de como o post chega e como você quer que saia, clique em **Gerar configuração** (leva de 1 a 4 minutos) e depois em **Usar esta configuração**.
5. Confira na **Prévia** e clique em **Salvar**.

## Ajustes opcionais

- **Rodapé:** texto no fim de todo post convertido. A caixa **Ativo** liga e desliga.
- **Destaques:** em **Formatação**, ligue **Título em negrito**, **Preço em negrito** e **Código do cupom em monoespaçado** (copia com um toque no Telegram).
- **Remover https://:** esconde o começo do link, que continua clicável.
- **Mensagem de erro:** o que o bot responde quando o /c não acha link no texto. `{from}` vira o nome de quem mandou.
- **Regras (substituições):** trocam um texto por outro em todo post convertido.

> **Dica:** para negrito e itálico use `<b>texto</b>` e `<i>texto</i>`. Markdown (asteriscos) não funciona.

## Como saber se funcionou

Mande um link de produto para o seu bot. Se ele responder com um link diferente, pronto: esse é o seu.

## Se algo não der certo

- **Os campos de formatação não aparecem:** ligue **Ativar customização** no card **Customização**.
- **Mudei a tela e o /c continua igual:** clique em **Salvar**. Enquanto aparecer **Alterações não salvas**, nada mudou no bot.
- **O link quebrou depois de uma regra:** regra de substituição que mexe no link quebra a conversão. Desligue ou edite a regra.
- **O bot não converte no grupo:** confira se o módulo de Grupos está ativo e a conversão no grupo ligada.

## Próximos passos

- Converta centenas de links em **[Gerar link](/docs/comecando/gerar-links-em-massa/)**.
- Escolha se o link sai curto em **[encurtador](/docs/telegram/encurtador/)**.
- Veja todos os comandos na **[referência de comandos](/docs/telegram/comandos/)**.

---

# DOC: Módulo WhatsApp do Bot do Afiliado: o que faz e por onde começar
URL: https://botdoafiliado.com/docs/whatsapp/comecando/
Atualizado: 2026-11-08
Descrição: O módulo WhatsApp repete os posts do seu canal do Telegram nos seus grupos e canais de WhatsApp, já com o seu link de afiliado. Veja o que precisa e a ordem dos passos.

O módulo WhatsApp pega o que você publica no seu canal do Telegram e repete nos grupos e canais de WhatsApp que você escolher, com a foto, o vídeo, o texto e **o seu link de afiliado**. Você continua postando só no Telegram.

> **Módulo pago:** R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, com grupos e canais ilimitados. Veja [preço e limites](/docs/whatsapp/planos-e-limites/).

## O que você ganha

- **Posta uma vez, sai nos dois:** o post do Telegram chega sozinho nos seus grupos de WhatsApp.
- **Comissão garantida:** os links saem convertidos para o seu link de afiliado.
- **Envio com calma:** um grupo de cada vez, com intervalo, sem disparar em rajada.
- **Vários números juntos:** eles dividem os envios no mesmo grupo e, se um cair, os outros assumem.
- **Grupos que crescem sozinhos:** quando um grupo lota, o bot pode criar o próximo, e o link que você divulga continua o mesmo.

## Antes de começar

1. O seu **bot do Telegram** cadastrado no painel ([primeiros passos](/docs/comecando/primeiros-passos/)).
2. Esse bot como **administrador** do canal ou grupo do Telegram de onde saem as ofertas.
3. Um **número de WhatsApp** só para as ofertas, com o celular por perto.

## Os passos, em ordem

1. **Conecte o número:** em **WhatsApp › Números**, leia o QR code com o celular. Veja [Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/).
2. **Confira a fonte:** em **WhatsApp › Fontes**, veja se o seu canal do Telegram aparece e cadastre-o. Veja [Fontes do Telegram](/docs/whatsapp/conectar-telegram/).
3. **Crie a campanha:** no menu, em **Campanhas**, escolha os grupos que recebem e a fonte. Veja [Criar campanhas](/docs/whatsapp/criar-campanha/).
4. **Teste:** mande um post de teste e confira no grupo.

Na tela **Campanhas**, o guia **Sua primeira campanha** acompanha esses passos e marca cada um quando fica pronto.

> **Atenção:** só conectar o número não publica nada. Os posts começam a sair quando há uma campanha ativa com uma fonte e pelo menos um grupo com **recebe ofertas** ligado.

## Cuidado com o número

Todo número que publica muito corre risco de bloqueio. Para diminuir esse risco, use um número só para as ofertas e aqueça ele aos poucos com o botão **Aquecer**, no cartão do número. Veja [aquecimento](/docs/whatsapp/aquecimento/).

## Onde fica cada coisa

No menu lateral, em **Comunidade e envio**, a tela **WhatsApp** guarda os números, grupos e envios, e a tela **Campanhas** guarda quais grupos recebem e o [link de entrada](/docs/whatsapp/link-e-grupos/). Problemas aparecem na aba **Incidentes** da tela WhatsApp ([Incidentes e notificações](/docs/whatsapp/incidentes-e-alertas/)).

<img src="/docs/whatsapp/visao-geral.webp" alt="Tela WhatsApp aberta pelo menu lateral, na aba Visão geral: no alto o botão Adicionar número e as abas Números, Grupos e canais, Aprovação de entrada, Canais, Fontes, Envios, Estatísticas e Incidentes; embaixo, a saúde dos grupos, os números conectados e os envios por dia" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

---

# DOC: Autenticação na API: como usar a chave de API (X-API-Key)
URL: https://botdoafiliado.com/docs/api/autenticacao/
Atualizado: 2026-11-08
Descrição: Como gerar e usar chaves de API do Bot do Afiliado, autenticar com o header X-API-Key e revogar ou excluir chaves no painel. Requer o módulo Conexão IA e API.

A API usa **chaves de API** geradas no painel. Cada chave tem o formato `bk_<prefixo>.<segredo>` e é enviada no header **`X-API-Key`**. O recurso exige o módulo **Conexão IA e API** ativo.

## Como chegar

Menu → **Configurar** → **API e IA (MCP)**. A tela tem três abas: **Chaves de API**, **Script do site** e **IA (MCP)**.

Acima das abas fica o **ID do bot**, com o botão de copiar. Use onde a integração pedir `bot_id`. A chave de API já identifica o bot sozinha, então o ID só serve em integração que peça o ID explícito.

## Gerar uma chave

1. Ative o **[módulo Conexão IA e API](/docs/planos/modulos/)**.
2. Em **API e IA (MCP)**, abra a aba **Chaves de API**.
3. No card **Criar chave de API**, dê um **nome** (opcional), escolha o **nível de permissão** e clique em **Criar**.
4. **Copie a chave completa** no card que aparece ("Chave criada no nível ... (copie agora)"). Se precisar dela de novo, use **Mostrar** na linha da chave (só o dono e os admins da organização, e só em chaves criadas a partir de 16/10/2026).

O botão **Conectar IA (MCP) →** do card da chave criada leva à aba **IA (MCP)**, já com a chave nos comandos. Veja **[O que é o MCP](/docs/ia/o-que-e-mcp/)**.

<img src="/docs/api/api-keys.webp" alt="Aba Chaves de API: o card Criar chave de API com Nome (opcional), o nível Padrão e o botão Criar; embaixo, a lista de chaves com Nome, Chave e Mostrar, o seletor de Nível, a Origem padrão com Trocar ou Definir, e Revogar e Excluir em cada linha" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## A lista de chaves

| Coluna | O que mostra |
|---|---|
| **Nome** | O nome da chave, quando foi criada e quando foi usada pela última vez ("nunca usada", "usada há 2 h"). Chave revogada ganha o selo **Revogada**. |
| **Chave** | O prefixo da chave e o botão **Mostrar**, que abre a chave inteira (com **Ocultar** e copiar). Em chave criada antes de 16/10/2026, o painel avisa que não dá para mostrar de novo. |
| **Nível** | Seletor com **Leitura**, **Padrão** e **Total**. Trocar vale na chamada seguinte. |
| **Origem padrão** | O destino que vale quando a chamada não diz onde o link vai. **Definir** ou **Trocar** abre o tipo (**Grupo**, **Canal**, **Site** ou **Post**) e o id. |
| Última coluna (sem título) | **Revogar** e **Excluir**. |

Você pode ter várias chaves, uma por integração ou sistema, e revogar cada uma separadamente.

### Origem padrão

A **Origem padrão** vale quando a chamada à API não manda `chat_id` nem `origem`: é como se mandasse esta origem. Serve para a integração que só converte e não sabe dizer o destino. Grupo e canal do Telegram usam o id do chat (ex.: `-1001234567890`); site usa o domínio (ex.: `meusite.com.br`); post usa um nome curto (ex.: `black-friday`). O id tem até 64 caracteres, só letras, números e `_ : . -`. O que vier no pedido ganha da origem padrão. Detalhes em **[convert-links](/docs/api/convert-links/)**.

## 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..."}'
```

## Níveis de permissão

Cada chave é criada com um **nível**, escolhido no painel. Ele limita o que aquela chave pode fazer na API (e nas ferramentas MCP, que passam pelos mesmos endpoints):

| Nível | Vale para | Endpoints |
|---|---|---|
| **Leitura** (`read`) | Consulta que **não** devolve link de afiliado nem gasta cota do marketplace | `/api/v1/coupons` (GET), `/coupons/categories`, `/templates` (GET), `/showcase/items` (GET), `/bot`, `/userbot/config` (GET), `/userbot/history`, `/userbot/preview-rules` |
| **Padrão** (`write`) | Leitura + operação do dia a dia | tudo de Leitura + `/convert`, `/convert-links`, `/product`, `/product/shipping`, `/product/history`, `/execute`, `/chat`, `/search-products`, `/amazon-prices`, `/promo-card`, `/watermark`, `/showcase/items` (POST e DELETE) |
| **Total** (`admin`) | Tudo, incluindo importar e apagar cupom, editar os textos do bot e configurar o Puxador | tudo de Padrão + `/coupons/ingest`, `/coupons/ingest-plugins`, `/coupons/{id}` (DELETE), `/coupons/{id}/activate`, `/templates` (POST), `/userbot/config` (POST) |

Os endpoints `/userbot/*` são os do **[Puxador](/docs/telegram/userbot/)**.

**Todo endpoint que devolve link de afiliado é Padrão**, mesmo parecendo consulta: `/product`, `/search-products` e `/amazon-prices` geram ou entregam link com a sua tag, que é exatamente o que uma chave de Leitura não deve fazer. Leitura fica com o que só informa: frete, histórico de preço, cupons e templates já cadastrados.

Ao conectar a IA por **MCP com login (OAuth)**, sem colar chave, o nível vem do seu papel na organização: **dono e admin → Total**, **postador → Padrão**.

Uma chamada acima do nível da chave responde **403** com `insufficient_scope`:

```json
{ "success": false, "error": "insufficient_scope" }
```

O nível é escolhido na criação e **pode ser trocado depois**: na lista de chaves, a coluna **Nível** é um seletor. Trocar **não rotaciona o segredo**: a mesma chave continua valendo, com o novo nível já na chamada seguinte. Chaves criadas antes desta mudança continuam em **Total** até você rebaixá-las.

Use o menor nível que resolve: a chave que só lê preço no seu site não precisa poder apagar cupom.

## Revogar ou excluir

Na aba **Chaves de API**, cada chave tem duas ações:

- **Revogar**: desativa a chave (efeito imediato), mas **mantém o registro** na lista (útil para auditoria e histórico). Não dá para reativá-la. Integrações que usam a chave (MCP, API, IA) param na hora.
- **Excluir**: **remove a chave de vez** da lista. Chaves já revogadas também podem ser excluídas para limpar a lista.

## Segurança

- A chave completa **não fica armazenada** em texto puro: a API confere a chave por um hash, e a cópia que o **Mostrar** abre fica cifrada. Na lista, o painel mostra só o **prefixo**, e cada Mostrar fica no log de auditoria.
- Crie a chave no **menor nível** que atende à integração (ver [Níveis de permissão](#níveis-de-permissão)).
- **Revogue ou exclua** chaves comprometidas na aba Chaves de API (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/
Atualizado: 2026-11-10
Descrição: Crie o seu bot pelo painel em poucos minutos, sem BotFather e sem token, conecte uma loja e receba o seu primeiro link de afiliado no Telegram.

Em três passos você cria o seu bot do Telegram, conecta a loja em que é afiliado e recebe o **primeiro link com o seu código de afiliado**. Leva poucos minutos.

## O que você ganha

- **Bot pronto sem complicação:** o Telegram cria o bot no seu nome e ele já chega conectado ao painel, sem BotFather e sem token.
- **Seu link em segundos:** você manda um link comum da loja e o bot devolve o seu link de afiliado.
- **Post mais completo:** quando a loja permite, o bot responde também com título, preço e foto do produto.

## Antes de começar

Tenha o **Telegram** aberto e, à mão, os dados do programa de afiliados da loja que você vai conectar.

## Passo 1: criar o bot

1. Abra o **[painel](https://app.botdoafiliado.com/)**. Na tela **Vamos começar**, procure o cartão **Criar meu bot pelo Telegram**.

<img src="/docs/comecando/vamos-comecar.webp" alt="Tela Vamos começar: em cima, o cartão Criar meu bot pelo Telegram, com o campo Nome do bot (opcional) e o botão Criar meu bot pelo Telegram; embaixo, o cartão Já tenho um bot, com os campos Token do Telegram e Nome (opcional) e o botão Continuar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. Se quiser, dê um **nome** ao bot (é opcional).
3. Clique em **Criar meu bot pelo Telegram**. O Telegram abre numa nova aba.
4. No Telegram, toque em **Iniciar** (se ele pedir), depois em **Criar meu bot**, e confirme.
5. Volte ao painel. A tela avança sozinha quando o bot fica pronto e abre o **Início**, com o roteiro **Deixe o bot pronto**.

> **Atenção:** o link do Telegram vale por 30 minutos. Se passar disso, clique em **Criar meu bot pelo Telegram** de novo.

## Passo 2: conectar uma loja

1. No menu, abra **Configurar › Lojas** (ou clique em **Conectar loja**, no roteiro do Início).
2. Escolha a loja em que você já é afiliado.
3. Cole os seus dados de afiliado e salve.

Não sabe o que colar? Veja o guia da sua loja: **[Shopee](/docs/integracoes/shopee/)**, **[AliExpress](/docs/integracoes/aliexpress/)** ou **[Amazon](/docs/integracoes/amazon/)**.

## Passo 3: converter o primeiro link

Abra a conversa com o **seu** bot no Telegram e mande um link de produto da loja que você conectou. Ele responde com o seu link de afiliado.

<img src="/docs/comecando/conversao-exemplo.png" alt="Conversa no Telegram: link da loja enviado e o bot respondendo com o link de afiliado" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Já tem um bot?

Se você já criou um bot no **[@BotFather](https://t.me/BotFather)**, use o cartão **Já tenho um bot**, na mesma tela **Vamos começar**:

1. Cole o **token** do bot. O token é a senha do bot que o BotFather mostrou quando você o criou. Não mostre para ninguém nem deixe aparecer em print.
2. Confira o **nome** e clique em **Continuar**.

Para criar outro bot depois, use **Criar novo bot** no seletor de bot, no topo do menu lateral.

## Se algo não der certo

- **O bot não responde:** confira se está falando com o bot certo e se ele aparece no seletor de bot do painel. Se conectou pelo token, confira se colou o token certo.
- **O link voltou sem mudar:** confira se a conta da loja desse link está ligada em **Configurar › Lojas**.

## Próximos passos

- Conheça os **[módulos](/docs/planos/modulos/)** (Ofertas, Cupons, Broadcast, Grupos) para quando a sua operação crescer.
- Ainda com problema? Veja **[Solução de problemas](/docs/referencia/solucao-de-problemas/)**.

---

# DOC: Como conectar o Bot do Afiliado no Claude (MCP)
URL: https://botdoafiliado.com/docs/ia/conectar-claude/
Atualizado: 2026-11-08
Descrição: Conecte o Bot do Afiliado ao Claude em poucos cliques, pelo diretório do Claude e com o seu login, sem chave, e gere links, buscas e posts de oferta conversando.

Conectando o Claude ao seu Bot do Afiliado, você gera links de afiliado, busca produtos e monta ofertas **conversando no Claude**, no site ou no app. A conexão é pelo login da sua conta do Bot, sem chave e sem copiar endereço.

> **Precisa do módulo Conexão IA e API.** Veja **[módulos](/docs/planos/modulos/)**.

## O que você ganha

- **Seu link sem sair do chat:** cole o link da loja e receba o seu link de afiliado.
- **Busca falada:** peça por loja e faixa de preço e receba foto, preço e o seu link.
- **Post pronto:** o texto da oferta sai no formato do seu bot.

## Como configurar

1. No [painel do Bot](https://app.botdoafiliado.com/), abra **Configurar › API e IA (MCP)** e a aba **IA (MCP)**.
2. No card **Claude.ai**, clique em **Abrir no diretório do Claude**. A página do Bot do Afiliado abre no Claude.
3. Clique em **Conectar**.
4. Entre com a sua **Central do Afiliado**, escolha o bot e autorize.

<video src="/docs/ia/conectar-claude.mp4" poster="/docs/ia/conectar-claude.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Configurar › API e IA (MCP), abrir a aba IA (MCP), ver no card Claude.ai o botão Abrir no diretório do Claude, clicar em Copiar URL e ver o Claude em Conexões de IA ativas" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/ia/conectar-claude.gif" alt="Vídeo: em Configurar › API e IA (MCP), abrir a aba IA (MCP), ver no card Claude.ai o botão Abrir no diretório do Claude, clicar em Copiar URL e ver o Claude em Conexões de IA ativas" /></video>

**Outro jeito, colando o endereço:** no mesmo card, clique em **Copiar URL** e depois em **Conector personalizado**. No Claude, cole o endereço na janela de adicionar conector, confirme e siga o passo 4. O endereço copiado já aponta para o seu bot.

## Como saber se funcionou

Peça *"Converta este link em afiliado:"* e cole um link de produto. Se voltar um link novo, pronto. O Claude também aparece em **Conexões de IA ativas**, no painel.

## Ajustes opcionais

- **Claude Desktop ou Claude Code:** entram com uma chave de API, não com login. Crie a chave na aba **Chaves de API**. Depois, copie o comando do card **Claude Code** e rode no terminal, ou, no card **Claude Desktop**, abra **Ver a configuração (mcp-remote)**, clique em **Copiar a configuração** e cole no arquivo `claude_desktop_config.json`.

> **Atenção:** não cole a chave de API na conversa nem em arquivo público. Se revogar a chave em **Chaves de API**, a conexão do Desktop ou do Code para de funcionar.

## Se algo não der certo

- **Não aparece a opção de conectar:** no Claude de empresa, um responsável pode precisar liberar os conectores. Veja a [ajuda oficial do Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).
- **O Claude diz que o módulo não está ativo:** ative o **Conexão IA e API** ([como assinar](/docs/planos/como-assinar/)).

## Próximos passos

- **[Exemplos de prompts](/docs/ia/exemplos-de-prompts/)** para começar a pedir.
- **[O que é o MCP](/docs/ia/o-que-e-mcp/)** para ver tudo o que a IA faz com o seu bot.

---

# DOC: Como ativar um plugin (conversor) no Bot do Afiliado
URL: https://botdoafiliado.com/docs/integracoes/ativar-plugin/
Atualizado: 2026-11-08
Descrição: Conecte a sua conta de afiliado de uma loja ao bot em poucos passos e todo link daquela loja passa a sair com o seu código, sem configurar mais nada.

Um plugin liga o bot à sua conta de afiliado de uma loja, como Shopee, Amazon ou AliExpress. Com ele ativo, todo link daquela loja sai com o **seu código**. O passo a passo é parecido em todas as lojas.

## O que você ganha

- **Comissão em todo link:** os links da loja saem com o seu código de afiliado.
- **Configura uma vez:** depois de salvar, o bot reconhece os links da loja sozinho.
- **Teste na hora:** o painel testa a conta assim que você cola as chaves.
- **Redes de uma vez:** na Awin, na Rakuten e na CityAds, as lojas aprovadas na rede entram sozinhas ao salvar.

## Como ativar

1. No painel do seu bot, abra **Configurar › Lojas**.
2. Na lista, escolha a loja ou rede em que você é afiliado.
3. Clique no botão **Conectar** com o nome da loja (ex.: **Conectar Shopee**).
4. Cole as chaves que a loja pede. O guia de cada loja, logo abaixo, diz o que colar e onde pegar.
5. Clique em **Salvar**.

<img src="/docs/integracoes/plugins-aba.webp" alt="Tela Lojas do painel: a lista mostra quais lojas estão conectadas e, à direita, a loja escolhida com o botão Conectar Magalu" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Pronto. Os links daquela loja já saem com o seu código e você não precisa configurar mais nada.

## O que cada loja pede

- **[AliExpress](/docs/integracoes/aliexpress/):** App Key, App Secret e o seu tracking ID (PID).
- **[Amazon](/docs/integracoes/amazon/):** só a sua tag de associado. Nome, foto e preço nas ofertas são opcionais.
- **[Shopee](/docs/integracoes/shopee/):** ID do app e Chave secreta.
- **[Mercado Livre](/docs/integracoes/mercado-livre/):** a sua tag. A conexão vem pela extensão do Chrome.
- **[Magalu](/docs/integracoes/magalu/):** cole um link de afiliado seu e o ID é lido sozinho.
- **[Awin](/docs/integracoes/awin/)**, **[Rakuten](/docs/integracoes/rakuten/)** e **[CityAds](/docs/integracoes/cityads/):** as chaves da rede.
- **[Terabyte](/docs/integracoes/terabyte/):** o seu ID de afiliado.
- **[Pague Menos](/docs/integracoes/pague-menos/):** só o código do consultor.
- **[Braé](/docs/integracoes/brae/)**, **[Beleza na Web](/docs/integracoes/belezanaweb/)** e **[Natura](/docs/integracoes/natura/):** o seu código e, se quiser, um cupom.

## Ajustes opcionais

- **Duas contas na mesma loja:** clique em **Adicionar outra conta**. O bot usa primeiro a de maior número em **Prioridade** (em **Mais opções: nome, prioridade e rastreamento**). Na lista, **Usar esta primeiro** resolve isso por você.
- **Pausar sem apagar:** clique em **Desativar** na linha da conta.
- **Apagar:** clique em **Configurar** na conta e depois em **Excluir**.
- **Redes (Awin, Rakuten, CityAds):** ao abrir uma conta já salva, **Atualizar lojas** traz de novo as lojas aprovadas.

## Como saber se funcionou

O card **Teste da conta** roda sozinho assim que as chaves estão preenchidas e mostra se deu certo. No AliExpress, enquanto o **Rastreamento padrão** estiver vazio, ele avisa que o link de teste não foi gerado; as chaves continuam valendo.

Depois, mande um link da loja para o seu bot no Telegram. Se ele responder com um link novo, esse link já é o seu.

## Se algo não der certo

- **O teste da conta falhou:** confira se as chaves estão certas e ativas no portal da loja, e se a sua conta de afiliado tem aprovação e acesso liberado.
- **O link não converteu:** veja **[Loja não mapeada](/docs/integracoes/loja-nao-mapeada/)**.

## Próximos passos

- Conecte a primeira loja: **[Shopee](/docs/integracoes/shopee/)**, **[Amazon](/docs/integracoes/amazon/)** ou **[AliExpress](/docs/integracoes/aliexpress/)**.
- Entenda **[o que é um plugin](/docs/integracoes/como-funcionam/)**.

---

# DOC: Como assinar o Bot do Afiliado e ativar os módulos
URL: https://botdoafiliado.com/docs/planos/como-assinar/
Atualizado: 2026-11-08
Descrição: Assine o Bot do Afiliado em poucos cliques: marque o plano base e só os módulos que quer, pague pelo Stripe e os módulos ligam sozinhos logo depois.

Para assinar, você abre a tela **Plano e módulos**, marca o plano base e os módulos que quer e paga pelo **Stripe**. Os módulos ligam sozinhos logo depois do pagamento.

## O que você ganha

- **Paga só o que usa:** o plano base é obrigatório e o resto você escolhe módulo por módulo.
- **Liga na hora:** pagou, os módulos já aparecem liberados no painel.
- **Pagamento seguro:** quem cobra é o Stripe; o Bot do Afiliado não guarda os dados do seu cartão.
- **Muda quando quiser:** dá para pôr ou tirar módulos depois, pagando só a diferença.

## Antes de começar

Só o **dono da organização** consegue assinar. Confira no seletor de bot, no topo do menu lateral, se o bot certo está selecionado: a assinatura vale para ele.

## Como assinar

1. No menu lateral, clique em **Plano e módulos** (em **Ajustes**; também fica no menu **Conta**, no rodapé).
2. O **plano base** já vem marcado, porque é obrigatório. Marque os módulos extras que você quer.
3. Se marcou o WhatsApp, escolha em **Números de WhatsApp (1 a 20)** quantos números quer.
4. Confira o **Total mensal** e clique em **Assinar**.
5. Conclua o pagamento na tela do **Stripe** que abrir.

<video src="/docs/planos/assinar-modulo.mp4" poster="/docs/planos/assinar-modulo.webp" autoplay muted loop playsinline controls aria-label="Vídeo: no menu, abrir Plano e módulos, ver o Plano Base já marcado, marcar o Módulo de Grupos, conferir o Total mensal e parar no botão Assinar" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/planos/assinar-modulo.gif" alt="Vídeo: no menu, abrir Plano e módulos, ver o Plano Base já marcado, marcar o Módulo de Grupos, conferir o Total mensal e parar no botão Assinar" /></video>

> **Dica:** viu um recurso travado com o botão **Ativar módulo** (ou **Comprar módulo**)? Clique nele: a tela **Plano e módulos** abre com aquele módulo já marcado.

## Como saber se funcionou

Você volta ao painel com o aviso **Assinatura atualizada.** Na tela **Plano e módulos**, os módulos que você pagou aparecem como **Contratado**.

## Mudar o plano depois

Com a assinatura ativa, o botão vira **Atualizar plano**. Marque ou desmarque módulos, clique nele e você paga só a diferença, sem abrir uma segunda assinatura. Para trocar o cartão ou cancelar, use **Gerenciar assinatura**. Veja **[gerenciar assinatura](/docs/planos/gerenciar-assinatura/)**.

## Se algo não der certo

- **Não acho Plano e módulos:** só o dono da organização vê esse atalho. Peça a ele para assinar.
- **Apareceu "Não foi possível carregar os planos":** clique em **Tentar novamente**. O valor e o botão de pagar só aparecem depois que os planos carregam.
- **Cliquei em Ativar módulo e não consigo assinar:** esse módulo ainda não está à venda, e a tela avisa isso.

## Indicação

Quer indicar o Bot do Afiliado e ganhar comissão? O cadastro, as regras e os pagamentos ficam no [IndicaSaaS](https://indicasaas.com/), não no painel do Bot.

## Próximos passos

- Veja o que cada um faz em **[módulos e preços](/docs/planos/modulos/)**.
- Tire dúvidas no **[FAQ de cobrança](/docs/planos/faq-cobranca/)**.

---

# DOC: Solução de problemas comuns do Bot do Afiliado
URL: https://botdoafiliado.com/docs/referencia/solucao-de-problemas/
Atualizado: 2026-11-08
Descrição: O bot não responde, o link não virou link de afiliado ou a conta da loja não passa no teste? Veja o que fazer em cada caso, passo a passo.

Os problemas mais comuns e o que fazer em cada um. Se nada resolver, escreva para **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.

## O bot não responde

1. Em **Configurar › Perfil e acesso**, no card **Bot principal**, confira se aparece **Token configurado**. Se precisar trocar, use **Trocar token** com um token do mesmo bot.
2. Confira se você está falando com o bot certo no Telegram (o @ dele).
3. Confira se você está no workspace onde o bot foi criado.

## Apareceu "Token já cadastrado"

- Gere um token novo no BotFather ou tire esse token do outro bot ou sub-bot onde ele está.
- Se o bot foi criado pelo painel, use **Gerar token novo**, no card **Segurança do bot** ([Perfil e acesso](/docs/comecando/configuracoes-do-bot/)).

## Apareceu "Use um token do mesmo bot"

- Cole o token do bot certo. Se você quer usar o outro bot no mesmo painel, adicione ele em **Gerenciar sub-bots**.

## O link não virou link de afiliado

1. Em **Configurar › Lojas**, confira se a conta da loja está ligada e com os seus dados de afiliado.
2. Em **Configurar › Rotas próprias**, cole o link em **Testar um link**. O painel mostra o link convertido ou o motivo.
3. Loja de rede (Awin, Rakuten, CityAds): confira se você foi aprovado nessa loja e use **Atualizar lojas** no cartão **Teste da conta** da loja ou o cartão **Importar rotas das redes** em **Configurar › Rotas próprias**.
4. Se ainda não converter, veja **[Loja não mapeada](/docs/integracoes/loja-nao-mapeada/)**.

## O Teste da conta falhou

- Confira se os dados estão certos e ativos no site do programa de afiliados.
- Confira se a sua conta tem acesso à API do programa. Na Amazon, use a Creators API, que não exige vendas para liberar.
- Confira se **Conta ligada** está marcada, em **Mais opções: nome, prioridade e rastreamento**.

## O Mercado Livre parou de converter

- Entre de novo no Mercado Livre no Chrome onde está a **[extensão](/docs/comecando/extensao-chrome/)**, com o Mercado Livre ligado em **Cookies das lojas**. A extensão manda o acesso novo para o plugin **[Mercado Livre](/docs/integracoes/mercado-livre/)** sozinha.

## Outros problemas

- WhatsApp: veja **[Problemas comuns do WhatsApp](/docs/whatsapp/problemas-comuns/)**.
- Dúvidas gerais: veja o **[FAQ](/docs/referencia/faq/)**.

---

# DOC: Comandos do Bot Afiliado no Telegram: a lista completa
URL: https://botdoafiliado.com/docs/telegram/comandos/
Atualizado: 2026-11-08
Descrição: Os comandos do Bot do Afiliado no Telegram que você usa no dia a dia, com um exemplo de cada, e como criar comandos seus com texto, foto e botões.

Você não precisa de comando para converter link: é só mandar o link para o bot (veja **[conversão automática](/docs/telegram/conversao-automatica/)**). Os comandos abaixo servem para tarefas específicas, como pesquisar produtos no AliExpress ou montar uma oferta. Alguns só funcionam com um módulo ativo ou com uma chave ligada (veja **[Funcionalidades](/docs/comecando/funcionalidades/)**).

## Converter e encurtar

- **`/converter`** (ou `/c`): troca todos os links de um texto pelos seus links de afiliado. Exemplo: `/c Baixou o preço! https://...`
- **`/encurtar`**: troca pelo seu link de afiliado, quando a loja tem conversão, e encurta. Precisa da chave **Encurtador de links**, no card **Comandos de encurtar** de **Configurar › Comandos**. Exemplo: `/encurtar https://...`
- **`/soencurtar`**: só encurta, sem trocar o link. Precisa da chave **Só encurtar**, no mesmo card. Exemplo: `/soencurtar https://...`
- **`/historico`**: mostra o histórico de preços de um produto do Mercado Livre. Exemplo: `/historico https://www.mercadolivre.com.br/...`

## Ofertas e cupons

- **`/oferta`** (módulo **Ofertas**): monta uma oferta formatada, com título, preço e chamada, em ordem de preço. Pode levar um código de cupom antes dos links. Exemplo: `/oferta CUPOM10 link1 link2`
- **`/cupom`** (módulo **Cupons**): abre o menu de cupons, onde a pessoa escolhe a categoria ou a loja e busca o cupom que quer. Exemplo: `/cupom`

## AliExpress

- **`/moedas`** (ou `/moeda`): gera o link com desconto de moedas do produto. Também funciona respondendo a uma mensagem que já tenha o link. Exemplo: `/moedas https://pt.aliexpress.com/item/...`
- **`/addcarrinho`**: gera o link que coloca o produto no carrinho. Exemplo: `/addcarrinho https://pt.aliexpress.com/item/...`
- **`/promo`** (ou `/promos`): gera vários links promocionais do produto de uma vez (moedas, relâmpago, super ofertas, combo). Exemplo: `/promo https://pt.aliexpress.com/item/...`
- **`/pesquisar`** (ou `/procurar`): pesquisa produtos com super desconto de moedas. Exemplo: `/pesquisar fone bluetooth`
- **`/pesquisarcombo`**: pesquisa ofertas em combo. Exemplo: `/pesquisarcombo meias`
- **`/pesquisachoice`**: pesquisa produtos Choice, de envio rápido. Exemplo: `/pesquisachoice carregador`
- **`/pesquisabrasil`**: pesquisa produtos enviados do Brasil. Exemplo: `/pesquisabrasil relógio`
- **`/pesquisarmagalu`**: pesquisa produtos da loja Magalu no AliExpress. Exemplo: `/pesquisarmagalu panela`
- **`/pesquisaralinomagalu`**: pesquisa a loja AliExpress no Magalu. Exemplo: `/pesquisaralinomagalu panela`

## Boas-vindas e grupos

- **`/start`**: mostra a mensagem de boas-vindas do bot. Exemplo: `/start`
- **`/adicionargrupo`**: mostra o link para adicionar o bot a um grupo. Exemplo: `/adicionargrupo`

Para mandar uma mensagem para todos os chats do bot, veja **[Broadcast](/docs/telegram/broadcast/)**.

## Escolher o que aparece no menu "/"

1. No painel, abra **Configurar › Comandos**.
2. No card **Menu de comandos do Telegram**, marque os comandos que devem aparecer e desmarque os que quer esconder.
3. Clique em **Salvar e aplicar**. O menu muda no Telegram na hora.

O menu não precisa de módulo.

<img src="/docs/telegram/comandos-menu.webp" alt="Card Menu de comandos do Telegram: os botões Salvar e aplicar, Recarregar, Marcar todos e Desmarcar todos, o contador 9/11 no menu e a lista de comandos com uma caixa marcada ou desmarcada em cada um" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Criar um comando seu

Um comando seu responde com o texto que você escrever, e pode ter foto e botões de link. Precisa do módulo **Grupos**.

1. Em **Configurar › Comandos**, no card **Comandos próprios**, clique em **Novo comando**.
2. Em **Nome do comando**, digite o nome (ex.: `/meucomando`).
3. Deixe marcado **ativo** e, se quiser, **aparecer no menu “/” do Telegram**.
4. Escreva a resposta. Clique numa variável para colocar no texto.
5. Se quiser, ponha uma foto em **Foto (opcional)** (até 5 MB) e até 6 botões de link em **+ Adicionar botão**.
6. Clique em **Salvar**.

<video src="/docs/telegram/comando-criar.mp4" poster="/docs/telegram/comando-criar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Configurar › Comandos, clicar em Novo comando, digitar o nome /grupos, escrever a resposta com a variável {nome}, pôr um botão com o link do grupo, clicar em Salvar e ver o /grupos na lista de comandos" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/telegram/comando-criar.gif" alt="Vídeo: em Configurar › Comandos, clicar em Novo comando, digitar o nome /grupos, escrever a resposta com a variável {nome}, pôr um botão com o link do grupo, clicar em Salvar e ver o /grupos na lista de comandos" /></video>

Variáveis que você pode usar na resposta:

| Variável | Vira |
|---|---|
| `{nome}` | Primeiro nome de quem usou o comando. |
| `{@usuario}` | Menção clicável (a pessoa é notificada). |
| `{usuario}` | Nome de usuário sem @, quando existir. |
| `{id}` | ID da pessoa no Telegram. |
| `{chatid}` | ID do grupo ou da conversa. |
| `{bot}` | Nome do bot. |
| `{data}` | Data atual. |
| `{hora}` | Hora atual. |

Título, preço e link de oferta não funcionam aqui.

<img src="/docs/telegram/comando-novo.webp" alt="Janela Novo comando preenchida: o nome /grupos com ativo e aparecer no menu do Telegram marcados, os botões de negrito, itálico e link, as variáveis de {nome} a {hora}, a resposta com {nome}, o campo Foto (opcional) e um botão Entrar no grupo com o link do grupo" style="display:block;margin:18px auto;max-width:560px;width:100%;border-radius:12px;border:1px solid var(--border)" />

**Sobre o nome do comando:**

- Se o nome for igual ao de um comando do bot (ex.: `/cupom`), o bot passa a responder com o seu. Alguns não podem ser trocados, como `/start` e `/adicionargrupo`.
- Não use apelido. Em vez de `/moeda`, `/promos`, `/c` ou `/procurar`, use `/moedas`, `/promo`, `/converter` ou `/pesquisar`.

## Próximos passos

- Monte ofertas com **[Ofertas](/docs/telegram/ofertas/)** e cadastre **[Cupons](/docs/telegram/cupons/)**.
- Veja **[moedas e cupom secreto do AliExpress](/docs/telegram/aliexpress-moedas-cupom/)**.

---

# DOC: Conectar um número de WhatsApp no Bot do Afiliado: QR code, código de pareamento e grupos
URL: https://botdoafiliado.com/docs/whatsapp/conectar-whatsapp/
Atualizado: 2026-11-08
Descrição: Conecte o seu número de WhatsApp ao bot lendo um QR code com o celular. Os grupos e canais dele aparecem sozinhos no painel, sem instalar nada.

Conectar o número é o primeiro passo do módulo WhatsApp: você lê um QR code com o celular e os grupos e canais desse número aparecem sozinhos no painel, na aba **Números** da tela **WhatsApp**.

## O que você ganha

- **Nada para instalar:** o número entra como aparelho conectado, igual ao WhatsApp Web. O seu celular continua sendo o dono da conta.
- **Grupos importados sozinhos:** depois de conectar, o painel busca os grupos e canais do número.
- **Um número cobre o outro:** com mais de um número no mesmo grupo, se um cair, os outros continuam enviando.
- **Aviso quando cai:** você recebe o aviso de número desconectado e de número reconectado.

## Antes de começar

- Um número de WhatsApp **só para as ofertas**, não o seu pessoal. Número que publica muito acaba recebendo denúncia, e você não quer isso no número que usa com a família.
- O celular desse número por perto.

## Como configurar

1. Na tela **WhatsApp**, clique em **Adicionar número**.
2. Na janela **Adicionar número**, escolha **Ler QR code** e clique em **Gerar QR code**.
3. No celular, abra **WhatsApp › Aparelhos conectados › Conectar um aparelho** e aponte a câmera para o QR da tela.

<img src="/docs/whatsapp/adicionar-numero-qr.webp" alt="Janela Adicionar número com um QR code de exemplo, o aviso Esperando o celular confirmar e o botão Trocar método ou gerar novamente" style="display:block;margin:18px auto;max-width:480px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. Quando aparecer **QR code lido**, espere ou clique em **Continuar usando o painel**. O painel avisa quando conectar e busca os grupos e canais do número sozinho.
5. Em **Número conectado**, confira o **Nome do número** (já vem do perfil do WhatsApp; ex.: "Ofertas 1") e clique em **Salvar nome**. Se fechar a janela, fica o nome do perfil.

**Está só no celular, sem outra tela?** Escolha **Código de pareamento**, preencha **Número com DDI e DDD** (ex.: 5511999998888) e clique em **Pedir código**. No celular, vá em **Aparelhos conectados › Conectar um aparelho › Conectar com número de telefone** e digite o código que o painel mostrou. Deixe a janela aberta até confirmar.

<video src="/docs/whatsapp/conectar-numero.mp4" poster="/docs/whatsapp/conectar-numero.webp" autoplay muted loop playsinline controls aria-label="Vídeo: na tela WhatsApp, clicar em Adicionar número e em Gerar QR code, ler o QR com o celular, dar o nome Ofertas 1 ao número e ver o cartão dele como Conectado" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/whatsapp/conectar-numero.gif" alt="Vídeo: na tela WhatsApp, clicar em Adicionar número e em Gerar QR code, ler o QR com o celular, dar o nome Ofertas 1 ao número e ver o cartão dele como Conectado" /></video>

## Ajustes opcionais

- **Função** (no cartão): **Envia ofertas**, **Cria grupos e envia ofertas**, **Só cria grupos**, **Segurança: só admin** ou **Vigia: apaga post de quem não é admin (grátis)**. Os três últimos não enviam ofertas. O primeiro número entra como **Envia ofertas**; os seguintes entram como **Vigia**: troque a função para eles mandarem ofertas.
- **Aquecer** (no cartão): esquenta o número aos poucos antes de enviar muito. Veja [aquecimento](/docs/whatsapp/aquecimento/).
- **Nome**: clique no nome do número no cartão, edite e clique em **Salvar**.
- **Números a manter ativos**: se você diminuiu a quantidade contratada, marque quais números continuam enviando e clique em **Salvar números ativos**.
- **Desconectar**: no menu **⋯** do cartão. Os grupos desse número param de receber até você conectar outro número neles.

## Como saber se funcionou

O cartão do número mostra **Conectado** e quantos grupos ele tem. Conectar não publica nada: você escolhe quais grupos recebem as ofertas na campanha ([Criar campanhas](/docs/whatsapp/criar-campanha/)).

## Risco de bloqueio

Nenhum número tem garantia de nunca ser bloqueado, e quem promete isso está mentindo. O que diminui o risco de verdade:

- número só para as ofertas, aquecido aos poucos;
- envio espaçado (o ritmo você ajusta na campanha);
- gente que entrou porque quis, pelo link, e não gente adicionada sem pedir;
- menos volume e mais ofertas que interessam.

> **Dica:** para o menor risco, use um **canal do WhatsApp** como destino. Ninguém entra na conversa e ninguém responde.

## Se algo não der certo

- **O cartão mostra Fora do ar:** a conexão caiu e o bot não envia por esse número. Clique em **Reconectar** no cartão e leia o QR de novo. Grupos e campanhas continuam como estavam.
- **Os grupos não apareceram:** clique em **Atualizar grupos e canais** no cartão do número.
- **Não consigo trocar a função para mandar ofertas:** você chegou no limite de números contratados (o **Vigia** não conta). Use o atalho **aumentar** no topo da tela.

## Próximos passos

- **[Aquecimento](/docs/whatsapp/aquecimento/)**: prepare o número antes de enviar muito.
- **[Criar campanhas](/docs/whatsapp/criar-campanha/)**: escolha quais grupos recebem as ofertas.
- **[Preço e limites](/docs/whatsapp/planos-e-limites/)**: quantos números você pode ter.

---

# DOC: Início do painel do Bot do Afiliado: resultado, atividade e contagens do bot
URL: https://botdoafiliado.com/docs/comecando/dashboard/
Atualizado: 2026-11-08
Descrição: Veja numa tela só a sua comissão, as vendas e os cliques, quantos links o bot converteu nos últimos 30 dias e um resumo do que o bot tem configurado.

A tela **Início** é a primeira do painel (o primeiro item do menu). Nela você vê quanto ganhou de comissão, quantos links o bot converteu nos últimos 30 dias e um resumo do que o bot tem configurado.

<img src="/docs/comecando/dashboard-inicio.webp" alt="Tela Início do painel: o menu à esquerda e os cartões Comissão, Vendas, Cliques e Conversão de Resultado de afiliado, o gráfico Atividade do bot dos últimos 30 dias e as contagens de Seu bot" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## O que você ganha

- **Resultado num olhar:** comissão, vendas, cliques e conversão do período.
- **Comparação pronta:** uma seta mostra se o número subiu ou caiu em relação ao período anterior.
- **Atalhos:** cada contagem abre a tela onde você resolve aquilo.

## Resultado de afiliado

Mostra o que as lojas registraram, lido do **Painel do Afiliado**. Escolha **Ontem**, **7 dias** ou **30 dias**.

- **Comissão**: quanto você ganhou no período.
- **Vendas**: valor das vendas e número de pedidos.
- **Cliques**: cliques registrados pelas lojas.
- **Conversão**: quantos cliques viraram venda e, embaixo, quanto você ganha em média por clique.

## Atividade do bot

Gráfico dos últimos 30 dias com **Links convertidos**, **Usos de cupom**, **Posts de oferta**, **Cliques em links curtos** (os do encurtador ofertou.ai) e **Cliques nas redes** (os que as lojas registraram). Passe o mouse sobre um dia para ver os números dele.

## Seu bot

Contagens do que o bot tem hoje, como **Conversas**, **Grupos**, **Cupons**, **Lojas ativas**, **Rotas próprias** e **Comandos**. Clique numa contagem para abrir a tela dela.

## Como conferir o dia de ontem

1. Em **Resultado de afiliado**, clique em **Ontem**.
2. Veja a seta de **Comissão** e de **Cliques** para comparar com o dia anterior.
3. Em **Atividade do bot**, passe o mouse sobre ontem para ver quantos links o bot converteu.

## Se algo não der certo

- **Resultado de afiliado não aparece:** a sua conta não tem um Painel do Afiliado vinculado. Veja **[Central do Afiliado](/docs/integracoes/central-do-afiliado/)**.
- **Apareceu um aviso no lugar dos números:** se houver mais de um Painel vinculado, deixe só um na Conta do Afiliado. Se os números não carregaram, tente de novo em instantes e confira o vínculo em **Organização e membros**.
- **Atividade do bot não aparece:** ela só surge depois que o bot registra o primeiro uso.
- **Um link não aparece no gráfico:** link que não virou link de afiliado fica em **Configurar › [Links sem loja](/docs/integracoes/loja-nao-mapeada/)**.

---

# DOC: Perfil e acesso: nome, token, admins, perfil no Telegram e sub-bots
URL: https://botdoafiliado.com/docs/comecando/configuracoes-do-bot/
Atualizado: 2026-11-08
Descrição: Mude o nome do bot, troque o token, escolha quem administra o bot no Telegram e deixe o perfil com foto e descrição, tudo numa tela só.

Em **Configurar › Perfil e acesso** você cuida do básico do seu bot: a conexão com o Telegram, quem administra o bot e como ele aparece para quem abre a conversa.

## O que você ganha

- **Bot com a sua cara:** foto, nome e descrição que as pessoas veem ao abrir a conversa.
- **Ajuda na operação:** outras pessoas usam os comandos de administrador, como `/broadcast`.
- **Bot fechado, se quiser:** só você e até 10 pessoas escolhidas usam o bot.

## Escolher quem administra o bot

1. Em **Acesso no Telegram**, busque a pessoa por nome, @usuário ou ID em **Dono no Telegram (opcional)** ou **Administradores adicionais**.
2. Clique em **Salvar alterações**.

Admin do bot usa os comandos no Telegram, mas não entra no painel. O X ao lado do nome tira a pessoa.

## Deixar o perfil com a sua cara

Em **Perfil no Telegram**, preencha e clique em **Salvar no Telegram**:

- **Foto**: **Pôr foto** ou **Trocar foto**.
- **Nome**: até 64 caracteres.
- **Descrição curta**: até 120 caracteres. Aparece no perfil e quando alguém compartilha o bot.
- **Descrição**: até 512 caracteres. É o que a pessoa lê antes de tocar em Iniciar.

<img src="/docs/comecando/perfil-no-telegram.webp" alt="Card Perfil no Telegram: à esquerda a foto com o botão Pôr foto e como o bot aparece; à direita os campos Nome, Descrição curta e Descrição com o contador de letras, as Permissões sugeridas ao pôr o bot num grupo e, no fim, o botão Salvar no Telegram" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Trocar o token

O token é a senha do bot, gerada pelo BotFather (o bot oficial do Telegram que cria bots).

- **Bot criado pelo painel:** no cartão **Segurança do bot**, clique em **Gerar token novo** e confirme. Você não precisa copiar nada.
- **Bot conectado pelo BotFather:** gere um token novo para o mesmo bot no BotFather, clique em **Trocar token**, cole em **Novo token do BotFather** e clique em **Salvar alterações**.

> **Atenção:** o token antigo para na hora. Qualquer sistema de fora que usava esse token também para.

## Ajustes opcionais

- **Só pessoas escolhidas podem usar o bot** (bot criado pelo painel): informe os IDs do Telegram (o número da conta de cada pessoa), separados por vírgula, e clique em **Salvar acesso**.
- **Permissões sugeridas ao pôr o bot num grupo**: **Usar as recomendadas** marca o que o Porteiro e a limpeza do grupo precisam.
- **Converter por menção (Guest Mode)**: quem responde a um post mencionando o bot recebe o post com os seus links. Liga no Mini App do BotFather.
- **Gerenciar sub-bots**: outros bots com as mesmas configurações. Vêm grátis com o plano base. Veja **[Sub-bots](/docs/telegram/sub-bots/)**.

O dono muda tudo. O admin da organização muda só o **Apelido do bot** (aparece quando há mais de um bot) e o perfil. O postador só vê. **Segurança do bot** só o dono do bot muda.

## Se algo não der certo

- **Apareceu "Use um token do mesmo bot":** o token colado é de outro bot. Gere o token do mesmo bot no BotFather.
- **A pessoa não aparece na busca:** a busca mostra só quem já conversou com o bot no privado. Peça para ela mandar `/start` ao bot, ou digite o ID dela.
- **Não aparece o cartão Segurança do bot:** ele só existe em bot criado pelo painel. Use **Trocar token**.

## Próximos passos

- Dê acesso ao painel para a equipe em **[Equipe e papéis](/docs/comecando/equipe-e-papeis/)**.
- Coloque o bot nos seus grupos com **[Grupos](/docs/telegram/grupos/)**.

---

# DOC: Funcionalidades do bot: liga e desliga encurtador, respostas do AliExpress e regras de grupo
URL: https://botdoafiliado.com/docs/comecando/funcionalidades/
Atualizado: 2026-11-08
Descrição: Ligue ou desligue com um clique o que o seu bot faz, como encurtar links, responder mensagens do AliExpress e apagar o link original nos grupos. Cada opção fica na tela que ela muda.

O bot tem algumas chaves de liga e desliga: encurtar links, mandar mensagem para todos, responder mensagens do AliExpress e apagar o link original nos grupos. Cada chave fica na tela do assunto dela e vale na hora, sem botão de salvar.

## O que você ganha

- **Bot do seu jeito:** você desliga o que não usa com um clique.
- **Grupo mais limpo:** o bot pode apagar a mensagem original e deixar só o link com o seu código.
- **Seu link nas mensagens do AliExpress:** o bot pode responder sozinho com o seu link quando alguém manda jogo de cupom, compra em grupo ou caixa da sorte.

## Onde fica cada chave

| Chave | Onde fica | O que faz |
|---|---|---|
| **Encurtador de links** e **Só encurtar** (vêm ligadas) | **Configurar › Comandos**, card **Comandos de encurtar** | Liberam o /encurtar (devolve o seu link de afiliado encurtado) e o /soencurtar (só encurta, sem trocar pelo seu link). |
| **Broadcast** (vem ligada) | **Postar › Broadcast**, card **Comando /broadcast** | Libera os comandos que mandam uma mensagem para todas as conversas e grupos do bot. Precisa do plano base ativo. |
| Respostas do AliExpress | **Configurar › Lojas › AliExpress**, card **Respostas automáticas do AliExpress** | O link de produto vira o link com desconto de moedas (vem ligado), e o bot pode responder com o seu link ao "jogo de cupons", à "compra em grupo" e "caixa da sorte" (vêm desligadas). Mais em **[Moedas e cupom (AliExpress)](/docs/telegram/aliexpress-moedas-cupom/)**. |
| **Apagar link original no grupo** (vem ligada) | **Grupos e canais › Canais e grupos**, card **Links nos grupos** | O bot manda o seu link de afiliado e apaga a mensagem de quem enviou. Link que o bot não converte (como convite de outro grupo) também é apagado, a não ser que esteja em **Deixar passar sem converter** ([veja como](/docs/telegram/whitelist/)). |

## Como mudar

1. Abra a tela da chave (coluna "Onde fica" acima).
2. Clique na chave para ligar ou desligar.
3. Pronto. Não precisa salvar.

## Uso comum: manter a mensagem original no grupo

1. Abra **Grupos e canais** e fique na aba **Canais e grupos**.
2. No card **Links nos grupos**, desligue **Apagar link original no grupo**.
3. O bot continua convertendo os links, mas não apaga mais a mensagem de quem enviou.

<img src="/docs/comecando/links-nos-grupos.webp" alt="Card Links nos grupos: a chave Apagar link original no grupo, ligada, com a explicação do que ela faz" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Se algo não der certo

- **O Broadcast não fica ligado:** ele precisa do plano base ativo na assinatura. Ligar a chave não ativa plano nem módulo.
- **O bot não apaga o link num grupo:** se a **Proteção** desse grupo (em **Grupos e canais**) estiver em **Observar** ou **Desligado**, a regra de apagar não age. Em **Automático**, funciona. Veja **[Comunidade](/docs/telegram/comunidade-ia/)**.

## Próximos passos

- Configure os seus **[grupos](/docs/telegram/grupos/)**.
- Veja todos os **[comandos do bot](/docs/telegram/comandos/)**.

---

# DOC: API: converter links de afiliado (POST /convert-links)
URL: https://botdoafiliado.com/docs/api/convert-links/
Atualizado: 2026-05-29
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/)**.

Links de encurtadores com verificação automática Kutt/Afilimais também podem ser resolvidos antes da conversão, inclusive em domínio próprio. O link de destino passa pelo conversor de afiliado configurado para a loja.

## 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": "..." }
  ]
}
```

## Origem do link (opcional)

Diga para onde o link vai e cada destino ganha o seu link curto, com os cliques contados separados.

- `chat_id`: ID do grupo ou canal do Telegram onde o link vai ser postado (número, ou texto só com dígitos e `-`). Conversa privada com o bot é ignorada.
- `origem`: destino fora do Telegram, `{"tipo": "...", "id": "..."}`. O `tipo` é `grupo`, `canal`, `site` ou `post`; o `id` tem até 64 caracteres entre letras, números e `_ : . -` (o domínio do site, por exemplo). Se vier `chat_id`, ele vale.

```json
{
  "urls": ["https://exemplo.com/produto"],
  "chat_id": -1001234567890
}
```

```json
{
  "url": "https://exemplo.com/produto",
  "origem": { "tipo": "site", "id": "meusite.com.br" }
}
```

- Sem os dois campos (ou com `null` neles) e sem origem padrão na chave, nada muda.
- **Origem padrão da chave:** em **API e IA MCP → Chaves de API**, a coluna **Origem padrão** guarda um destino com os mesmos tipos e regras do `origem`. Ele vale quando o pedido não manda `chat_id` nem `origem`, como se mandasse essa origem: serve para a integração que só converte e não sabe dizer o destino. O que vier no pedido ganha dela, e um `chat_id` de conversa privada continua sem origem. No MCP conectado com essa chave, ela vale só no `convert_links` e no `add_coupon` com `convert_url`, que convertem por este endpoint; nas outras ferramentas, como `create_offer_post`, `run_command` e `get_product`, o link sai sem origem.
- A mesma URL para dois destinos gera dois links curtos. A exceção são os links que saem direto da loja, sem passar pelo encurtador (Shopee, AliExpress, Mercado Livre e Amazon pela integração da própria loja): esses são iguais em qualquer destino.
- `tipo` fora da lista ou `id` com outro caractere devolve **400**.

## 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`).

### Links que já pertencem ao afiliado

Links de produto Amazon já atribuídos à tag configurada
para a conversão podem retornar o mesmo endereço com sucesso, inclusive quando
reutilizados do cache. O tracking específico do usuário, quando configurado, tem
prioridade. Sem comprovação da tag correta no destino Amazon, devolver a URL de
origem continua gerando `conversion_returned_source_url`.

## Exemplo (curl)

```bash
curl -X POST "https://botdoafiliado.com/api/v1/convert-links" \
  -H "content-type: application/json" \
  -H "X-API-Key: <SUA_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: Conceitos do Bot do Afiliado: workspace, bot, plugin, rota e tracking
URL: https://botdoafiliado.com/docs/comecando/conceitos/
Atualizado: 2026-11-10
Descrição: O que significam bot, plugin, tracking ID, módulo, workspace e rota no Bot do Afiliado, em linguagem simples, para você configurar sem dúvida.

O Bot do Afiliado troca o link comum de uma loja pelo seu link de afiliado. Para isso funcionar, você só precisa de duas coisas: um **bot** e um **plugin** conectado. Os outros termos aparecem quando a operação cresce. O passo a passo está em **[Comece por aqui](/docs/comecando/comece-por-aqui/)**.

## Bot

É o seu bot do **Telegram**, que responde com os seus links. O painel cria o bot para você, sem BotFather e sem token, ou você conecta um que já tem. Cada bot tem as próprias configurações. Veja **[Perfil e acesso](/docs/comecando/configuracoes-do-bot/)**.

## Plugin

É a ligação com uma loja ou rede, como Shopee, Amazon ou Awin. Você preenche os dados da sua conta de afiliado uma vez, em **Configurar › Lojas**, e o bot passa a gerar os links daquela loja com o seu código. Veja **[como ativar um plugin](/docs/integracoes/ativar-plugin/)**.

## Tracking ID

É o seu código de afiliado dentro do link. É ele que diz para a loja que a venda é sua. Na conta da loja, ele fica em **Rastreamento padrão**, dentro de **Mais opções: nome, prioridade e rastreamento**. Cada rede dá um nome diferente para ele; veja o **[glossário](/docs/comecando/glossario/)**.

## Módulo

É um recurso extra que você liga no seu bot. Ofertas, Broadcast e Sub-bots já vêm no **plano base**, sem custo a mais; Cupons, Grupos, Conexão IA e API, Puxador, Shopee Live e WhatsApp você assina à parte. O plano base é obrigatório; os módulos você liga quando precisar, em **Plano e módulos**. Veja **[módulos e preços](/docs/planos/modulos/)**.

## Workspace

É o espaço que junta os seus bots, os módulos assinados e as pessoas da equipe. Se quiser separar clientes, marcas ou projetos, use um workspace para cada. A assinatura é por workspace.

## Rota

Diz ao bot qual plugin usar para cada site. Por exemplo: links de aliexpress.com.br vão para o plugin do AliExpress. Quando você salva um plugin, o bot cria as rotas dele sozinho. Veja **[como funcionam plugins e rotas](/docs/integracoes/como-funcionam/)**.

---

# DOC: Como conectar o Bot do Afiliado no ChatGPT (MCP)
URL: https://botdoafiliado.com/docs/ia/conectar-chatgpt/
Atualizado: 2026-11-08
Descrição: Conecte o seu Bot do Afiliado ao ChatGPT com o login da sua conta, sem chave, e gere links de afiliado, buscas e posts de oferta conversando.

Conectando o ChatGPT ao seu Bot do Afiliado, você gera links de afiliado, busca produtos e monta ofertas **conversando no ChatGPT**. A conexão é pelo login da sua conta do Bot, sem chave.

> **Precisa do módulo Conexão IA e API.** Veja **[módulos](/docs/planos/modulos/)**.

## O que você ganha

- **Seu link sem sair do chat:** cole o link da loja e receba o seu link de afiliado.
- **Busca falada:** peça por loja e faixa de preço e receba foto, preço e o seu link.
- **Post pronto:** o texto da oferta sai no formato do seu bot.

## Antes de começar

A sua conta do ChatGPT precisa permitir criar apps. Isso depende do plano e da organização e pode exigir plano pago ou o **modo desenvolvedor**.

## Como conectar

1. No [painel do Bot](https://app.botdoafiliado.com/), abra **Configurar › API e IA (MCP)** e a aba **IA (MCP)**.
2. No card **ChatGPT**, clique em **Copiar URL**. O endereço já aponta para o bot aberto.
3. Clique em **Abrir Conectores do ChatGPT**. Se o ChatGPT pedir, ative o **modo desenvolvedor**.
4. Crie um app novo e cole o endereço copiado. Se o ChatGPT perguntar o tipo de autenticação, escolha **OAuth** (é o login com a sua conta).
5. Entre com a sua **Central do Afiliado**, confira o bot e autorize.
6. Ligue o app na conversa.

<img src="/docs/ia/mcp-chatgpt.webp" alt="Card ChatGPT na aba IA (MCP): o selo LOGIN, o aviso de que pode exigir plano pago ou modo desenvolvedor, os botões Abrir Conectores do ChatGPT e Copiar URL e o Como conectar" style="display:block;margin:18px auto;max-width:560px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Tem um bot só? O endereço geral `https://app.botdoafiliado.com/mcp` também serve. Com mais de um, use o copiado do painel.

## Como saber se funcionou

Peça *"Converta este link em afiliado:"* e cole um link de produto. Se voltar um link novo, pronto. O ChatGPT também aparece em **Conexões de IA ativas**, no painel.

> **Atenção:** revise a oferta antes de publicar. Nunca mande senha, token do Telegram ou chave de API na conversa.

## Se algo não der certo

- **Não acho onde criar o app:** os menus mudam de conta para conta, e a organização pode bloquear a opção. Veja a [ajuda oficial da OpenAI](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).
- **O ChatGPT diz que o módulo não está ativo:** ative o **Conexão IA e API** ([como assinar](/docs/planos/como-assinar/)).

## Próximos passos

- **[Exemplos de prompts](/docs/ia/exemplos-de-prompts/)** para começar a pedir.
- **[O que é o MCP](/docs/ia/o-que-e-mcp/)** para ver tudo o que a IA faz com o seu bot.

---

# DOC: Como gerenciar a assinatura e trocar de módulos
URL: https://botdoafiliado.com/docs/planos/gerenciar-assinatura/
Atualizado: 2026-11-08
Descrição: Ponha ou tire módulos pagando só a diferença, troque o cartão ou cancele a assinatura do Bot do Afiliado, tudo pela tela Plano e módulos.

Depois de assinar, você põe ou tira módulos na própria tela **Plano e módulos** e troca o cartão ou cancela pelo botão **Gerenciar assinatura**. Só o dono da organização faz isso.

## O que você ganha

- **Paga só a diferença:** a mudança é proporcional, sem abrir uma segunda assinatura.
- **Não perde a conexão:** ao diminuir os números do WhatsApp, os que sobram ficam pausados, com a conexão guardada.
- **Cancela sem perder o que pagou:** os módulos seguem até o fim do período já pago.

## Como chegar

1. Selecione o bot no topo: a assinatura vale para ele.
2. No menu lateral, clique em **Plano e módulos** (em **Ajustes**; também fica no menu **Conta**, no rodapé). No celular, o atalho fica no menu de navegação.

## Trocar módulos ou números

1. Marque ou desmarque os módulos.
2. Se usa WhatsApp, ajuste **Números de WhatsApp (1 a 20)**.
3. Confira o novo valor em **Total mensal**.
4. Clique em **Atualizar plano**.

<img src="/docs/planos/gerenciar-assinatura.webp" alt="Card Total mensal de quem já assina: o valor do mês, o resumo Plano base + 2 módulos e os botões Gerenciar assinatura e Atualizar plano" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Trocar o cartão ou cancelar

1. Clique em **Gerenciar assinatura**. Abre o portal do Stripe.
2. Lá, atualize o cartão ou cancele a assinatura.

## Como saber se funcionou

Depois de cancelar, abra **Organização e membros**, no menu **Conta**: o cartão **Assinaturas e módulos** mostra a data em que cada módulo **expira**.

## Se algo não der certo

- **Não vejo Plano e módulos:** só o dono da organização vê esse atalho.
- **Mudei o bot errado:** confira o seletor de bot, no topo do menu lateral, antes de mexer.

## Próximos passos

- **[Módulos e preços](/docs/planos/modulos/)** e **[preço por número do WhatsApp](/docs/whatsapp/planos-e-limites/)**.
- **[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/
Atualizado: 2026-11-08
Descrição: Seus tokens, chaves e dados de afiliado ficam guardados protegidos no Bot do Afiliado. Veja o que fazer para manter a sua conta segura e o que fazer se algo vazar.

O Bot do Afiliado guarda protegidos o token do seu bot do Telegram, as suas chaves de API e os seus dados de afiliado. Nada disso aparece aberto na tela. Veja o que fica protegido e o que você pode fazer para manter a conta segura.

## O que fica protegido

- **Token do Telegram:** guardado criptografado e nunca mostrado no painel.
- **Dados de afiliado das lojas:** guardados criptografados no seu workspace e usados só para gerar os seus links. Você atualiza ou remove quando quiser.
- **Chaves de API:** aparecem inteiras só quando você cria (no aviso **Chave criada no nível … (copie agora)**). Depois, o painel mostra só o começo da chave.
- **Token da Meta, chave do Google Analytics e segredo de webhook:** guardados cifrados e não voltam para a tela. O segredo do webhook aparece uma vez só, quando é criado.
- **Conexões de IA:** o ChatGPT ou o Claude só usam as permissões que você aceitou ao conectar.

O dono e os administradores do workspace podem ver uma chave de API de novo em **Mostrar**, na tela **Configurar › API e IA (MCP)**, e cada vez fica registrada. Chaves mais antigas não dá para mostrar de novo: gere outra.

## O que você deve fazer

1. **Ligue a verificação em duas etapas** em **Conta e organização › Perfil e segurança** ([Perfil e segurança da conta](/docs/comecando/perfil-e-seguranca/)).
2. **Use uma chave de API para cada integração** e revogue as que não usa.
3. **Nunca cole token ou chave** em site, post, grupo ou código público.
4. **Dê acesso ao workspace só a quem você confia.**

## Se você suspeitar de vazamento

- **Token do Telegram:** gere um novo no BotFather e troque em **Configurar › Perfil e acesso**, com **Trocar token**. O antigo deixa de valer. Se o bot foi criado pelo painel, use **Gerar token novo**, no card **Segurança do bot**.
- **Chave de API:** clique em **Revogar** na lista **API Keys** da tela **Bots** (pela busca, **Ir para Bots**). A chave para de funcionar na hora.
- **Conta aberta em outro aparelho:** encerre em **Sessões ativas**, na tela de [Perfil e segurança](/docs/comecando/perfil-e-seguranca/).
- **App de IA que você não usa mais:** desconecte em **Conexões de IA ativas**.

## Próximos passos

- Proteja o login em **[Perfil e segurança da conta](/docs/comecando/perfil-e-seguranca/)**.
- Troque o token do bot em **[Perfil e acesso](/docs/comecando/configuracoes-do-bot/)**.
- Veja como usar as chaves na **[visão geral da API](/docs/api/visao-geral/)**.

---

# DOC: Ofertas: o comando /oferta e a aba Texto e rodapé
URL: https://botdoafiliado.com/docs/telegram/ofertas/
Atualizado: 2026-11-08
Descrição: Mande /oferta com um link e o bot devolve o post pronto, com título, preço, cupom e o seu link. Na aba Texto e rodapé, em Aparência das ofertas, você deixa o post com a cara do seu canal.

O comando **/oferta** transforma um ou mais links num post de oferta pronto, com título, preço, cupom e o seu link de afiliado. Na aba **Texto e rodapé**, em **Configurar › Aparência das ofertas**, você define como esse post fica escrito, e o mesmo formato vale para o **[Postador](/docs/telegram/formatador-tempo-real/)**.

> **Módulo necessário:** Ofertas. Veja **[módulos e preços](/docs/planos/modulos/)**.

## O que você ganha

- **Post pronto em segundos:** você manda o link e o bot monta o post inteiro.
- **Vários produtos num post só:** saem do mais barato para o mais caro, com até 6 fotos numa grade.
- **Posts sempre no mesmo padrão:** você escreve o formato uma vez e todo post segue ele.
- **Confere antes de salvar:** a prévia mostra o post com um produto de verdade, sem publicar nada.

## Como usar o /oferta no Telegram

Mande para o seu bot:

- **`/oferta link`**: monta a oferta. Pode mandar vários links juntos ou responder a uma mensagem que tenha os links.
- **`/oferta CUPOM link`**: monta o post com cupom. O cupom vem antes dos links.
- **`/oferta cupom: link-de-resgate link-do-produto`**: para cupom que se pega numa página de resgate.
- **`/oferta "Compre aqui 👇" link`**: o texto entre aspas vira a chamada do post.

<img src="/docs/telegram/ofertas-post.png" alt="Post de oferta gerado pelo /oferta no Telegram: foto dos produtos, título, preço e link curto" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como configurar o formato do post

1. No painel, abra **Configurar › Aparência das ofertas**, aba **Texto e rodapé**.
2. Em **Teste com sua oferta**, cole o link de um produto em **Links dos produtos e cupom, se houver** (e o cupom, se tiver). Sem link, a tela usa um produto de exemplo.
3. Em **Formato que deseja editar**, escolha **Post de Oferta › 1 produto** (post sem cupom) ou **Post com Cupom › 1 produto** (post com cupom).
4. Escreva o post do seu jeito. Clique nas variáveis acima do editor para colocá-las no texto: variável em verde está certa, em âmbar não vale naquele formato.
5. Confira na **Prévia do rascunho**, ao lado do editor.
6. Clique em **Salvar**. Só o formato aberto é salvo; repita em cada formato que você mudou.

<img src="/docs/telegram/customizar-formato.webp" alt="Card Editar o formato: o seletor Formato que deseja editar em 1 produto, as variáveis em botões verdes, o editor do post e, ao lado, a Prévia do rascunho com a foto, o título, o preço e o link do produto colado" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Para posts com vários produtos, edite também **Item da lista** (como cada produto aparece) e **Base da Lista** (o começo e o fim do post).

> **Dica:** para negrito use `<b>texto</b>` e para riscado `<s>texto</s>`. Só funcionam as marcações do Telegram: `<b>`, `<i>`, `<s>` e `<code>`.

**Para mudar o rodapé** (o texto do fim de todo post): em **Formato que deseja editar**, escolha **Rodapé**, escreva o texto, confira a prévia e clique em **Salvar**. Se aparecer o botão **Pôr no fim de** com o nome de um formato, clique nele para o rodapé entrar também naquele formato.

<video src="/docs/telegram/ofertas-rodape.mp4" poster="/docs/telegram/ofertas-rodape.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Aparência das ofertas, aba Texto e rodapé, colar o link de um produto em Teste com sua oferta, escolher Rodapé em Formato que deseja editar, escrever um rodapé novo, ver a prévia do post mudar e clicar em Salvar" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/telegram/ofertas-rodape.gif" alt="Vídeo: em Aparência das ofertas, aba Texto e rodapé, colar o link de um produto em Teste com sua oferta, escolher Rodapé em Formato que deseja editar, escrever um rodapé novo, ver a prévia do post mudar e clicar em Salvar" /></video>

## Ajustes opcionais

- **Preço riscado e parcelas:** troque a linha de preço por `{linhadopreco}`. Veja **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- **Cupom no lugar certo:** `{linhadocupom}` mostra o código ou o link de resgate, e some quando não há cupom.
- **Rodapé por loja:** em **Rodapé por loja**, no fim da tela, escolha a loja, escreva o texto e clique em **Salvar rodapé**. Vale pela loja do primeiro link.
- **Esconder centavos:** em **Ocultar centavos a partir de (R$)**, informe um valor e clique em **Salvar limite**. Com R$ 1.500, o preço R$ 1.501,92 aparece como R$ 1.501. Só o dono ou um admin muda.
- **Voltar ao original:** **Voltar ao padrão** e depois **Salvar**.

## Como saber se funcionou

Mande **`/oferta`** com o link de um produto para o seu bot no Telegram. O post tem que voltar no formato que você salvou.

## Se algo não der certo

- **A chamada não aparece:** ela só sai onde o formato tem `{cta}`. Coloque a variável e salve.
- **Preço ou cupom saiu repetido:** a linha antiga ficou junto de `{linhadopreco}` ou `{linhadocupom}`. Apague a linha antiga.
- **Mudei o formato e o post continua igual:** faltou clicar em **Salvar** naquele formato.
- **Nenhum produto foi montado:** o bot responde com a lista dos links e o motivo de cada um.

## Próximos passos

- Monte e poste a oferta pelo painel com o **[Postador](/docs/telegram/formatador-tempo-real/)**.
- Veja as variáveis do post em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- Cadastre os seus **[cupons](/docs/telegram/cupons/)**.

---

# DOC: Fontes do Telegram no módulo WhatsApp: o canal que alimenta as campanhas
URL: https://botdoafiliado.com/docs/whatsapp/conectar-telegram/
Atualizado: 2026-11-08
Descrição: Ligue o seu canal do Telegram às campanhas de WhatsApp e o que você posta no canal chega sozinho nos seus grupos, pelo mesmo bot que você já tem.

Uma **fonte** é o canal ou grupo do Telegram que alimenta as suas campanhas de WhatsApp: o que você posta lá chega nos seus grupos. O seu bot precisa ser administrador do canal, e a fonte precisa estar numa campanha.

## O que você ganha

- **Posta uma vez, chega nos dois:** o próximo post do canal sai nos grupos da campanha.
- **Sem bot novo:** usa o bot que você já cadastrou no painel.
- **Sua conta pessoal fica de fora:** o Bot lê o canal pelo bot, não pela sua conta.

## Antes de começar

Você precisa de um bot cadastrado no painel. Se ainda não tem, comece pelos **[primeiros passos](/docs/comecando/primeiros-passos/)**.

## Como configurar

1. No Telegram, abra o canal ou grupo e coloque o seu bot como **administrador** (no canal: **Administradores › Adicionar administrador**; no grupo: adicione o bot e promova a administrador). Basta a permissão de ler as publicações.
2. No painel do Bot do Afiliado, abra **WhatsApp › Fontes**.
3. Em **Escolha um canal ou grupo…**, selecione o canal e clique em **Adicionar fonte**.

<img src="/docs/whatsapp/fontes.webp" alt="Aba Fontes da tela WhatsApp: o canal Ofertas do Dia já cadastrado, ligado a uma campanha, e embaixo a lista Escolha um canal ou grupo com o botão Adicionar fonte" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. Em **Campanhas**, abra a campanha, marque a fonte em **Fontes e ritmo** e salve.

> **Dica:** dá para pular os passos 2 e 3. Marcando o canal direto em **Fontes e ritmo**, o painel cadastra a fonte na hora.

<video src="/docs/whatsapp/ligar-canal.mp4" poster="/docs/whatsapp/ligar-canal.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Campanhas, abrir a campanha, ir em Fontes e ritmo, marcar o canal do Telegram, clicar em Salvar campanha e ver a campanha com 2 fontes" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/whatsapp/ligar-canal.gif" alt="Vídeo: em Campanhas, abrir a campanha, ir em Fontes e ritmo, marcar o canal do Telegram, clicar em Salvar campanha e ver a campanha com 2 fontes" /></video>

## Como saber se funcionou

Publique um post novo no canal. Ele deve chegar nos grupos da campanha. Na aba **Fontes**, cada fonte mostra as campanhas em que está.

## Se algo não der certo

- **O canal não aparece na lista:** o bot não é administrador ali. Se não está em nenhum, a lista mostra **Nenhum chat disponível — o bot precisa ser admin**.
- **A fonte tem o selo fora de campanha:** nada dela é repassado. Coloque numa campanha em uso.
- **Apaguei no Telegram e continuou no WhatsApp:** coloque o canal também no **[Puxador](/docs/telegram/userbot/)** ou apague pelo painel ([o que chega](/docs/whatsapp/o-que-chega/)).

## Como desligar

Em **Fontes**, clique na lixeira e confirme em **Remover fonte**. Os posts param de ir para o WhatsApp; o que já foi enviado fica. O bot continua convertendo links no canal. Para parar só uma campanha, tire a fonte dela em **Fontes e ritmo**.

## Próximos passos

- Monte a campanha em **[Criar campanha](/docs/whatsapp/criar-campanha/)**.
- Veja **[o que chega](/docs/whatsapp/o-que-chega/)** no WhatsApp.

---

# DOC: API: dados do produto (POST /product)
URL: https://botdoafiliado.com/docs/api/product/
Atualizado: 2026-10-21
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`

A extração aceita o formato atual de produto do Magazine Você. Para Magalu e Terabyte, bloqueios no acesso direto podem usar uma segunda tentativa pelo proxy de extração. URLs de outras lojas com `/produto/` não são tratadas como produtos da KaBuM.

No Mercado Livre, anúncios sem catálogo também são identificados no destaque do link de afiliado, com sua variação. Os produtos da seção “Para você” não substituem o produto destacado.

## Request

```json
{
  "url": "https://shopee.com.br/...",
  "telegram_user_id": 123456789,
  "history_limit": 10,
  "watermark": true
}
```

- `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).
- `watermark` (opcional): `true` inclui `product.image_url_watermark`, a foto com a marca d'água configurada no painel (Configurar › Aparência das ofertas › Fotos e chamada › Marca d'água nas fotos). Vem `null` quando o produto não tem foto, a marca não está configurada ou a foto não pôde ser processada — o resto da resposta não muda.

## 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": []
}
```

Campos de `product.*` podem vir `null` quando não foi possível extrair.

Pela API, o `price_history` vem sempre `[]`: o campo segue na resposta, mas o histórico de preço não tem acesso por API. Ele faz parte do módulo [Histórico de Preços](/modulos/historico-de-precos/) e aparece na vitrine e nas consultas feitas pelo Claude e pelo ChatGPT.

## 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/)**.

## Preço anterior e parcelamento

O produto pode retornar `original_price` e seu alias `old_price` para o preço anterior, além de `installments`. Campos ausentes retornam `null`; o preço anterior só é válido quando maior que o preço atual.

```json
{
  "price": "199.90",
  "original_price": "299",
  "old_price": "299",
  "installments": { "count": 10, "amount": 19.99, "interest_free": true }
}
```

Os valores de `amount` e `total` são em reais. `interest_free` só aparece quando a fonte informa os juros. Não calcule parcelas dividindo o preço à vista: a condição do cartão pode ter outro total. A extração depende dos dados disponíveis no marketplace; a extensão também pode capturar a condição da página aberta pelo usuário.

---

# DOC: Glossário de marketing de afiliados: os termos essenciais
URL: https://botdoafiliado.com/docs/comecando/glossario/
Atualizado: 2026-11-08
Descrição: O que querem dizer os termos que aparecem no Bot do Afiliado e nos programas das lojas, como comissão, tracking ID, plugin e Puxador, em uma linha cada.

Os termos que você vai ver no painel do Bot do Afiliado e nos programas das lojas, em uma linha cada.

## Nas lojas e redes

- **Comissão:** a parte da venda (percentual ou valor fixo) que a loja paga para você.
- **Rede de afiliados:** empresa que reúne muitas lojas num só cadastro, como Awin e Rakuten.
- **Tracking ID:** o seu código dentro do link, que diz à loja que a venda é sua. No painel, fica em **Rastreamento padrão**.
- **PID (AliExpress):** o nome do tracking ID no AliExpress.
- **Partner tag (Amazon):** a sua tag de associado, como sualoja-20.
- **Publisher ID (Awin e Rakuten):** o seu número de afiliado na rede.
- **Advertiser ID (Awin e Rakuten):** o número de uma loja dentro da rede.
- **App Key e App Secret (AliExpress), ID do app e Chave secreta (Shopee):** os dados de acesso que a loja dá para o bot gerar os seus links.

## Nos números

- **Cliques:** quantas vezes abriram o seu link.
- **Conversão:** quando o clique vira venda.
- **EPC:** quanto você ganha, em média, por clique.
- **Pendente e Aprovado:** a comissão fica pendente até a loja confirmar a venda.

## No painel do bot

- **Plugin (conversor):** a ligação com uma loja ou rede, que gera o seu link de afiliado. Fica em **Configurar › Lojas**.
- **Rota:** diz ao bot qual plugin cuida de cada site.
- **Prioridade:** decide qual conta ou rota vale quando duas cobrem a mesma loja; vence o maior número.
- **Links sem loja:** links que chegaram ao bot e não viraram link de afiliado (em **Domínios pendentes**).
- **Deixar passar sem converter:** sites e links que saem do jeito que estão, sem converter nem encurtar, e podem ficar nos grupos (antes eram a Lista liberada, ou whitelist, e os Links preservados).
- **Puxador:** lê canais de promoções com a sua conta do Telegram e traz as ofertas com os seus links para você aprovar.
- **Sub-bot:** outro bot do Telegram no mesmo painel, com as mesmas configurações do principal.
- **Módulo:** recurso extra que você assina à parte, como Ofertas, Cupons ou Broadcast.
- **Workspace:** o espaço que junta os seus bots, os módulos e a equipe.

Para ver como as peças se encaixam, leia 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/
Atualizado: 2026-11-08
Descrição: Frases prontas para pedir ao ChatGPT ou ao Claude, com o seu bot conectado: buscar produtos por preço, converter links, ver preço e montar post de oferta.

Depois de **[conectar no Claude](/docs/ia/conectar-claude/)** ou **[no ChatGPT](/docs/ia/conectar-chatgpt/)**, é só pedir em português, como pediria a um assistente. Abaixo estão frases que funcionam; copie e troque pelo seu produto ou link.

> **Dica:** você não precisa dizer "use o MCP" nem nenhum comando. Fale normal: *"acha uns produtos de cozinha baratos na Shopee"*, *"converte esse link pra afiliado"*.

## Buscar produtos

> 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

Dá para combinar como quiser:

- **Loja:** Shopee, AliExpress ou Amazon. Se você não disser a loja, a IA busca em todas as lojas ativas no seu bot e junta os resultados, mostrando de qual loja é cada item.
- **Faixa de preço:** "até R$100", "entre 50 e 150", "acima de 200".
- **Ordem:** "do mais barato", "mais caro primeiro" ou pela relevância, se você não disser nada.
- **Mais resultados:** "me mostra mais" ou "próxima página".

Cada produto vem com foto, preço e o seu link de afiliado pronto.

## Converter links

> Converta este link em afiliado: `https://www.aliexpress.com/item/100500...html`

Para vários de uma vez:

> 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/...`

Divulgue sempre o link final que a IA devolver: ele já sai com o seu código de afiliado e encurtado do jeito que o seu bot faz.

## Ver preço e dados de um produto

> Qual o preço e o título deste produto? `https://shopee.com.br/...`

A IA responde com título, preço, foto e o histórico de preço.

## Montar um post de oferta

> Monte um post de oferta deste produto: `https://...`

> Monte um post de oferta com o cupom MEUCUPOM: `https://...`

> Monte um post de oferta com a chamada "Compre aqui": `https://...`

A IA usa o formato de oferta do seu bot (título, preço, cupom e link) e devolve o texto pronto. Você revisa e posta.

## Mudar o formato e as mensagens do bot

A IA lê e muda o formato das ofertas (oferta, cupom, rodapé de cada loja) e as mensagens que o bot responde (boas-vindas, "carregando…", entrega do link):

> Me mostra o formato 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.

> **Atenção:** confira antes de deixar a IA salvar. Um formato mal escrito muda todas as ofertas ou respostas do bot. Mensagens de erro e textos de comandos de administração só mudam no painel.

## Usar os comandos do bot

A IA roda os comandos do seu bot e devolve o resultado no formato dele:

> Roda o /c nesse link: `https://...`

> Encurta esse link pra mim: `https://...`

> Me mostra o histórico de preço desse produto: `https://...`

Comandos de administração, como broadcast e configurações, não ficam disponíveis por aqui.

## O que não dá para fazer por aqui

- **Publicar sozinho nos seus canais:** a publicação continua pelo painel e pelo bot.

## Próximos passos

- Veja tudo o que a IA faz com o seu bot em **[o que é o MCP](/docs/ia/o-que-e-mcp/)**.

---

# DOC: FAQ de cobrança e pagamento do Bot do Afiliado
URL: https://botdoafiliado.com/docs/planos/faq-cobranca/
Atualizado: 2026-11-08
Descrição: Respostas curtas sobre a cobrança do Bot do Afiliado: como pagar, como pôr ou tirar módulos, como cancelar e por que o pagamento é seguro.

Aqui estão as dúvidas mais comuns sobre a cobrança, respondidas logo abaixo. A assinatura fica na tela **Plano e módulos**, no menu lateral (em **Ajustes**), e só o dono da organização a vê.

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 seu (nota fiscal, reembolso, problema no pagamento)? Escreva para **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.

---

# DOC: Changelog do Bot do Afiliado: novidades e atualizações
URL: https://botdoafiliado.com/docs/referencia/changelog/
Atualizado: 2026-11-09
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.

## 11/11/2026 — Extensão 1.0.62: um botão principal por vez e nomes iguais aos do painel

- **Um botão azul por momento:** no painel lateral, só o próximo passo fica em destaque. Sem oferta na tela, é o **Gerar oferta desta página**; com a oferta pronta, o **Postar agora**; se não há como postar (chave de API, bot sem canais ou lista de canais vazia), o **Copiar texto de disparo**. Os outros dois continuam ali, em contorno.
- **Um nome só por campo:** "Gatilho de venda" passa a se chamar **Chamada**, como no Postador do painel. Em **Campos**, "Preço De (riscado)" e "Preço Por (venda)" viram **Preço anterior (riscado)** e **Preço de venda**, na extensão e no painel.
- Para atualizar, baixe o ZIP em **[Extensão do Chrome](/docs/comecando/extensao-chrome/)** e clique em **Recarregar** em `chrome://extensions`. Quem instalou pela Chrome Web Store recebe sozinho quando a loja liberar a versão.

## 11/11/2026 — Extensão 1.0.61: o desconto do seu cupom parte do preço sem o cupom da página

- **Desconto do cupom:** quando a página do Mercado Livre mostra o preço com o cupom dela e também o preço sem cupom, o desconto que você digita passa a abater do preço sem cupom, porque cupom não acumula. Exemplo: página com R$ 100 e R$ 90 com cupom; 10% digitado dá R$ 90 (antes dava R$ 81). O aviso abaixo do campo mostra de qual preço a conta parte.
- Quando a página mostra um preço só (por exemplo, "no Pix com cupom"), nada muda: o desconto abate do preço mostrado.
- Para atualizar, baixe o ZIP em **[Extensão do Chrome](/docs/comecando/extensao-chrome/)** e clique em **Recarregar** em `chrome://extensions`. Quem instalou pela Chrome Web Store recebe sozinho quando a loja liberar a versão.

## 11/11/2026 — Extensão 1.0.60: correções nas listas das lojas e no desconto do cupom

- **Listas das lojas:** a barra, os selos e as caixas de seleção não aparecem mais em dobro. A barra fica acima da lista de produtos, na largura dela (na busca do Mercado Livre em grade ela entrava espremida dentro do primeiro produto, e em páginas com carrossel caía dentro dele). Ordenar por maior desconto e filtrar passam a funcionar na busca do Mercado Livre, sem deixar espaço vazio.
- **Seleção:** o que você marcou continua marcado quando troca de aba e volta, e quando a loja carrega mais produtos ao rolar.
- **Loja que redesenha a página:** quando a loja troca a lista depois de carregar, a barra e os selos voltam sozinhos. Em página pesada eles aparecem assim que a lista está pronta, sem esperar o resto carregar.
- **Tema e ícone:** a barra das listas, a barra de seleção e a faixa do produto seguem o tema da extensão (claro, escuro ou o do computador) e mostram o ícone do Bot do Afiliado, para ficar claro de quem são.
- **Faixa na página do produto:** ganhou um botão de fechar. Na KaBuM ela fica abaixo do nome do produto, e não mais flutuando no canto da tela.
- **Desconto do cupom:** quando o preço da página já vem com cupom ou Pix, o campo de desconto não trava mais. Nada é descontado sozinho, mas, se o seu cupom é outro, digite o desconto: ele abate do preço mostrado.
- Com o painel da extensão fechado, os botões **Copiar links de afiliado** e **Postar no canal** da lista avisam para abrir o painel.
- Para atualizar, baixe o ZIP em **[Extensão do Chrome](/docs/comecando/extensao-chrome/)** e clique em **Recarregar** em `chrome://extensions`. Quem instalou pela Chrome Web Store recebe sozinho quando a loja liberar a versão.

## 11/11/2026 — Extensão 1.0.59: cara nova e configuração inicial mais curta

- **Extensão 1.0.59:** o painel lateral, as Configurações e as boas-vindas ficam com o mesmo visual do painel novo: fundo branco, letras maiores e mais legíveis, botões sem brilho e menos molduras. O tema escuro continua.
- **Últimas capturas** mostra o nome do produto em até duas linhas (antes cortava cedo) e vira uma lista só.
- Nas Configurações, as seis abas cabem na tela; antes **Canais** aparecia cortada. No celular ou na janela estreita, a aba aberta fica sempre à vista.
- No Puxador, ligar e desligar virou uma chave.
- **Configuração inicial mais curta:** quatro passos no lugar de seis (conectar, canais, cookies das lojas e pronto). Se você não está logado no painel, ele abre em outra aba e, quando você volta, a conexão continua sozinha, sem clicar de novo. No fim, **Concluir e abrir o painel** já deixa a extensão aberta para a primeira oferta. Quem usa só o Painel do Afiliado vê só o que é dele.
- Corrigido: uma caixa tracejada vazia aparecia em toda oferta gerada.
- Nada muda na captura, no texto, no envio aos canais nem nos cookies das lojas.
- Para atualizar, baixe o ZIP em **[Extensão do Chrome](/docs/comecando/extensao-chrome/)** e clique em **Recarregar** em `chrome://extensions`. Quem instalou pela Chrome Web Store recebe sozinho quando a loja liberar a versão.

## 09/11/2026 — Extensão 1.0.58: listas das lojas e Postar no canal em lote

- **Extensão 1.0.58:** as buscas e listas de ofertas do Magalu, KaBuM, Netshoes, SHEIN, Terabyte, AliExpress, Shopee, Amazon, Americanas, Natura, Pague Menos, Drogaria São Paulo, Pacheco e Casas Bahia, Ponto e Extra ganham selo de desconto em cada produto, a marca do que você já usou e uma caixa de seleção. Fora a Natura, que usa carrosséis, ganham também uma barra com filtros (como frete grátis, só com cupom e não usados, conforme o que a loja mostra) e a ordem por maior desconto real. O Mercado Livre já tinha isso desde a 1.0.57. Cada recurso tem a sua chave em **Configurações › Recursos**.
- **Postar no canal em lote:** marque até 10 produtos da lista, confira o texto que o bot monta e escolha os canais. Só publica quando você clicar em **Postar agora**, e produto sem link de afiliado fica de fora.
- Na página do produto, a faixa com o vendedor e o que a página informa de preço, parcelas e estoque também aparece no Magalu, na Netshoes, na SHEIN e na KaBuM.
- Para atualizar, baixe o ZIP em **[Extensão do Chrome](/docs/comecando/extensao-chrome/)** e clique em **Recarregar** em `chrome://extensions`. Quem instalou pela Chrome Web Store recebe sozinho quando a loja liberar a versão.

## 09/11/2026 — Links da Shopee mais rápidos (em preparação)

- O link de produto da **Shopee** sai numa consulta à loja em vez de duas: cada link novo fica cerca de meio segundo mais rápido no bot, no Puxador e na API. O link e a atribuição da venda não mudam.

## 08/11/2026 — Documentação e painel mais simples; Amazon pela Creators API

- A **[documentação](/docs/)** foi reescrita para quem não é técnico: cada guia começa pelo que você ganha e segue com o passo a passo curto, com os nomes de menu e botão que aparecem hoje no painel (por exemplo, **Configurar › Lojas**).
- O **painel** fala português simples: saíram nomes internos, códigos e termos em inglês de rótulos, dicas, avisos e situações (por exemplo, "Job" virou **Envio**, "CTA" virou **Chamada**, "Dashboard" virou **Início** e os envios do Broadcast mostram **Na fila**, **Enviando** e **Concluído**). Nomes que você precisa achar no site da loja, como **App Key** da AliExpress ou **Creators API** da Amazon, continuam iguais. As respostas do bot quando um link não converte agora dizem em qual tela do painel resolver.
- No **[Puxador](/modulos/puxador/)**, a versão que monta o post com o título e a foto do produto na loja passou a se chamar **Loja** (antes **API**): no texto e na foto você escolhe **Fonte** ou **Loja**, e o botão virou **Montar pela loja**. Nada muda no que já estava escolhido.
- A Amazon encerrou a PA-API. O guia dela saiu e quem abrir o endereço antigo cai no da **[Creators API](/docs/integracoes/amazon-creators/)**, que é o caminho para ter nome, foto e preço nas ofertas da Amazon. Veja **[Amazon](/docs/integracoes/amazon/)**.
- O texto do cupom da **Natura**, da **Brae** e da **Beleza na Web** e a frase do código de consultor da **Pague Menos** voltam a ser editáveis no painel: **Configurar › Aparência das ofertas**, aba **Texto e rodapé**, grupo **Cupom por loja**, com prévia.
- Os guias ganharam **fotos novas do painel** e **vídeos curtos** mostrando o caminho inteiro: conectar a **[Shopee](/docs/integracoes/shopee/)** e a **[AliExpress](/docs/integracoes/aliexpress/)**, **[gerar links](/docs/comecando/gerar-links-em-massa/)**, **[postar uma oferta](/docs/telegram/formatador-tempo-real/)**, **[aprovar no Puxador](/docs/telegram/userbot/)**, **[cadastrar cupom](/docs/telegram/cupons/)**, **[conectar um número de WhatsApp](/docs/whatsapp/conectar-whatsapp/)** e mais.
- O módulo **[Alertas](/modulos/alertas/)** está à venda: **R$ 49/mês**, somado ao plano base, em **Conta › Plano e módulos**. Seus seguidores criam alertas na sua vitrine e recebem aviso no celular quando você posta a oferta.
- Em **Configurar › Lojas**, o **Teste da conta** roda de novo sozinho quando você muda o **Rastreamento padrão**. Na AliExpress, o PID fica nele, e antes o teste só voltava a rodar ao clicar em **Testar de novo**.

## 08/11/2026 — Mais comentados da Vitrine em JSON

- A **Vitrine** publica os **Mais comentados** do início do site em `/destaques.json` (no domínio próprio, ou em `botdoafiliado.com/v/seu-slug/destaques.json`), para levar as ofertas mais comentadas a outro site seu. [Como usar](/docs/comecando/vitrine/#mais-comentados-em-json)

## 07/11/2026 — Ofertas, Broadcast e Sub-bots grátis; Puxador por R$ 99,90

- **[Ofertas](/modulos/ofertas/)**, **[Broadcast](/modulos/broadcast/)** e **[Sub-bots](/modulos/sub-bots/)** passam a vir **grátis com o plano base**: quem tem o base já usa os três, sem contratar nada. Quem pagava algum deles deixa de pagar.
- O **[Puxador](/modulos/puxador/)** cai de R$ 149,90 para **R$ 99,90/mês**, além do plano base. [Preços](/pricing/)

## 05/11/2026 — WhatsApp: 1ª conexão grátis e R$ 29,90 por conexão adicional

- O **módulo WhatsApp** segue em R$ 49,90/mês e vem com a 1ª conexão (número de WhatsApp) grátis; cada conexão adicional passa a custar R$ 29,90/mês. 2 conexões saem por R$ 79,80, 3 por R$ 109,70 e 20 por R$ 618,00. [Preço e limites](/docs/whatsapp/planos-e-limites/).
- Continua de 1 a 20 conexões, com grupos e canais ilimitados e sem cota de mensagens.

## 05/11/2026 — Mensagens temporárias nos grupos do WhatsApp

- Em **Permissões** do modelo dos grupos há **Mensagens temporárias**: **Desligadas**, **24 horas**, **7 dias** ou **90 dias**. Os grupos que a campanha cria sozinha já nascem com elas.
- Para os grupos que já existem, use **Padronizar grupos** na campanha ou escolha os grupos em **Grupos e canais**: um grupo por vez, com intervalo, como as outras permissões. **Manter como está** não muda nada.

## 03/11/2026 — Você escolhe onde o Top da semana é postado

- O **Top da semana** agora vai só para os canais e grupos que você adiciona na lista **Onde postar o Top da semana**, em **Reputação**. Canal ou grupo novo não entra sozinho, e com a lista vazia o Top não é postado: **quem já usava o Top precisa adicionar os grupos**.
- Cada canal ou grupo recebe o post uma vez, enviado pelo bot que está nele.

## 03/11/2026 — Top da semana passa a contar só a semana

- O **Top da semana** postado nos grupos mostrava o acumulado de sempre. Agora mostra o XP e os pontos ganhos desde o domingo anterior, e quem não ganhou nada na semana não aparece.
- O ranking do `/reputacao top` e da aba Reputação continua acumulado.

## 02/11/2026 — Lista de canais: só entra o que você adiciona

- No **Postador** e na **extensão do Chrome** (1.0.55), a lista de canais não parte mais de todos os canais do bot: você adiciona os canais e grupos onde vai postar. Canal novo não entra sozinho. Quem já tinha uma lista continua com ela.
- O passo entrou no roteiro **Deixe o bot pronto** do painel e na configuração inicial da extensão.

## 02/11/2026 — WhatsApp: grupo sem número conectado não conta mais como falha

- A oferta para um grupo sem número conectado aparece como **Descartado** em **Envios**, com o motivo, e sai de **Falhos**.
- O aviso desse caso chega no máximo uma vez por dia, mesmo com o grupo parado por dias. A **Visão geral** segue mostrando os grupos nessa situação.

## 02/11/2026 — Extensão 1.0.54: erros em português e Campos sem módulo

- **Extensão 1.0.54:** os erros aparecem em português, sem o código do servidor. Sem o módulo **Ofertas**, a prévia, o **Copiar** e o **Postar nos canais** explicam que o formato salvo e o envio fazem parte desse módulo. Antes diziam só "tente novamente".
- Conectada pelo **Entrar com o painel**, a extensão grava o cookie das lojas e os **Campos** sem nenhum módulo ativo. O envio aos canais continua no módulo **Ofertas**.

## 01/11/2026 — Fila do Puxador em tempo real

- A **Fila de aprovação** do Puxador recebe as ofertas novas e as mudanças (aprovada, descartada, enviada, versão API pronta) assim que acontecem, em vez de conferir a cada poucos segundos. As novidades continuam entrando no aviso **Mostrar N novas ofertas**.

## 01/11/2026 — Extensão sem o módulo de API

- Conectada pelo **Entrar com o painel**, a extensão captura o produto e monta a oferta sem o módulo **Conexão IA e API**. Antes, sem o módulo, o **Gerar oferta desta página** parava com erro. O modo **Chave de API** continua precisando do módulo. Não precisa atualizar a extensão.

## 31/10/2026 — Extensão 1.0.53 e Puxador igual ao /oferta

- **Puxador:** a versão pela API sai exatamente como o `/oferta` monta, com o preço e o cupom do post de origem. Linhas da origem como "PIX" e "ou resgate cupom" não entram mais soltas no post.
- **Extensão 1.0.53:** na aba Puxador, o aviso de que a versão pela API não ficou pronta diz o motivo em português em vez do código (antes aparecia "duplicate"), e some na oferta repetida, que já leva o selo **Já postado**.

## 31/10/2026 — Extensão 1.0.52: selo de "já postado" atualiza ao trocar de produto

- **Extensão 1.0.52:** ao abrir outro produto, os selos **Já postado** do produto anterior saem da lista de canais na hora. Antes eles ficavam na tela e todo produto parecia já postado.

## 31/10/2026 — Extensão 1.0.51: aviso de "já postado" e Puxador mais seguro

- **Extensão 1.0.51:** em **Postar no canal**, o canal que já recebeu o mesmo produto nas últimas 2 horas (ou na janela do "já postado" configurada no Puxador) ganha o selo **Já postado às HH:MM**, e o primeiro toque em **Postar** avisa antes de repetir. Vale para o que saiu pela extensão, pelo Postador e para o que foi postado no canal por outros caminhos.
- Na aba **Puxador** da extensão, a oferta repetida mostra há quanto tempo saiu e pede dois toques para publicar, mesmo quando a repetição só é descoberta na hora de aprovar. **Texto** e **Foto** (Conversor ou API) ficam na mesma linha.
- No grupo de aprovação do Telegram, **Postar mesmo assim** numa oferta repetida agora pede confirmação.
- Oferta já publicada que for **apagada no canal de origem** gera um aviso **🚨 URGENTE** no grupo de aprovação, com o botão **Apagar no meu canal**. A editada na origem também chega como urgente.

## 28/10/2026 — WhatsApp mais rápido e a velocidade de cada etapa

- O canal e o primeiro grupo de cada número saem assim que o post chega do Telegram, sem passar pela fila. Os outros grupos seguem a vez do número, no intervalo da campanha, como antes: o ritmo que protege o número não muda.
- A conversão dos links começa enquanto a foto do post ainda está sendo preparada, em vez de esperar por ela.
- Novo cartão **Velocidade do Telegram ao WhatsApp** em **WhatsApp → Estatísticas**: por campanha, quanto cada post levou do Telegram até o WhatsApp confirmar, etapa por etapa, nas últimas 24 horas ou 7 dias. Mede os posts que chegarem depois da atualização. Veja **[Criar campanhas](/docs/whatsapp/criar-campanha/)**.

## 27/10/2026 — Extensão 1.0.47: cartão da foto sem quebrar

- Quando a loja não dá a foto do produto, ou não deixa mostrar fora do site dela, o painel lateral mostra **Sem foto do produto** na largura toda, com o botão de enviar foto à vista. Antes ficava uma imagem quebrada pequena, com o texto cortado embaixo do botão. [Como funciona](/docs/comecando/extensao-chrome/)
- Na **KaBuM**, a captura volta a pegar a maior foto da página quando a loja publica a foto de compartilhamento vazia.

## 27/10/2026 — MCP: a IA propõe ofertas para a fila do Puxador

- Nova opção em **API e IA (MCP) > IA (MCP)**: **Permitir que a IA proponha ofertas**, desligada por padrão. Ligada, a IA conectada põe na fila de aprovação do Puxador uma oferta que ela escreveu, com os links já convertidos. Nada sai sem aprovação, e a proposta nunca se aprova sozinha. Até 10 por hora e 50 por dia. [Como funciona](/docs/ia/o-que-e-mcp/).
- O login da IA ganhou a permissão própria **Propor ofertas**. Quem conectou o app antes precisa reconectar para usá-la.

## 27/10/2026 — Puxador: oferta com mais de 3 horas sai da fila

- A oferta que passou de **3 horas** na fila vai sozinha para o **Histórico** como descartada, e o card do grupo do Telegram perde os botões com a linha **⌛ Tirada da fila: oferta com mais de 3 h**. **Aprovar** uma oferta assim não publica. [Como funciona](/docs/telegram/userbot/).
- Post com mais de 3 horas no canal de origem não entra na fila: nem o que chega atrasado quando a conta reconecta, nem o que o `/puxar` traz.

## 27/10/2026 — Puxador: versão API só com o preço e o cupom da fonte

- A versão **API** é o post do **/oferta** inteiro: da fonte entram só o preço e o cupom. Linhas como "Sem Juros", o nome da loja ou a dica do canal não vão mais para ela; ficam a condição do cupom ("Resgate cupom do anúncio") e a de que o preço depende (Pix, só no app, à vista). [Como funciona](/docs/telegram/userbot/).
- **Corrigir com IA** passa a mexer só no que você descreveu: o resto do post fica igual, letra por letra. Na versão API, a IA não traz texto da fonte para o post.

## 27/10/2026 — Puxador: "Já postado" com a hora, e tirar da fila se você quiser

- A oferta de um produto que já saiu no canal de destino agora mostra **Já postado às 14:32**, com a hora do post anterior, na fila do site, no histórico e no botão do card no Telegram (**🔁 Já postado às 14:32 · Postar mesmo assim**). [Como funciona](/docs/telegram/userbot/).
- Em **Puxador › Configuração › Texto, foto e bloqueio**, **Produto já postado no canal**: **Marcar na fila** (como era) ou **Tirar da fila**, que não manda card e leva a oferta direto para o **Histórico**. A janela vai de **30 min** a **24 h** (padrão **2 h**).
- Além do item na loja (Amazon, Shopee, Mercado Livre, AliExpress, Magalu, KaBuM), o mesmo produto de outras lojas é reconhecido pela página do produto, em post de um link só.

## 26/10/2026 — Puxador: seletor Fonte ou API no texto e na foto

- Em **Puxador › Configuração › Texto, foto e bloqueio**, **Texto** e **Foto** ganham o seletor **Fonte** ou **API**, o mesmo da fila. Por fonte, em **Fontes › Texto e foto**, dá para seguir o **Padrão** ou escolher. [Como funciona](/docs/telegram/userbot/).
- Quem ainda não escolheu começa com **API** no texto e na foto. Quem já tinha escolhido continua como estava.
- Post editado no canal de origem perdia a versão pela API, e o card ficava sem os seletores (aconteceu com as ofertas da KaBuM). Agora a versão é montada de novo depois da edição, e o card sempre mostra **Fonte** e **API**: sem a versão pronta, escolher **API** monta na hora.

## 26/10/2026 — Porteiro do site: a confirmação conta na campanha que trouxe a pessoa

- Quem entra no grupo pelo link de uma campanha e depois confirma o cadastro no site agora tem o **Confirmou o e-mail** (CompleteRegistration na Meta, sign_up no GA4) enviado com essa campanha: vai ao pixel e ao G- dela, com o clique do anúncio e as UTMs. Antes ia só aos destinos padrão, sem campanha. [Como funciona](/docs/referencia/rastreio-e-eventos/).
- O Bot passa a guardar de onde cada pessoa veio: a campanha, o grupo, o clique e as UTMs do primeiro toque, para os eventos seguintes saírem com a origem certa.

## 26/10/2026 — Comunidade em Desligado volta a apagar o link original

- Em grupo com a **Comunidade** em **Desligado**, o bot respondia com o link convertido e deixava a mensagem original no grupo. Agora ele apaga a original, como em qualquer grupo com **Apagar link original no grupo** ligado. O modo **Observar** continua sem apagar nada. [Como funciona](/docs/telegram/comunidade-ia/).

## 25/10/2026 — Sem "Recebe ofertas": cada ferramenta escolhe a sua lista de canais

- Acabou a autorização de destino. Todo canal ou grupo em que o bot está pode receber ofertas do **Postador**, das campanhas e da extensão; se o bot sair do chat, o envio é recusado com o motivo.
- No **Postador**, a nova aba **Canais e grupos** mostra todos os canais e grupos do bot, com busca e filtro, e você marca quais ficam na lista de envio. Canal novo entra na lista sozinho. Esconder só tira da lista, o bot continua no canal. [Como funciona](/docs/telegram/formatador-tempo-real/).
- A coluna **Recebe ofertas** saiu de **Telegram › Chats** e de **WhatsApp › Grupos e canais**. No WhatsApp, quem recebe se escolhe na campanha, na seção **Grupos**.
- Na próxima versão da extensão, **Postar no canal** lista todos os canais e grupos do bot, e quais aparecem se escolhe na nova aba **Configurações › Canais**, com busca e filtro. O botão **Escolher**, no painel lateral, leva para ela. [Como funciona](/docs/comecando/extensao-chrome/).

## 26/10/2026 — Puxador: post de cupom com uma linha por cupom

- O modelo do post de cupom ganha `{titulo}`, `{condicao}` e `{carrinho}`. A linha com `{condicao}` se repete para cada cupom do post, com a condição dele: um post com quatro códigos sai com quatro linhas. O link do carrinho entra só quando o post traz um. O modelo sugerido passa a ser o formato dos canais de cupom (🚨 título, 🏷 uma linha por cupom, 🚨 o link com o rótulo do canal, 🛒 Link carrinho). [Como funciona](/docs/telegram/userbot/).
- `{rotulo}` traz o que o canal escreve antes do link ("Ative em algum produto do link"). Post com tutorial, aviso ou um link por cupom sai como veio do canal, para o modelo não cortar a instrução.
- O Puxador reconhece mais posts de cupom: "35% OFF em R$ 99", "Limitado a R$ 20" e títulos como "➡️ Próximo Cupom Mercado Livre" não viram mais post de produto.

## 25/10/2026 — Puxador: post de cupom no seu modelo e com a imagem de cada loja

- Em **Puxador › Configuração › Post de cupom**, o post de cupom pode sair **no seu modelo de texto**, com `{loja}`, `{cupom}`, `{desconto}`, `{link}`, `{texto}` e `{footer}`, e com uma **imagem sua para cada loja** (e uma para as outras lojas) no lugar da foto do canal. A prévia mostra o resultado loja por loja. Sem modelo, o post de cupom continua saindo como veio do canal. [Como funciona](/docs/telegram/userbot/).

## 25/10/2026 — MCP: Vitrine e fila do Puxador pela IA

- A IA conectada pelo MCP agora **lista, adiciona e remove itens da sua Vitrine**. Todo item entra com o seu link de afiliado, convertido na hora; se a conversão falhar, nada é salvo. [Como funciona](/docs/ia/o-que-e-mcp/).
- A **fila do Puxador** também chegou ao MCP: a IA mostra as ofertas que esperam decisão e, com o seu OK, aprova (publica nos destinos) ou rejeita. Aprovar e rejeitar exigem ser dono ou admin do bot, e a decisão fica no Histórico como **Conexão IA (MCP)**. [Como funciona](/docs/ia/o-que-e-mcp/).

## 25/10/2026 — Script de rastreio para a sua landing e clique no canal do WhatsApp

- Um script para colar na sua landing leva o `fbclid`, as UTMs e os cookies `_fbp` e `_fbc` da Meta para o link de entrada da campanha no toque, inclusive a partir da segunda página da visita. Pode disparar um evento seu no Pixel e no GA4. [Como instalar](/docs/referencia/rastreio-na-landing/).
- O botão do **canal do WhatsApp** passa a contar clique na campanha pelo link de entrada (`ofertou.ai/e/<campanha>?canal=<código>`). O WhatsApp não avisa quem segue o canal: a entrada não é contada e não vira Lead.

## 25/10/2026 — Extensão 1.0.45: tema claro ou escuro e Configurações reorganizadas

- **Extensão 1.0.45:** **tema claro, escuro ou do sistema**, em **Configurações › Aparência** ou no botão de lua/sol no topo do painel lateral. Vale para o painel lateral, a janela separada e as Configurações, e acompanha a sua conta do Chrome. Sem escolha, segue o tema do Windows. [Como funciona](/docs/comecando/extensao-chrome/).
- As **Configurações** agora têm três abas (**Conta**, **Aparência** e **Cookies das lojas**), mostram no topo a qual bot a extensão está conectada e têm uma chave de liga/desliga por loja. Cada alteração mostra a confirmação na hora.
- **Configuração inicial:** ao instalar, abre um passo a passo curto: conectar o bot, escolher o tema e onde a extensão abre, ligar os cookies das lojas (opcional) e como usar. Quem usa só o Painel do Afiliado pula direto para os cookies. Dá para refazer pelo link **Configuração inicial**, no rodapé das Configurações.
- **Cookies das lojas:** quando o bot ainda não tem conta no plugin Mercado Livre ou Amazon, a extensão diz em vermelho que nada foi salvo e onde criar a conta (**Configurar › Lojas**), com link direto. O aviso do **Sincronizar agora** só diz **Sincronizado** quando todas as lojas ligadas salvaram, e uma conta do Mercado Livre sem **Etiqueta de afiliado** também avisa.
- O ícone da extensão ganhou a margem que a Chrome Web Store pede.

## 25/10/2026 — Puxador: post com vários produtos também pela API

- Post de **2 a 6 produtos** sai na versão **API** como o seu `/oferta` com vários links: um item por produto, em ordem de preço, e a grade com as fotos. O preço de cada item vem do próprio post. Quando o post não deixa claro o preço de cada produto, a oferta fica no **Conversor**, e a fila diz por quê. [Como funciona](/docs/telegram/userbot/).
- Com a **autoaprovação** e a versão API escolhida, a oferta espera a versão da API ficar pronta antes de sair. Antes ela podia sair na versão Conversor.
- Na versão **API**, a condição do post (como "Sem Juros" ou "Resgate o cupom do anúncio") sai junto do preço. Antes ela saía depois do rodapé e repetia o preço.
- Post de cupom no formato "R$ 60 OFF em R$ 499" é reconhecido como cupom: ganha o selo, segue a regra "Posts de cupom", manda o código ao módulo Cupons e não ganha mais uma versão API de produto.
- Quando a versão **API** não fica pronta, a fila diz se a montagem ainda não terminou ou deu erro.

## 24/10/2026 — WhatsApp: o Bot aprova ou recusa quem pede para entrar no grupo

- Nova aba **WhatsApp › Aprovação de entrada**. Nos grupos com **Aprovar quem entra pelo link** ligado, o Bot aprova cada pedido sozinho, na hora e numa conferência a cada 5 minutos, por campanha ou pela regra padrão.
- **Lista de bloqueio:** cole os números (com ou sem DDI e o 9) para todas as campanhas ou uma só, e eles têm o pedido recusado.
- **Um grupo por pessoa:** recusa quem já está em outro grupo da mesma campanha, conferindo na hora que a pessoa está mesmo lá, e mostra em qual grupo.
- **Comunidade:** o pedido, a aprovação e o trancar valem para a comunidade, e o "outro grupo" conta quem está em qualquer grupo dela.
- **Quem volta pelo link vai para o mesmo grupo:** o navegador que já entrou num grupo da campanha volta para ele no próximo clique, se houver vaga. [Como funciona](/docs/whatsapp/link-e-grupos/).
- **Últimas decisões** mostra cada pedido aprovado ou recusado e o motivo. Grupo trancado fica de fora. [Como funciona](/docs/whatsapp/aprovacao-de-entrada/).

## 24/10/2026 — Documentação mais fácil de ler por pessoas e por IAs

- Toda página da ajuda mostra quando foi publicada e atualizada, tem **Anterior** e **Próxima** no fim e uma **versão em Markdown** (troque a barra final do endereço por `.md`).
- Nova página **[Para agentes de IA](/docs/ia/para-agentes/)**, com preços, limites, endpoints e o que o Bot não faz, num lugar só.
- Reescritas com mais detalhe: os plugins **[Beleza na Web](/docs/integracoes/belezanaweb/)**, **[Braé](/docs/integracoes/brae/)**, **[Natura](/docs/integracoes/natura/)** e **[Pague Menos](/docs/integracoes/pague-menos/)** (o que muda em cada link e no post), a **[Central do Afiliado](/docs/integracoes/central-do-afiliado/)**, o **[POST /convert](/docs/api/convert-legado/)**, os **[erros e limites da API](/docs/api/erros-e-limites/)**, a **[referência interativa](/docs/api/referencia/)** e o **[Comece por aqui](/docs/comecando/comece-por-aqui/)**.
- Saíram os avisos de "em preparação" do que já está no ar (centavos no texto, cupons por site, NerdCupons, link no `ofertou.ai`, indicação pelo IndicaSaaS e Comunidade IA). A página "Módulo WhatsApp" da seção do Telegram foi unida a **[Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)**.

## 24/10/2026 — Puxador à venda, com Conversor ou API, post de cupom e destino por palavra-chave

- O **[Puxador](/modulos/puxador/)** saiu do piloto: R$ 149,90/mês, além do plano base, em **Conta › Plano e módulos**.
- Cada oferta sai como **Conversor** (texto e foto do canal, com os seus links) ou **API** (como o seu `/oferta`, com a mesma foto em grade e a sua marca d'água). A fila já mostra a foto da API, os links do texto ficam clicáveis e título grande não estoura mais o card.
- **Post de cupom:** ganha o selo **Cupom**, tem a regra de destino **Post de cupom** e, ao aprovar, o código entra no módulo **Cupons** (opção **Cadastrar cupons no módulo Cupons ao aprovar**).
- **Já publicado:** além do link, o Puxador compara o produto (ASIN da Amazon, item da Shopee e outros) no mesmo destino por duas horas, inclusive post feito à mão no canal. Preço menor não conta como repetida.
- **Destino por palavra-chave** aparece em **Onde aprovar e publicar**. A regra por palavra no texto ignora o rodapé que o seu bot acrescenta. [Como funciona](/docs/telegram/userbot/).

## 24/10/2026 — Troca e moderação de links do grupo no plano base

- No grupo, o bot apaga a mensagem com link que não converte, como o **convite de outro grupo** (`t.me/+…`, `chat.whatsapp.com/…`) ou a loja sem rota, **no plano base**. Antes isso pedia o módulo Grupos. Continua valendo a **Lista liberada** e a chave **Apagar link original no grupo**, em [Funcionalidades](/docs/comecando/funcionalidades/). [Como funciona](/docs/telegram/grupos/).
- O módulo Grupos segue com o Porteiro, o anti-spam de bots, a reputação e os comandos personalizados.

## 22/10/2026 — Extensão 1.0.44: parcelamento da KaBuM sem desconto no Pix

- **Extensão 1.0.44:** na KaBuM, quando o preço à vista no Pix é o mesmo do cartão (sem o "-N%" ao lado), o parcelamento sem juros volta a entrar no post. Ex.: "R$ 456,75 à vista no PIX · 10x R$ 45,67 s/ juros". Com desconto no Pix, a parcela continua de fora, porque é de outro preço.

## 22/10/2026 — Extensão 1.0.43: só o Painel do Afiliado, sem bot

- **Extensão 1.0.43:** quem usa só o **Painel do Afiliado** não precisa conectar um bot. No painel lateral sem bot, **Abrir Cookies das lojas** leva direto ao card, e a chave **Enviar ao Painel do Afiliado** (antes "Enviar também…") manda o login da Magalu (admin do Magazine Você) e do Mercado Livre com a sua sessão do paineldoafiliado.com, como dono ou admin da organização. [Como funciona](/docs/comecando/extensao-chrome/#para-o-painel-do-afiliado).
- No card **Cookies das lojas**, tudo vem desligado, e o envio ao bot liga loja por loja. Com 2 ou mais contas no plugin, **Conta do plugin que recebe o cookie** escolhe qual conta recebe.

## 21/10/2026 — Extensão 1.0.42: cookies da Amazon e do Mercado Livre em dia sozinhos

- **Extensão 1.0.42:** com você logado na Amazon e no Mercado Livre no mesmo Chrome, a extensão manda o cookie da sessão para o bot quando ele muda. Na Amazon ele vai para o card do **SiteStripe** (e liga o `link.amazon` se o plugin ainda não tinha); no Mercado Livre, para o campo **Cookie** do plugin. Vem desligado: você liga por loja no card **Cookies das lojas**, na engrenagem da extensão, com o status de cada loja e o botão **Sincronizar agora**. Funciona conectado como dono ou admin do bot, ou com chave de API de nível admin. [Como funciona](/docs/comecando/extensao-chrome/#cookies-das-lojas).
- O cookie colado à mão e o da extensão ficam no mesmo campo, e vale o mais recente. Cookie que a Amazon recusa, conta da Amazon sem loja de Associados e cookie de outra conta do Mercado Livre nunca substituem o que já estava salvo. No painel, o plugin mostra quando o cookie foi atualizado pela extensão.
- Na Amazon, o título da oferta não leva mais "No Programe e Poupe". Com cupom de código, a condição continua na linha do cupom.

## 21/10/2026 — WhatsApp: grupo criado sozinho recebe as ofertas e o incidente de número desconectado

- O grupo que a campanha cria sozinha, quando o anterior lota ou pelo **Criar grupo agora**, passa a receber as ofertas da campanha, como os outros grupos do WhatsApp dela. Antes ele só entrava no link de entrada. Campanha só de captação continua como estava.
- Quando um número cai e um grupo fica sem nenhum número conectado, abre o incidente **Número desconectado** desse grupo em **Incidentes**, junto do aviso de queda. Ele fecha quando o número volta. Veja **[Incidentes e notificações](/docs/whatsapp/incidentes-e-alertas/)**.

## 21/10/2026 — Filtro por comunidade do WhatsApp nas campanhas

- Na aba Grupos da campanha, o filtro de tipo ganha **Só comunidades do WhatsApp**, com a escolha de qual comunidade, e **Adicionar os encontrados** põe todos os grupos dela de uma vez. A busca também acha o grupo pelo nome da comunidade. Veja **[Criar campanhas](/docs/whatsapp/criar-campanha/)**.

## 21/10/2026 — Central de ajuda revista tela por tela e "?" em todas as telas

- **Plugin Amazon:** o card do SiteStripe agora diz que é **opcional** e que pede o **cookie da sua sessão na Amazon**, com o aviso de tratar o cookie como senha. Ganhou o botão **Remover cookie** (antes, apagar o campo mantinha o cookie salvo) e uma página própria: [SiteStripe da Amazon](/docs/integracoes/amazon-sitestripe/). A tag de associado aparece como o único campo obrigatório, e a [página do plugin Amazon](/docs/integracoes/amazon/) explica cada card. A ajuda da Creators API passou a indicar a versão 3.1, a que o painel usa.
- **"?" em mais telas:** Dashboard, Gerar link, Puxador, Vitrine, Shopee Live, Configurações do bot, Sub-bots, Broadcast, Campanhas, WhatsApp, Incidentes, Notificações e os cards Rastreio das campanhas, Destinos de eventos, Webhooks e Script do site. Nas telas Postador, Chats, Fotos e CTAs, Funcionalidades, Organização e Perfil, o "?" passou a abrir a página da própria tela.
- **Páginas novas:** [Dashboard](/docs/comecando/dashboard/), [Chats](/docs/telegram/chats/), [Fotos e CTAs](/docs/telegram/fotos-e-ctas/), [Configurações do bot](/docs/comecando/configuracoes-do-bot/), [Funcionalidades](/docs/comecando/funcionalidades/), [Organização](/docs/comecando/organizacao/), [Perfil e segurança](/docs/comecando/perfil-e-seguranca/) e [Rastreio e eventos](/docs/referencia/rastreio-e-eventos/).
- **Correções na ajuda:** entre contas de plugin e entre rotas, vence a de **maior** número de prioridade (a ajuda dizia o menor). A antiga whitelist é o card **Lista liberada**, em **Não mapeados**, e o bot tenta converter os links dela do mesmo jeito. Comunidade, pedido de entrada do Porteiro e rastreio das campanhas deixaram de aparecer como "em preparação". Claude Desktop, Claude Code, Cursor e VS Code conectam pelo MCP com chave de API; Claude.ai e ChatGPT, com login.
- **Nomes:** o Userbot aparece como **Puxador** em toda a ajuda, e as páginas usam os nomes de tela de hoje: Formato das ofertas, Fotos e CTAs, Chats, Assinaturas, Notificações e Chaves de API. Campanhas tem página própria, fora de WhatsApp.
- **Extensão:** a página indica a versão 1.0.41, e o link do ZIP para instalação manual voltou a funcionar.
- **Além do Telegram:** a ajuda deixou de apresentar o Bot do Afiliado como produto só de Telegram. As páginas de visão geral, de cupons e das integrações mostram onde o mesmo link, cupom e oferta também saem: painel, extensão do Chrome, API, IA (MCP), grupos de WhatsApp e a sua vitrine. A seção "Telegram" da ajuda passou a se chamar **Bot, ofertas e grupos**, com o mesmo endereço.

## Centavos no texto — 09/10/2026

- Em Promoções → Formato das ofertas, será possível definir um limite inclusivo para ocultar centavos somente no texto do post, sem arredondar. Exemplo: com limite de R$ 1.500, R$ 1.501,92 aparece como R$ 1.501. Campo vazio desativa. Preços originais e cálculos permanecem completos.
- Se o corte deixar o preço anterior igual ao atual, os dois mantêm os centavos. Só o dono ou um admin do bot altera o limite.
- No ar (conferido em 24/10/2026). [Como funciona](/docs/telegram/ofertas/).

## 20/10/2026 — Logo nova nas prévias e na extensão 1.0.41

- A prévia de link do site (WhatsApp, Telegram, redes sociais), as capas do blog e as imagens das páginas de módulo saem com a logo e a fonte novas do Bot do Afiliado.
- No modo escuro do site e no menu lateral do painel, a logo mantém o ícone em azul, com o texto em branco.
- **Extensão 1.0.41:** ícone novo no Chrome. A captura não mudou.

## 20/10/2026 — Uma página para cada módulo e combos prontos

- Cada módulo ganhou página própria em `/modulos/`, com o que ele faz, como começar, para quem serve, perguntas frequentes e o preço. Conexão IA e MCP e API de links são duas páginas do mesmo módulo, cobrado uma vez.
- Cinco [combos](/pricing/#combos) mostram módulos que costumam andar juntos e o total somado, sem desconto de pacote.
- O **módulo WhatsApp** entrou na página inicial e em [Módulos e preços](/pricing/): R$ 49,90/mês por número conectado, com grupos e canais ilimitados e sem cota de mensagens.
- Tracking por usuário e Rastreamento de vendas avançado aparecem como **em breve**: têm página e preço previsto, mas ainda não dá para contratar pelo painel.

## 20/10/2026 — Plugin Amazon (Gerenciado) descontinuado

- O plugin **Amazon (Gerenciado)** saiu da lista de plugins e não aceita conta nova. Para conectar a Amazon, use o plugin **Amazon** ([guia](/docs/integracoes/amazon-paapi/)), que também funciona só com a sua tag de associado.
- As contas que usavam o Amazon (Gerenciado) passaram para o plugin **Amazon** com a mesma tag de associado, e os links continuam saindo com a sua tag.

## 20/10/2026 — Extensão 1.0.40: a captura usa o que está na tela

- **Extensão 1.0.40:** nas lojas sem leitura própria, o nome, a foto, o preço e o preço "de" da oferta são os que aparecem na página aberta. Quando a página mostra um código de cupom junto do produto (como "R$25 OFF COM CUPOM LOREAL25"), o campo de cupom já vem preenchido.
- Na Drogaria São Paulo, o preço sai certo mesmo com o selo de desconto em reais na foto, e "ou 1x de R$ 34,99" não é mais tratado como parcela.

## 20/10/2026 — Extensão 1.0.38: Drogaria São Paulo com foto

- **Extensão 1.0.38:** na Drogaria São Paulo e na Drogarias Pacheco, a oferta sai com a foto, o nome do produto e o preço "de" da página. Antes saía sem foto. As duas lojas também entram na captura automática.
- **Bot e API:** o `/oferta` e o `/api/v1/product` passaram a trazer título, preço e foto dos produtos da Drogaria São Paulo, que antes voltavam vazios.

## 17/10/2026 — Comunidade: fotos dos grupos, acesso conferido sozinho e cores mais legíveis

- Nas listas de grupos da **Comunidade**, cada grupo aparece com a foto do Telegram, carregada conforme a linha aparece na tela. Canal fica com o ícone de canal, e grupo sem foto, com o ícone de grupo.
- Em **Comunidade → Proteção**, ao abrir um grupo, o card **Permissões do bot** consulta as permissões sozinho; **Verificar novamente** repete a consulta. Canal, bot sem o módulo Grupos e quem não é dono ou admin do workspace não consultam.
- Em todo o painel, os selos e textos de sucesso e de erro ficaram um pouco mais escuros e a borda dos campos, mais visível, nos temas claro e escuro, para atingir o contraste mínimo de leitura.

## 16/10/2026 — API de cupons: lista por cursor

- `GET /api/v1/coupons` aceita `cursor`: a lista vem em páginas na ordem da última atualização, sem o total. Comece com `cursor=0` e siga o `next_cursor` até ele vir `null`.
- Com `updated_since`, vêm só os cupons que mudaram desde a hora informada, inclusive os apagados. Serve para manter uma cópia dos seus cupons em dia sem baixar tudo de novo.
- Quem já usa `offset` e `total` não precisa mudar nada.

## 16/10/2026 — API: ver de novo a chave criada

- Em **API e IA MCP → Chaves de API**, as chaves criadas a partir de agora ganham **Mostrar** na lista: o dono e os admins do workspace veem a chave inteira de novo e copiam. Cada vez fica registrada no log de auditoria.
- As chaves criadas antes continuam como estavam e aparecem só na criação. Para ter uma que dá para ver de novo, gere outra.

## 16/10/2026 — WhatsApp: saúde do número, grupo criado ao salvar e link de grupo no espelho

- **Saúde do número:** em **WhatsApp → Números**, cada cartão mostra uma nota de 0 a 100 (boa, regular, atenção ou frágil) com até 4 dicas, como reconectar o número, dividir os grupos entre mais números quando ele envia acima do que sugerimos para o tempo dele no Bot, ou ver por que os envios falharam. É uma estimativa nossa, feita com o uso do número no Bot: o WhatsApp não publica as regras de bloqueio, e nota alta não garante que o número não será restrito. A nota só orienta: não muda cota, intervalo nem fila.
- **Grupo criado ao salvar:** com **criar o próximo grupo sozinho** ligado, salvar a entrada da campanha sem nenhum grupo com vaga já cria o primeiro grupo. Antes, ele só nascia no primeiro clique do link. Se a criação falhar, o que você salvou continua salvo e a tela avisa.
- **Criar grupo agora:** o botão cria o próximo grupo da série mesmo com vaga, com o nome base, a foto e o modelo salvos: um a cada 2 minutos e até 10 por dia por organização, dentro do teto de grupos da campanha. A lista de campanhas mostra quantos números conectados são admin nos grupos de cada uma.
- **Espelho do canal:** link de grupo do WhatsApp, de canal ou grupo do Telegram, de rede social ou de vídeo (YouTube, Instagram, TikTok e outros) sai no post como está, também o que a substituição da campanha põe no texto (como "@meucanal" virando o link do grupo). Antes, um link desses barrava o post inteiro. Encurtador que leva ao WhatsApp, como o `wa.link`, também passa. Link de loja que não converte continua barrando o post.
- **Envios:** quando a conversão falha, o envio diz qual link não converteu, em vez de "Não foi possível preparar o envio".
- **Tags da campanha:** na aba **Rastreio**, as tags são o Pixel Meta e o GA4. O GTM e o Pinterest só aparecem na campanha que já tinha um deles salvo.

## 16/10/2026 — Cupons: o IA Extrator não inventa código

- Em **Cupons → IA Extrator**, o código só é preenchido se aparecer inteiro no texto colado. Em "Shopee: 10% OFF acima de R$ 50, resgate pelo link", o desconto não vira mais `SHOPEE10` nem `10OFF`: o cupom fica sem código, e "resgate pelo link" passa a valer como "resgate no link".
- Códigos escritos no post com ponto, hífen ou sublinhado (`meli.20`, `Vem-Pra-Ca`, `PROMO_10`) continuam preenchidos.

## 16/10/2026 — Fotos da Comunidade e catálogo do Mercado Livre

- **Comunidade:** a IA lê as fotos dos grupos com um modelo melhor. Nos nossos testes com fotos reais, todas as leituras ficaram dentro do prazo e os prints de pedido foram reconhecidos; com o modelo anterior, cerca de um terço das fotos passava do prazo e ficava sem leitura.
- **Mercado Livre, link de catálogo:** o bot tenta gerar o link de afiliado da página de catálogo (`/p/MLB…`) mesmo sem o anúncio do vendedor. Quando o Mercado Livre recusa, a resposta explica e pede o link do anúncio: abra o produto, escolha o vendedor e envie o link dele. Antes, a resposta dizia que a página estava fora do programa de afiliados. Na API, o `/api/v1/product` devolve o mesmo erro, agora com a causa no campo `message`.

## 16/10/2026 — Extensão 1.0.37: parcelamento sem juros

- **Extensão 1.0.37:** o "sem juros" agora vem do que a loja escreve, e não de uma conta com o preço. Quando a página mostra a parcela sem juros junto do preço, o post leva a parcela, e ela continua sem juros se você aplicar cupom ou digitar um preço com desconto (a parcela é recalculada sobre o preço novo).
- Quando o preço capturado é só no Pix e a parcela é de outro valor ("ou R$ 3.299 em 10x", "R$ 470,58 em até 12x", "à vista no PIX", "5% off à vista no Pix ou NuPay"), o post sai sem parcela. Parcela que a loja não declara sem juros também não entra.

## 16/10/2026 — Página inicial atualizada

- **Home reorganizada:** passo a passo de três etapas, recursos atuais (extensão do Chrome, vitrine, conexão com Claude e ChatGPT) com link para a documentação de cada um e FAQ ampliada. As demonstrações com dados fictícios de recursos ainda não liberados e a página de indicadores públicos foram retiradas.
- **Criar o bot sem BotFather:** o passo a passo e a FAQ da home mostram o caminho de hoje. No painel, **Criar meu bot pelo Telegram** cria o bot no seu nome e ele já chega conectado, sem BotFather e sem token. Quem já tem um bot continua conectando pelo token do BotFather.

## 15/10/2026 — Extensão 1.0.36: preço e parcelas da KaBuM

- **Extensão 1.0.36:** na KaBuM, a extensão volta a ler o preço à vista e o preço riscado. A loja passou a mostrar o preço num contador animado, e a extensão acabava lendo o preço de um produto do carrossel de similares. Em produto esgotado, o preço de um similar também não entra mais no post.

## 15/10/2026 — Extensão 1.0.35: parcelamento do AliExpress

- **Extensão 1.0.35:** a extensão volta a ler o parcelamento do AliExpress. A loja passou a escrever a parcela como `R$306,61 x 12 sem juros`, sem a palavra "meses", e o post saía sem parcela. O formato antigo continua reconhecido.

## 13/10/2026 — WhatsApp: links curtos da Amazon e do Mercado Livre no espelho

- O espelho do canal para o grupo do WhatsApp não recusa mais o link curto que o próprio bot gerou na Amazon (link.amazon) e no Mercado Livre (meli.la). Antes, o post saía com "Não foi possível preparar o envio".
- Link de outro afiliado continua sendo trocado pelo seu, e o que não dá para converter continua sem ir.

## 13/10/2026 — Comunidade: quatro abas

- A Comunidade ficou com **Atividade**, **Proteção**, **Reputação** e **Consumo de IA**. A antiga aba Feedbacks virou o filtro **Feedbacks** da Atividade.
- Na **Proteção**, você escolhe o grupo ou canal e vê tudo dele numa página: o modo de proteção, o **Porteiro** (quem entra, quem fala e o que a pessoa aceita), as permissões do bot e as pessoas do grupo. Em **Todos os grupos** ficam a punição automática, os confirmados no site e os infratores.
- Os links antigos para as abas Porteiro, Mini App de entrada e Feedbacks levam ao lugar novo.

## 13/10/2026 — Reputação: voto com 👍, 👏 e 👎

- No grupo, responder a mensagem de alguém só com 👍 ou 👏 dá +1 de reputação, e só com 👎 tira 1, como o `+1` e o `-1`. Vale o emoji repetido e com tom de pele. Com texto junto ("👍 valeu"), não é voto.
- O bot confirma o voto por emoji como confirma o `+1`. Quando o voto não conta (a pessoa já votou na semana ou respondeu a um bot, a um post do canal ou a si mesma), o bot não responde nada, porque muita gente responde 👍 só para dizer "ok". No `+1`, o bot continua explicando por que o voto não contou.
- Em grupo com Tópicos, só conta a resposta a uma mensagem. A mensagem solta no tópico, que o Telegram entrega como resposta à abertura do tópico, não vira voto em quem abriu o tópico. Vale também para o `+1`.

## 13/10/2026 — Porteiro: cadastro no seu site para liberar as mensagens

- A regra do Porteiro ganhou **O que a pessoa precisa para falar**: estar no canal (como antes), **confirmar o cadastro no seu site** ou as duas coisas. É para grupo público, que não tem pedido de entrada.
- Vale só para quem entrar depois de ligar a regra. A pessoa fica pausada na 1ª mensagem (ou já na entrada, para grupo sob ataque de robôs), recebe o aviso e confirma com o e-mail ou com o Google, sem senha. A confirmação vale em todos os grupos do bot.
- Novo card **Confirmados no site** na aba Comunidade e um **Link para fixar no grupo**.
- No card **Confirmados no site**, o dono e os administradores veem marcadas as contas diferentes do Telegram que confirmaram com o mesmo e-mail (**E-mail em outra conta**, com o @ ou o nome da outra). Ninguém é bloqueado por isso.
- Na regra **Canal e site**, quem confirma o cadastro antes de entrar no canal recebe no privado o aviso de mensagens liberadas assim que entra no canal. A mensagem do canal que falta também traz o botão **Pronto, entrei**, que confere na hora.
- As páginas do seu site deixaram de carregar a medição do próprio Bot do Afiliado (Google Analytics e Pixel da Meta).
- A política de privacidade explica o que guardamos de quem confirma o cadastro e o que pode ir para a Meta.

## 10/10/2026 — Cupons: cada código em destaque e Programe e Poupe na linha do cupom

- Com mais de um cupom no post (`20OFFAMAZON + SKAL129LKAJ`), cada código sai no seu próprio monoespaçado, fácil de copiar. Antes, a frase inteira ficava num bloco só. Um cupom sozinho continua como era.
- **Extensão 1.0.32:** produto da Amazon no Programe e Poupe com cupom sai com `CÓDIGO + Programe e Poupe` na linha do cupom, e só o código fica em destaque. Antes, a condição ia no fim do título. Sem cupom, a condição continua no título.

## 10/10/2026 — Extensão 1.0.31: cupom no preço e parcelas sem juros

- **Extensão 1.0.31:** o desconto do cupom lembrado da loja entra no preço quando você captura o próximo produto da mesma loja. Antes, o campo mostrava o desconto, mas o post saía com o preço sem o cupom.
- Parcelado no valor da página continua **sem juros** depois do desconto do cupom, com a parcela recalculada sobre o preço com cupom (10x de R$ 20,00 vira 10x de R$ 16,00 com 20% de cupom). Parcelamento com juros e preço digitado à mão continuam sem parcelas.
- Amazon: o parcelamento da calculadora ("6x de R$ 29,85 sem juros, total parcelado R$ 179,00") volta a ser detectado. A Amazon arredonda a parcela para cima, e a soma não fechava com o total.

## 10/10/2026 — /oferta com link de celular da Amazon e páginas que o Mercado Livre recusa

- No `/oferta`, o link que o app ou o site de celular da Amazon compartilha (`amazon.com.br/gp/aw/d/…`) é lido como o produto. Um `/oferta` com dois produtos, um deles com esse link, saía só com o outro.
- Mercado Livre: link da página de Ofertas, de categoria, de cupons ou da página inicial explica que o Mercado Livre não permite link de afiliado para essas páginas, e sugere usar o link de um produto, de uma busca ou de uma loja oficial. Antes, a mensagem era "tente novamente", e repetir não resolvia.

## 10/10/2026 — Links no grupo: todo link é convertido

- Em grupos, com o módulo Grupos e **Apagar link original no grupo** ligados, todo link passa pela conversão: o bot envia a versão de afiliado e apaga a mensagem original. Se a conversão falhar, a mensagem também é apagada, a não ser que o link esteja na **whitelist**. Antes, link de loja com erro na conversão ficava no grupo.
- Vale também nos grupos com **Proteção da Comunidade** no modo **Automático**. Antes, nesses grupos o bot não apagava convite de outro grupo nem link sem conversão de quem era inscrito. Nos modos Observar e Desligado, nada muda.
- Mensagem editada para incluir um link passa pelo mesmo caminho da mensagem nova: o bot converte, responde à mensagem e a apaga. A prévia do link, que o Telegram também manda como edição, não repete o post. Mensagem de administrador do grupo e post do canal ficam de fora.
- Na whitelist, um link passa a liberar também o que está abaixo dele: `https://t.me/seucanal` libera os posts do canal (`https://t.me/seucanal/123`).

## 10/10/2026 — Fontes da campanha e criação automática de grupos

- Na campanha, a aba **Fontes** lista todos os canais e grupos do Telegram em que o seu bot está, com busca e os canais primeiro. Marcar um que ainda não era fonte já o cadastra. Antes só apareciam as fontes cadastradas, e as outras ficavam escondidas em “Adicionar fonte”.
- **Criar grupos automaticamente quando lotar** deixa claro que vale só para grupos de WhatsApp, e as opções de como os grupos novos nascem ficam recolhidas.
- O aviso de convite do Telegram diz o nome certo da permissão: no canal, **Adicionar membros**; no grupo, **Convidar usuários por link**.

## 10/10/2026 — Cupom por link no formato de cupom, marca no /oferta e anúncios do Mercado Livre

- **Extensão 1.0.30:** com cupom por link, o post sai no formato de **Cupom**, igual ao Postador: a linha de resgate entra no lugar de `{linhadocupom}`, logo abaixo do preço. Antes ia no formato de oferta, e a linha caía depois do link do produto.
- No Telegram, `/oferta` e `/cupom` passam a sair com a marca d'água quando “Aplicar nas fotos das ofertas” está ligado. Antes, só o Postador, a extensão, o link colado e a API aplicavam a marca.
- Links de anúncio patrocinado da busca do Mercado Livre (`click1.mercadolivre.com.br/...`) agora funcionam: o bot vai direto para o produto anunciado.

## 10/10/2026 — Prévia da extensão com a foto final

- **Extensão 1.0.29:** a prévia do post mostra a **foto como ela sai**: no padrão do seu bot (fundo e grade) e, com “Aplicar nas fotos das ofertas” ligado, com a marca d'água. Antes a prévia mostrava a foto crua do produto e a formatação só acontecia no envio.
- Com “Enviar com a foto do produto” desmarcado (em Postar no canal), a prévia também sai sem a foto.

## 09/10/2026 — Marca d'água nas fotos

- Em **Fotos próprias → Marca d'água nas fotos**, envie o seu logo (PNG com fundo transparente fica melhor) e/ou um texto, escolha o canto, a opacidade e o tamanho, e teste na hora.
- Pela API: `POST /api/v1/watermark` devolve a foto com a marca (PNG, ou a URL com `store:true`), e `POST /api/v1/product` com `watermark: true` traz `product.image_url_watermark` junto com o produto.
- A mesma foto com a mesma marca não é refeita: a segunda chamada devolve a URL já pronta.
- O logo pode ser **SVG** (vira PNG transparente no envio) e a seção mostra a marca **ao vivo** numa foto de exemplo, clara ou escura, ou numa foto de produto: posição, tamanho e opacidade mudam na hora, e dá para escolher o canto clicando na foto.
- **Aplicar nas fotos das ofertas:** ligando essa opção na seção da marca d'água, a foto do post já sai com a marca no /oferta e /cupom do bot, no Postador e na extensão (uma marca só na imagem inteira, inclusive na grade de vários produtos). A prévia aceita também o link do produto, não só o da imagem.
- **Extensão 1.0.28:** a foto trocada no produto passa a ficar salva como foto própria e volta sozinha quando o mesmo produto aparecer de novo. Antes ela valia só para aquele post.

## 07/10/2026 — Página da oferta para copiar o cupom no WhatsApp (em preparação)

- Na aba **Rastreio**, a opção **Página da oferta nos posts com cupom** (WhatsApp), recomendada; vem desmarcada e passa a valer quando você a marca e salva: nos posts com cupom, os links da Shopee, do Mercado Livre e do AliExpress que vão para o WhatsApp abrem a página da oferta, mesmo no modo Direto ou Pelo ofertou.ai. Os posts sem cupom e o Telegram seguem o modo escolhido. A tabela do que a campanha mede diz, na linha de cada uma dessas lojas, o que muda nos posts com cupom. [Como funciona](/docs/whatsapp/criar-campanha/).
- A página mostra a foto do produto, o título, o preço e cada trecho em monoespaçado como um botão que copia com um toque (também os escritos com crases no WhatsApp). **Copiar e ir para a loja** copia o cupom do post (o trecho da linha que diz cupom ou código; sem ela, o primeiro) e abre a loja (com dois ou mais cupons, o botão diz qual copia); **Ir sem copiar** abre direto. Com mais de um link da Shopee, do Mercado Livre e do AliExpress no post, cada um tem o seu botão, com o nome do produto quando o post o diz, que copia o cupom desse produto, e cada página mostra o título, o preço e os cupons do produto do link aberto. Num post com vários produtos, a página sai sem a foto do post, que não diz de qual produto ela é; num post de um produto com um link por tamanho, cor ou loja, cada página mostra o título, o preço e a foto do post, com o tamanho ou a cor dela ao lado da loja. A página só mostra como preço o valor que o post diz que é preço, e sem um preço claro no post não mostra nenhum: o valor, o mínimo ou o teto de um cupom, o desconto, a parcela ou o frete com o cupom, o de um crédito e o preço por unidade não viram preço. Pontuação e quebra de linha junto dos rótulos de desconto ou frete não transformam esses valores no preço do produto. Preço antigo não serve de reserva; quando o texto é ambíguo, o destaque fica sem preço.
- Mais rápida: um arquivo só, sem fonte externa, e as tags da campanha carregam depois que a página e a foto aparecem. Sem cupom, a página segue sozinha para a loja, sem a foto e sem os botões dos outros links: as tags entram logo que ela aparece, e a loja abre 400 ms depois delas.
- Copiar o cupom vira um evento novo nos Destinos de eventos, um por clique: `CupomCopiado` na Meta e `cupom_copiado` no GA4.

## 07/10/2026 — Páginas de entrada com a cara do grupo

- A página do link de entrada, a do e-mail antes do convite e o Mini App do porteiro do Telegram mostram a foto, o nome e a descrição do grupo e, a partir de 10 pessoas, quantas estão nele, com o botão na cor do app (o verde do WhatsApp; no Telegram, o azul ou a cor do tema de quem abre). As páginas não levam a marca do Bot do Afiliado. [Como funciona](/docs/whatsapp/link-e-grupos/).
- No Link de entrada, a **Foto do grupo** é enviada pelo portal (vira quadrada, 640 px) e também é a imagem da prévia do link. Sem ela, a página usa a foto dos grupos criados sozinhos ou a do Padronizar; sem nenhuma, as iniciais do nome. No Mini App do Telegram, a foto, a descrição e os membros vêm do próprio grupo; a descrição da prévia do link, quando existe, vale no lugar da dele.
- Antes do botão, uma linha diz o que vai e para quem, conforme o que a campanha mede (por exemplo: o e-mail fica com você, e a Meta recebe o e-mail e um identificador em código, o IP e dados do navegador); o aviso inteiro, com o mesmo texto de antes, abre em **Saiba mais**. Fora do Mini App, os textos têm contraste de pelo menos 4,5:1, também com o aviso aberto; no Mini App valem as cores do tema do Telegram de quem abre. **Em preparação:** o link da sua política de privacidade à vista no rodapé, também na página que pede e-mail e no Mini App.
- **Em preparação:** a verificação contra robôs só aparece quando precisa de um toque. Se ela falhar, tenta de novo sozinha e o código sai quando ela passar; se ela não carregar (bloqueador de anúncios ou rede), a página avisa.
- As tags de anúncio passam a carregar depois de a página aparecer na tela, e a página só segue para o convite 400 ms depois de elas entrarem, o tempo que elas já tinham para mandar o evento; o estilo continua embutido, sem fonte externa.

## 07/10/2026 — Porteiro de entrada com e-mail confirmado (em preparação)

- No Mini App do porteiro de entrada do Telegram, cada grupo escolhe se pede e-mail: **não pedir**, **opcional** ou **obrigatório**. O e-mail só vale depois de confirmado com um código de 6 dígitos enviado por e-mail (10 minutos, 5 tentativas). [Como funciona](/docs/telegram/grupos/).
- Pedir e-mail exige o link da sua política de privacidade, que aparece no Mini App com o aviso do que vai para a Meta e o Google. Com e-mail ligado, o Mini App não carrega pixel nem tag.
- A lista de pessoas e o CSV do público passam a mostrar só e-mails confirmados.
- No painel do porteiro e na campanha, o funil de quem pediu entrada: abriu o porteiro, confirmou o e-mail, foi aprovado, entrou e ficou 30 dias.
- No link de entrada do WhatsApp, a campanha pode pedir o e-mail antes do convite (opcional ou obrigatório), com o mesmo código de 6 dígitos e uma verificação contra robôs. [Como funciona](/docs/whatsapp/link-e-grupos/).
- O aviso do Mini App e do link de entrada diz quando cada envio acontece e para qual ferramenta (confirmação do e-mail, entrada e 30 dias no grupo; o que só a Meta ou só o Google Analytics recebe aparece assim) e só cita o e-mail indo ao Google Analytics quando o destino do GA4 tem os dados fornecidos pelo usuário ligados. No link de entrada do `ofertou.ai`, o aviso também diz que confirmar o e-mail liga aquele navegador à pessoa. Código errado aparece em destaque, junto do campo.
- Com um chat do Telegram na rotação do link de entrada, o e-mail do código diz que o convite é do Telegram, e a confirmação fica registrada no canal do grupo.

## 07/10/2026 — Rastreio dos links das campanhas (em preparação)

- Nova aba **Rastreio** na campanha do WhatsApp: os links da Shopee, do Mercado Livre e do AliExpress saem **Direto** (o link da loja, como hoje), **Pelo ofertou.ai** (um link por grupo, com o clique de pessoas contado por grupo) ou na **Página da oferta** (cupom copiável e botão da loja), com exceção por loja. A Amazon sai sempre com o link dela. [Como funciona](/docs/whatsapp/criar-campanha/).
- O padrão da organização fica em **Configurações → Rastreio das campanhas**. A troca vale a partir do próximo post.
- A Página da oferta passa a valer também nos chats do Telegram e nos envios pelo Postador.
- As tags (Pixel Meta, GA4, GTM, Pinterest e API de Conversões) passam do Link de entrada para a aba Rastreio, que também mostra o que cada loja mede e o que vai para a Meta e o GA4.
- A aba lembra que a sua política de privacidade precisa descrever o clique (no Direto, o das redes e das outras lojas, que já passam pelo ofertou.ai) e traz o texto pronto para a descrição do grupo quando o link da sua política estiver cadastrado.
- A Página da oferta só entra com **Converter links de afiliado** ligado; sem a conversão, o texto sai como está.
- A tabela do que vai para a Meta e o GA4 acompanha o modo escolhido antes de salvar e mostra o e-mail confirmado, que sai só pelo servidor.
- Liberação por etapas: Pelo ofertou.ai e Página da oferta abrem para todas as contas quando a página de privacidade do ofertou.ai estiver no ar. Até lá, os links saem Direto.

## 07/10/2026 — Tudo que a pessoa vê no ofertou.ai, com o navegador reconhecido

- No ar desde 24/10/2026. O aviso com a verificação contra robôs, no link de entrada que pede e-mail, continua em preparação.

- O link de entrada das campanhas, a página de cópia e o porteiro do Telegram passam a morar no `ofertou.ai`. Os links já publicados continuam valendo e levam ao endereço novo com os mesmos parâmetros do anúncio. [Detalhes](/docs/whatsapp/link-e-grupos/).
- O `ofertou.ai` passa a reconhecer o mesmo navegador entre as passagens (cookie `__Host-nid`, 400 dias), guardado por conta, sem ligar contas diferentes. [Cookies do ofertou.ai](/docs/telegram/encurtador/).
- A política dos cookies e o botão **Não me reconhecer neste navegador** ficam em `ofertou.ai/privacidade`. Quem usa o botão segue para a loja ou o grupo sem os códigos de medição, e os códigos dos cliques que já tinha feito são apagados.
- As páginas só criam o cookie `_fbp` quando carregam o pixel da Meta.
- O rodapé das páginas traz a política do `ofertou.ai` e, quando cadastrado, o link da sua política de privacidade. Onde a página mostra o aviso de privacidade (o porteiro do Telegram e o link de entrada que pede e-mail), o link da sua política também vai no aviso. Os links abrem em outra aba, também no Telegram Web.
- Os eventos enviados à Meta pelo servidor (entrada, clique na oferta e compra) passam a levar o identificador da pessoa e o do navegador, e o pixel da página leva o mesmo identificador do navegador. Quando entra no grupo pelo convite do próprio clique, ou confirma o e-mail no link de entrada que pede e-mail, o navegador fica ligado à pessoa. Um navegador já ligado a uma pessoa não passa a outra.
- Na lista de clientes, o CSV para público personalizado passa a trazer na coluna `external_id` um código da pessoa no lugar do id do Telegram, o mesmo que vai (com hash) na API de Conversões, também para quem só confirmou o e-mail no link de entrada. Quem pediu a exclusão dos dados fica com a coluna em branco.

## 07/10/2026 — Link curto da Shopee aberto até a página

- Link curto da Shopee (`s.shopee.com.br` ou `shp.ee`) colado no bot passa a ser aberto até a página da loja antes da conversão, também quando a Shopee responde com uma página que redireciona sozinha, em vez de mandar direto para a loja. Antes, nesse caso, o link curto seguia sem abrir.

## 07/10/2026 — Destinos de eventos: Meta e GA4 pelo servidor

- Em **Configurações → Destinos de eventos**, entrada no grupo, clique na oferta, compra e permanência de 30 dias passam a sair também pelo servidor para a Meta (API de Conversões) e para o GA4, numa fila com nova tentativa. A compra vai com o valor da comissão. [Como configurar](/docs/whatsapp/link-e-grupos/).
- Só vai o que tem certeza: clique e venda casados exatamente. Cada evento tem o seu interruptor (no destino da campanha, os da entrada no grupo e do clique na oferta valem também para a tag da página), e cada destino tem o botão de evento de teste.
- Os erros da Meta aparecem em português e dizem o que fazer, como gerar outro token quando o atual venceu. Em **Webhooks**, o botão **Rotacionar secret** passa a se chamar **Gerar outro segredo**.
- Webhooks ganham `oferta.clicada`, `venda.atribuida`, `venda.estornada`, `lead.email_confirmado` e `lead.ficou_30d`. [Eventos](/docs/api/webhooks/#eventos).

## 07/10/2026 — API: destino do link na conversão

- O `/api/v1/convert-links` e o `/api/v1/convert` aceitam dois campos opcionais que dizem para onde o link vai: `chat_id` (o grupo ou canal do Telegram) ou `origem` (`{"tipo": "site", "id": "meusite.com.br"}`, com os tipos `grupo`, `canal`, `site` e `post`). [Como usar](/docs/api/convert-links/#origem-do-link-opcional).
- Com o destino, cada um ganha o seu link curto e os cliques passam a ser contados separados por destino. Links que saem direto da loja, sem passar pelo encurtador (Shopee, AliExpress, Mercado Livre e Amazon pela integração da própria loja), continuam iguais em todos os destinos.
- Sem os campos (ou com `null` neles) e sem origem padrão na chave, nada muda. Conversa privada com o bot não conta como destino, e tipo fora da lista devolve erro 400.
- Cada chave de API pode ter uma **origem padrão**, em **API e IA MCP → Chaves de API**: vale quando o pedido não manda `chat_id` nem `origem`, para a integração que só converte e não sabe o destino. [Como usar](/docs/api/convert-links/#origem-do-link-opcional).
## Magalu — 07/10/2026

- Correção para buscas e seleções do Magazine Você que passavam pela verificação da loja e geravam links sem a lista de produtos. O destino e a loja do afiliado são preservados.

## Segurança — 07/10/2026

- Login com autenticador mantém o segundo fator após e-mail, SSO e passkey sem verificação local.
- Chaves de leitura recebem convites WhatsApp mascarados.
- Comandos administrativos pela API exigem chave admin ou sessão de proprietário/administrador; informar um ID Telegram não concede esse acesso.
- Tokens MCP são conferidos contra destinatário e conexão vigente; tokens vinculados a uma chave não são aceitos como Bearer.

- Sessões refletem suspensão, troca de senha e alteração de permissões; conexões MCP respeitam o bot autorizado.
- Extensão 1.0.27 abre a composição em janela própria do Chrome; o painel deixa de guardar páginas privadas para uso offline.
- Convites de equipes são consumidos uma vez; alterações no porteiro aguardam a revogação dos convites anteriores.
- Edição de mídia, composição de ofertas, exportação CSV e integrações passam por validações adicionais.

## 07/10/2026 — Política de privacidade com a medição do site

- A [política de privacidade](/privacidade/) passa a descrever a medição do site e do painel: o Google Analytics, o Pixel da Meta, o Microsoft Clarity (que grava a sessão de navegação no site público, com o texto digitado mascarado) e os marcos da conta (cadastro, login, primeiro canal conectado, primeira oferta e pagamento), que saem do nosso servidor (para o Google com o identificador da conta; para a Meta com e-mail e nome em hash).
- Ela lista como bloquear cada ferramenta. Nada disso muda o funcionamento do Bot do Afiliado.

## 01/10/2026 — Links da Rakuten voltam a abrir

- Links da Rakuten (Netshoes e as demais lojas da rede) davam erro "Invalid Publisher Code" ao abrir: o link saía com o SID numérico, que a Rakuten não aceita. Agora o bot usa o ID de link da conta, que ele busca sozinho na API da Rakuten — o plugin continua pedindo só **SID + App ID + App Secret**.
- Os links curtos já publicados com o ID errado foram corrigidos e voltam a levar à loja.

## 29/09/2026 — Página de cópia do cupom no WhatsApp

- Nova opção na campanha: **Página de cópia no WhatsApp**. O link da loja abre uma página com o cupom e o botão **Copiar e ir para a loja**, porque no WhatsApp o texto monoespaçado do Telegram não se copia sozinho.
- O clique na página conta por grupo e dispara o pixel do link de entrada da campanha, com o mesmo evento no navegador e na API de Conversões.
- Na Shopee, a venda feita a partir da página volta ligada ao clique e vai para a Meta como compra.

## 26/09/2026 — Campanhas do WhatsApp com até 2.000 grupos

- Uma campanha aceita até 2.000 grupos e chats (antes, 200). Posts, edições e "apagar para todos" das campanhas grandes entram na fila em etapas, sem se perder no meio do caminho.
- O envio manual (pelo Postador ou pela própria campanha) vai para até 1.000 destinos de uma vez; acima disso, nada sai pela metade e a tela avisa.
- A foto, o vídeo ou o áudio do post ficam guardados pelo Bot do Afiliado enquanto a fila envia: o grupo que recebe horas depois continua recebendo a mídia.
- Links de Shopee, AliExpress, Mercado Livre e Amazon são convertidos uma vez por post e reaproveitados em todos os grupos.
- Abrir uma campanha antiga não mostra mais "Alterações ainda não salvas" sem ninguém ter mexido. No celular, o nome do grupo aparece inteiro na lista da campanha.

## 26/09/2026 — Aquecimento do WhatsApp

- **Aquecimento:** métodos próprios do Bot do Afiliado para aquecer o número escolhido, direto no cartão do número em **WhatsApp → Números**, com janela em horário de Brasília, limite diário, acompanhamento, pausa e retomada. [Como funciona](/docs/whatsapp/aquecimento/).
- **Intervalo sorteado:** você define o mínimo e o máximo, e a espera até a próxima conversa é sorteada a cada envio. Até 200 mensagens por dia.
- **Conversas com etapas:** a mensagem seguinte de uma conversa só sai depois da resposta, alguns segundos após ela; sem resposta em 2 horas, a conversa termina e o aquecimento segue. Toda mensagem conta no limite diário.
- O progresso mostra quantos contatos responderam, quantos ficaram sem resposta e o horário do próximo envio.
- Se o número cair por um momento, o aquecimento espera e retoma sozinho. Quando precisa pausar, o dono recebe um aviso e retoma de onde parou.

## 26/09/2026 — WhatsApp: admins em massa e grupos padronizados

- **Adicionar admins:** na campanha, a aba Administrar grupos põe os outros números conectados como admins em todos os grupos dela. Cada número entra pelo link e recebe admin, um grupo por vez, com o intervalo que você escolher.
- **Padronizar grupos:** nome, descrição, foto e permissões iguais em todos os grupos da campanha, com numeração que não repete a dos grupos criados sozinhos.
- **Grupos criados sozinhos personalizados:** descrição, permissões e admins extras já no nascimento do grupo.
- Andamento com o próximo horário e as falhas de cada grupo; dá para parar no meio.
- **Só admins enviam:** padronizar com essa permissão tira do envio das ofertas, naqueles grupos, os números que não são admin, até eles virarem admin. Antes, parte dos envios ia pelo número sem permissão e falhava.
- O mesmo número em lotes de várias campanhas faz uma operação de grupo por vez, com o intervalo escolhido, e nunca no mesmo segundo de um envio.

## 23/09/2026 — Comando /c: configuração gerada por IA a partir dos seus posts

- **Gerar a configuração com IA:** cole até 5 posts como eles chegam e, ao lado, como você quer que saiam. A IA monta a configuração do /c e o sistema testa cada tentativa no motor real até bater com os seus exemplos, mostrando exemplo por exemplo o que bateu e o que ficou diferente. Nada é salvo antes de você conferir na Prévia.
- Configuração que altera qualquer link do post é descartada: os links precisam sair intactos para virar o seu link de afiliado.
- Até 5 gerações por dia em cada bot.
- Posts com "-Link produto:" não saem mais com o 🛒 repetido numa linha sozinha.

## 23/09/2026 — Comando /c: prévia ao vivo e parcelas sem repetição

- **Prévia:** a página do /c mostra, enquanto você edita, como o post sai no Telegram.
- **Parcelas:** "Sem Juros" não vira mais "12x 12x Sem Juros" nem "10x 12x Sem Juros".
- Novos campos para o prefixo do título, regras que podem ser reordenadas e rodapé com várias linhas.

## 23/09/2026 — Lojas brasileiras na Awin

- **Awin:** a sincronização do Brasil também encontra programas classificados como Brazil USD, incluindo a LG BR, sem exigir outra conta ou configuração por loja.

## 22/09/2026 — Assinaturas após o login

- Primeiro acesso seleciona corretamente o bot da organização, sem pedir um novo cadastro para quem já possui bot.
- Falha ao carregar planos mostra opção de tentar novamente e não oferece assinatura com valor zerado. A ação dos avisos não sobrepõe o texto no celular.

## 22/09/2026 — Indicação pelo IndicaSaaS

- Referência de indicação preservada entre site, login e checkout de uma nova assinatura, com respeito ao prazo do programa.
- Mudanças de módulos mantêm a indicação da assinatura existente. Cadastro e teste gratuito não contam como venda.
- No ar no site, no painel e no checkout. Cadastro de indicadores e pagamento das comissões ficam no IndicaSaaS. [Como funciona](/docs/planos/como-assinar/).

## 22/09/2026 — Identificação e acompanhamento do WhatsApp

- O cartão do número preserva o nome cadastrado como título; o nome do perfil WhatsApp aparece abaixo.
- Entradas, saídas e sondagens de saúde de grupos exigem vínculo com campanha da organização. Descobrir um grupo não inicia seu acompanhamento. Campanhas arquivadas deixam de autorizar novas medições; pausar o repasse preserva o vínculo e o histórico.

## 22/09/2026 — Uso interno da IA

- Uso interno da Comunidade com período definido, registro de análises e custo do provedor separado da cobrança à organização. A concessão é específica da organização e não altera preços dos clientes.
- A aba Consumo identifica a modalidade e o horário final. A expiração impede novas análises automaticamente.

## 22/09/2026 — Comunidade e configurações mais claras

- Lista de grupos com busca por nome e @ em Proteção, Atividade, Feedbacks e Porteiro, sem dropdown de grupos.
- Histórico mais compacto, filtros adicionais e recibos expansíveis. IA não habilitada aparece como análise pausada, com o motivo também na aba Consumo.
- Corrigida a falha que interrompia consultas ao Telegram e ao antispam antes de enviar a requisição. Permissões continuam sendo verificadas, sem assumir acesso.
- A verificação do canal obrigatório reconhece seus nomes alternativos ativos no Telegram.
- Configurações do bot concentradas em nome, Telegram e acesso. Token existente só aparece para troca; sub-bots ficam sob demanda. Conta, membros e módulos têm atalhos para suas páginas próprias.

## 22/09/2026 — Pessoas e resultados

- Visão de audiência por organização, com filtros de campanha e período, origens e confiança, entradas e permanência observada nos grupos.
- Origem e parâmetros de campanha preservados na entrada WhatsApp. Comissões registradas da campanha separadas de comissão individual, que depende de vínculo comprovado.

## 22/09/2026 — Teclado e estatísticas no celular

- Ordenação das tabelas por Enter/Espaço e nomes acessíveis na paginação, buscas, Gerar Link e Converter.
- Estatísticas WhatsApp contidas na largura do celular, com dados diários preservados para leitores de tela e aba selecionada visível ao abrir seu link.

## 22/09/2026 — Incidentes e Alertas no menu

- Organização e Assinaturas ficam sempre visíveis no rodapé do menu para o proprietário, inclusive no celular. A página Organização também oferece um atalho para gerenciar assinaturas.
- Incidentes e Alertas aparecem junto ao Dashboard, fora de Módulos, no desktop e no celular. São recursos do Bot, sem contratação adicional própria.

## 22/09/2026 — Campanhas e conexão WhatsApp

- Campanhas com abas de destino/rastreamento e resumo/configuração/links por origem. Convite pendente permanece visível, com instruções e retentativa sem duplicar a campanha. Consulta horária mais compacta.
- Links da mesma campanha para site ou grupo, com origens marcadas ou identificadas pelos sinais disponíveis. Visitas separadas de entradas, vendas e pessoas únicas.
- Aba Anúncios reutiliza a conexão Meta pelo Pixel. Correções de plataforma, moeda e validação dos dados; conexões Google/TikTok e ROAS continuam pendentes.
- QR Code renderizado no modal e grupos/canais buscados automaticamente, com erro recuperável. Ritmo configurado na campanha de envio.

## 22/09/2026 — Portal de proteção e consumo

- Tela com proteção por grupo, atividade, feedbacks e consumo. Escolha pelo nome, modos, regras e CAS; salvar um grupo preserva o comportamento dos demais.
- Histórico com filtros e total no servidor, evidências e resultados separados. Descartar não desbane; a reversão usa uma ação própria com confirmação. Revisão e correção continuam disponíveis aos administradores após cancelamento do módulo.
- Consumo mostra tarifas aceitas, uso entregue, reservas e tetos. Contratação, aceite da tarifa e alteração de limites ainda não estão na tela; nenhuma cobrança real foi criada.

## 22/09/2026 — Consumo e recuperação da Comunidade IA

- O serviço reserva o teto de gasto antes da análise e registra consumo entregue sem duplicar mensagem/foto em retentativas. O aceite da tarifa ainda não está na tela; nenhuma cobrança foi ativada.
- Recuperação limitada de análises interrompidas preserva os recibos e impede repetir punições ou handlers de ofertas. Resultado pendente ou desconhecido continua exigindo revisão.

## 21/09/2026 — Configuração da Comunidade IA

- Executor unificado: Observar suspende exclusão, banimento e aviso disciplinar; Automático reúne Porteiro, CAS e regras confirmadas pela IA. Recibos, proteção contra repetição e reversão explícita com confirmação.
- Novas configurações começam desligadas e em revisão. O salvamento confere os grupos do bot e impede que uma aba antiga sobrescreva alterações mais recentes.
- A configuração vale por grupo; os grupos que não adotaram a proteção seguem com o comportamento anterior.

## 20/09/2026 — Comunidade IA

- **Situação em 24/10/2026:** a Comunidade está no ar para grupos do Telegram com o módulo Grupos. A análise por IA só roda com tarifa aceita ou com uso interno concedido pelo responsável pelo serviço; sem isso, o Porteiro e o CAS seguem no modo configurado. [Como funciona](/docs/telegram/comunidade-ia/).

- Autoria da mensagem respondida com nome e @ nas duas etapas da IA e identificação da cópia automática do canal vinculado por dados do Telegram. Ofertas oficiais com cupom/link recebem contexto próprio; respostas de membros continuam analisadas separadamente.
- Contexto por usuário com nome, @username, mensagens recentes e registro de Infratores, vinculado pelo ID do Telegram.
- Nova aba para feedbacks, relatos de compra, elogios, reclamações e entusiasmo nos grupos Telegram.
- Moderação contextual com regras por categoria, exclusão e banimento configuráveis, evidência e recibos separados. Reputação opcional por contribuição, com teto diário e revisão.
- Testes com conversas arquivadas: ajustes na leitura da IA, na separação entre foto e print e no contexto usado para reputação. [Como funciona](/docs/telegram/comunidade-ia/).

## 19/09/2026 — Dados do Painel pela Conta do Afiliado

- **Painel do Afiliado no dashboard:** comissão, vendas, cliques, conversão e a série de cliques passam a vir do vínculo entre o bot e o Painel na Conta do Afiliado. Quem já tem os dois vinculados vê os números automaticamente, sem reconectar o Painel. Isso corrige o erro "HTTP 401" que aparecia no lugar dos dados.
- **Sem vínculo:** o cartão do Painel, na aba Plugins, explica como vincular em Organização (só o dono do bot). Se a organização tiver mais de um Painel vinculado, o dashboard avisa em vez de escolher um.
- **Envio de cliques:** a conexão para enviar ao Painel os cliques dos links curtos continua disponível separadamente no cartão.

## 19/09/2026 — Postador e Vitrine no celular e no app

- **Postador:** no celular a tela segue a ordem de uso — compor, ver a prévia do Telegram, conferir os links e só então escolher os canais e postar; o botão de postar ocupa a largura toda. O convite para instalar a extensão do Chrome só aparece em tela de computador e nunca dentro do app.
- **Vitrine:** no celular cada item vira um card com foto, preço, cupom, situação e ações à vista (antes a tabela só mostrava foto e título). No computador, Editar e Excluir ficam numa linha só e preços com milhar (ex.: R$ 2.978,96) saem formatados.

## 19/09/2026 — Acesso e topo no app

- O topo e o menu respeitam o espaço da barra do sistema e do recorte da tela do iPhone.
- Dentro do app, o acesso por e-mail usa um código para digitar no próprio app. Se um link abrir em outro navegador e falhar, a mensagem explica como retomar o acesso.

## 16/09/2026 — Campanhas WhatsApp, redirecionador e canais

- **Redirecionador por campanha:** fila com ocupação e saúde, distribuição por crescimento ou sorteio, IDs de tags e prévia do link. Cliques roteados e leituras de prévias ficam separados; robôs não criam grupos nem disparam tags.
- **Canais:** cartões de seguidores e saldo aproximado em 24 horas/7 dias, com série por dia ou hora. Ausência, coleta atrasada e janela parcial não viram zero ou período completo.
- **Campanhas e pausa:** entrada e encaminhamentos independentes, arquivamento dos dois e restauração com entrada pausada. Assinatura pausada preserva números e evita consultas pagas; formulário intocado acompanha a leitura atualizada.

## 16/09/2026 — Incidentes, alertas e busca

- **Incidentes:** página com abertos/fechados, grupo ou campanha, datas, orientações e última sonda.
- **Alertas:** preferências salvas por tipo e canal, prévia do e-mail real e opção de relatório diário conforme o acesso da conta. Avisos de segurança permanecem ativos.
- **Busca global:** Ctrl+K/⌘K encontra campanhas, grupos, números e incidentes no workspace selecionado, respeitando os módulos liberados.

## Setembro de 2026 — site e guias (preparado, sem publicação)

- **Soluções:** cinco demos com dados fictícios, pausa e movimento reduzido; prévias identificam liberação pendente.
- **Indicadores públicos:** estado indisponível preserva o isolamento dos dados de clientes, sem totais inventados.
- **MCP e apps:** catálogo conferido com o código, guias atuais dos clientes, página de instalação PWA e trilha Comece por aqui. Nenhum link de loja de app sem verificação.

## 16/09/2026 — Anúncios Meta (prévia restrita)

- **Anúncios Meta:** consulta de investimento, orçamento diário/vitalício e status, comparação com meta de CPL e estimativa opcional de imposto sem taxa padrão. Valores ausentes permanecem indisponíveis; moedas e períodos incompatíveis não são somados. Veja os [critérios e limites](/docs/referencia/anuncios-meta/). A tela segue em acesso restrito (conferido em 24/10/2026).

## 16/09/2026 — Paridade com monitoramento de grupos (RealLead)

- **Dashboard de campanhas por hora (publicado depois):** com Hoje/24H/7D em UTC, nove cartões e tabela acessível; métricas sem evidência aparecem como indisponíveis. Atribuição ganha pedidos distintos, comissão estimada sem cancelamentos, filtros de status e Top 5 produtos/Sub IDs. “Não pago” permanece indisponível separadamente porque a origem o entrega como pendente.

- **Saúde dos grupos WhatsApp:** o Bot passa a verificar, a cada 15 minutos, o link de convite de cada grupo que recebe entradas e se o grupo foi suspenso pelo WhatsApp. Convite inválido ou grupo suspenso sai da distribuição sozinho, abre um incidente e avisa o dono por e-mail e pelo bot do Telegram; quando volta, o grupo é reaberto e o aviso de recuperação sai uma vez.
- **Redirecionador de entrada:** a campanha escolhe entre encher um grupo por vez (crescimento) ou distribuir entre os grupos abertos (balanceado); pode carregar Pixel da Meta, Google Analytics 4, Google Tag Manager e Tag do Pinterest na página de entrada, com evento configurável e identificador de deduplicação; e define título, descrição e imagem da prévia no WhatsApp. A busca da prévia pelo WhatsApp ou Facebook não conta como clique e é contada à parte.
- **CPC Meta e CPL Real:** com o Pixel do Afiliado vinculado à mesma organização e os IDs de anúncio cadastrados na campanha, a atribuição por campanha mostra investimento, custo por clique da Meta (gasto ÷ cliques), CPL Real (gasto ÷ saldo positivo de entradas menos saídas, sem comprovar retenção individual), taxa de entrada e taxa de evasão. Sem gasto conhecido, os campos ficam em branco — nunca zero.
- **Webhooks de saída:** cadastre até 5 URLs HTTPS em Configurações e receba um POST assinado (HMAC-SHA256) quando um lead entra ou sai, um convite quebra, um grupo é suspenso ou recuperado, um número cai ou volta, uma campanha fica sem grupo aberto ou um envio falha. Reentrega com espera crescente por até 5 tentativas; 20 falhas seguidas pausam o webhook e avisam o dono. Faz parte do módulo Conexão IA e API.
- **MCP:** seis ferramentas novas para o assistente de IA — listar campanhas, detalhe da campanha, métricas por dia ou por hora, grupos de WhatsApp, histórico de atividade e estatísticas do histórico. Só leitura; o convite completo do grupo exige permissão de escrita.
- **Relatório diário por e-mail:** opcional por organização, sai às 6h (Brasília) com cliques, entradas, saídas, pedidos e comissões do dia anterior por campanha, top grupos e produtos. Dia sem movimento não gera e-mail.
- **Canais de WhatsApp:** número de seguidores coletado de hora em hora, com série por dia ou por hora e novos seguidores no período.

## 16/09/2026 — Campanhas e WhatsApp

- **Campanhas independentes no WhatsApp:** aba própria com entrada nos grupos, fontes, filtros de conteúdo e encaminhamentos por campanha. Links e grupos de entrada são separados dos destinos de conteúdo; é possível operar somente captação ou somente repasse. Pausas independentes e arquivamento preservam o histórico.

- **Campanhas de repasse WhatsApp:** múltiplas fontes e destinos por campanha, regras e substituições próprias, pausa, período, intervalo e histórico por campanha. Fontes existentes são preservadas até a primeira associação; envios antigos concluídos continuam como legado.
- **Links e acompanhamento:** endereço personalizado para campanhas de captação, visualizações de canais separadas dos recibos e sondagem das exclusões no Telegram para revogar os espelhos recentes.

- **Tráfego e campanhas:** abas para visão geral, campanhas, grupos, atribuição e configurações; gráficos diários, edição de campanha, filtros, reativação de arquivadas e acompanhamento da sincronização de vendas. Referências de anúncios não representam uma integração de gastos.
- **WhatsApp:** navegação por tarefas, busca de números e destinos, filtros de envios e gráficos ampliados. Replicação permite destinos por fonte, pausa, período opcional e mídia combinada com palavra-chave. O link de captação permite selecionar grupos existentes por campanha.

- **Portal:** corrige os ícones da aba do navegador.
- **Blog:** restaura as ilustrações dos artigos de integração e programas de afiliados.

- **Imagens dos cards:** validação da origem e dos redirects antes do download, com limites de tamanho e tempo. Imagens de fontes externas precisam passar pelo upload de mídia própria.

- **Redução de números WhatsApp:** reduzir a quantidade pausa os excedentes e preserva as sessões. Dono e administrador escolhem quais manter ativos sem mudar a cobrança; a fila respeita a seleção atual, inclusive para envios já agendados.

- **Interações no NerdCupons:** revelar um cupom não conta como uso. Uso, feedback e estrelas só confirmam após gravação; repetições reutilizam a mesma confirmação, e falhas permitem tentar novamente sem duplicar métricas.

- **Destino do clique WhatsApp:** o link de entrada preserva o grupo escolhido; a conciliação exige esse destino e mantém a entrada apenas provável. Pré-visualizações identificáveis não entram na contagem de cliques.

- **Atribuição de campanhas:** destinos compartilhados deixam de escolher uma campanha para os links das ofertas. Entradas por horário são sempre prováveis e exigem destino e organização compatíveis; convites identificados pelo Telegram continuam exatos. Veja os [critérios e limites](/docs/referencia/atribuicao-campanhas/).

- **Acesso a módulos pagos:** falhas na verificação deixam de liberar recursos como Broadcast por padrão; recursos gratuitos e isenções confirmadas são preservados.

- **WhatsApp por número:** escolha de 1 a 20 números, total mensal calculado por quantidade, capacidade visível na tela e recusa de conexões acima do contratado. Alterações preservam os outros módulos; a perda da assinatura bloqueia novos envios e os que ainda aguardam na fila.

- **Criação de grupos WhatsApp:** falha buscando o convite preserva o grupo criado; uma resposta incerta pausa novas criações até confirmação, evitando grupos duplicados. O link de cada campanha usa seus próprios grupos automáticos e os grupos manuais.

- **Módulo WhatsApp: canais e grupos que crescem sozinhos.** A sincronização passa a trazer os **canais** do número (selo *canal* em Grupos); canal marcado como destino recebe os posts como um grupo e fica fora do link de entrada. Campanha com destino WhatsApp ganha **criar o próximo grupo sozinho**: quando todos os grupos destino lotam, nasce "Nome base N" com a foto escolhida, já como destino, e o link da campanha continua o mesmo; um teto de grupos opcional (1–200) responde "grupos lotados" ao ser atingido. Documentação nova em [WhatsApp](/docs/whatsapp/comecando/).

## 2026-09

- **Alertas de canal (publicado depois):** links gerados pelo painel, extensão, API e comandos passam a ser reconhecidos também quando vêm do cache. Alertas antigos saem da lista quando o mesmo bot reconhece o link; links de outros bots continuam separados.

- **18/09 — Prévia da foto na extensão:** a imagem aparece inteira, na proporção original e sem margens brancas artificiais. Publicada na 1.0.24.

- **17/09 — Extensão 1.0.24:** troca da foto do produto pelo ícone de upload sobre a imagem. A foto escolhida acompanha prévia, histórico, canal e vitrine; disponível na conexão com o painel. Publicada na Chrome Web Store e no site em 29/09.

- **17/09 — Cupons Mercado Livre na operação Nerd Ofertas:** alternância entre contas com histórico separado, limite compartilhado e pausa ao receber recusa de acesso. Rejeição numa conta não retira cupons das demais; publicações continuam deduplicadas.

- **17/09 — Amazon:** links de produto que já pertencem ao afiliado deixam de ser recusados quando o SiteStripe ou o cache reutiliza o mesmo endereço. A aceitação exige comprovação da tag configurada para a conta ou usuário da conversão.

- **11/09 — Extensão 1.0.23:** parcelamento sem juros da Amazon confirmado pela tabela é preservado mesmo com divergência na soma das parcelas. O cartão ou meio exigido acompanha a oferta. Publicada junto da 1.0.24, em 29/09.

- **11/09 — Extensão 1.0.22:** Mercado Livre conserva o parcelamento explicitamente sem juros ao capturar preço com cupom e recalcula as parcelas pelo valor descontado. Preços exclusivos do Pix permanecem sem parcelas. Publicada junto da 1.0.24, em 29/09.

- **Cupons por site (publicado em 10/09/2026):** URLs de lojas preservadas ao renomear, logos personalizados nos consumidores, filtros por site na API/MCP e atualização de esgotamento sem apagar os demais dados. Ingestões antigas continuam compatíveis. Migração com preservação dos IDs e arquivamento revisado dos conflitos históricos.

- **Cupons por site (publicado depois):** lojas e marketplaces com domínio e logo editáveis, cadastro automático pelos plugins e escolha manual ou identificação pelo link ao salvar cupons. Cupons antigos preservados.

- **Preparado para a próxima atualização — Imagem dos cupons Mercado Livre:** reaproveitamento da arte no Telegram entre reinícios, evitando uploads repetidos e mantendo o formato das mensagens.

- **09/09 — Total de cupons Meli:** rodapé confere o total a cada 30 minutos e soma cada novidade publicada uma vez, sem consulta adicional antes da postagem.

- **Velocidade dos cupons Mercado Livre (no ar desde 09/09/2026):** sincronização passa a gravar somente dados alterados, mantendo a conferência dos cupons e a publicação de novidades.

- **Extensão 1.0.21 (publicado depois):** Amazon compara as modalidades visíveis do produto e captura o menor preço, incluindo Programe e Poupe. Quando a assinatura vence, sua condição acompanha cada produto na oferta, histórico e listas. Pasta descompactada fixa e ZIP versionado atualizados (o ZIP dessa versão saiu do site; o [download padrão](/extensao/botdoafiliado-postador.zip) traz sempre a versão mais nova).

- **Extensão 1.0.20 (publicado depois):** validação das parcelas contra o preço final em todas as lojas, incluindo Pix, cupom, edição manual e histórico; “sem juros” só com indicação explícita e parcelamento recolhido por padrão. ZIP versionado na época (já fora do site); o [download padrão](/extensao/botdoafiliado-postador.zip) traz sempre a versão mais nova.

- **Cupons Mercado Livre (no ar desde 09/09/2026):** desconto fixo deixa de repetir um limite de mesmo valor na mensagem do canal; limites percentuais e valores diferentes são preservados.

- **Extensão 1.0.19 (publicado depois):** revisão de preços e parcelas nas sete lojas; reconhecimento de “s/ juros” e da ordem das parcelas do AliExpress, correção da coluna de compra do Magalu e do “De” do Terabyte. Parcelas de outro vendedor no Mercado Livre são ignoradas; cupom com compra mínima não trava o preço da Nutella.

- **Extensão 1.0.18, Shopee (publicado depois):** preço bruto da API recebe Pix antes do cupom, sem repetir desconto no preço da página. O aviso de desconto exige um preço capturado, e o “Preço de” preenchido é enviado ao post nos dois modos de conexão.

- **Extensão 1.0.17, Amazon (publicado depois):** captura do preço principal à vista com reais e centavos separados; parcelamento preserva a declaração de juros e o total a prazo. Condições ocultas da calculadora não substituem a condição exibida.

- **08/09/2026 — Resgate Mercado Livre na operação Nerd Ofertas:** acompanhamento do horário anunciado na campanha, resgate e conferência na conta antes da publicação. Cupons resgatados antecipadamente aguardam o início da validade.

- **Porteiro de canal (publicado depois):** avisos de bloqueio incluem “Entrar no canal” com link clicável, inclusive em mensagens personalizadas. O envio alternativo sem HTML também mantém a URL.

- **10/09/2026 — Resgates Mercado Livre (preparado, ainda não publicado):** preserva a agenda após reinício ou retirada da página, reconfere respostas inconclusivas e recupera cupons confirmados depois, respeitando a validade e a deduplicação. Timeout de resgate deixa de pausar todos os códigos.

- **Mercado Livre:** links corretos de anúncios sem catálogo deixam de ser recusados por comparação com um produto da seção “Para você”. A leitura usa o destaque e preserva a variação do anúncio, sem trocar a etiqueta quando o destino está correto.
- **Links e ofertas:** correção de encurtadores Kutt/Afilimais, extração atualizada do Magazine Você e fallback de acesso para Magalu/Terabyte. Links da Terabyte deixam de consultar produtos da KaBuM com o mesmo número de anúncio. Erros de `/oferta`, com ou sem cupom, deixam de repetir links antigos e mostram a falha da tentativa atual.
- **08/09/2026 — Cupons Mercado Livre:** cupom sem código deixa de ser cadastrado e publicado quando não é possível gerar o link da campanha. O link genérico de reserva não garante esse desconto.

- **WhatsApp:** QR code ou código de pareamento, opção de tentar novamente e exibição do nome e telefone da conta conectada quando disponíveis no gateway.
- **Formato das ofertas:** links reais no topo, escolha do produto e prévia acompanhando o rascunho; ajustes avançados recolhidos. O Postador recomenda a extensão oficial para Chrome.
- **Personificação:** retorno à conta original ao terminar a hora, sem perder o aviso durante a renovação e sem encerrar as sessões legítimas do cliente.

- **Configurar plugins:** os formulários recuperam os ajustes salvos ao reabrir. Magalu exibe o promoterId, inclusive de configurações antigas; trocar de bot abre os dados desse bot.

- **Segurança:** proteção do editor HTML e do portal antigo, isolamento de mídia privada e notificações, tratamento de cookies inválidos e atualização de dependências.

- **Vitrines Magalu:** links da página inicial da loja passam pelo identificador configurado no bot e pelo encurtador. Corrigido o reaproveitamento de resultados antigos de “sem rota” no Magazine Você.

- **Magalu:** retirada a loja padrão dos cadastros. “Ler tags” detecta o identificador quando o link o informa e pede preenchimento quando ele traz só o promoter ID. Vitrines com a configuração padrão incorreta deixam de ser convertidas; o cache antigo é ignorado.
- **Credenciais de afiliado:** Amazon, Natura, Braé, Beleza na Web, Pague Menos e Terabyte exigem os dados da sua própria conta. Removidos valores e exemplos de contas do operador; campos vazios geram orientação de configuração.

- **Login e troca de conta:** o painel passa a concluir o acesso com a conta escolhida na Central. Corrigidos o reaproveitamento da sessão anterior, o retorno ao login por organização antiga e a restauração de cache de outra conta.

- **Cupons por site:** URLs de lojas preservadas ao renomear, logos personalizados nos consumidores, filtros por site na API/MCP e atualização de esgotamento sem apagar os demais dados. Ingestões antigas continuam compatíveis. Migração com preservação dos IDs e arquivamento revisado dos conflitos históricos.

- **Histórico real na Central:** conversões recebidas no Bot, última importação e estado da sincronização automática aparecem mesmo sem recibo recente. A teia distingue conta vinculada de dados importados.

- **Porteiro de canal (publicado depois):** avisos de bloqueio incluem “Entrar no canal” com link clicável, inclusive em mensagens personalizadas. O envio alternativo sem HTML também mantém a URL.

- **Mercado Livre:** links corretos de anúncios sem catálogo deixam de ser recusados por comparação com um produto da seção “Para você”. A leitura usa o destaque e preserva a variação do anúncio, sem trocar a etiqueta quando o destino está correto.
- **Links e ofertas:** correção de encurtadores Kutt/Afilimais, extração atualizada do Magazine Você e fallback de acesso para Magalu/Terabyte. Links da Terabyte deixam de consultar produtos da KaBuM com o mesmo número de anúncio. Erros de `/oferta`, com ou sem cupom, deixam de repetir links antigos e mostram a falha da tentativa atual.
- **Compartilhamento na Central.** Confirmação da última importação de conversões do Painel para o Bot, com contas, horário, quantidade e erros. Veja [contas e compartilhamento](/docs/integracoes/central-do-afiliado/).

- **Conversão (publicado depois):** Natura aceita links de produto e vitrine de `minhaloja.natura.com`, usando a consultoria configurada. O resumo de falhas oferece **ver ocorrências** para abrir os domínios não mapeados. Erros internos do Mercado Livre passam a informar o detalhe disponível, com tokens removidos.
- **Extensão (publicado depois):** preço no Pix do Mercado Livre deixa de receber parcelas referentes ao preço cheio. Parcelamento começa recolhido ao capturar ou carregar produtos.

- **Vitrine: itens que expiram sozinhos e cupom esgotado fora do card.** Cada item aceita uma data de expiração (com atalhos +1/+3/+7 dias) e a página ganha uma **expiração padrão em dias** aplicada a todo item novo — painel, extensão, API (`expires_at`) ou Puxador. Item vencido some da página pública e fica no painel marcado **expirado**, com **Renovar**. O cupom do item é cruzado com a aba Cupons: esgotado, vencido ou inativo deixa de aparecer no card (o produto continua) e o painel avisa.
- **Moedas do AliExpress: falha na conversão deixa de aparecer como sucesso.** Sem plugin AliExpress configurado ou com a conversão do link falhando, o `/moedas` informa o motivo em vez de devolver a página de moedas sem afiliado.

- **Extensão 1.0.16 disponível para instalação manual.** O [ZIP da extensão](/extensao/botdoafiliado-postador.zip) inclui a captura do preço anterior e do parcelamento da página aberta, recursos que exigem essa versão. A atualização da Chrome Web Store ainda está pendente. Veja [como instalar o ZIP](/docs/comecando/extensao-chrome/).

- **Linha do cupom editável para código e link.** Em **Promoções → Customizar**, ajuste os dois casos e use `{linhadocupom}` para escolher automaticamente o trecho, sem rótulo vazio quando não há cupom. A amostra aceita a URL informada; posts e listas respeitam a posição da variável e os formatos antigos são preservados. Falha ao converter o link de resgate passa a interromper a geração com erro.
- **Preço completo com parcelas no formato do post.** `{linhadopreco}` escolhe os quatro casos com/sem preço anterior e parcelamento. Os formatos existentes são preservados. Postador e extensão permitem informar parcelas; a API aceita os mesmos dados por produto. A extensão 1.0.16 captura os campos na página aberta, quando disponíveis.
- **Userbot: fila recuperável e publicação confirmada.** Falhas ficam visíveis, ofertas antigas podem ser carregadas e o destino aparece na aprovação. Captura com fila persistente, álbuns e proteção contra repetições; envio incerto aguarda conferência no destino.

- **Preço anterior riscado na própria tela Customizar.** O grupo **Linha do preço** reúne **Só preço atual**, **De … por** e o trecho avançado. A amostra permite ajustar os preços e conferir os dois cenários; o teste com links reais usa o formato salvo e aguarda o salvamento das alterações. Os formatos padrão e presets usam a linha completa, preservando os formatos que você já salvou. No Postador, os campos passam a se chamar **Preço de venda** e **Preço anterior (riscado)**.
- **Formatação das linhas de preço e das listas de produtos.** Negrito e riscado dos trechos personalizados são preservados na oferta, sem exibir as tags HTML como texto.
- **Primeiro acesso ao painel.** A entrada aguarda carregar o workspace e seus bots antes de abrir a configuração inicial. Quem já tem um bot não precisa cadastrar outro quando entra em um navegador novo.

- **Interações do NerdCupons (publicado depois).** Uso, feedback e estrelas ganham confirmação idempotente e limites persistentes. Revelar continua disponível se o registro falhar; o site passa a avisar quando não conseguiu gravar. O histórico é preservado sem tratá-lo como pessoas verificadas. A ativação depende da publicação coordenada dos dois serviços.

- **Proteção das imagens de promo (publicado depois).** Downloads de fotos e fundos passam a aceitar apenas CDNs de marketplaces suportados e mídia própria, com limites de tamanho e tempo. Fotos externas podem ser enviadas pelo painel.

- **Postador: envio acompanha a oferta atual.** Editar links, preços, cupom ou outras opções bloqueia copiar e postar até a nova prévia terminar. Respostas atrasadas e erros não liberam a oferta anterior. O botão Limpar também apaga o preço "De".
- **Mercado Livre: link com destino errado deixa de aparecer como sucesso.** Se a verificação reprovar o destino e as etiquetas reserva não resolverem, o bot informa a falha. Conversões antigas que podiam guardar esse link no cache central deixam de ser reutilizadas.

## 2026-08

- **Correção de segurança nas prévias de HTML.** As telas de mensagens, promoções e broadcast agora sanitizam todo HTML antes de renderizar: preservam a formatação compatível com o Telegram e removem scripts, atributos executáveis e links inseguros.
- **Puxador corrige com IA e aprende por canal, sempre com a sua confirmação.** Descreva o que saiu errado e a IA compara a origem com o resultado automático para preencher um rascunho, sem alterar links; você revisa e edita antes de salvar. Para texto, formatação, preço ou cupom, o sistema ainda calcula uma troca literal determinística, testa nas 10 conversões mais recentes daquele canal e mostra o impacto antes de aplicar. A IA não aplica regras nem cria regex sozinha. Problemas de link, mídia ou outros tipos ficam registrados para diagnóstico, sem mudar as regras: o afiliado continua sendo escolhido globalmente em **Rotas** e **Plugins**. A versão **Canal** e a versão **API** também são corrigidas separadamente, sem uma sobrescrever a outra.
- **Puxar novamente as mensagens recentes de um canal.** Administradores do bot agora podem usar `/puxar @canal 5` (ou o ID numérico) para buscar posts que saíram antes da captura ao vivo. O canal precisa estar ativo no Puxador; as mensagens passam pela mesma conversão, deduplicação e fila de aprovação das ofertas novas. O padrão é 2 mensagens e o máximo é 100.
- **Puxador com nova fila de aprovação.** A primeira visita agora abre direto em **Aprovação**, e a tela organiza as ofertas numa grade responsiva que não muda de lugar enquanto você decide: novidades esperam no botão **Mostrar N novas ofertas**, e decisões feitas no Telegram ou por outra pessoa deixam um marcador no card até a próxima atualização. Também chegaram filtro por vários canais, agrupamento das versões do mesmo produto, prévia fiel do Telegram com imagem ampliável, seletores independentes **Canal/API** para texto e foto e um editor com prévia lado a lado. Se uma oferta já publicada for editada no canal de origem, você escolhe entre **Atualizar o post** e **Manter como está**.
- **Puxador com perfil completo por canal.** Em vez de tentar reproduzir formatos complexos com dezenas de trocas manuais, cada origem pode selecionar um dos nove perfis portados da operação antiga: Economizando com JP, Economizanderson, Ofertas Benevides, Links BR, Promo China Ofertas, Setup Humilde, Samuel Felipe, Promo Bugs ou Promotom. O perfil trata somente o texto; a conversão afiliada continua usando as **Rotas e Plugins** globais do bot conforme o domínio. Durante **Gerando links**, também dá para pré-aprovar (publica só quando terminar) ou descartar.
- **Cobrança mais segura na ativação de módulos.** Antes de liberar um módulo pago, o Bot do Afiliado agora confere a assinatura diretamente no Stripe e só então aplica o acesso.
- **Status do Userbot corrigido para piloto controlado.** A interface e o fluxo estão prontos, mas a infraestrutura que mantém as contas conectadas ainda passa pela validação final. Por isso, o módulo não está disponível no checkout público; a documentação agora deixa isso explícito e trata R$ 149,90/mês como preço previsto para a abertura.
- **Correção: o popup de conta não prende mais o botão Salvar fora da tela.** Em janelas baixas e navegadores/WebViews sem suporte à viewport dinâmica, o editor de Plugins agora fica limitado à área visível e pode ser rolado até as ações.
- **Correção: links da Awin e da CityAds não perdem mais parâmetros da loja.** O link de afiliado agora mantém o que vier na URL original, inclusive parâmetros que ativam cupom, como `?coupon=SEUCUPOM`.
- **Links do `ofertou.ai` agora alimentam o Público do Painel do Afiliado.** Com a conta conectada, cada acesso ao link curto envia de forma agregada a hora, o site de origem, a região aproximada, o dispositivo e qual link recebeu o clique. O Painel não recebe IP nem identificação da pessoa. A cobertura vale para os links que passam pelo encurtador próprio; links nativos das lojas continuam dependendo dos dados que cada marketplace fornece.
- **Correção: título limpo da Amazon na extensão.** A captura agora usa o nome do produto exibido na página, sem carregar junto o sufixo do título da aba, como `: Amazon.com.br: Beleza`.
- **Painel mais consistente e confortável no celular.** Botões, campos, seletores, checkboxes e links de ajuda agora seguem a mesma escala visual e ganham áreas de toque maiores no celular. A tela de login e a confirmação em duas etapas usam o mesmo layout, com mensagens de erro e carregamento no lugar certo. A barra superior mostra a tela atual também em telas pequenas, a busca rápida (`Ctrl+K`/`⌘K`) separa os resultados por categoria e ações como excluir, revogar ou desconectar aparecem com o padrão visual de atenção.
- **Reforço de segurança no painel, na API e nas conexões de IA.** O portal não persiste mais tokens de sessão no armazenamento da aba; a renovação fica no cookie protegido do navegador. Conexões MCP por login agora só veem e executam as ferramentas cobertas pelas permissões aceitas na autorização. Também passamos a rejeitar links de cupom que não sejam `http`/`https`, bloquear seleção inválida de workspace em vez de trocar silenciosamente de workspace e exigir autenticação no endpoint técnico de consulta do AliExpress. Cabeçalhos CSP/HSTS foram ativados no portal e nos sites.
- **AliExpress: o link gerado passa a marcar a origem no destino.** Todo link de afiliado do AliExpress agora aterrissa na página do produto com o parâmetro `from=botdoafiliado` na URL — identifica que o clique veio de um link montado pelo bot, no mesmo espírito da etiqueta de atribuição do Mercado Livre. Não muda preço, comissão nem o destino do link; e se a URL já traz um `from` próprio (páginas de moedas e de campanha usam esse parâmetro), o valor original é **preservado**.
- **Entrar com código de 6 dígitos, sem depender do link do email.** Na tela de login, abaixo do "Enviar link", agora tem **Receber código por email**: chega um código de 6 dígitos, você digita ali mesmo e entra. Existe porque o link do email abre no **navegador padrão do aparelho** — que muitas vezes não é onde você pediu o acesso (você pede no computador e abre o email no celular, ou o app do email abre num navegador interno) e aí o login simplesmente "não acontece". O código vale **10 minutos**, é de **uso único** e aceita no máximo **3 tentativas** antes de precisar pedir outro. As formas de entrar de sempre continuam: link por email, Google e passkey.
- **Módulo novo: Userbot — a curadoria dos canais chega pronta, com os seus links.** Conecte a **sua conta do Telegram** pelo painel e escolha os **canais de promoções** que você já acompanha. Quando sai uma oferta, o bot troca **todos os links** pelos seus de afiliado, monta a mensagem **no seu formato** e te entrega para **aprovar** — no grupo de aprovação do Telegram (um tópico por canal de origem) ou na aba **Userbot** do painel, ao vivo. Nada vai ao ar sem o seu OK, e **oferta repetida** nas últimas 2 horas já chega barrada. Dá para separar o destino por **palavra-chave** ou por **quantidade de links**, e limpar o texto de cada canal com regras de substituição. Você também pode pedir para o bot **montar o post do zero**: o **título** vem da API do produto, a mensagem sai nos **seus templates** e a foto pode ser a **sua arte de promo** em vez da imagem da loja — enquanto **preço e cupom continuam vindos do canal**, que é quem sabe o valor real da promo. Ligando **Publicar na Vitrine ao aprovar**, cada oferta aprovada entra sozinha no seu site. **R$ 149,90/mês.** Detalhes em [Userbot](/docs/telegram/userbot/). *Atenção: quem entra nos canais é a sua conta pessoal — automação em conta de usuário pode levar o Telegram a limitá-la, e esse risco é seu.*
- **Correção: no Magalu, a extensão usa o que está na página — inclusive a foto.** O Magalu responde **403 a qualquer leitura de servidor** desde 07/08, então quem lê o produto lá é a extensão, direto da página aberta no seu navegador. Título, preço e "de" já vinham dela, mas a **imagem** ainda era a que a API devolvia — e no Magalu isso só pode ser cache antigo, então dava para o post (e a arte) sair com a **foto de outro produto**. Agora, quando a extensão lê a página do Magalu, o dado dela vence a API em tudo. Nas outras lojas nada muda: a imagem da API continua vindo primeiro, porque lá ela costuma ser melhor que a do DOM.
- **Extensão: post de lista direto das capturas.** Marque duas ou mais capturas em **Últimas capturas** e clique em **Copiar N como lista** — sai **um post só**, montado com os seus formatos **Base da Lista** e **Item da lista** (aba Customizar), levando o preço e o título de cada captura. Com um item marcado a barra some, porque aí o post é o de 1 produto (o botão **Texto** da linha). Post leva um cupom só, como no Postador: se os selecionados tiverem **códigos diferentes**, a lista sai sem cupom e o aviso aparece na hora.
- **Extensão: "Últimas capturas" agora copia no seu formato.** O botão **Texto** de uma captura antiga montava a mensagem num layout fixo da extensão — nada a ver com o formato configurado na aba **Customizar** que o botão da oferta atual usa. Agora ele passa pelo mesmo motor do bot (template certo de oferta/cupom, linha de preço "de → por", gatilho) e vai para a área de transferência **já formatado** para colar no Telegram. O botão **Link** também mudou: quando aquela captura ficou sem link de afiliado (a conversão falhou na hora), ele copiava o **link cru da loja** — uma venda sem a sua tag, sem aviso nenhum. Agora ele converte na hora, guarda o link na captura e só avisa se realmente não der.
- **API key agora tem nível de permissão.** Ao criar a chave no painel (aba **API e IA MCP**) você escolhe entre **Leitura** (frete, histórico de preço, cupom, template e vitrine já cadastrados), **Padrão** (leitura + tudo que gera link: `/convert`, `/convert-links`, `/product`, `/execute`, `/chat`, busca de produto, promo e vitrine) e **Total** (tudo, incluindo importar/apagar cupom, editar template e configurar o userbot). Chamada acima do nível responde **403 `insufficient_scope`** — vale também para as ferramentas de IA via MCP, que passam pelos mesmos endpoints. Assim a chave que você cola num site ou entrega para uma ferramenta de terceiro não precisa mais poder mexer no catálogo inteiro. **Chaves criadas antes continuam em Total**, sem mudança de comportamento — e dá para rebaixar qualquer uma na hora: a coluna **Nível** da lista é um seletor, e trocar não rotaciona o segredo (a integração segue funcionando com a mesma chave). Detalhes em [Autenticação na API](/docs/api/autenticacao/).
- **MCP por login (OAuth) passa a respeitar o papel do membro.** Quem conecta a IA pelo login em vez de colar chave recebia acesso total ao bot, mesmo sendo **member** do workspace — dava para configurar o userbot e apagar cupom pelo conector, coisas que o mesmo usuário não faz no painel. Agora o nível do conector segue o papel: **owner/admin → Total**, **member → Padrão** (opera, não configura).

## 2026-07

- **`/moedas`: responder um link já funciona + mensagens do comando reescritas.** Agora dá para **responder** qualquer mensagem que tenha o link do produto digitando só `/moedas` — jeito natural de pedir as moedas do link que alguém acabou de mandar no grupo (antes o link tinha que vir junto do comando). As duas mensagens do comando também melhoraram: a de **como usar** era só *"Use: /moedas URL-do-produto-ali"* e agora explica que o comando gera o link que abre o produto **no app com o desconto de moedas aplicado**, mostra um exemplo pronto para copiar e avisa que **link curto** (`s.click.aliexpress.com`, `a.aliexpress.com`) e link de página de moedas também servem; a de **erro** era *"Link inválido para moedas."* e agora diz o que faltou — precisa ser link de **produto** do AliExpress, não de busca, de loja ou de outro site. Quem tinha os textos padrão recebe os novos automaticamente; se você personalizou em **Mensagens**, a sua versão é preservada.
- **Correção: produto "espremido" na foto saía sem a arte de fundo branco.** Quando a foto do produto era **bem justa** — o item ocupando quase todo o quadro, com poucos pixels de margem (típico de portas, escadas, tapetes e outros itens altos e estreitos) — o bot não reconhecia o fundo do catálogo e mandava a **foto crua**, sem a montagem no quadro branco. Agora ele também analisa a **moldura fina** da imagem, que enxerga o fundo mesmo nesses casos. Fotos de ambiente (lifestyle) continuam saindo como estão, sem moldura.
- **Correção: comando personalizado "cupom"/"oferta" não sequestra mais o Postador e a extensão.** Se você criasse um comando personalizado chamado `cupom` (ou `oferta`), o **Postador** e a **extensão** passavam a responder com o **texto do comando** em vez de montar o post (o post saía só com a mensagem do comando, e editar o título dava erro). Os montadores internos agora ignoram comandos personalizados — o seu `/cupom` custom continua valendo normalmente **no Telegram**, sem interferir na montagem de ofertas.
- **Templates de oferta: linhas de preço e cupom totalmente customizáveis.** Três variáveis novas nos formatos de oferta/cupom (aba Customizar): **`{linhadopreco}`** — a linha do preço pronta, com template próprio para **com** e **sem** preço "De" (`format.oferta.linha_preco` / `format.oferta.linha_preco_de`, ex.: `✅ De ~R$ 4.599~ por **R$ 3.899**`); **`{linhadocupom}`** — a linha do cupom pronta, com texto próprio para cupom de **código** (`format.cupom.codigo`) e por **link** (`format.cupom.link`); e **`{precode}`** — o preço "De" cru. Cada linha se adapta sozinha: sem preço ou sem cupom, ela some do post. Vale para `/oferta`, `/cupom`, Postador e extensão. Veja exemplos em [Mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/).
- **Correção: rodapé do conversor saía colado na linha do link.** Quando uma **Regra** de limpeza da aba Customizar removia um trecho do fim do post (ex.: apagar o "-Anúncio" da origem), as quebras de linha em volta iam junto — e o rodapé aparecia **grudado** no link (`…ofertou.ai/xxx🚀 Mais grupos…`). Agora o rodapé é anexado **depois** da formatação, sempre num parágrafo próprio, em todos os caminhos (conversão automática, `/converter` e conversor via IA/chat).
- **Dashboard: detalhes no hover + duas linhas de cliques (links curtos e redes).** Passe o mouse sobre as barras do gráfico **Conversões (30 dias)** para ver o detalhe de cada dia: links convertidos, falhas, usos de cupom e posts de oferta. E o gráfico ganhou **duas linhas de cliques por dia**, separadas de propósito porque medem coisas diferentes: a **verde** conta os cliques nos **links curtos do próprio bot** (`ofertou.ai`) — não depende de integração nenhuma, mas cobre só o que o bot encurta (**Amazon, Shopee, AliExpress e Mercado Livre não passam pelo encurtador**, então não entram nessa linha); a **âmbar** conta os cliques que as **próprias redes de afiliado** registraram, lidos do **Painel do Afiliado** (aparece quando você conecta a conta). Cada linha some sozinha quando não há dado. A linha verde vale para links **criados a partir de agora**; links antigos passam a contar assim que forem reutilizados numa nova conversão.
- **Visual novo no painel e na vitrine (modo claro).** O **modo claro** do painel e da **vitrine pública** ganhou o design system do Nerd Ofertas: tipografia **Inter**, grafite no lugar do preto puro e superfícies mais suaves. O **modo escuro** continua com as tonalidades de sempre. Alterne em **Claro / Escuro / Auto** no rodapé do menu lateral.
- **Comandos enxutos: `/coringa`, `/encurtar`, `/grade` e `/post` saíram do bot.** Os quatro foram removidos do Telegram e do menu de comandos (`/grade` e `/post` já não funcionavam; `/coringa` e `/encurtar` tinham pouco uso — a conversão automática e o `/soencurtar` cobrem os casos). Dica: com a prioridade dos comandos personalizados, esses nomes ficaram **livres** — você pode criar o seu próprio `/encurtar` ou `/coringa` na tela **Comandos**. Para o menu refletir a mudança, clique em **Aplicar menu** na mesma tela.
- **Comandos personalizados: prioridade sobre os padrões + botões de link.** Duas melhorias na tela **Comandos**: (1) um comando personalizado com o **mesmo nome de um comando padrão** (ex.: `/cupom`) agora **vence** — o bot responde com a **sua** resposta, não com o menu convencional (exceto `/start` e comandos administrativos, que continuam protegidos); (2) a resposta pode ter **botões de link** (até 6, um por linha) — cada botão abre a URL que você definir, ótimo para "Ver ofertas", "Entrar no grupo", "Abrir site". Configuráveis junto do texto e da foto do comando.
- **Mercado Livre: link gerado agora é verificado (e re-gerado com etiqueta reserva se não cair no produto).** A API de links do Mercado Livre às vezes gera um `meli.la` que **não aponta para o produto** — cai na página do seu perfil de afiliado (ex.: a lista de "listas"), o comprador não vê o produto e a prévia da oferta podia sair de **outro item**. Agora o bot **confere o destino de todo link gerado** de produto: se não bater, **re-gera automaticamente** com as suas **etiquetas reserva** (campo novo nas credenciais do plugin, separadas por vírgula — a comissão é da mesma conta) e **só guarda no cache link verificado** (antes, um link ruim ficava congelado por até 30 dias). Configure em **Plugins → Mercado Livre → Etiquetas reserva**.
- **Cupons: lista ordenada pelo maior desconto + visual padronizado.** A lista do `/cupom` agora vem **ordenada do maior para o menor desconto** (18% OFF antes de 10% OFF; R$ 60 OFF antes de R$ 20 OFF) — cupom sem desconto estruturado vai para o fim. E o emoji dos itens foi **padronizado em 🏷** (antes o cabeçalho usava 🏷 e cada cupom usava 🎟). Se você personalizou o template `coupon.list.item`, nada muda; quem usa o padrão recebe o novo visual automaticamente.
- **API: buscar cupons dos plugins sob demanda.** Novo endpoint **`POST /api/v1/coupons/ingest-plugins`** (autenticado pela sua chave de API) dispara a mesma busca de cupons do botão "Buscar cupons" do painel e do cron — incluindo a desativação dos cupons que saíram do feed oficial. Aceita `{"sites":["mercadolivre"]}` para limitar a um site; máximo de 1 chamada por minuto. Útil para automações e para forçar uma atualização imediata via terminal.
- **Reputação: ranking e Top da semana agora premiam interação, não só votos.** O **ranking** (`/reputacao top`, aba Reputação) e o **Top da semana** postado nos grupos passam a ordenar pelo **conjunto: interação (XP) + reputação** — quem participa todo dia sobe no ranking mesmo sem receber muitos votos, e os votos dos colegas continuam somando por cima. As linhas do Top também ficaram mais completas: mostram o **nível**, o **XP** e os **pontos de reputação** de cada membro (antes só os pontos).
- **Rodada de segurança: papéis, domínios próprios e credenciais.** Auditoria completa do backend com correções em oito pontos. Os principais para você: **domínio próprio** (página de chat e página da live) agora só pode ser reivindicado por quem realmente o cadastrou — nenhum outro bot consegue tomar um domínio já em uso, nem derrubar o certificado de outro ao remover o seu; **faturamento** (assinar plano e abrir o portal de cobrança) e **criar bot** ficaram restritos ao **dono** e a **admin**, como já valia no menu; **credenciais de plugin** deixaram de ser visíveis para o papel **Membro** (e o campo `remoteAuth` do CityAds passou a sair mascarado como os demais segredos). Nos bastidores, endereços configuráveis das APIs da **Amazon** agora só aceitam domínios da própria Amazon, tokens de conexões de **IA (MCP)** passaram a ter a validade verificada a cada uso, e o webhook do Telegram só aceita chamadas assinadas. Nada muda no seu dia a dia — é blindagem.
- **Correção: link `meli.la` de perfil social gerava o produto errado.** Ao converter um link `meli.la` que abre o **perfil social de outro afiliado** com um produto em destaque, o bot podia gerar o link de um produto **do carrossel "Quem viu também comprou"** em vez do produto destacado (ex.: destaque era um Ryzen 5 5500 e saía um Ryzen 5 2600). Acontecia quando o destaque era um anúncio direto de vendedor (endereço `/up/…`), sem página de catálogo — o leitor pulava o destaque e pegava a primeira recomendação, que muda a cada acesso. Agora o leitor **ancora no produto em destaque** e entende também anúncios diretos; os links errados que ficaram em cache foram descartados. Quando um cupom do ML **esgota antes da data de validade** (comum nos códigos de maior apelo, como `VALEPRAMODA`), ele sumia da página oficial mas **continuava ativo no bot** até a data original — mostrando cupom morto no grupo, na vitrine e no `/cupom`. Agora cada busca de cupons (automática, 4× ao dia, ou pelo botão **Buscar cupons**) também **desativa os cupons que saíram da lista oficial**. Se o código voltar, ele reativa sozinho. Cupons cadastrados manualmente não são tocados.
- **Reputação: o Histórico agora tem paginação.** A tabela de votos e ajustes da aba **Reputação** mostrava só os 50 eventos mais recentes, sem como ver os anteriores. Agora ela pagina igual ao Ranking — dá para navegar por todo o histórico de auditoria (quem votou em quem, quando e por qual origem).
- **Conexões de IA: acesso antigo é encerrado a cada renovação.** As conexões de IA (Claude, ChatGPT, Cursor…) se renovam sozinhas de tempos em tempos. Até agora, a credencial **anterior** continuava valendo em paralelo por vários dias depois da renovação — se ela tivesse vazado, o acesso indevido sobreviveria. Agora cada renovação **encerra a credencial antiga na hora**. Você não precisa fazer nada: a renovação continua automática e invisível.
- **Tela de autorização de IA: agora mostra para onde o acesso vai.** Ao conectar uma IA ao seu bot (Claude, ChatGPT, Cursor…), a tela de permissão passa a exibir **o endereço que vai receber o acesso** (ex.: `claude.ai`) — e o **logo/símbolo** do aplicativo só aparece quando confere com esse endereço. Como qualquer aplicativo pode se **cadastrar sozinho** com o nome e o logo que quiser, o nome na tela não é prova de nada: o destino é. Se um dia aparecer um app dizendo "Claude" mas enviando para outro endereço, você vai ver na hora.
- **Conexão com o Painel do Afiliado mais robusta e transparente.** Quando o Painel está **fora do ar** ou o resumo falha, o portal agora **diz isso** (antes parecia que você nunca tinha conectado); se a conta está conectada mas **sem catálogo público**, o card explica e leva direto para criar/publicar o catálogo; e o dashboard avisa quando os números não carregam em vez de sumir. Ao **desconectar**, os números em cache somem na hora (antes podiam aparecer por até 5 min). Por baixo, a conexão já pede as **permissões novas** do Painel (à prova do futuro *enforcement* de escopos) — se aparecer o aviso "reconectar", é só clicar 1× e pronto.
- **Correção: título/preço editado no Postador e na extensão agora é respeitado.** Ao **editar o título** (ou o preço) de um produto antes de postar, a edição às vezes era **descartada em silêncio** e o post saía com o valor original — acontecia principalmente com links **encurtados** (ex.: `s.shopee.com.br/…`), por uma diferença de formato na URL entre a extensão e o servidor. Agora a edição é casada corretamente e **sempre aplicada**.
- **Correção: linha em branco extra na oferta (produtos da Shopee).** O nome de produtos da **Shopee** vinha com uma quebra de linha "escondida" no fim, que empurrava uma **linha em branco a mais** no meio do post. Corrigido — o título entra numa linha só.
- **Grupos: link adicionado por EDIÇÃO da mensagem agora é moderado.** Antes, um membro podia mandar uma mensagem inocente e depois **editá-la para inserir um link** de terceiro, escapando da moderação. Agora o bot também verifica **mensagens editadas** em grupos e apaga o link não autorizado (módulo **Grupos**).
- **Preço "De → Por" nas ofertas: nova variável `{de}` (opcional e adaptável).** Agora dá para mostrar o preço **De** (riscado) nas suas ofertas: adicione a variável **`{de}`** no template da oferta (aba **Mensagens**), ex.: `✅ {de}<b>{preco}</b>` → *"✅ De ~R$ 199,00~ por **R$ 149,00**"*. O valor do "De" vem **automaticamente** do preço riscado do marketplace (Amazon, Mercado Livre, Magalu, KaBuM…). O melhor: quando **não há** preço original (a loja não informa, ou é um produto sem "De"), a variável **some sozinha** — o post sai limpo só com o preço, sem sobra. O texto do "De" é personalizável no template `format.oferta.de`. No **Postador** há um campo **"Preço De"** dedicado (aplica ao 1º produto) e o campo **"Preço de"** da **extensão** também passa a valer no post — em ambos, vazio = usa o original do marketplace.
- **Extensão: pega o cupom da própria página (KaBuM e Amazon) automaticamente.** Ao capturar um produto na **KaBuM** (ex.: `JULHOGAMER10`) ou na **Amazon** (ex.: `cupom: BORALEVAR`), a extensão agora **lê o cupom exibido na página** e já preenche o campo Cupom — e, se esse código estiver cadastrado no seu bot, o **desconto entra junto**. O cupom da página tem prioridade sobre o último lembrado daquela loja.
- **Extensão: cupom e desconto lembrados por loja + desconto puxado do cupom cadastrado.** A extensão agora **lembra o último cupom e desconto que você usou em cada marketplace**: capturar em série na mesma loja mantém o cupom, mas ao **trocar de loja** (ex.: Shopee → KaBuM) ela **não carrega mais o cupom da loja anterior**. E quando você digita (ou reusa) um **código** de cupom que já está **cadastrado no seu bot**, o **desconto é preenchido automaticamente** (%/R$, respeitando teto e mínimo) — igual ao Postador.
- **Extensão: reconhece o preço "com cupom" da Shopee (não só "no Pix com cupom").** O aviso de "preço já com cupom" (que trava o desconto) agora também entende o rótulo **"com cupom"** da Shopee — quando o preço vale com cupom e aceita parcelamento sem juros —, além do "no Pix com cupom". O valor de referência "ou R$…" (sem cupom nem desconto de pagamento) vira o "De".
- **Extensão: cupom por link na prévia agora sai logo após o preço (não no fim).** Quando o cupom é um **link** de resgate, a prévia da extensão jogava a linha do cupom **no fim do post**, em vez de logo abaixo do preço como o resto do bot já fazia. Agora a extensão manda o cupom para o servidor posicionar — mesmo lugar do `/oferta` do Telegram e do Postador.
- **Extensão: "preço já veio com desconto" só quando REALMENTE tem cupom/Pix.** O aviso *"Preço já veio com desconto da página — o desconto não é reaplicado"* (que trava o campo de desconto) estava aparecendo em **qualquer** produto em promoção com preço "de/por" riscado. Agora ele só aparece quando o preço mostrado **de fato inclui cupom/Pix** — pelos rótulos claros do **Mercado Livre** (bloco de cupom / "no Pix com Cupom") e da **Shopee** ("no Pix com cupom"). Em promoção comum, o campo de desconto continua liberado para você aplicar o cupom que digitou.
- **Correção: cupom do Mercado Livre que começa "hoje" aparecia só no fim do dia.** Um cupom novo (ex.: um código que passa a valer no mesmo dia) tinha a data de **início** interpretada como o **fim** do dia — então ele só entrava na lista de vigentes às 23:59, praticamente invisível no único dia de validade. Agora a data de início vale a partir de **00:00 (horário de Brasília)**: o cupom aparece assim que começa. A correção se aplica sozinha na próxima busca de cupons (ou clique em **Buscar cupons** no painel para já valer).
- **Shopee e Mercado Livre: o mesmo produto gera sempre o mesmo link.** Assim como já acontecia na Amazon, o encurtador da **Shopee** (`s.shopee.com.br`) e o gerador do **Mercado Livre** criam um código novo a cada geração — então reconverter o mesmo produto (ou o mesmo item vindo de formas diferentes: `meli.la`, link de vitrine, link direto…) podia devolver **links diferentes** para o mesmo destino. Agora o link é **fixado por produto + seu código de afiliado** por 30 dias: reconversões devolvem o **link idêntico**, e no Mercado Livre isso vale mesmo quando o produto chega por endereços diferentes. Bônus: a reconversão fica mais rápida (não refaz a chamada à API). *(Links de loja, cupom e campanha continuam gerando normalmente, sem cache que possa envelhecer.)*
- **Extensão mais enxuta e vitrine no automático.** A extensão do Chrome ficou focada no essencial: saíram os botões de **"Gerar imagem"**, **"Publicar na vitrine"** e **"Abrir no painel"** (a geração de arte já acontece do lado do bot ao postar). Agora, **toda oferta que você posta num canal pela extensão entra sozinha na sua vitrine** — sem clique extra. E o ajuste **"Formato do cupom por link"** saiu das configurações da extensão: esse texto passa a ser definido **só no painel** (aba **Mensagens**, `format.cupom.link`), valendo para todos os caminhos.
- **Amazon: o mesmo produto gera sempre o mesmo `link.amazon`.** O encurtador SiteStripe da Amazon cria um código novo a cada geração, então reconverter o mesmo produto podia devolver `link.amazon/…` diferentes (ambos válidos e com a sua tag, mas dois links). Agora o link é **fixado por produto + tag** por 30 dias — reconversões devolvem o **link idêntico**. Bônus: a reconversão fica mais rápida (não refaz o encurtamento).
- **Extensão do Chrome publicada na Chrome Web Store.** A extensão **Bot do Afiliado — Postador** agora instala com **1 clique**, sem aviso de "modo desenvolvedor" e com **atualização automática**. [Instalar](https://chromewebstore.google.com/detail/bot-do-afiliado-%E2%80%94-postador/ngfhfiffemmlmnlpcolaibfagekidcaa) — veja o [guia da extensão](/docs/comecando/extensao-chrome/).
- **Vitrine: logo por upload (não precisa mais colar URL).** Na aba **Vitrine**, o campo da logo virou um **upload de imagem** (JPG/PNG/WebP) — igual ao da Página da Live. A imagem é otimizada e hospedada automaticamente, com prévia e botão de trocar/remover. Antes era preciso colar a URL de uma imagem já hospedada em outro lugar.
- **Cupom por link agora sai no lugar certo (junto do preço).** Quando você usa um **link** no lugar do código do cupom (ex.: "Resgate todos os cupons desta página: …"), a linha agora aparece **logo abaixo do preço** — no mesmo lugar do cupom de código — em vez de ir para o fim do post. Há uma variável `{cupom}` no template da oferta (aba **Mensagens**) para você escolher a posição; o texto do link continua editável em `format.cupom.link`.
- **Correção: foto de oferta saindo em branco (produtos WebP).** Ao postar uma oferta cuja imagem do produto é **WebP** (formato comum no Mercado Livre e na Shopee), a arte saía **toda branca** — o gerador de imagem do bot não decodificava WebP. Agora a imagem é **convertida para JPEG** automaticamente antes de montar a arte, e há uma proteção extra para nunca gerar um card em branco. Vale para o Postador e para a **extensão do Chrome** (o "Postar" direto pela extensão).
- **Ranking de reputação com paginação.** A tabela do ranking (aba **Reputação**) agora tem **páginas** (20 por vez) — dá para navegar por todos os membros, não só os primeiros.
- **Extensão: visual do "Convertendo…" corrigido.** O texto de carregamento longo estava **estourando o botão** e aparecia cortado; agora fica curto e limpo.
- **Anúncio de subida de nível mais rico.** Quando um membro sobe de nível (pelo **XP**, ganho em atividade ou compartilhando ofertas), o aviso no grupo agora mostra o **nível anterior → novo**, o **XP atual** e **quanto falta para o próximo nível** — antes era só "subiu para o nível X". Continua ligável/desligável em **Reputação → Anunciar subida de nível** e o texto é personalizável na aba **Mensagens** (template `reputation.level_up`), com os novos campos `{nivel_anterior}`, `{xp}` e `{proximo}`.
- **Correção importante: link do Mercado Livre não gera mais o produto errado.** Alguns links `meli.la` de **outros afiliados** abrem numa **vitrine** do vendedor (`/social/…`) — o bot lia o **carrossel de recomendação** da página e às vezes gerava o link de **outro produto** (ex.: um link de placa de vídeo virava whey protein). Agora ele identifica o **produto promovido de verdade** (o que o link aponta) e gera o link **certo**. Se, em algum caso, não der para identificar o produto com segurança, o bot **avisa e pede o link direto** (`.../p/MLB…`) em vez de arriscar o errado. Links **diretos de produto**, **listas** e **lojas** seguem funcionando normal.
- **Oferta de 1 produto: mais fotos saem na arte formatada (não na foto crua).** Quando a foto do produto **preenche o quadro** (tubo, caixa, bisnaga encostando no topo/base — muito comum na Amazon), o `/oferta` mandava a **foto original** em vez de montar a arte na proporção do post. Agora, se a foto tem **fundo utilizável** (margem limpa em um dos eixos), ela é **formatada no canvas** por encaixe (contain), com o fundo na cor detectada. Fotos "de ambiente" (lifestyle, fundo cheio) continuam indo na original.
- **Amazon: o cookie do SiteStripe é testado na hora que você cola.** No plugin **Amazon**, ao colar o cookie do **SiteStripe — link.amazon**, o painel faz um **teste automático** e mostra o resultado no card **Validação**: **Cookie OK** (verde) quando está gerando `link.amazon`, ou uma mensagem clara quando o **cookie expirou** (a Amazon pediu login — é só copiar de novo, já logado) ou quando a conta **não tem loja de Associado** ativa. Antes não dava para saber se o cookie estava valendo até tentar postar uma oferta.
- **Correção: dava para sair da Reputação sem salvar, achando que tinha salvado.** Na aba **Operação → Reputação**, o switch *"Sistema de reputação ativo"* fica no topo da tela, mas o único botão **Salvar** ficava lá embaixo, escondido no fim do card **Níveis** — quem ligava o switch e saía perdia a mudança **sem nenhum aviso**, e o selo do cabeçalho já mostrava *"ativa"* antes de gravar, reforçando o engano. Agora, ao mexer em qualquer configuração, aparece uma **barra "alterações não salvas"** que acompanha a rolagem, com **Salvar** e **Descartar**, e o selo do cabeçalho passa a refletir **só o que está realmente gravado**.
- **Reputação separada do nível (XP).** O ganho por atividade agora vai para o **XP** (que define o seu **nível**) e a **reputação** passa a vir **só dos votos `+1`/`-1`** dos membros e do ajuste do admin. Antes tudo somava no mesmo placar e a presença atropelava o voto — quem só ficava online subia mais do que quem era reconhecido pelos colegas. Agora cada número mede uma coisa: XP é o quanto você participa, reputação é o quanto te reconhecem.
- **Cupom calcula o preço sozinho no Postador.** Digitou o **código** do cupom? Se ele já está cadastrado no seu bot, o **desconto é preenchido automaticamente** e o "de/por" é recalculado na hora — respeitando o **valor mínimo** da compra e o **teto de desconto** do cupom. Cupom de **cashback** não abaixa o preço (ele volta depois da compra), então aparece como aviso em vez de virar desconto.
- **Cupons do Mercado Livre no automático.** O bot passa a puxar sozinho os cupons vigentes do programa de afiliados do Mercado Livre (junto com a busca de cupons, 4× por dia), com o **link de resgate já convertido para o seu afiliado**. Basta ter o plugin do Mercado Livre ativo.
- **O menu de cupons mostra o desconto de cada código.** Antes, cupons sem descrição viravam uma lista de códigos soltos, sem dizer o que cada um fazia. Agora o bot monta a descrição a partir dos dados do próprio cupom (ex.: *"R$ 50 OFF (mín. R$ 249)"*) e agrupa só os códigos que são **a mesma oferta**.
- **Correção: preço acima de mil virava cupom.** No `/oferta` do Telegram, um preço escrito sem o ponto do milhar (ex.: `R$2199`) não era reconhecido como preço e acabava tratado como código de cupom. Corrigido — agora vale para qualquer valor.
- **Reputação no grupo (pontos, níveis e +1/−1).** O módulo Grupos ganhou um **sistema de reputação**: membros ganham pontos ao **interagir**, votam uns nos outros **respondendo com `+1` ou `-1`** (1 voto por semana por membro — **admins votam sem limite**), sobem de **nível** com anúncio no grupo e aparecem no ranking do **`/reputacao top`**. Tudo **editável no painel** (aba **Operação → Reputação**): pesos, intervalos, faixas/nomes dos níveis e ajuste manual de pontos. Textos personalizáveis na aba Mensagens (`reputation.*`). E mais: **Top 10 da semana** postado automaticamente nos grupos, **bônus por compartilhar oferta** convertida, **`/perfil`** com card visual (imagem com nível e barra de progresso), **decaimento mensal** opcional e **alerta anti-brigada** no painel. [Saiba mais](/docs/telegram/reputacao/).
- **Cupom por link em todo lugar (mesmo formato).** A linha de resgate do **cupom por link** (template `format.cupom.link`, personalizável em **Mensagens**) agora vale em **todos os caminhos**: no `/oferta` do **Telegram** (`cupom: https://...`), no **Postador em tempo real** do painel, na extensão e na **API/IA (MCP)** — antes cada caminho tinha um comportamento. A URL de resgate sai **convertida para o seu afiliado** e o post vira formato de oferta automaticamente.
- **Vitrine: página de Links (estilo linktree) + cupons filtráveis por loja.** A vitrine ganhou a página **`/v/seu-slug/links`** — o seu **link na bio** de verdade: todos os seus links (grupo, Instagram, WhatsApp…) como **botões grandes com o ícone da rede**, mais atalhos para as ofertas do dia, cupons e lojas com contagem. No painel, o botão **"Copiar link da bio"** já copia esse endereço. E a página de **Cupons** ganhou **filtro por loja** (chips com o logo e a contagem de cada uma), combinando com a busca.
- **Correção importante: link "escondido" em texto formatado agora converte.** Quando uma mensagem trazia o link como **hyperlink** (texto clicável, comum em posts encaminhados de canal), o bot repostava **o link original** sem converter — inclusive links de afiliado de **outra pessoa**. Agora o link é convertido para o **seu** afiliado normalmente; se a conversão falhar, sai **ERRO** — nunca mais republica o link de terceiro.
- **Correção: Mercado Livre podia gerar o link de outro produto.** Um problema no cache fazia dois produtos diferentes da **mesma promoção** compartilharem o link — às vezes o link gerado abria **outro item**. Corrigido: cada produto tem seu link, e o cache antigo afetado foi descartado.
- **Menos ruído nos "domínios não mapeados".** **Encurtadores** (bit.ly, meli.la, s.click, s.shopee…) e links que deram **erro momentâneo** mas já têm rota **não entram mais** na lista — só domínios realmente sem integração aparecem.
- **Cupons com o logo da loja.** Os cupons importados dos plugins (Awin/Rakuten/CityAds) agora mostram o **logo da loja** na vitrine, junto do nome da categoria — visual mais reconhecível na aba de Cupons.
- **Vitrine virou um site de ofertas (com páginas próprias).** A vitrine pública agora tem **páginas separadas** para **Ofertas**, **Cupons** e **Lojas** — e uma **página por loja** (ex.: `/v/seu-slug/loja/amazon`, tipo "ofertas Amazon"). Cada página tem **título, descrição e endereço próprios** (bem melhor para aparecer no Google), **trilha de navegação** (breadcrumb) e o menu do topo levando às páginas de verdade. A capa mostra os **destaques** e uma prévia de ofertas e cupons, com "Ver todas". Inclui **sitemap automático** (`/v/seu-slug/sitemap.xml`) e dados estruturados (ItemList + breadcrumb) para o buscador entender cada página.
- **Preço "de" em (quase) todas as lojas.** O preço original riscado agora vem junto da extração no **Mercado Livre, AliExpress, Magalu, KaBuM e Amazon** (PA-API e Creators) — aparece no `product` da API/IA, no Postador, na extensão e alimenta o histórico de preços. Regra de segurança: só mostra o "de" quando ele é **maior** que o preço atual.
- **Extensão lê a página da loja.** A captura agora também extrai **direto da página aberta** (em paralelo com a API): pega o **preço que a loja exibe** — inclusive o **já descontado com cupom** que Shopee e Mercado Livre mostram — e dá título/foto/preço em lojas sem extração própria (Magalu, Terabyte). O preço riscado da página vira o "Preço de".
- **Cupom por link (página de resgate).** Colou uma **URL** no campo Cupom (no **Postador** ou na **extensão**)? O post sai no formato de oferta e ganha a linha **"🏷 Resgate todos os cupons desta página: {link}"** no final, com o link **já convertido** para o seu afiliado. O texto da linha é **customizável** na aba **Mensagens** (template `format.cupom.link`) — e também via IA/MCP.
- **Vitrine repaginada (visual de site de ofertas).** A vitrine pública (`/v/{slug}`) ganhou um **novo visual profissional**: **barra de menu fixa no topo** (Ofertas · Cupons · Lojas) com botão de destaque, cabeçalho de marca com a sua cor e **ícones das redes** detectados automaticamente dos seus links (Instagram, WhatsApp, Telegram, YouTube, TikTok…). Os produtos agora mostram **badge de desconto**, **selo da loja** (Amazon, Shopee, Mercado Livre, Magalu, KaBuM, AliExpress…), quando entraram (*há 3h*) e o preço antigo riscado. Tem **busca**, **filtro por loja**, uma faixa de **🔥 Maiores descontos**, uma **aba de Cupons** (mostra os cupons ativos do bot — código copiável, desconto e loja) e rodapé com selos de confiança e o aviso de afiliação.
- **Vitrine com cara de link na bio.** A vitrine pública ganhou **links estilo linktree**: o primeiro vira o **botão em destaque** no topo (ex.: "Entrar no grupo") e os demais viram a fileira de botões (Instagram, Telegram, WhatsApp…). Os cards agora mostram **"há 3h"** (quando a oferta entrou) e a página traz o aviso de afiliação no rodapé.
- **Extensão: foto crua ou com template.** Na hora de gerar a imagem, escolha **com template** (quadrada ou story) ou a **foto original do produto** (sem template) — copiar e baixar funcionam nos dois casos.
- **Arte de promo direto no Postador.** Cada oferta do Postador ganhou o botão **🎨 Arte**: gera a arte com o seu modelo e **usa como foto daquela oferta** na hora (entra na prévia e no post, como uma foto própria).
- **Colar formatado no Telegram.** O **texto de disparo** copiado na extensão agora cola **já formatado** (negrito e riscado) no Telegram Desktop/Web — e continua saindo certo no WhatsApp.
- **Arte de promo com o seu modelo do Canva.** Em **Promoções → Fotos & CTAs**, envie um fundo criado no **Canva** (1080×1080 para feed e 1080×1920 para story, com o centro livre) e escolha as cores do preço e do botão — as artes geradas pela extensão e pela API saem com a **sua identidade visual**, com botão **Testar arte** para conferir na hora.
- **Shopee Live: extrair sem misturar com a fila.** Na tela da live, o botão único "Extrair e resolver" virou **dois**: **Extrair e copiar** (resolve os ids/links e copia — sem tocar na fila) e **Extrair e adicionar à fila** (pré-carrega a fila para processar depois, sem copiar).
- **Postador dentro da extensão.** Depois de capturar a oferta, a extensão do Chrome agora **posta direto nos seus canais** do Telegram (modo *Entrar com o painel*): escolhe os canais autorizados, envia com a arte ou a foto do produto e confirma — sem abrir o painel. A segurança é a mesma do site: só canais que você **autorizou como destino** recebem, e o servidor recusa qualquer outro.
- **Extensão do Chrome (beta).** Capture produtos **sem sair da página da loja**: o painel lateral gera o seu link de afiliado, o texto de disparo, a arte de promo e publica na vitrine ou abre o Postador com o link preenchido. Funciona em **todas as lojas** dos seus plugins — e conecta com **um clique usando o seu login do painel** (sem colar chave; a API key segue como alternativa). [Saiba mais](/docs/comecando/extensao-chrome/).
- **Vitrine pública de promoções.** Nova aba **Promoções → Vitrine**: publique suas ofertas numa página própria (`botdoafiliado.com/v/seu-slug`) com foto, preço "de/por", **selo de desconto automático**, cupom com botão de copiar e o seu link — perfeita para o **link na bio**, com SEO pronto. Grátis para todos os bots. [Saiba mais](/docs/comecando/vitrine/).
- **Arte de promo pronta.** Novo endpoint `/api/v1/promo-card` gera um **card 1080×1080 ou story 1080×1920** com foto do produto, gatilho de venda, preços, cupom e botão "compre pelo link" — usado pela extensão e disponível na API para automações.
- **Foto do cupom sem corte na página da live.** Na página pública da **Shopee Live**, a foto de cupom que você envia agora aparece **inteira** — antes, imagens mais altas eram cortadas na altura.
- **Script do site corrigido.** O **[Script do site](/docs/api/script-do-site/)** (converte os links do seu site automaticamente com uma Embed Key) tinha parado de carregar em alguns endereços — foi corrigido e o snippet documentado volta a funcionar. Também blindamos a **Página de Chat embutida** (iframe e bolha) contra mudanças de segurança da infraestrutura: o widget continua funcionando nos sites dos clientes.
- **Canal de segurança (security.txt).** Publicamos o padrão **RFC 9116** em `/.well-known/security.txt`: pesquisadores de segurança agora têm um canal oficial para reportar vulnerabilidades de forma responsável.
- **Referência da API mais completa.** A [referência interativa (Scalar)](/docs/api/referencia/) agora abre com um **guia de início rápido** (3 passos + exemplo cURL), cada seção traz **link direto para o guia correspondente** na documentação, e os exemplos de código saem em **cURL por padrão** (com seletor para JavaScript, Python, PHP e outros). A [visão geral da API](/docs/api/visao-geral/) ganhou a **tabela completa de endpoints** por seção — incluindo os novos `product/history`, `amazon-prices`, `execute` (post de oferta pronto) e a família de **cupons**.
- **`product` devolve mais dados.** O endpoint de produto (API e IA/MCP) agora retorna também **estoque/disponibilidade** e **preço "de"** (riscado) quando o marketplace fornece, além de descrição, loja e faixa de preço — os mesmos dados alimentam o histórico de preços.
- **Overlay para OBS na Shopee Live.** O módulo **Shopee Live** ganhou um **overlay para a sua transmissão**: adicione a URL como *Fonte de Navegador* no **OBS** e uma **faixa transparente** mostra ao vivo os **produtos da live** passando na tela, com **foto, nome e preço**. A URL (e as **dimensões recomendadas**) ficam na tela da Shopee Live; um botão **Limpar** zera tudo antes de começar. [Saiba mais](/docs/telegram/shopee-live/).
- **Painel totalmente redesenhado.** O painel ganhou um **design system novo** — visual mais limpo com a identidade da marca, **modo escuro** de ponta a ponta, sidebar colapsável que lembra sua preferência, busca rápida com **Ctrl+K** e telas mais organizadas. Tudo que você já usava continua no mesmo lugar, só que melhor de usar (inclusive no celular).
- **Canais autorizados no Postador.** Por segurança, agora você **autoriza** quais canais podem receber ofertas: no seletor de canais do Postador, clique em **Autorizar** no canal desejado (dá para remover depois). Só canais autorizados ficam selecionáveis — e o servidor recusa envio para qualquer outro.
- **CTA salvo por produto.** Ao postar uma oferta de **1 produto** com CTA, a chamada fica **vinculada ao produto** e volta **sugerida** automaticamente quando ele reaparecer no Postador. A aba **Fotos próprias** virou **Fotos & CTAs**: gerencie as fotos e os CTAs salvos num lugar só — com **cadastro manual** pelo link do produto, edição e exclusão.
- **Ordenação de verdade na aba Chats.** Clicar numa coluna da tabela de Conversas agora ordena a **lista inteira no servidor** (não só a página carregada) — por título, tipo, ID ou status, subindo ou descendo.
- **Links da Amazon mais precisos.** A conversão passa a **preservar os parâmetros que mudam o produto/vendedor** (`th`, `psc`, `smid`, `m`, `ref`…) — a variação/loja que você mandou é a que abre — e links de **busca** da Amazon mantêm o termo pesquisado.
- **Mercado Livre: links de catálogo.** Links `/p/…` (página de catálogo) agora puxam o produto certo — o bot resolve o **anúncio vencedor** do catálogo automaticamente.
- **Menção inline melhorada.** Digitar **@seubot** em qualquer conversa mostra uma mensagem de divulgação que ensina a usar (personalizável em Mensagens); com um **link de produto** junto, gera a oferta ali mesmo.
- **Domínio próprio sem janela pós-atualização.** As rotas dos **domínios próprios** (Página de Chat/Live) agora são recriadas **em segundos** após cada atualização do sistema — antes podiam levar até 30 minutos para voltar.
- **Seletor de bots legível no modo escuro.** O dropdown nativo do seletor (e os `<select>` em geral) agora segue o tema — itens escuros no modo escuro, em qualquer navegador.

## 2026-06

- **Páginas de lojas (`/sites`) melhoradas.** A **busca por loja/domínio voltou a funcionar** (antes a busca perdia o termo e mostrava tudo), os **cards ficaram clicáveis por inteiro** e cada loja agora mostra a **comissão**. A página de cada loja (`/sites/{loja}`) foi enriquecida com a **comissão**, **passo a passo de como gerar o link** e **perguntas frequentes** — melhor para quem procura “afiliado {loja}” no Google.
- **Comissão por programa em destaque.** As páginas de **integrações** (`/plugins`) e de **lojas** passam a exibir a **comissão** de cada programa. Casos com taxa pública trazem o número (ex.: **Amazon 7% a 13%** com tabela por categoria e resumo das regras do programa; **Shopee até 10%**, 3% em vendas indiretas); os demais indicam que varia por categoria/anunciante.
- **Comissão real por loja nas redes (Awin e CityAds).** Nas lojas que entram por **rede de afiliados**, a comissão exibida em `/sites/{loja}` agora é **puxada automaticamente da API da rede** por anunciante (ex.: “5% a 8%”), em vez do texto genérico — atualizada nas sincronizações. A **Rakuten** não expõe a taxa por anunciante na API, então segue como “varia por anunciante”.
- **Novo módulo: Automação para Shopee Live.** Chegou o módulo **Shopee Live** — automação para as suas **lives da Shopee**, com uma **aba dedicada** no painel. Módulo opcional (R$ 299/mês), ativado sob demanda. [Saiba mais](/docs/telegram/shopee-live/).
- **Links Amazon podem sair como `link.amazon`.** No plugin **Amazon**, há um novo campo opcional **SiteStripe — link.amazon**: cole o **cookie** da sua sessão do **Associados** e os links da Amazon passam a ser encurtados como **`link.amazon/…`** (o link de marca da Amazon), em vez de `amzn.to`. Se o cookie vencer, o bot volta ao encurtador anterior **automaticamente** — sem quebrar nada.
- **Cupons detalhados.** Além da descrição, o cupom agora aceita **tipo de desconto** (% ou R$), **valor**, **compra mínima**, **desconto máximo** (só faz sentido em %, então só aparece nesse caso) e marcação de **cashback**, além do botão **Marcar esgotado**. As **categorias** saem em ordem **alfabética** e as tabelas (cupons, expirados e categorias) ganharam paginação com passadores no rodapé. Tudo disponível também na **API** (`/api/v1/coupons/ingest`) e via **IA/MCP** (`add_coupon`/`list_coupons`).
- **Aba Customizar explicada.** Os ajustes de formatação do `/c` (Customizar) agora têm **explicação e exemplos** em cada campo: o que é **Processamento por linha**, como funciona o **Regex de preço** e o **Replace do preço** (com antes→depois), prefixo do link e remover `https://`. Tutorial completo também em **[Conversão automática → Formatação](/docs/telegram/conversao-automatica/)**.
- **Sub-bot já ativa o webhook sozinho.** Ao adicionar um sub-bot, agora o **webhook é registrado no Telegram automaticamente** — o sub-bot passa a responder na hora (antes ele ficava cadastrado mas mudo). Se algum sub-bot tiver parado de responder, há um botão **Reativar webhook** ao lado dele para reaplicar na hora.
- **Excluir chave de API (não só revogar).** Na aba **API e IA MCP**, além de **Revogar** (que desativa a chave mas a mantém na lista), agora dá pra **Excluir** a chave de vez — ela some da lista. Chaves já revogadas também podem ser removidas. O nome da chave pode ter o tamanho que você quiser, sem limite.
- **Sub-bot mais rápido de adicionar.** Em **Sub-bots**, agora você **só cola o token** do BotFather e clica em Adicionar — o **nome** vira o **@usuário do bot** automaticamente (detectado pelo token), sem precisar digitar. De quebra, o token é **validado na hora**: se estiver errado ou revogado, avisamos em vez de cadastrar um bot que não responde.
- **O Postador lembra a sua CTA.** No **Postador de Ofertas**, ao postar uma oferta de **um produto**, a chamada para ação (CTA) usada fica **salva** e volta **pré-preenchida** na próxima vez — em qualquer dispositivo. Ofertas com vários produtos não alteram esse padrão.
- **Página de Chat (seu bot no navegador).** Nova aba **Operação → Página de Chat**: publique uma página estilo WhatsApp onde a pessoa cola um link e recebe a versão com **os seus afiliados** — sem abrir o Telegram. Tem **endereço próprio** (`botdoafiliado.com/c/seu-slug`), visual com **foto** (que também vira o **favicon** da aba), **tema de 2 cores** e **editor rico** (negrito, itálico, emoji…) nas boas-vindas, **prévia do produto** (imagem, título e preço, igual às redes sociais) e **4 formas de pôr no seu site**: link hospedado, **iframe numa rota** (`seu-site.com/chat`), **bolha flutuante** bem customizável (ícone/cor/greeting, API JS, CSS próprio) e **domínio próprio** com provisionamento automático (Cloudflare for SaaS). As páginas hospedadas já saem com **SEO** (canonical, Open Graph, Twitter Card e JSON-LD). Grátis para todos os bots. [Saiba mais](/docs/comecando/pagina-de-chat/).
- **Domínio próprio mais fácil (Página de Chat).** A tela de domínio próprio ficou passo a passo: mostra o **registro CNAME** já pronto (Tipo, Nome e Destino) com **botão de copiar** em cada campo, valida na hora se você digitou um **subdomínio** (domínio raiz não aceita CNAME), e o status agora é **claro e automático** — “aguardando DNS”, “emitindo SSL” e “no ar” se atualizam sozinhos, sem ficar clicando. Com dicas de solução para os tropeços comuns (propagação, “DNS only” na Cloudflare). [Saiba mais](/docs/comecando/pagina-de-chat/).
- **MCP muito mais esperto (IA no Claude/ChatGPT).** Grande revisão do servidor MCP: novo tool **`get_bot_info`** (a IA descobre **o que o seu bot suporta** — marketplaces com busca, domínios conversíveis, módulo de cupons — em vez de tentar e errar); **`add_coupon` com `convert_url`** (já converte o link do cupom em afiliado ao cadastrar, sem passo extra) e novos campos **início de vigência** e categoria por ID; **paginação** em `list_coupons` (offset) e na busca de produtos (a resposta agora indica a página); avisos quando um marketplace **falha na busca** (antes a IA concluía "não existe" se a Shopee caísse); **erros com dica acionável** (ex.: "ative o módulo de Cupons no painel" em vez de um código técnico); validação de **datas de validade** (rejeita DD/MM/AAAA que viraria cupom sem prazo); comandos **`coringa`** e **`addcarrinho`** liberados via IA; respostas mais **enxutas** (menos ruído interno = IA mais rápida e barata); e `get_template` com **`keys_only`** para listar as chaves sem baixar todos os textos.
- **Mensagens não somem mais em erros temporários.** Corrigimos uma família de casos raros em que o bot recebia a mensagem e **não respondia nada** — erro passageiro de infraestrutura, limite de envio do Telegram em grupos movimentados ou imagem de produto lenta. Agora o bot **retenta automaticamente** quando o Telegram pede para aguardar, responde "tente de novo" em vez de ficar mudo quando algo falha de verdade, e a moderação de grupos **não apaga mensagens por engano** durante instabilidade (na dúvida, deixa passar).
- **Porteiro de canal nos grupos.** Nova aba **Grupos** no painel: exija que membros do seu **grupo** estejam no seu **canal** do Telegram. Quem não estiver tem a mensagem **apagada na hora** (mesmo sem link) e recebe o **aviso que você definiu** (com `{nome}` e `{canal}`), no máximo 1 a cada 30s por pessoa. Inclui **tabela de infratores** com contador e botões de **Banir/Desbanir/Zerar**, além do **Testar canal** para validar as permissões do bot.
- **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 `<script>` no seu site e os links de loja viram seus links de afiliado automaticamente — sem backend e sem expor sua API key.
- **API mais segura.** O endpoint de conversão (`/api/v1/convert*`) agora identifica o bot **sempre pela API key** (o campo `bot_id` deixou de ser aceito sem chave). Para uso no navegador, use a Embed Key acima.
- **Busca de produtos com mais filtros.** A busca (API/IA) agora aceita comissão mínima, faixa de preço, loja oficial e novas ordenações (maior comissão, mais vendidos, melhor avaliados, maior desconto) — nos marketplaces que suportam. Filtros específicos de cada loja via `site_filters`.
- **Busca na Kabum.** A Kabum entrou como fonte de busca de produtos (`site: "kabum"`) — o link de afiliado é gerado pela sua rota Awin.
- **Shopee: menos produtos indisponíveis na busca.** A busca passa a descartar ofertas expiradas ou ainda não iniciadas e ganhou o filtro `key_seller_only` — só vendedores de alto desempenho da Shopee, reduzindo resultados de vendedores em férias ou com estoque inativo.
- **Amazon: busca migrada para a Creators API.** Como a PA-API foi descontinuada, a busca de produtos da Amazon passou a usar a Creators API (contas com PA-API antiga continuam funcionando).
- **Plugin CityAds.** Nova integração com a rede de afiliados CityAds: importa suas lojas conectadas (Brasil) e gera os links de afiliado automaticamente.
- **Tela de Perfil.** Veja o email logado, gerencie suas passkeys, encerre sessões ativas e veja a conta Google vinculada.
- **Níveis de acesso por usuário.** Convide pessoas para o bot por link e defina o papel: **Owner** (tudo), **Admin** (configurar o bot) ou **Membro** (gerar link e promoções).
- **Amazon: links mais limpos.** Correção que evita re-encurtar um link que já estava encurtado.
- **Referência da API em Scalar.** A documentação interativa da API agora usa o Scalar (busca, schemas e "try it out").
- **Documentação de plugins atualizada.** Amazon PA-API e Creators API: um único plugin com seletor de fonte (região pré-configurada para BR). Magalu: detecta o promoter ID automaticamente ao colar um link. Pague Menos e Beleza na Web: campos novos documentados. Nova página: CityAds.

## 2026-05

- **Documentação completa lançada.** Guias de Começando, Integrações (AliExpress, Amazon, Shopee, Awin, Rakuten, Magalu, Mercado Livre e mais), Telegram (ofertas, cupons, broadcast, grupos), Planos e API REST.
- **SEO aprimorado.** Páginas com dados estruturados (FAQ, passo a passo, breadcrumb) e preços, para melhor indexação.

> Sugestões de conteúdo ou encontrou algo desatualizado? Escreva para **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)**.

---

# DOC: Cupons: cadastre, importe e mostre os seus cupons por loja no bot e na vitrine
URL: https://botdoafiliado.com/docs/telegram/cupons/
Atualizado: 2026-11-08
Descrição: Guarde os seus cupons por loja e o seu público acha cada um pelo /cupom no bot e na vitrine. Cupom vencido sai sozinho, e o Postador já calcula o preço com desconto.

Na tela **Cupons** você guarda os seus cupons organizados por loja. O seu público acha cada um pelo comando **/cupom** no bot e na página da loja na vitrine, e o **[Postador](/docs/telegram/formatador-tempo-real/)** usa o desconto para calcular o preço da oferta.

> **Módulo necessário:** Cupons. Veja **[módulos e preços](/docs/planos/modulos/)**.

## O que você ganha

- **Cupom fácil de achar:** quem usa o bot manda **/cupom** e vê os cupons de cada loja.
- **Nada de cupom vencido no ar:** com data de expiração, o cupom sai sozinho da lista de ativos.
- **Preço com desconto calculado:** com o desconto cadastrado, o Postador faz a conta por você.
- **Menos digitação:** importe das redes de afiliados ou cole um post e deixe a IA preencher.

## Como cadastrar um cupom

1. No painel, abra **Postar › Cupons**.
2. Na aba **Cupons**, clique em **Novo cupom**.
3. Em **Site**, escolha a loja ou deixe em **Identificar pelo link**.
4. Preencha o **Código** ou o **Link**. Sem código, o cupom vale direto no link.
5. Se quiser, preencha **Descrição/regras** com o que o cupom dá (por exemplo, 15% OFF acima de R$100) e a **Expiração**.
6. Clique em **Salvar**.

<video src="/docs/telegram/cupons-novo.mp4" poster="/docs/telegram/cupons-novo.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Postar › Cupons, clicar em Novo cupom, escolher a loja Amazon, digitar o código CASA15 e a descrição, pôr a data de expiração, clicar em Salvar e ver o cupom no topo da lista" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/telegram/cupons-novo.gif" alt="Vídeo: em Postar › Cupons, clicar em Novo cupom, escolher a loja Amazon, digitar o código CASA15 e a descrição, pôr a data de expiração, clicar em Salvar e ver o cupom no topo da lista" /></video>

## Cadastrar vários de uma vez

**Importar das redes:** com a **Awin**, a **Rakuten** ou a **CityAds** conectada em **Configurar › Lojas**, clique em **Importar das lojas** na aba **Cupons**. Entram os cupons ativos dos seus programas do Brasil, já com o seu link de afiliado. Só entram cupons com código, e rodar de novo atualiza os que já existem, sem duplicar.

**Extrair com IA:** na aba **Extrair com IA**, cole o texto de um post do jeito que veio e clique em **Extrair**. Em **O que a IA achou** aparecem os códigos, o link e a validade que ela leu. Confira o formulário preenchido e clique em **Salvar cupom**, ou em **Salvar todos (N)** se o post tiver vários. O aviso **Cupom salvo.** confirma.

<img src="/docs/telegram/cupons-ia-extrator.webp" alt="Aba Extrair com IA: o texto de um post de cupom colado, os botões Extrair, Salvar cupom e Salvar todos, a lista O que a IA achou e o formulário já preenchido com a loja Magalu, o código APP30, a descrição e o link" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Ajustes opcionais

- **Desconto para o Postador:** preencha **Tipo de desconto**, **Valor do desconto** e, se houver, **Compra mínima** e **Desconto máximo**. Marque **É cashback** quando o valor volta depois, sem desconto no carrinho.
- **Cupom esgotado:** no menu ao lado do cupom, clique em **Marcar esgotado**; quando voltar, **Reativar estoque**. Para vários, marque as caixas das linhas.
- **Reusar cupom vencido:** na aba **Expirados**, **Ativar** volta o cupom sem prazo. Para dar uma data nova, use **Editar**.
- **Loja que não está na lista:** na aba **Sites**, use **Novo site** com **Nome** e **Domínio**. As lojas conectadas já aparecem sozinhas.

## Como seu público usa no Telegram

- **`/cupom`** abre o menu por loja. Ao tocar numa loja, o bot mostra os cupons ativos dela.
- **`/cupom shopee`** busca direto pelo texto.
- **`/oferta CUPOM link`** monta um post de oferta com o cupom. Veja **[Ofertas](/docs/telegram/ofertas/)**.

<img src="/docs/telegram/cupons-bot.png" alt="Comando /cupom no Telegram mostrando o menu de lojas com cupons (Uber, AliExpress, Mercado Livre, Amazon)" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

Na aba **Cupons**, o cupom novo aparece na lista com a **Validade** e a **Situação** **Ativo**.

<img src="/docs/telegram/cupons-painel.webp" alt="Aba Cupons do painel: a lista de cupons com código, loja, descrição, validade e situação, o botão Novo cupom no alto e um cupom marcado como Esgotado" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Depois, mande **/cupom** para o seu bot no Telegram. Toque na loja do cupom que você cadastrou: ele tem que aparecer na lista.

## Se algo não der certo

- **O cupom não aparece no /cupom:** o bot só mostra cupom **Ativo** e dentro da validade. Confira a **Situação** e a **Validade** na lista, e se a loja está ativa na aba **Sites**.
- **A IA deixou o cupom sem código:** o código precisa estar escrito inteiro no texto colado. A IA não inventa código.
- **O Postador não calculou o desconto:** preencha **Tipo de desconto** e **Valor do desconto** no cupom. Se o produto não atinge a **Compra mínima**, o desconto não entra.

## Próximos passos

- Use os cupons nas ofertas com o **[Postador](/docs/telegram/formatador-tempo-real/)**.
- Conecte **[Awin](/docs/integracoes/awin/)**, **[Rakuten](/docs/integracoes/rakuten/)** ou **[CityAds](/docs/integracoes/cityads/)** para importar cupons.
- Cupom secreto do AliExpress funciona de outro jeito: veja **[moedas e cupom do AliExpress](/docs/telegram/aliexpress-moedas-cupom/)**.

---

# DOC: Campanhas: grupos, regras, fontes, link de entrada e rastreio
URL: https://botdoafiliado.com/docs/whatsapp/criar-campanha/
Atualizado: 2026-11-08
Descrição: Crie uma campanha para escolher de qual canal do Telegram vêm as ofertas e para quais grupos de WhatsApp e Telegram elas vão, com filtro e link de afiliado.

A campanha diz ao bot **de onde vêm as ofertas** (o seu canal do Telegram) e **para onde elas vão** (os seus grupos e canais de WhatsApp e Telegram). Sem campanha, nada é repassado.

## O que você ganha

- **Tudo num lugar só:** você escolhe a origem e os grupos que recebem, e o bot faz o resto.
- **Só passa o que você quer:** filtre por palavra-chave, bloqueie palavras ou exija foto ou vídeo.
- **Comissão garantida:** os links saem convertidos para o seu link de afiliado.
- **Envio espaçado:** você define o intervalo entre os envios, para proteger o número.
- **Uma campanha por nicho:** por exemplo, "Moda" com os grupos de moda e "Eletrônicos" com outros. Mudar uma não mexe na outra.

## Antes de começar

- Um número conectado ([Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)).
- O seu bot no canal do Telegram de onde saem as ofertas ([Fontes do Telegram](/docs/whatsapp/conectar-telegram/)).

## Como configurar

1. No menu lateral, em **Comunidade e envio**, abra **Campanhas** e clique em **Nova campanha**.
2. Dê um **Nome** (ex.: "Moda").
3. Na seção **Destinos**, em **Adicionar**, marque os grupos e canais que vão receber as ofertas.
4. Confira se o interruptor **recebe ofertas** está ligado em cada grupo escolhido.

<img src="/docs/whatsapp/nova-campanha.webp" alt="Formulário Nova campanha na seção Destinos: o Nome Moda, dois grupos de WhatsApp em Na campanha com o interruptor recebe ofertas ligado, a lista Adicionar com os outros grupos e canais e o botão Criar campanha" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

5. Na seção **Regras**, escolha em **Repassar** o que passa: todas as mensagens, só com imagem ou vídeo, ou só com palavra-chave.
6. Na seção **Fontes e ritmo**, marque o canal do Telegram de onde vêm as ofertas.
7. Clique em **Criar campanha**.

A campanha nova abre no **Link de entrada**. Ligue **Ativar link de entrada** só se você também quiser levar pessoas para os grupos ([Link de entrada e grupos](/docs/whatsapp/link-e-grupos/)).

> **Dica:** toda mudança só vale depois de clicar em **Salvar campanha**. Enquanto aparecer **Alterações ainda não salvas.**, nada mudou.

<video src="/docs/whatsapp/criar-campanha.mp4" poster="/docs/whatsapp/criar-campanha.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Campanhas, clicar em Nova campanha, dar o nome Moda, marcar dois grupos, ligar o link de entrada, clicar em Criar campanha e ver o Link de entrada salvo com o botão Copiar link" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/whatsapp/criar-campanha.gif" alt="Vídeo: em Campanhas, clicar em Nova campanha, dar o nome Moda, marcar dois grupos, ligar o link de entrada, clicar em Criar campanha e ver o Link de entrada salvo com o botão Copiar link" /></video>

## Ajustes opcionais

- **Palavras-chave** e **Palavras bloqueadas** (em **Regras**): separe por vírgula. Vale a palavra inteira: *promo* não pega *promoção*. Palavra bloqueada sempre ganha e o post não sai.
- **Substituições** (em **Regras**): troque um texto por outro em todo post, com pares **De** e **Para**.
- **Ritmo dos encaminhamentos** (em **Fontes e ritmo**): o tempo, em segundos, entre um envio e outro. Em branco, cada número espera 8 segundos.
- **Regras** de um grupo (na seção **Destinos**): regras só para aquele grupo, além das da campanha.
- **Rastreio**: como os links das ofertas saem e as tags da Meta e do Google Analytics. Veja [Rastreio e destinos de eventos](/docs/referencia/rastreio-e-eventos/).

## Mandar um aviso para todos os grupos

Com a campanha salva, abra a seção **Enviar mensagem**, escreva o aviso e clique em **Enviar para N destinos**. Ele vai para todos os grupos e canais da campanha que recebem ofertas, no WhatsApp e no Telegram.

> **Atenção:** esse envio não dá para desfazer. Se parte falhar, clique em enviar de novo sem mudar o texto: só os que falharam recebem.

## Como saber se funcionou

Publique um post no seu canal do Telegram e veja se ele chega no grupo. Para testar um grupo só, use **Testar** em **WhatsApp › Grupos e canais**.

Cada envio aparece em **WhatsApp › Envios**, em **Últimos envios**, com o status (**Enviado**, **Falhou** etc.). Na seção **Métricas** da campanha você vê envios, falhas, cliques e entradas de cada grupo.

## Se algo não der certo

- **Nada chega no grupo:** confira se a campanha tem uma fonte, se os encaminhamentos estão ativos e se o grupo está com **recebe ofertas** ligado. O selo **sem destino de conteúdo** avisa campanha sem grupo que recebe.
- **O mesmo post chegou duas vezes:** a mesma fonte está em duas campanhas com esse grupo em comum. Tire o grupo de uma delas.
- **Apareceu "Campanha pausada por conteúdo repetido":** o mesmo post chegou 10 vezes em 10 minutos e a campanha parou por segurança. Confira as fontes e os grupos e clique em **Retomar encaminhamentos**.
- **Não consigo editar uma campanha arquivada:** clique em **Restaurar pausada** antes.

## Próximos passos

- **[Link de entrada e grupos](/docs/whatsapp/link-e-grupos/)**: um link para divulgar e grupos que crescem sozinhos.
- **[Pessoas e resultados](/docs/referencia/trafego-campanhas/)**: quem entrou pelos links e de onde veio.
- **[Problemas comuns](/docs/whatsapp/problemas-comuns/)**: o que fazer quando algo trava.

---

# DOC: API: endpoint legado POST /convert
URL: https://botdoafiliado.com/docs/api/convert-legado/
Atualizado: 2026-10-24
Descrição: O POST /api/v1/convert do Bot do Afiliado converte 1 link por chamada, exige chave de API de nível Padrão ou Total e continua no ar; o /convert-links aceita o mesmo corpo e até 150 links, por isso é o caminho recomendado.

O **`POST /api/v1/convert`** converte **um link por chamada** no seu link de afiliado. Ele continua no ar para quem já integrou, mas o **[/convert-links](/docs/api/convert-links/)** aceita o mesmo corpo e até 150 links por chamada, então é o caminho para integração nova.

- **Método:** `POST`
- **Path:** `https://botdoafiliado.com/api/v1/convert`
- **Auth:** header `X-API-Key` (obrigatório), chave de nível **Padrão** (`write`) ou **Total** (`admin`). Veja **[autenticação](/docs/api/autenticacao/)**.

## Request

```json
{
  "url": "https://exemplo.com/produto",
  "telegram_user_id": 123
}
```

| Campo | Obrigatório | O que faz |
|---|---|---|
| `url` | sim | O link completo a converter, com `http://` ou `https://`. |
| `telegram_user_id` | não | Com o módulo **Tracking por usuário**, cada pessoa ganha a sua versão do link. Sem o módulo, todos recebem o mesmo link. |
| `chat_id` / `origem` | não | Destino do link, para medir o clique por grupo, canal ou site. Veja **[Origem do link](/docs/api/convert-links/#origem-do-link-opcional)**. |
| `refresh` | não | Só Mercado Livre: gera um link novo na API do ML e grava por cima do guardado. Em outra loja, `400` com "refresh só vale para link do Mercado Livre.". |
| `bot_id` | — | Ignorado: o bot é sempre o da chave. |

## Response (200)

```json
{
  "success": true,
  "url_original": "https://exemplo.com/produto",
  "url_resolvida": "https://exemplo.com/produto",
  "affiliate_url": "https://...",
  "final_url": "https://...",
  "site": "exemplo.com",
  "provider": "awin"
}
```

Use o **`final_url`**: é o link já com a política de encurtamento do bot aplicada (por exemplo `amzn.to` na Amazon e `ofertou.ai` nas lojas sem encurtador próprio). O `affiliate_url` é o link antes do encurtador.

## Erros

| HTTP | Quando |
|---|---|
| `401` | Sem `X-API-Key` ou chave inválida. A mensagem lembra que, no navegador, o caminho é a Embed Key. |
| `403` | `insufficient_scope`: chave de nível Leitura. |
| `400` | Corpo inválido, `refresh` fora do Mercado Livre ou loja sem integração ativa. O `error` vem em texto para mostrar ao usuário, como "Ainda não tenho uma integração ativa para esse site. Verifique se o plugin/rota está configurado no painel.". |

A mesma URL convertida de novo devolve a mesma resposta: cada data center guarda o resultado por 60 segundos, além do cache do conversor. O `refresh` passa por cima dos dois. Lista completa em **[erros e limites](/docs/api/erros-e-limites/)**.

## Migrar para /convert-links

1. Troque a URL do endpoint de `/api/v1/convert` para `/api/v1/convert-links`.
2. Continue enviando `url` (modo single): a resposta tem os mesmos campos.
3. Quando quiser otimizar, agrupe várias URLs em `urls` e itere `items[]`.

---

# DOC: Gerar link: links de afiliado em massa, colando ou por planilha
URL: https://botdoafiliado.com/docs/comecando/gerar-links-em-massa/
Atualizado: 2026-11-08
Descrição: Troque até 200 links pelos seus links de afiliado de uma vez, colando os links ou enviando uma planilha, e baixe tudo pronto para usar.

A tela **Gerar link** troca muitos links de uma vez pelos seus links de afiliado: até **200 por rodada**. Você cola os links ou envia uma planilha, e recebe tudo pronto para copiar ou baixar.

## O que você ganha

- **Tempo:** em vez de converter link por link, você converte uma lista inteira num clique.
- **Planilha pronta:** envie a sua planilha e receba de volta a mesma planilha com os seus links no lugar.
- **Fácil de levar:** copie todos os links de uma vez ou baixe em CSV.

## Antes de começar

A loja dos links precisa estar conectada no seu bot. Veja **[como funcionam as integrações](/docs/integracoes/como-funcionam/)**.

## Como gerar

1. No painel, abra **Postar › Gerar link**.
2. Cole os links no campo **Links para converter**, um por linha. Ou clique em **Enviar planilha** e escolha um arquivo CSV ou Excel (.csv, .xlsx ou .xls).
3. Clique em **Gerar**. Com vários links, o botão mostra quantos são, como **Gerar 3 links**.
4. Na tabela **Resultados**, use:
   - **Copiar todos** para copiar os links convertidos, um por linha;
   - **Baixar CSV** para baixar a lista;
   - **Baixar planilha convertida** (aparece se você enviou planilha) para receber a sua planilha com os links trocados.

<img src="/docs/comecando/gerar-links-massa-input.webp" alt="Campo Links para converter com três links de loja colados, o botão Gerar 3 links, o botão Enviar planilha e o Limpar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

**Limpar** apaga o campo, os resultados e a planilha enviada, para começar de novo.

<video src="/docs/comecando/gerar-links-massa.mp4" poster="/docs/comecando/gerar-links-massa.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Gerar link, colar três links de loja, clicar em Gerar 3 links, ver a tabela Resultados com o link de afiliado de cada um e clicar em Copiar todos" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/comecando/gerar-links-massa.gif" alt="Vídeo: em Gerar link, colar três links de loja, clicar em Gerar 3 links, ver a tabela Resultados com o link de afiliado de cada um e clicar em Copiar todos" /></video>

## Como saber se funcionou

Cada link aparece na tabela com um status. **ok** quer dizer que deu certo: o seu link aparece ao lado, com **Copiar** e **Abrir**. Abra um deles para conferir.

<img src="/docs/comecando/gerar-links-massa-resultado.webp" alt="Tabela Resultados com três links: o link original, o status ok e o link de afiliado com os botões Copiar e Abrir; no topo, Copiar todos e Baixar CSV" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Se algo não der certo

- **Status erro, com o aviso O bot ainda não converte links deste site:** a loja desse link não está conectada. Conecte em **Configurar › Lojas** e gere de novo.
- **Apareceu o aviso Nenhum link encontrado na planilha:** a planilha não tem links. Confira se enviou o arquivo certo.
- **Colei mais de 200 links:** só os 200 primeiros são convertidos. Gere o resto numa segunda rodada.

## Próximos passos

- Para trocar os links de um post do Telegram, use o comando **[/c](/docs/telegram/conversao-automatica/)**.
- Para montar uma oferta com prévia, use o **[Postador](/docs/telegram/formatador-tempo-real/)**.

---

# DOC: Campanhas: como interpretar a atribuição
URL: https://botdoafiliado.com/docs/referencia/atribuicao-campanhas/
Atualizado: 2026-11-08
Descrição: Entenda o que quer dizer origem Exata, Provável ou Desconhecida em cada entrada e em cada comissão, e saiba quais campanhas trazem gente e vendas.

A atribuição mostra **de onde veio** cada pessoa que entrou nos seus grupos e cada venda registrada, e o quanto dá para confiar nisso. Você vê tudo em **Campanhas › Pessoas e resultados** ([Pessoas e resultados](/docs/referencia/trafego-campanhas/)).

## O que você ganha

- **Saber qual campanha traz gente:** cada entrada mostra a campanha e a origem.
- **Separar certeza de estimativa:** entradas e comissões vêm marcadas como exatas ou prováveis.

## Origem de cada entrada

- **Exata:** a pessoa entrou pelo convite da campanha, e o bot confirmou. No Telegram, o bot precisa ser **administrador** do grupo para ver isso.
- **Provável:** alguém clicou no link da campanha até 30 minutos antes da entrada. É um bom indício, mas é só uma coincidência de horário.
- **Desconhecida:** não há informação suficiente, ou mais de uma campanha disputa a mesma entrada. A pessoa continua contada no grupo, só não vai para nenhuma campanha.

## Comissões

Em **Pessoas e resultados**, as comissões aparecem em três grupos:

- **Confirmada · vínculo exato:** venda já confirmada e ligada a um clique no seu link.
- **Pendente · vínculo exato:** venda ligada a um clique, ainda esperando confirmação.
- **Atribuição provável:** alguém comprou o mesmo produto até 72 horas depois de clicar num link da campanha.

Nenhum desses números, sozinho, prova qual anúncio trouxe o comprador.

## Para ter números mais certos

- **Deixe o bot como administrador** dos grupos do Telegram, para as entradas pelo convite virem como **Exata**.
- **Use uma campanha por grupo** quando quiser saber qual campanha trouxe cada pessoa. Com várias campanhas no mesmo grupo, as entradas disputadas ficam como **Desconhecida**.
- **Conte os cliques:** no modo **Direto**, o clique não é contado, e a venda provável depende dele. Na seção **Rastreio** da campanha, **O que esta campanha mede** mostra loja a loja o que dá para medir.

## Ainda em acesso restrito

Movimento por hora, pedidos e comissão estimada, taxa de conversão e o Top 5 de produtos e Sub IDs ainda não aparecem para a sua conta.

## Próximos passos

- Veja as entradas e as comissões em **[Pessoas e resultados](/docs/referencia/trafego-campanhas/)**.
- Escolha como os links saem e ligue a Meta em **[Rastreio e destinos de eventos](/docs/referencia/rastreio-e-eventos/)**.

---

# DOC: Como enviar ofertas e mensagens em massa para todos os chats do bot
URL: https://botdoafiliado.com/docs/telegram/broadcast/
Atualizado: 2026-11-08
Descrição: Mande uma mensagem ou oferta de uma vez para todas as conversas e grupos do seu bot no Telegram, com opção de fixar e de ver quem recebeu.

O **Broadcast** manda a mesma mensagem, de uma vez, para **todas as conversas e grupos ativos** do seu bot e mostra a entrega chat a chat. Canais ficam de fora.

> **Plano:** o Broadcast vem grátis com o plano base. Confira em **Conta › Plano e módulos** se o base está ativo.

## O que você ganha

- **Um envio, todo mundo avisado:** a mensagem chega em todas as conversas e grupos ativos do bot.
- **Mensagem fixada:** o bot fixa a mensagem nos grupos onde tem permissão.
- **Entrega à vista:** você vê quantos receberam e onde deu erro.
- **Sem travar:** quem bloqueou o bot sai da lista sozinho, sem atrapalhar os outros.

## Como configurar

1. Confira em **Conta › Plano e módulos** que o plano base está ativo.
2. No painel, abra **Postar › Broadcast**, aba **Novo**.
3. Escreva a **Mensagem** (até 4096 caracteres). Se quiser, clique em **Enviar imagem** para pôr uma foto (até 5 MB).
4. Marque **Fixar mensagem no grupo após enviar** se quiser a mensagem fixada.
5. Confira a **Pré-visualização (como ficará no Telegram)**.
6. Clique em **Enviar Broadcast**, digite **ENVIAR** e clique em **Enviar agora**.

<video src="/docs/telegram/broadcast-enviar.mp4" poster="/docs/telegram/broadcast-enviar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Postar › Broadcast, escrever a mensagem, ver a Pré-visualização de como fica no Telegram, marcar Fixar mensagem no grupo após enviar e chegar ao botão Enviar Broadcast" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/telegram/broadcast-enviar.gif" alt="Vídeo: em Postar › Broadcast, escrever a mensagem, ver a Pré-visualização de como fica no Telegram, marcar Fixar mensagem no grupo após enviar e chegar ao botão Enviar Broadcast" /></video>

> **Atenção:** depois de enviada, a mensagem não volta atrás. Ela também não aceita variáveis: o mesmo texto vai para todos.

Evite mandar broadcast demais, para não gerar bloqueios.

## Como saber se funcionou

Depois de enviar, a aba do envio (**Envio #** e o número dele) abre sozinha. Ela mostra quantos já receberam, os erros e, em **Entrega em cada chat**, a situação de cada chat (**Enviado**, **Falhou**, **Cancelado**). O erro vem em frase simples, como **A pessoa bloqueou o bot.**; o texto original do Telegram fica em **Texto original**, para o suporte. Para parar no meio, clique em **Cancelar envio**.

<img src="/docs/telegram/broadcast-entrega.webp" alt="Aba de um envio em andamento: quantos chats já receberam e quantos deram erro, a mensagem enviada, a lista Entrega em cada chat e o botão Cancelar envio" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Os envios anteriores ficam em **Histórico**, com a situação de cada um (**Na fila**, **Enviando**, **Concluído**, **Falhou** ou **Cancelado**). Clique em **Ver** para abrir um deles.

<img src="/docs/telegram/broadcast-historico.webp" alt="Aba Histórico do Broadcast: lista dos envios com número, situação, total de chats, enviados, data e o botão Ver" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Enviar pelo Telegram

Com a chave **Broadcast** ligada no card **Comando /broadcast**, no fim da tela **Postar › Broadcast**, o dono e os admins do bot podem enviar direto do Telegram:

| Comando | O que faz |
|---|---|
| `/broadcast <msg>` | Envia a mensagem para os chats ativos. |
| `/broadcastcompin <msg>` | Envia e **fixa** a mensagem nos chats. |
| `/broadcastsempin <msg>` | Envia sem fixar. |
| `/broadcaststatus <número>` | Mostra quantos receberam, as falhas e os cancelados. |
| `/broadcastcancel <número>` | Cancela um envio em andamento. |

Pelo comando, a mensagem vai até 3500 caracteres. Se você responder a uma mensagem só com o comando, o bot reenvia aquela mensagem para todos.

<img src="/docs/telegram/broadcast-enfileirado.png" alt="Comando de broadcast no Telegram: o bot responde que o envio entrou na fila, com o número do envio" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

<img src="/docs/telegram/broadcast-status.png" alt="Comando /broadcaststatus: o bot mostra status, total de chats, enviados, falhas e cancelados" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Se algo não der certo

- **A tela mostra um cadeado:** o plano base não está ativo. Confira em **Conta › Plano e módulos**.
- **O botão de enviar travou:** a mensagem passou de 4096 caracteres.
- **Não fixou em algum grupo:** o bot só fixa onde tem permissão para isso.
- **Alguém não recebeu:** só chats ativos recebem, e quem bloqueou o bot fica inativo. Veja a lista em **[Grupos e canais › Canais e grupos](/docs/telegram/chats/)**.

## Próximos passos

- Veja quem recebe e dê acesso de admin em **[Grupos e canais › Canais e grupos](/docs/telegram/chats/)**.
- Confira os **[módulos e preços](/docs/planos/modulos/)**.

---

# DOC: Aprovação automática de entrada nos grupos de WhatsApp
URL: https://botdoafiliado.com/docs/whatsapp/aprovacao-de-entrada/
Atualizado: 2026-11-08
Descrição: O Bot aprova sozinho quem pede para entrar nos seus grupos de WhatsApp e recusa números bloqueados e quem já está em outro grupo da mesma campanha.

Quando o grupo pede aprovação para entrar, alguém precisa aceitar cada pedido. A **Aprovação de entrada** faz isso por você: o Bot recusa quem está na sua lista de bloqueio ou já está em outro grupo da mesma campanha e aprova o resto, na hora.

## O que você ganha

- **Golpista não volta:** número bloqueado não entra, mesmo com o link na mão.
- **Vaga para gente nova:** quem já está no grupo 1 não ocupa vaga no grupo 2.
- **Nada de aprovar à mão:** quem responde os pedidos é o Bot.
- **Campanha medida certo:** a entrada aprovada conta para a campanha do clique.

## Antes de começar

Um número da sua conta precisa ser **admin do grupo**; sem isso o Bot não vê os pedidos. Só o dono ou admin da conta mexe nessa tela.

## Como configurar

1. Nos grupos da campanha, deixe **Aprovar quem entra pelo link** em **Sim**: em **Link de entrada › Como os grupos novos nascem › Permissões** nos grupos que a campanha cria, ou em **Administrar grupos › Padronizar grupos** nos que já existem ([Criar campanha](/docs/whatsapp/criar-campanha/)).
2. Abra **WhatsApp › Aprovação de entrada**.
3. Ligue **Aprovar sozinho** na linha **Padrão (campanhas sem regra própria)**.
4. Ligue também **Recusar quem está na lista de bloqueio** e **Recusar quem já está em outro grupo da campanha**.
5. Se já havia pedidos parados, clique em **Ler pedidos agora**.

<img src="/docs/whatsapp/aprovacao.webp" alt="Aba Aprovação de entrada da tela WhatsApp: a linha Padrão (campanhas sem regra própria) com as chaves Aprovar sozinho, Recusar quem está na lista de bloqueio e Recusar quem já está em outro grupo da campanha ligadas, o botão Ler pedidos agora no alto e Criar regra própria embaixo" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Lista de bloqueio

Cole os números em **Números**, um por linha, do jeito que tiver (com ou sem 55, com ou sem o 9). Em **Vale para**, escolha **Todas as campanhas** ou uma campanha. O **Motivo** é só para você lembrar. Cabem 500 números por vez e 5.000 no total; **Tirar** libera o número.

## Ajustes opcionais

- **Criar regra própria** dá a uma campanha recusas diferentes do padrão. **Seguir o padrão** desfaz.

## Como saber se funcionou

A tabela **Últimas decisões** mostra cada pedido com **Aprovado**, **Recusado** ou **Falhou** e o motivo. Na recusa por outro grupo, aparece **Já está em** e o nome do grupo.

## Se algo não der certo

- **Os pedidos não aparecem:** confira se um número da sua conta é admin do grupo.
- **Apareceu Falhou:** o WhatsApp não aceitou a resposta. O Bot tenta de novo sozinho.
- **Um grupo não é aprovado:** grupo trancado (pelo **Máximo de pessoas por grupo** ou à mão) e grupos da rede de aquecimento ficam de fora de propósito.

## Próximos passos

- Monte o link da campanha em **[Link de entrada e grupos](/docs/whatsapp/link-e-grupos/)**.
- Ajuste a campanha em **[Criar campanha](/docs/whatsapp/criar-campanha/)**.

---

# DOC: Link de entrada e grupos que crescem sozinhos no módulo WhatsApp
URL: https://botdoafiliado.com/docs/whatsapp/link-e-grupos/
Atualizado: 2026-11-08
Descrição: Um link só para divulgar na bio e nos anúncios: ele leva cada pessoa a um grupo com vaga e, quando todos lotam, o bot cria o próximo grupo sozinho.

O link de entrada é um endereço só da sua campanha para divulgar na bio, no perfil e nos anúncios. A cada clique, ele leva a pessoa para um grupo da campanha que ainda tem vaga. Quando todos lotam, o bot pode criar o próximo grupo sozinho.

## O que você ganha

- **Um link para sempre:** você divulga o mesmo link, mesmo quando os grupos mudam.
- **Grupo cheio não trava a entrada:** quando um grupo chega no máximo, ele tranca e as próximas pessoas vão para outro com vaga.
- **Próximo grupo nasce sozinho:** com nome numerado e a mesma foto.
- **Seu número fica escondido:** o link não mostra o seu número, o seu nome nem quais outros grupos existem.

## Antes de começar

- Uma campanha com pelo menos um grupo na seção **Destinos** ([Criar campanhas](/docs/whatsapp/criar-campanha/)).
- Um número conectado, se quiser que o bot crie grupos sozinho ([Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)).

## Como configurar

1. Em **Campanhas**, abra a campanha e vá na seção **Link de entrada**.
2. Ligue **Ativar link de entrada**.
3. Em **Máximo de pessoas por grupo**, escolha quantas pessoas cada grupo pode ter. Quando um grupo chega nesse número, ele tranca e sai do link, mas continua recebendo as ofertas.
4. Clique em **Salvar campanha**.
5. Em **Link de entrada salvo**, logo abaixo da chave **Ativar link de entrada**, clique em **Copiar link** e cole na sua bio, no perfil ou no anúncio.

<img src="/docs/whatsapp/link-de-entrada.webp" alt="Seção Link de entrada da campanha: a chave Ativar link de entrada ligada, o Máximo de pessoas por grupo em 1000, Criar grupos automaticamente quando lotar, o Endereço personalizado e o Link de entrada salvo com o botão Copiar link" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Os grupos do link são os mesmos da seção **Destinos** da campanha: a lista é uma só para as ofertas e para a entrada.

## Criar grupos sozinho quando lotar

1. Na seção **Link de entrada**, ligue **Criar grupos automaticamente quando lotar**.
2. Preencha **Nome base dos grupos** (ex.: "Ofertas"). Os grupos nascem "Ofertas 1", "Ofertas 2" e assim por diante.
3. Se quiser, envie a **Foto dos grupos (opcional)**: JPG, PNG ou WebP, até 10 MB.
4. Clique em **Salvar campanha**.

Funciona só para grupos de WhatsApp e precisa de um número conectado. Quando a campanha já manda ofertas para algum grupo do WhatsApp, o grupo novo também passa a receber as ofertas.

Para criar um grupo na hora, use **Criar grupo agora** (um a cada 2 minutos, até 10 por dia). Em **Como os grupos novos nascem**, você escolhe o número que cria os grupos, a descrição e as permissões. Por padrão, só os admins enviam mensagens, editam o grupo e adicionam pessoas.

## Ajustes opcionais

- **Endereço personalizado (opcional)**: um nome seu no link, de 3 a 64 letras, números ou hífens. Trocar o nome desativa o anterior.
- **Distribuição das entradas**: **Crescimento** enche um grupo de cada vez; **Balanceado** sorteia entre os grupos com vaga.
- **E-mail antes do convite**: pede o e-mail da pessoa, confirmado por um código, antes de mostrar o grupo. Para usar, preencha **Link da sua política de privacidade**.
- **Página e prévia do link**: o título, a descrição e a foto que aparecem quando o link é compartilhado.
- **Link por grupo**: um link para cada grupo, para medir cada anúncio ou público separado. Clique em **Link por grupo** para abrir a lista.

## Arrumar todos os grupos de uma vez

Na seção **Administrar grupos** da campanha, você mexe em todos os grupos de WhatsApp dela, um por vez, com intervalo:

- **Adicionar admins**: escolha quantos admins cada grupo deve ter ou quais números viram admin em todos.
- **Padronizar grupos**: aplica a todos o mesmo **Nome base**, foto, descrição e permissões. O que ficar em branco ou em **Manter como está** não muda.

O andamento aparece na própria seção e continua mesmo com a tela fechada. **Parar lote** interrompe.

## Como saber se funcionou

Abra o link copiado no celular: ele deve levar ao convite de um grupo da campanha. Na **Fila de destinos**, dentro de **Link de entrada**, você vê os grupos do link e se cada um está **Aberto**, **Lotado** ou **Trancado**. Na seção **Métricas**, **Cliques de pessoas** mostra quantos clicaram.

> **Atenção:** o link guarda um código no navegador da pessoa para reconhecê-la nas próximas visitas. Você responde pelos dados da sua campanha, então cite isso na sua política de privacidade. Quem não quiser ser reconhecido pode desligar em [ofertou.ai/privacidade](https://ofertou.ai/privacidade).

## Se algo não der certo

- **O link diz "grupos lotados":** todos os grupos estão cheios e o bot não pode criar outro (criação desligada, limite atingido ou nenhum número conectado). Ligue **Criar grupos automaticamente quando lotar**, aumente o **Máximo de pessoas por grupo**, adicione outro grupo na campanha ou reconecte o número.
- **O link diz "entrada temporariamente indisponível":** o WhatsApp demorou para confirmar a criação do grupo. Tente de novo em instantes. Se continuar, fale com o suporte.
- **Pausei a campanha e continua entrando gente:** **Pausar encaminhamentos** não desliga o link. Desligue **Ativar link de entrada** e clique em **Salvar campanha**.
- **Um número parou de enviar ofertas num grupo:** com **Só admins enviam mensagens** ligado, só número admin envia. Use **Adicionar admins** para torná-lo admin.

## Próximos passos

- **[Aprovação de entrada](/docs/whatsapp/aprovacao-de-entrada/)**: o bot aprova ou recusa cada pedido para entrar.
- **[Pessoas e resultados](/docs/referencia/trafego-campanhas/)**: quem entrou pelo link e de onde veio.
- **[Rastreio na sua landing](/docs/referencia/rastreio-na-landing/)**: medir as entradas a partir da sua página.

---

# DOC: Chats do bot no Telegram: conversas, grupos, canais e admins do bot
URL: https://botdoafiliado.com/docs/telegram/chats/
Atualizado: 2026-11-08
Descrição: Veja todas as conversas, grupos e canais do seu bot, saiba quem ainda recebe as mensagens e dê acesso de admin do bot a quem você confia.

A aba **Canais e grupos**, em **Grupos e canais**, mostra todas as conversas, grupos e canais em que o seu bot está, diz quem ainda recebe as mensagens e deixa você dar acesso de **admin do bot** a outras pessoas.

## O que você ganha

- **Tudo num lugar:** conversas privadas, grupos e canais do bot numa lista só.
- **Quem ainda recebe:** quem bloqueou o bot aparece como **Inativo**.
- **Ajuda de confiança:** um admin do bot pode usar os comandos de administrador, como `/broadcast` e `/feature`.
- **Atalho para a conversa:** **Abrir no Telegram** leva direto ao chat.

## Como tornar alguém admin do bot

1. Peça para a pessoa mandar `/start` ao bot no privado.
2. No painel, abra **Grupos e canais**, aba **Canais e grupos**.
3. Busque a pessoa em **Buscar por ID, nome ou @usuário**.
4. Na linha dela, clique em **Tornar admin**.

<img src="/docs/telegram/chats-lista.webp" alt="Aba Canais e grupos: o campo Buscar por ID, nome ou @usuário e a lista com Chat, Tipo, Situação e Função no bot; nas conversas privadas, os botões Tornar admin ou Remover admin e, em todas as linhas com @, Abrir no Telegram" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Para tirar o acesso, clique em **Remover admin** na mesma linha. A mesma lista aparece em **[Configurar › Perfil e acesso](/docs/comecando/configuracoes-do-bot/)**, no card **Bot principal**, em **Administradores adicionais**.

> **Atenção:** admin do bot não é o mesmo que admin do grupo no Telegram, nem que membro da equipe no painel. Os papéis do painel ficam em **[Equipe e papéis](/docs/comecando/equipe-e-papeis/)**.

## Como saber se funcionou

Na linha da pessoa, a coluna **Função no bot** passa para **Admin**.

## O que a lista mostra

- **Tipo:** **Canal**, **Grupo**, **Supergrupo** ou **Privado**.
- **Situação:** **Ativo** ou **Inativo**. Inativo quer dizer que a pessoa bloqueou o bot, a conta foi desativada ou o chat não existe mais. Volta a **Ativo** quando o chat manda algo ao bot. O **[Broadcast](/docs/telegram/broadcast/)** só envia para chats ativos.
- **Função no bot:** **Dono**, **Admin** ou **Usuário** (só em conversa privada).

## Se algo não der certo

- **A lista está vazia:** adicione o bot a um grupo ou converse com ele no privado.
- **A pessoa não aparece na lista:** peça para ela mandar `/start` ao bot no privado.
- **Não aparece o botão Tornar admin:** só o dono do bot dá esse acesso, e só em conversa privada. O botão também não aparece na linha do próprio dono.
- **Sem o botão Abrir no Telegram:** grupo ou canal privado sem @ não tem esse botão.

## Próximos passos

- Configure a proteção e o Porteiro dos grupos em **[Comunidade](/docs/telegram/comunidade-ia/)**.
- Mande uma mensagem para todos os chats com o **[Broadcast](/docs/telegram/broadcast/)**.

---

# DOC: Script do site: converter links de afiliado no seu site
URL: https://botdoafiliado.com/docs/api/script-do-site/
Atualizado: 2026-11-08
Descrição: Adicione conversão automática de links de afiliado ao seu site com uma chave do site travada por domínio — sem servidor próprio e sem expor a sua chave de API.

O **Script do site** adiciona **conversão automática de links de afiliado** ao seu site — sem servidor próprio e sem expor a sua chave de API. Ele encontra os links de loja na página e troca pelos **seus** links de afiliado.

> A **chave do site** é diferente da chave de API: ela é **travada por domínio** (só funciona nos sites que você autorizar) e serve apenas para converter links no navegador. Para integração de servidor para servidor, use a **[chave de API](/docs/api/autenticacao/)**.

## 1) Gerar a chave do site

No painel: Menu → **Configurar** → **API e IA (MCP)** → aba **Script do site**.

1. No card **Nova chave de site**, informe o **Nome (para você identificar)** (ex.: "Meu blog").
2. Liste os **Domínios autorizados**, um por linha (ex.: `meusite.com.br`). Só nesses domínios a chave funciona.
3. Clique em **Gerar chave** e **copie a chave agora** (ela não é mostrada de novo). O card **Chave criada — copie agora** traz a chave e o script pronto, com **Copiar chave** e **Copiar script**.

Em **Suas chaves de site**, cada chave mostra o prefixo, os domínios e o último uso, com **Editar** (nome e domínios) e **Revogar**.

<img src="/docs/api/script-do-site.webp" alt="Card Nova chave de site: o Nome (para você identificar) preenchido com Meu blog, dois sites em Domínios autorizados, um por linha, e o botão Gerar chave" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 2) Colar o script no site

Cole no `<head>` do seu site:

```html
<script src="https://app.botdoafiliado.com/embed/v1/affiliate.js?token=SEU_TOKEN" async></script>
```

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 `<a>`.

## 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 chave do site é **travada por domínio** — só funciona a partir dos domínios cadastrados.
- Não expõe a chave de API 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: Equipe e papéis no Bot do Afiliado: dono, admin e postador
URL: https://botdoafiliado.com/docs/comecando/equipe-e-papeis/
Atualizado: 2026-11-08
Descrição: Chame pessoas para ajudar no seu bot com um link de convite e escolha o que cada uma pode fazer: dono, admin ou postador.

Você pode chamar outras pessoas para trabalhar no seu bot e escolher o que cada uma pode fazer. Assim a equipe, ou um cliente, ajuda sem ter acesso a tudo.

## O que você ganha

- **Ajuda sem risco:** quem só posta ofertas não mexe na configuração nem na assinatura.
- **Convite por link:** a pessoa entra já com o papel certo, sem depender de e-mail.
- **Controle na sua mão:** troque o papel ou tire alguém quando quiser.

## Os três papéis

- **Dono**: faz tudo, inclusive **Plano e módulos**, gerenciar membros e excluir o bot.
- **Admin**: configura o bot (lojas, rotas próprias, comandos, respostas do bot) e opera. Não gerencia membros e só vê **Plano e módulos** se o dono ligar **Faturamento** para ele.
- **Postador** (o membro): cuida do dia a dia: **gerar link**, **promoções** e **cupons**. Vê as telas, mas não altera a configuração.

No menu, o postador vê **Início**, o grupo **Postar**, **Campanhas** e **WhatsApp**. **Grupos e canais**, **Anúncios Meta** e **Configurar** aparecem só para admin e dono. A regra vale no painel e na API: não dá para contornar.

## Como convidar alguém

1. No rodapé do menu lateral, abra **Conta e organização › Organização e membros**.
2. No cartão **Membros**, escolha o papel: **Postador — gera link e promoções** ou **Admin — configurar o bot**.
3. Se quiser, informe o e-mail. Use **+ Mais** para fazer vários convites de uma vez.
4. Clique em **Gerar link de convite**.
5. Em **Link de convite — copie e envie**, clique em **Copiar** e mande o link para a pessoa (pelo WhatsApp, por exemplo).

<video src="/docs/comecando/equipe-convidar.mp4" poster="/docs/comecando/equipe-convidar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: no cartão Membros, digitar o e-mail da pessoa, ver o seletor de papel, clicar em Gerar link de convite e chegar ao botão Copiar do link pronto" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/comecando/equipe-convidar.gif" alt="Vídeo: no cartão Membros, digitar o e-mail da pessoa, ver o seletor de papel, clicar em Gerar link de convite e chegar ao botão Copiar do link pronto" /></video>

## Como saber se funcionou

Ao abrir o link, a pessoa entra no bot já com o papel escolhido. Se não estiver logada, o convite vale assim que ela entrar na conta.

## Trocar o papel ou tirar alguém

Na tabela de membros, troque o papel pelo seletor da linha e confirme em **Promover** ou **Rebaixar**, ou clique em **Remover**. Só o dono convida e gerencia; o admin só vê a lista.

## Próximos passos

- Veja a tela completa em **[Organização e membros](/docs/comecando/organizacao/)**.
- Ainda montando o bot? Siga os **[Primeiros passos](/docs/comecando/primeiros-passos/)**.

---

# DOC: Pessoas e resultados: quem entrou pelas campanhas e de onde veio
URL: https://botdoafiliado.com/docs/referencia/trafego-campanhas/
Atualizado: 2026-11-08
Descrição: Veja quem entrou nos seus grupos por cada campanha, de onde veio (Meta, Google, TikTok), quanto tempo ficou e as comissões registradas no período.

A aba **Pessoas e resultados** mostra quem entrou nos grupos da organização escolhida pelas suas campanhas: por qual grupo, de onde veio, quanto tempo ficou e as comissões registradas no período.

## O que você ganha

- **Saber de onde vem o seu público:** cada entrada mostra a origem, como **Meta**, **Google**, **TikTok** ou **Orgânico**.
- **Ver quem fica:** a permanência mostra quanto tempo cada pessoa ficou no grupo.
- **Comissões por campanha:** as vendas registradas de cada campanha, separadas entre confirmadas, pendentes e prováveis.
- **Comparar campanhas:** filtre por campanha e por período.

## Como usar

1. No menu lateral, em **Comunidade e envio**, abra **Campanhas** e clique na aba **Pessoas e resultados**.
2. Escolha a **Campanha** (ou **Todas as campanhas**) e o **Período**: 7, 30 ou 90 dias.
3. Veja no resumo as **Pessoas distintas**, as **Entradas** e quantas estão **Com saída**.
4. Abra **Origens e comissões registradas** para ver de onde vieram as entradas e as comissões do período.
5. Desça até a lista para ver cada entrada, com o grupo, a campanha, a origem e a **Permanência**.

<img src="/docs/referencia/pessoas-e-resultados.webp" alt="Aba Pessoas e resultados da tela Campanhas: os filtros Campanha e Período, o resumo com Pessoas distintas, Entradas e Com saída, Origens e comissões registradas aberto com as origens Meta, Orgânico, Google e TikTok e as comissões Confirmada, Pendente e Provável, e a lista de entradas com grupo, origem e Permanência" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como ler os números

- **Origem:** vem com uma confiança, **Exata**, **Provável** ou **Desconhecida**. Veja o que cada uma quer dizer em [Como interpretar a atribuição](/docs/referencia/atribuicao-campanhas/).
- **Comissões:** aparecem em **Confirmada · vínculo exato**, **Pendente · vínculo exato** e **Atribuição provável**. Elas vêm das vendas importadas do Painel do Afiliado.
- **Permanência:** com saída, o tempo vai até a saída (**Saiu em**). **Sem saída registrada** conta desde a entrada até agora, sem garantir que a pessoa ainda está no grupo. **Inconclusiva** aparece quando não dá para saber com certeza a ordem de entrada e saída.

## Ainda em acesso restrito

As telas de tráfego pago (visão geral, captação e anúncios, grupos e retenção, atribuição, anúncios e configurações de vendas) ainda não aparecem para a sua conta.

## Próximos passos

- Entenda a origem de cada entrada em **[Como interpretar a atribuição](/docs/referencia/atribuicao-campanhas/)**.
- Monte uma campanha em **[Criar campanhas](/docs/whatsapp/criar-campanha/)**.
- Conte os cliques e ligue a Meta em **[Rastreio e destinos de eventos](/docs/referencia/rastreio-e-eventos/)**.

---

# 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/
Atualizado: 2026-11-08
Descrição: No seu grupo do Telegram, o bot troca o link do membro pelo seu e apaga convite de outro grupo. Com o módulo Grupos, o Porteiro decide quem entra e quem fala.

No seu grupo do Telegram, o bot troca o link que um membro posta pelo **seu link de afiliado** e apaga o que não pode ficar, como convite de outro grupo. Isso vem no **plano base**. Com o **módulo Grupos**, o **Porteiro** também decide quem entra no grupo e quem pode falar.

> **Plano:** a troca de links vem no plano base. O Porteiro, o anti-spam de bots, a **[reputação](/docs/telegram/reputacao/)** e os **[comandos personalizados](/docs/telegram/comandos/)** precisam do **módulo Grupos** ([módulos e preços](/docs/planos/modulos/)).

## O que você ganha

- **Comissão sua no grupo:** link de loja postado por um membro vira o seu link de afiliado.
- **Grupo sem divulgação dos outros:** convite de outro grupo (Telegram ou WhatsApp) e link que não converte são apagados.
- **Funciona até em mensagem editada:** link colocado depois, na edição, também é trocado.
- **Menos robô e spam** (módulo Grupos): o Porteiro barra quem não cumpre as suas regras.
- **Canal junto com o grupo** (módulo Grupos): só fala no grupo quem também está no seu canal.

## Como configurar

1. Use o comando **/adicionargrupo** para pegar o link de convite do bot.
2. Adicione o bot ao grupo como **administrador** (ele precisa disso para apagar e fixar mensagens).
3. Em **Grupos e canais**, aba **Canais e grupos**, no card **Links nos grupos**, deixe ligada a chave **Apagar link original no grupo**.

<img src="/docs/comecando/links-nos-grupos.webp" alt="Card Links nos grupos: a chave Apagar link original no grupo, ligada, com a explicação do que ela faz" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. Em **Configurar › Links sem loja**, ponha no card **Deixar passar sem converter** os sites que podem ficar no grupo sem conversão, como redes sociais e os seus canais.

## Porteiro: quem entra e quem fala

Precisa do **módulo Grupos**. Só o dono ou um admin da organização configura.

1. Abra **Grupos e canais**, aba **Proteção**, e escolha o grupo na lista.
2. No card **Porteiro**, em **Quem entra**, escolha uma opção:
   - **Entra direto e confirma o cadastro no seu site para falar:** para grupo público. A pessoa entra, lê as ofertas e só fala depois de confirmar o cadastro no seu site, a sua **[Vitrine](/docs/comecando/vitrine/)** (que precisa estar publicada com um nome).
   - **Pede para entrar e o bot aprova:** para link com aprovação. O bot aprova na hora ou depois que a pessoa aceita as regras.
   - **Sem porteiro na entrada (os admins decidem):** o bot não decide quem entra.
3. Em **Quem fala**, se quiser, marque **Para falar, também precisa estar no canal**, escolha o canal e clique em **Testar canal**.

<img src="/docs/telegram/grupos-porteiro.webp" alt="Card Porteiro de um grupo: em Quem entra, as três opções, com Sem porteiro na entrada marcada; em Boas-vindas, a caixa Dar boas-vindas a quem entra; em Quem fala, Para falar, também precisa estar no canal marcada, o canal escolhido e o botão Testar canal" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. Em **O que a pessoa aceita**, escreva as **Regras do grupo** (opcional).
5. Clique em **Salvar porteiro**, na barra fixa no fim da tela.

> **Atenção:** ao salvar uma mudança em **Quem entra**, os links de convite do Telegram das campanhas daquele grupo são trocados, e os antigos param de funcionar.

A confirmação no site e o pedido de entrada só funcionam em **supergrupo**. No pedido de entrada, o selo **Quem analisa os pedidos** precisa mostrar **Este bot analisa os pedidos**, e o pedido de entrada precisa estar ligado no **BotFather** (o bot oficial do Telegram onde você criou o seu bot), em **Join Request Queries**. Se faltar, o topo da aba **Proteção** avisa.

## Ajustes opcionais

- **Aviso para quem não está no canal:** escreva o seu texto. Os botões **Inserir** colocam o nome da pessoa e do canal.
- **Boas-vindas:** marque **Dar boas-vindas a quem entra**. Só a pessoa vê a mensagem, com o nome dela marcado.
- **Quando pausar:** **Na 1ª mensagem** (padrão) ou **Já na entrada**, para grupo sob ataque de robôs.
- **E-mail no Mini App:** peça o e-mail de quem pede para entrar (exige o **Link da sua política de privacidade**).
- **Punição automática**, em **Todos os grupos:** **IA lê e pune infratores** e **Banir quem aciona bot de spam**.
- **Listas do grupo**, abaixo do Porteiro: **Pessoas que pediram entrada** (com **Baixar CSV**), **Confirmados no site** e **Infratores**, com os botões **Banir** e **Desbanir**.

## Como saber se funcionou

Peça para alguém que não é administrador postar um link de loja no grupo. O bot apaga a mensagem e manda a versão com o seu link.

## Se algo não der certo

- **O bot não troca nem apaga nada:** ele precisa ser administrador do grupo. Lembre que mensagens de administradores são ignoradas, então teste com outra conta.
- **Troca o link, mas não apaga a mensagem:** confira a chave **Apagar link original no grupo**. Se o grupo usa a proteção da **[Comunidade](/docs/telegram/comunidade-ia/)**, o modo precisa estar em **Automático**.
- **Um link que deveria ficar foi apagado:** ponha o site em **[Deixar passar sem converter](/docs/telegram/whitelist/)**.
- **Testar canal deu erro:** o bot precisa ser administrador do grupo (apagar mensagens e banir) e do canal exigido. Com **[sub-bots](/docs/telegram/sub-bots/)**, basta o bot principal ser admin do canal.

## Próximos passos

- Entenda o **[Deixar passar sem converter](/docs/telegram/whitelist/)**.
- Veja a **[conversão automática](/docs/telegram/conversao-automatica/)**.
- Configure a proteção da **[Comunidade](/docs/telegram/comunidade-ia/)**.

---

# DOC: O que chega no WhatsApp: mídia, formatação, álbum, edição e o que não passa
URL: https://botdoafiliado.com/docs/whatsapp/o-que-chega/
Atualizado: 2026-11-08
Descrição: Texto, foto, vídeo, GIF, áudio e sticker do seu canal do Telegram chegam no WhatsApp com o link de afiliado preservado. Veja o que muda e o que fica de fora.

Quase tudo que você posta no canal do Telegram chega igual no WhatsApp: texto com formatação, foto, vídeo, GIF, áudio e sticker. Veja o que muda no caminho e o que fica de fora.

## O que você ganha

- **Link de afiliado nunca some:** link escondido atrás de uma palavra chega com o endereço visível.
- **Nada sai sem o seu código:** os links são convertidos antes de sair; se a conversão falhar, o post não sai.
- **Correção acompanha:** editou o texto ou a legenda de uma foto no Telegram, muda no WhatsApp.
- **Grupo sem enxurrada:** álbum chega como uma foto só.

## O que chega

- **Texto**, com negrito, itálico, riscado e links.
- **Foto**, **vídeo** e **GIF**, com a legenda.
- **Áudio**, **nota de voz** e **sticker** comum, sem legenda (o WhatsApp não aceita legenda neles).
- **Álbum:** vai a foto que leva a legenda, com a legenda.
- **Arquivo** (PDF, ZIP, planilha): o arquivo não vai; sai a legenda com "[Arquivo: nome]" no fim.

## O que não chega

- **Sticker animado**, **enquete**, localização e contato.
- **Posts antigos:** só sai o que for publicado depois de o bot virar administrador do canal.

O que fica de fora aparece em **WhatsApp › Envios**, no cartão **Últimos envios**, como **Descartado** e com o motivo.

## Editar e apagar

- **Editar:** texto e legenda de foto mudam no WhatsApp sem gastar envio. Legenda de vídeo, GIF e áudio e troca de foto ou vídeo não mudam.
- **Apagar:** em **Últimos envios**, clique em **Apagar para todos**, até cerca de 2 dias depois do envio. Se o canal também está no **[Puxador](/docs/telegram/userbot/)**, apagar no Telegram já apaga no WhatsApp.

## Ajustes opcionais

Na campanha, em **Regras**: **Converter links de afiliado** (desligado, o texto sai como está), as substituições de texto (maiúsculas e minúsculas contam) e o **Repassar** "só com imagem ou vídeo", que deixa passar só foto, GIF e vídeo. Veja [Criar campanha](/docs/whatsapp/criar-campanha/).

## Se algo não der certo

- **O post não saiu por falha na conversão do link:** confira a loja em **Configurar › Lojas** ([como ativar plugins](/docs/integracoes/ativar-plugin/)) antes de tentar de novo.
- **Ficou em dúvida se chegou:** o post pode ter chegado mesmo sem confirmação. Confira o grupo antes de clicar em **Reenviar**.

## Próximos passos

- Ligue o seu canal em **[Fontes do Telegram](/docs/whatsapp/conectar-telegram/)**.
- Resolva post que não saiu em **[Problemas comuns](/docs/whatsapp/problemas-comuns/)**.

---

# DOC: Erros e limites da API REST
URL: https://botdoafiliado.com/docs/api/erros-e-limites/
Atualizado: 2026-10-24
Descrição: A API do Bot do Afiliado responde 401 sem chave, 403 insufficient_scope quando o nível não cobre o endpoint e 400 com texto pronto para o usuário; no lote do /convert-links, o limite é 150 URLs e o que passa disso é ignorado.

A API do Bot do Afiliado usa três respostas de erro na chamada inteira: **`401`** sem chave válida, **`403 insufficient_scope`** quando o nível da chave não cobre o endpoint e **`400`** para corpo inválido ou conversão impossível. No lote do `/convert-links`, cada item falha sozinho, com `ok: false`. Veja também **[autenticação](/docs/api/autenticacao/)**.

## Erros da chamada

| HTTP | `error` | Significado |
|---|---|---|
| 401 | `invalid_api_key` (ex.: `/execute`) ou o texto "API key obrigatória (header X-API-Key)…" (`/convert` e `/convert-links`) | `X-API-Key` ausente ou inválida. No navegador, use uma **[Embed Key](/docs/api/script-do-site/)**. |
| 403 | `insufficient_scope` | A chave é válida, mas o **[nível](/docs/api/autenticacao/#níveis-de-permissão)** dela não cobre esse endpoint (ex.: chave de Leitura chamando `/convert-links`). |
| 400 | `url ou urls é obrigatório` | O corpo do `/convert-links` não trouxe nenhum link. |
| 400 | texto em português | Conversão impossível no `/convert` (ex.: "Ainda não tenho uma integração ativa para esse site…") ou `refresh` fora do Mercado Livre. |
| 5xx | erro inesperado | Falha de rede, indisponibilidade da loja ou exceção não tratada. |

## Erros por item (lote)

No modo batch do `/convert-links`, falha de conversão **não** derruba a chamada: o item traz `ok: false`, `affiliate_url: null`, `final_url: null` e `error`. O `error` vem em texto pronto para mostrar ao usuário, com uma exceção:

- **`conversion_returned_source_url`**: o conversor devolveu o próprio link de origem, sem prova de que a sua atribuição está nele. A API recusa em vez de entregar um link que não paga comissão. Amazon pode reaproveitar um link já gerado para a tag ativa.

No `/execute`, parcelamento incompleto ou inválido em `installments_overrides` volta como `status: "error"` com `error: "invalid_installments"`.

Textos que você pode encontrar: "Não consegui ler esse link…" (URL incompleta), "Esse link não parece seguro…" (destino recusado), "O Mercado Livre não permite link de afiliado para esta página…" (oferta, categoria ou cupom do ML) e o de integração inativa.

## Limites

| Limite | Valor |
|---|---|
| URLs por chamada no `/convert-links` | **150**; as que passam disso são ignoradas, sem erro |
| `history_limit` no `/product` | **1 a 50** (padrão 10); fora disso, o valor é trazido para a faixa |
| ASINs por chamada no `/amazon-prices` | **10** |
| Imagem na arte do `/promo-card` | **4 MiB**; a foto original (`raw: true`), **8 MiB**; SVG recusado |
| Resposta repetida | a mesma URL devolve a mesma resposta por 60 segundos no mesmo data center |

## Boas práticas

- Trate `success`/`ok` antes de usar `affiliate_url`/`final_url`.
- Repita só os itens que falharam e use lotes menores em caso de timeout.
- Implemente **backoff** em caso de 5xx.
- Não exponha a API key no cliente: no site, use a Embed Key travada por domínio.

---

# DOC: Página de Chat: ofereça o seu bot como um chat no navegador
URL: https://botdoafiliado.com/docs/comecando/pagina-de-chat/
Atualizado: 2026-11-08
Descrição: Crie grátis uma página de chat no estilo WhatsApp onde qualquer pessoa cola um link e recebe o seu link de afiliado, sem precisar do Telegram.

A **Página de Chat** é uma página pronta, no estilo WhatsApp, onde qualquer pessoa cola um link de produto e recebe de volta o **seu link de afiliado**. É o seu bot do Telegram funcionando no navegador, para quem não usa Telegram.

É **grátis** para todos os bots, e cada bot tem a sua.

## O que você ganha

- **Alcança quem não usa Telegram:** basta mandar o endereço da página.
- **Seu link sempre:** todo link colado ali sai com o seu código de afiliado. Comandos como /moedas, /oferta e /cupom também funcionam.
- **Com a sua cara:** título, foto, cores e mensagem de boas-vindas são seus.
- **Prévia bonita:** no AliExpress, a resposta vem como um card com foto, título, preço e o botão **Abrir oferta**.
- **Aparece no Google:** a página pode ser encontrada em buscas, usando o título e as boas-vindas que você escreveu.

## Como configurar

1. No menu, abra **Configurar** e, na seção **Vitrine**, clique em **Página de chat**. Ela abre na aba **Página de chat** da Vitrine.
2. No card **Endereço**, marque **Página de chat ativa (pública)**.
3. Em **Endereço**, escreva o nome da sua página, por exemplo `seubot`. Ela fica em `botdoafiliado.com/c/seubot`. O painel mostra na hora se está **disponível**.

<img src="/docs/comecando/pagina-de-chat.webp" alt="Card Endereço da página de chat: a caixa Página de chat ativa (pública) marcada e, em Endereço, o começo fixo botdoafiliado.com/c/ com o campo ofertasdodia e os botões Copiar e Abrir" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. No card **Aparência**, preencha o **Título (cabeçalho do chat)** e a **Mensagem de boas-vindas**.
5. Clique em **Salvar**.

> **Dica:** escreva nas boas-vindas as palavras que o seu público procura, como "cupom AliExpress" ou "desconto Shopee". Isso ajuda a página a aparecer no Google.

## Ajustes opcionais

- **Foto / logo:** use **Enviar foto** (até 5 MB). Sem foto, vale a foto de start do bot.
- **Tema (duas cores):** escolha as cores do topo e do balão. **Padrão WhatsApp** volta ao verde.
- **Link "Voltar" (URL https, opcional):** para onde o visitante volta, como o seu site.
- **Idioma da página:** **Português (Brasil)**, **English** ou **Español**.

Sem mensagem de boas-vindas, a página usa a mensagem de start do bot.

## Como saber se funcionou

Clique em **Abrir**, ao lado do endereço, e cole um link de produto no chat. Se voltar o seu link de afiliado, está funcionando. Use **Copiar** para pegar o endereço e divulgar.

## Colocar o chat no seu site

Depois que a página está ativa e salva, o painel mostra mais opções. Em todas, os links saem com o seu código.

- **Só o link:** divulgue `botdoafiliado.com/c/seu-endereco` na bio, nos grupos e onde quiser. Não precisa de mais nada.
- **Botão flutuante no seu site (embed):** copie o código que o painel mostra e cole no seu site. Aparece um botão que abre o chat.
- **Numa rota do seu site (página inteira):** copie o código do painel e cole numa página do seu site, como `seu-site.com/chat`. Funciona em qualquer hospedagem.
- **Domínio próprio:** deixa o chat num endereço seu, como `chat.seu-site.com` (veja abaixo).

### Domínio próprio

1. No card **Domínio próprio**, digite um subdomínio, como `chat.seu-site.com`, e clique em **Adicionar domínio**.
2. O painel mostra um registro **CNAME**. No site onde você cuida do seu domínio (Registro.br, GoDaddy, Hostinger, Cloudflare...), crie esse registro: tipo **CNAME**, nome `chat` e o valor que o painel mostra (use o botão **Copiar**).
3. Espere. O painel confere sozinho e mostra quando a página está no ar, com cadeado (https).

## Se algo não der certo

- **As opções de colocar no site não aparecem:** marque **Página de chat ativa (pública)**, preencha o endereço e clique em **Salvar**.
- **O endereço aparece em uso:** outro bot já usa. Escolha outro nome.
- **O domínio próprio não fica no ar:** a mudança no domínio leva de minutos a algumas horas. Use sempre um subdomínio (`chat.seu-site.com`), porque o domínio principal (`seu-site.com`) não funciona. Confira se não há outro registro com o mesmo nome.
- **Seu domínio está na Cloudflare:** deixe o registro como **DNS only** (nuvem cinza), não **Proxied** (nuvem laranja).

## Próximos passos

- Monte também a sua **[Vitrine](/docs/comecando/vitrine/)**, o seu site de ofertas.
- Conecte mais lojas em **[Integrações](/docs/integracoes/como-funcionam/)**.

---

# DOC: Anúncios Meta: investimento, orçamento e CPL
URL: https://botdoafiliado.com/docs/referencia/anuncios-meta/
Atualizado: 2026-11-08
Descrição: Veja num lugar só quanto cada anúncio da Meta gastou, o que trouxe e para onde leva, e pause ou mude o orçamento sem abrir o Gerenciador de Anúncios.

**Anúncios Meta** mostra, numa tela só, quanto cada campanha, conjunto e anúncio da Meta gastou, quantos resultados trouxe e quanto custou cada um. Dali você também pausa, ativa e muda o orçamento diário, sem abrir o Gerenciador de Anúncios.

## O que você ganha

- **Tudo num lugar:** investimento, resultados e custo por resultado (**CPL Meta**) da sua conta de anúncios.
- **O melhor anúncio em destaque:** o selo **Menor CPL** marca o que trouxe resultado mais barato.
- **Nenhuma venda perdida sem aviso:** a coluna **Para onde leva** mostra se o anúncio vai para o Bot e marca em amarelo o que vai direto para a Shopee sem rastreio, porque essa venda não volta para o anúncio.
- **Comissão de volta:** o cartão **Comissão pelo link do Pixel** mostra a comissão da Shopee que voltou pelo link rastreado do Pixel do Afiliado.
- **Ajuste rápido:** pause, ative ou mude o orçamento daqui. Nada muda na Meta sem você confirmar.

## Antes de começar

- Você precisa ser **dono** ou **admin** do bot. Membro não vê a tela.
- Tenha uma **conta de anúncios na Meta**.
- A ligação com a Meta é feita pelo **Pixel do Afiliado**. Se você ainda não tem conta lá, ela é criada grátis, com o mesmo login, no passo 2.

## Como configurar

1. No menu lateral, em **Comunidade e envio**, clique em **Anúncios Meta**.
2. No cartão **Conta da Meta**, clique em **Conectar com a Meta**. O Pixel do Afiliado abre em outra aba.
3. No Pixel do Afiliado, conecte a sua conta da Meta e escolha a conta de anúncios.
4. Volte ao Bot e clique em **Atualizar**.

## Como acompanhar

1. Em **Período**, escolha **Últimos 7 dias**, **Últimos 30 dias** ou **Últimos 90 dias**.
2. Em **Rastreio**, escolha **Só as que levam ao Bot** para ver só os anúncios que mandam gente para os seus grupos.
3. Confira os números do topo: **Investimento**, **Resultados da Meta**, **CPL Meta** (o investimento dividido pelos resultados) e **Comissão pelo link do Pixel**.
4. Clique na seta ao lado da campanha para abrir os conjuntos e os anúncios. Na coluna **Para onde leva**, o selo verde mostra que o anúncio vai para o Bot ou para o link rastreado do Pixel. Selo amarelo (**Shopee sem rastreio** ou **Rastreio quebrado**) pede troca do link.
5. Na coluna **Ações**, use **Pausar** ou **Ativar**. Para mudar o orçamento, clique no lápis (**Mudar o orçamento diário**), digite o valor e clique em **Salvar orçamento**. Toda mudança pede confirmação e vai direto para a Meta.

<img src="/docs/referencia/anuncios-meta.webp" alt="Tela Anúncios Meta com a Meta conectada: os filtros Período, Rastreio e Resultado, os cartões Investimento, Resultados da Meta, CPL Meta e Comissão pelo link do Pixel, o aviso amarelo de anúncio sem rastreio e a lista de campanhas aberta, com o selo Menor CPL, a coluna Para onde leva com os selos verdes do Bot e o amarelo Shopee sem rastreio, e os botões de pausar e o lápis do orçamento" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Atenção:** ao pausar, a Meta para a entrega na hora. Para voltar, clique em **Ativar** na mesma linha ou ative no Gerenciador.

## Ajustes opcionais

- **Resultado:** escolha qual resultado contar. Se a sua conta recebe a entrada no grupo, ela é o padrão. **O que cada conjunto otimiza** mostra o mesmo que a coluna Resultados do Gerenciador.
- **Por criativo:** junta o mesmo anúncio de todas as campanhas e deixa pausar ele em todas de uma vez.
- **Ocultar:** tira uma campanha da lista e dos totais, só neste navegador.
- Clique no nome de uma campanha, conjunto ou anúncio para abrir ele no Gerenciador de Anúncios.

## Como saber se funcionou

No topo do cartão **Conta da Meta** aparece **Meta conectada** com o número da conta, e as suas campanhas aparecem na lista. Depois de pausar ou mudar o orçamento, uma mensagem verde diz o que mudou na Meta.

## Se algo não der certo

- **Aparece Conexão Meta vencida:** clique em **Reconectar com a Meta** e entre de novo pelo Pixel do Afiliado.
- **Aparece Pixel fora da sua organização:** o Pixel do Afiliado e o bot precisam estar na mesma organização da Central do Afiliado. Clique em **Vincular na Central**.
- **Não aparecem os botões de pausar e de orçamento:** eles só valem na conta marcada **(a do Pixel)** em **Conta de anúncios**. Para usar outra conta, clique em **Trocar conta no Pixel**.
- **A mudança não entrou:** pausar e mudar o orçamento por aqui usam o plano Pro do Pixel do Afiliado, e só quem é dono ou admin da organização no Pixel pode fazer. O orçamento mínimo é 1,00 na moeda da conta.

## Próximos passos

- Para a Meta saber quem entrou no grupo e quem comprou, ligue o Pixel Meta na campanha e a API de Conversões: **[Rastreio e destinos de eventos](/docs/referencia/rastreio-e-eventos/)**.
- Quem entrou pelos seus links e de onde veio: **[Pessoas e resultados](/docs/referencia/trafego-campanhas/)**.

---

# DOC: Sub-bots: gerencie vários bots de afiliado no mesmo painel
URL: https://botdoafiliado.com/docs/telegram/sub-bots/
Atualizado: 2026-11-08
Descrição: Com os Sub-bots você coloca mais bots do Telegram no mesmo painel, todos com as configurações do bot principal, sem montar nada de novo. Grátis no plano base.

Com os **Sub-bots** você coloca mais de um bot do Telegram no mesmo painel. Todos usam as mesmas configurações do bot principal, então você não precisa montar nada de novo. Serve para separar a operação por **canal, cliente ou marca**.

> **Incluído no plano base:** sem custo extra. Confira em **Conta › Plano e módulos** se o plano base está ativo.

## O que você ganha

- **Nada para refazer:** o sub-bot já nasce com as configurações do bot principal.
- **Operações separadas:** um bot para cada canal, cliente ou marca.
- **Token protegido:** fica guardado com criptografia e não aparece no painel.

## Como configurar

1. No Telegram, crie um novo bot no **BotFather** (o bot oficial do Telegram que cria bots) e copie o **token** que ele entrega, um código longo que liga o bot ao painel.
2. No painel, abra **Configurar › Perfil e acesso** e clique em **Gerenciar sub-bots**, no fim da página.
3. Cole o token no campo **Token do Telegram (BotFather)**.
4. Clique em **Adicionar**. O nome é preenchido sozinho com o @ do bot, e ele já começa a responder.

<img src="/docs/telegram/sub-bots.webp" alt="Card Sub-bots: o campo Token do Telegram (BotFather) com o botão Adicionar, Permissões sugeridas em todos no topo e a lista com o bot principal e três sub-bots, cada um com Religar bot, Permissões sugeridas e Remover" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Ajustes opcionais

- **Permissões sugeridas:** o Telegram passa a sugerir as permissões certas (apagar mensagens, banir, convidar e fixar) quando alguém põe esse bot como admin de um grupo. **Permissões sugeridas em todos**, no topo do card, faz isso no principal e em todos os sub-bots.
- **Remover:** tira o sub-bot do painel.

## Como saber se funcionou

O sub-bot aparece na lista. Mande uma mensagem para ele no Telegram: ele deve responder.

## Se algo não der certo

- **Apareceu Token já cadastrado:** esse token já está em outro bot ou sub-bot. Crie outro bot no BotFather e use o token novo.
- **O sub-bot não responde:** clique em **Religar bot** na linha dele. O mesmo vale se aparecer um aviso pedindo isso logo ao adicionar.
- **O Porteiro de canal não funciona no grupo do sub-bot:** quem confere o canal é sempre o **bot principal**, então ele precisa ser admin do canal. O sub-bot só precisa ser admin do grupo. Veja **[Grupos](/docs/telegram/grupos/)**.

## Próximos passos

- Veja as outras opções em **[Perfil e acesso](/docs/comecando/configuracoes-do-bot/)**.
- Entenda como os tokens são protegidos em **[segurança e tokens](/docs/referencia/seguranca-e-tokens/)**.

---

# DOC: Módulo WhatsApp: preço por número, grupos e canais ilimitados
URL: https://botdoafiliado.com/docs/whatsapp/planos-e-limites/
Atualizado: 2026-11-08
Descrição: Módulo WhatsApp por R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, com grupos, canais e mensagens sem limite.

O módulo WhatsApp é cobrado por **conexão**, que é um número de WhatsApp conectado ao Bot. Você escolhe quantas quer, e grupos, canais e mensagens não têm limite.

> **Módulo pago:** **R$ 49,90/mês com a 1ª conexão grátis**, mais **R$ 29,90/mês por conexão adicional**. Soma-se ao plano base e aos outros [módulos](/docs/planos/modulos/) que você tiver.

## O que você ganha

- **Grupos e canais ilimitados** em cada número.
- **Sem cota de mensagens:** posts, edições e reenvios não são contados.
- **Sem cobrança por fonte:** quantos canais do Telegram quiser.
- **Ajuste quando quiser:** de 1 a 20 números.

## Quanto fica

- **1 conexão:** R$ 49,90/mês.
- **3 conexões:** R$ 109,70/mês.
- **20 conexões:** R$ 618,00/mês.

## Como mudar a quantidade de números

1. No menu lateral, clique em **Plano e módulos** (só o dono vê).
2. No módulo WhatsApp, ajuste **Números de WhatsApp (1 a 20)**.
3. Clique em **Atualizar plano**.

Com a assinatura ativa, a diferença é cobrada proporcional ao que falta do ciclo. Para assinar pela primeira vez, veja [como assinar](/docs/planos/como-assinar/).

Ao diminuir, os números que passam do novo total ficam pausados, sem perder a conexão. Escolha quais continuam em **WhatsApp › Números**, no cartão **Números a manter ativos**.

## Como saber se funcionou

A aba **Números** da tela **WhatsApp** mostra quantos números estão liberados e quantos você contratou.

## Se algo não der certo

- **Não consigo pôr mais um número para mandar ofertas:** você chegou ao limite (o **Vigia** não conta). Clique em **aumentar** no topo da tela ou desconecte um número que não usa.
- **Número fora do ar ainda ocupa vaga:** todo número cadastrado ocupa vaga. Use **Desconectar**, no menu **⋯** do cartão, para liberar.

## Próximos passos

- Cancele, troque o cartão ou veja faturas em **[Gerenciar assinatura](/docs/planos/gerenciar-assinatura/)**.
- Tire dúvidas no **[FAQ de cobrança](/docs/planos/faq-cobranca/)**.

---

# DOC: Referência interativa da API (Scalar)
URL: https://botdoafiliado.com/docs/api/swagger/
Atualizado: 2026-10-24
Descrição: A referência interativa da API do Bot do Afiliado fica em /docs/api/referencia/ (Scalar) e lê o contrato público /api/openapi.json, que não pede login; o /swagger antigo exige sessão do painel e responde 401 para o público.

A referência interativa da API do Bot do Afiliado fica em **[/docs/api/referencia/](/docs/api/referencia/)**, no **Scalar**, e lê o contrato público **`https://botdoafiliado.com/api/openapi.json`**. O contrato não pede login; testar um endpoint pede a sua **[API key](/docs/api/autenticacao/)**.

## Referência interativa da API

👉 **[Abrir a referência da API (Scalar) »](/docs/api/referencia/)**

A referência Scalar tem **busca** (atalho `Ctrl+K`), schemas de request/response, exemplos de código (cURL por padrão; troque para JavaScript, Python, PHP e outros no seletor) e **try it out** direto no navegador. A página monta o conteúdo no navegador: sem JavaScript, use o JSON abaixo.

### Atalhos por seção

| Seção | O que tem | Link direto |
|---|---|---|
| Conversão | `convert-links`, `convert` (legado) | [abrir »](/docs/api/referencia/#tag/conversao) |
| Produtos | `product`, `product/history`, `product/shipping`, `search-products`, `amazon-prices` | [abrir »](/docs/api/referencia/#tag/produtos) |
| Ofertas | `execute` (post pronto), `chat`, `templates` | [abrir »](/docs/api/referencia/#tag/ofertas) |
| Cupons | listar, cadastrar, desativar/reativar, categorias, ingestão | [abrir »](/docs/api/referencia/#tag/cupons) |

## O contrato OpenAPI

| O quê | Valor |
|---|---|
| Endereço | `https://botdoafiliado.com/api/openapi.json` |
| Login | nenhum |
| CORS | `access-control-allow-origin: *`, métodos `GET` e `OPTIONS` |
| Cache | `public, max-age=300` (5 minutos) |
| Autenticação declarada | `ApiKeyAuth`, header `X-API-Key` |

> 💡 Importe o contrato no **Postman/Insomnia** ou use-o para **gerar clientes** na sua linguagem (openapi-generator e afins).

## E o /swagger?

O `/swagger` e o `/swagger-data` são a documentação **interna** da API: só abrem com sessão do painel (ou a senha do ambiente) e respondem **401** para o público. Robôs e agentes de IA não devem usá-los: o `robots.txt` os fecha e o `llms.txt` aponta para a referência pública.

## 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`): na referência, use o campo **Auth** no topo para preenchê-la uma vez e testar qualquer endpoint.
3. Teste os endpoints **[convert-links](/docs/api/convert-links/)** e **[product](/docs/api/product/)**.

---

# DOC: Vitrine: o seu site público de ofertas, com link na bio
URL: https://botdoafiliado.com/docs/comecando/vitrine/
Atualizado: 2026-11-08
Descrição: Tenha grátis um site com as suas ofertas e o seu link de afiliado em cada uma, pronto para a bio do Instagram e do TikTok e para os grupos.

A **Vitrine** é o seu site de ofertas, em `botdoafiliado.com/v/seu-endereco`. Cada oferta aparece com foto, preço, cupom e um botão que leva à loja pelo **seu link de afiliado**. É o link para a bio do Instagram e do TikTok e para os grupos.

É **grátis** para todos os bots.

## O que você ganha

- **Link na bio pronto:** um endereço só, com todas as suas ofertas e cupons.
- **Seu link em cada oferta:** o botão de cada oferta leva à loja pelo seu link de afiliado.
- **Com a sua cara:** logo, capa, cores e nome do site são seus.
- **Ofertas entrando sozinhas:** o Puxador, a extensão e as campanhas do WhatsApp podem publicar direto na Vitrine.
- **Cupom vencido sai sozinho:** se o cupom está cadastrado em **[Cupons](/docs/telegram/cupons/)**, a Vitrine esconde o código quando ele esgota ou vence.

## Como configurar

1. No painel, abra **Configurar** e, na seção **Vitrine**, clique em **Site**.

<img src="/docs/comecando/vitrine-configurar.webp" alt="Seção Vitrine da tela Configurar: os itens Site, Aparência, Prévia do link, Links da bio, Posts, Página da oferta, Página de chat, Gerador de cupom Shopee, Alertas, Piloto do Afiliado e Domínio próprio" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. Na aba **Site**, no card **Seu site**, deixe **Vitrine ativa (pública)** ligada. Num site novo, ela já vem ligada.
3. Em **Endereço**, escreva o nome do seu site, de 3 a 32 caracteres (letras minúsculas, números e hífen).
4. Preencha **Nome do site**, **Bio** e **Logo** (quadrada, a partir de 256 px).
5. Na aba **Aparência**, escolha **Layout**, **Capa** e **Cores**. A **Prévia** logo abaixo mostra como fica no celular e no computador.
6. Clique em **Salvar**.

<video src="/docs/comecando/vitrine-ativar.mp4" poster="/docs/comecando/vitrine-ativar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Configurar, clicar em Site na seção Vitrine, conferir que Vitrine ativa está ligada, digitar o endereço e o nome do site, clicar em Salvar e ver o aviso Vitrine salva" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/comecando/vitrine-ativar.gif" alt="Vídeo: em Configurar, clicar em Site na seção Vitrine, conferir que Vitrine ativa está ligada, digitar o endereço e o nome do site, clicar em Salvar e ver o aviso Vitrine salva" /></video>

Use **Abrir página** para ver o site no ar, **Copiar link** para copiar o endereço e **Copiar link da bio** para copiar a página de links, que é a melhor para a bio.

> **Dica:** dê um **Nome do site**. Sem ele, a página aparece como **Ofertas & Cupons**, e a regra de cadastro do Porteiro não pode ser ligada.

## Adicionar ofertas

Na aba **Posts**, clique em **Adicionar post** e preencha:

1. **Título** e **Link da oferta** (obrigatórios). O link é o seu link de afiliado.
2. Se quiser: **Foto (link da imagem)**, **Preço (por)**, **Preço antigo (de)** e **Cupom (opcional)**.
3. Salve. A oferta aparece no site, com as mais novas primeiro.

A chave **No site** tira o post do site sem apagar. **Editar** e **Excluir** ficam na mesma linha.

Outras formas de publicar, sem digitar nada:

- **Extensão do Chrome:** capture o produto na loja e poste no canal; a oferta entra na Vitrine junto. Veja **[a extensão](/docs/comecando/extensao-chrome/)**.
- **Puxador:** ligue **Publicar na Vitrine ao aprovar** e cada oferta aprovada entra sozinha. Veja **[o Puxador](/docs/telegram/userbot/)**.
- **Campanhas do WhatsApp:** ligue **Publicar os posts das campanhas do WhatsApp**, no card **Seu site**.
- **API:** para quem integra com outro sistema. Veja a **[visão geral da API](/docs/api/visao-geral/)**.

## Ajustes opcionais

- **Links (estilo linktree):** na aba **Links da bio**, até 20 links. O link marcado em **É o “Entrar no grupo” do topo do site** vira o botão em destaque no topo.
- **Arquivar as ofertas depois de** (aba **Posts**): de **1 dia (padrão)** a **Nunca**. A oferta arquivada sai de "Ofertas do dia", mas o link dela continua funcionando.
- **Expiração padrão dos posts (dias)** (aba **Posts**): cada post novo some do site depois desse número de dias. Vazio, nunca expira.
- **Banners das lojas** (aba **Aparência**): uma arte sua no topo da página de cada loja, acima dos cupons (1600×400).
- **Capa Banner ou Logo com o nome** (aba **Aparência**): pedem uma imagem sua (Banner: 1600×400; Logo com o nome: PNG ou SVG com fundo transparente). Sem a imagem, o site mostra a capa **Faixa**.

## Prévia do link no WhatsApp

A prévia é o card com imagem, título e descrição que aparece quando alguém manda o seu link no WhatsApp, no Telegram ou nas redes. Ela fica na aba **Prévia** da Vitrine.

1. Envie a **Imagem da prévia (1200×630)**, deixando o que importa no centro.
2. Escreva o **Título da prévia** e a **Descrição da prévia**.
3. Clique em **Salvar**.

Se deixar vazio, a prévia usa a logo, o nome do site e a bio.

**Modelos das ofertas e cupons:** você também pode criar uma arte em que cada oferta entra sozinha com a foto, o preço e o cupom dela. Em **+ Novo modelo a partir de um pronto…**, escolha um modelo pronto, mude o que quiser (os botões embaixo do campo de texto inserem itens como {preco} e {cupom}), clique em **Ver a imagem de verdade** para conferir e depois em **Salvar**. Sem modelo, a prévia é a foto do produto.

## Domínio próprio

Coloca a Vitrine num endereço seu, como `sualoja.com.br`, com cadeado (https) automático. Salve a Vitrine com o endereço antes.

1. Na aba **Domínio**, no card **Domínio próprio**, digite o domínio e clique em **Adicionar domínio**.
2. No site onde você cuida do seu domínio, crie o registro **CNAME** com o valor que a tela mostra.
3. Clique em **Atualizar status**. Em poucos minutos o site fica no ar.

Pode ser o domínio principal ou um subdomínio. No domínio principal, se o seu provedor não aceitar CNAME, use o tipo **ALIAS** ou **ANAME** (na Cloudflare funciona direto).

## Mais comentados em JSON

Os **Mais comentados** do início do site também saem em JSON público, para você mostrar em outro site seu: `https://sualoja.com.br/destaques.json` no domínio próprio, ou `https://botdoafiliado.com/v/seu-slug/destaques.json` no endereço curto. Use `?n=` para escolher quantas ofertas, de 1 a 12 (padrão 6). Cada oferta traz título, loja, preço, foto, o endereço da página dela no seu site e quantos comentários teve nas últimas 24 horas. Qualquer site pode ler a resposta, que se atualiza a cada poucos minutos.

## Página da oferta e comentários

Cada oferta tem uma página própria, com a identidade da sua Vitrine. Na aba **Página da oferta**, em **Participação na conversa**, escolha **Permitir comentários**, **Somente leitura** ou **Desativar comentários**, e clique em **Salvar preferências das ofertas**. Os comentários acompanham a conversa do grupo no Telegram.

Para cuidar de denúncias, use **Revisar comentários denunciados**: **Manter comentário** ou **Remover comentário**.

## Como saber se funcionou

Clique em **Abrir página**. Se o site abrir com o seu nome e as ofertas que você adicionou, está no ar. Clique no botão de uma oferta e confira se a loja abre.

## Se algo não der certo

- **A página saiu do ar:** confira se **Vitrine ativa (pública)** está ligada e clique em **Salvar**.
- **A tela avisa que o endereço está em uso:** outro bot já usa. Escolha outro.
- **Uma oferta sumiu:** ela pode ter vencido. No painel, ela aparece com o selo **expirado** e o botão **Renovar**.
- **O cupom sumiu de um item:** o cupom está esgotado, vencido ou inativo em **Cupons**. O painel mostra o aviso no item; troque o código ou reative o cupom.

## Próximos passos

- Instale a **[extensão do Chrome](/docs/comecando/extensao-chrome/)** para publicar ofertas direto da loja.
- Ligue o **[Puxador](/docs/telegram/userbot/)** para as ofertas aprovadas entrarem sozinhas.
- Crie também a sua **[Página de Chat](/docs/comecando/pagina-de-chat/)**.

---

# DOC: Rastreio das campanhas e destinos de eventos (Meta e GA4)
URL: https://botdoafiliado.com/docs/referencia/rastreio-e-eventos/
Atualizado: 2026-11-08
Descrição: Saiba quais grupos trazem cliques e vendas, e mande esses resultados direto do bot para a Meta e o Google Analytics otimizarem os seus anúncios.

Aqui você escolhe como os links das ofertas saem nos grupos das campanhas e liga a Meta e o Google Analytics 4 (GA4). Assim você sabe quais grupos trazem cliques e vendas, e a Meta e o Google usam esses resultados para otimizar os seus anúncios.

> **Módulo pago:** os modos **Pelo ofertou.ai** e **Pela Vitrine** fazem parte do módulo **Rastreamento de vendas avançado** ([módulos e preços](/docs/planos/modulos/)). Sem ele, os links saem no modo **Direto**.

## O que você ganha

- **Cliques por grupo:** você vê quantas pessoas clicaram nas ofertas de cada grupo.
- **Cupom em um toque:** na página da oferta, a pessoa copia o cupom com um toque e segue para a loja.
- **Anúncios com dados reais:** a Meta e o GA4 recebem direto do bot quem entrou, quem clicou e quem comprou.
- **Só o que é certo:** venda provável não vai para a Meta nem para o GA4.
- **Configura uma vez:** o padrão da organização vale para todas as campanhas.

## Antes de começar

- Você precisa ser **dono** ou **administrador** da organização.
- Para mandar resultados para a Meta ou o GA4, tenha um **Pixel da Meta** ou uma propriedade do **Google Analytics 4**.

## Como configurar

### 1. Escolha como os links saem

São três modos:

- **Direto:** o link da própria loja. É o padrão, mas o clique não é contado.
- **Pelo ofertou.ai:** o link passa pelo ofertou.ai e segue para a loja. Conta os cliques de cada grupo.
- **Pela Vitrine:** na Shopee, no Mercado Livre e no AliExpress, abre a oferta na sua Vitrine, com a foto, o preço, o cupom para copiar e o botão da loja. Também conta os cliques.

Para escolher:

1. Abra **Configurar › Rastreio, eventos e webhooks**. A tela **Organização** abre na aba **Rastreio**.
2. No cartão **Rastreio das campanhas**, escolha o modo.
3. Em **WhatsApp**, deixe ligada a opção **Vitrine nos posts com cupom** (recomendada).
4. Clique em **Salvar padrão**.

### 2. Coloque o Pixel e o GA4 na campanha

1. Em **Campanhas**, abra a campanha e vá em **Rastreio › Tags da campanha**.
2. No cartão **Meta**, cole o número do seu pixel em **Pixel Meta**.
3. No cartão **Google Analytics 4**, cole o código que começa com **G-** em **GA4**.
4. Salve a campanha.

Cole só o número ou o código, não o código inteiro da tag.

### 3. Mande os resultados direto do bot

1. Em **Organização**, abra a aba **Eventos (Meta e GA4)**, onde fica o cartão **Destinos de eventos**.
2. No bloco **Meta (API de Conversões)**, preencha **ID do pixel (conjunto de dados)**, que é o número do seu pixel, e **Token da API de Conversões**. O token você gera na Meta, em **Gerenciador de Eventos › o seu pixel › Configurações › API de Conversões › Gerar token**.
3. No bloco **Google Analytics 4**, preencha **ID da métrica (G-…)** e **Chave secreta da API (Measurement Protocol)**. A chave fica no Google Analytics, em **Administrador › Fluxos de dados › o fluxo da Web › Chaves secretas da API do Measurement Protocol**.
4. Clique em **Salvar**.

## Ajustes opcionais

- **Exceções por loja:** dê um modo próprio para Shopee, Mercado Livre ou AliExpress.
- **Configuração própria desta campanha:** em **Rastreio › Links das ofertas** da campanha, use um modo diferente do padrão.
- **Configurar uma campanha com pixel ou GA4 próprio:** em **Destinos de eventos**, para a campanha que tem pixel ou GA4 só dela.
- **Enviar o e-mail confirmado (em hash):** no GA4, marque só se a coleta de dados fornecidos pelo usuário estiver ligada na sua propriedade.
- Cada tipo de resultado tem um interruptor no destino: desligue o que não quiser mandar.

## Como saber se funcionou

- **Links:** toque no link de uma oferta nova. No modo **Pelo ofertou.ai**, ele passa pelo ofertou.ai; no modo **Pela Vitrine**, abre a página com o cupom.
- **Meta:** no destino, cole o **Código de Testar eventos** da Meta e clique em **Enviar evento de teste**.
- **GA4:** clique em **Enviar evento de teste** e confira no **DebugView** do Google Analytics. O GA4 aceita o envio até com a chave errada, então só o DebugView prova que está certo.

> **Atenção:** a sua política de privacidade precisa dizer o que cada ferramenta recebe. Na seção **Rastreio** da campanha, **O que a sua política de privacidade precisa dizer** traz esse texto.

## Se algo não der certo

- **As opções aparecem com cadeado:** falta o módulo **Rastreamento de vendas avançado**. Clique em **Comprar módulo** para abrir **Plano e módulos** com ele em destaque.
- **Os posts antigos não mudaram:** é normal. O modo novo vale a partir do próximo post.
- **O selo diz Só no navegador:** falta o token ou a chave secreta no destino. Preencha e salve.
- **O selo diz Pausado por falhas:** o envio parou depois de muitas falhas seguidas, e o dono recebeu um aviso. Confira o token ou a chave, cole de novo em **Trocar credencial** e use **Reenviar falhas**.

## Próximos passos

- Entenda os números em **[Como interpretar a atribuição](/docs/referencia/atribuicao-campanhas/)**.
- Tem landing page própria? Veja **[Rastreio na sua landing](/docs/referencia/rastreio-na-landing/)**.
- Veja quem entrou e de onde veio em **[Pessoas e resultados](/docs/referencia/trafego-campanhas/)**.

---

# DOC: Comunidade IA no Telegram
URL: https://botdoafiliado.com/docs/telegram/comunidade-ia/
Atualizado: 2026-11-08
Descrição: Deixe a IA cuidar dos seus grupos do Telegram, apagando spam e golpe, e veja os feedbacks e relatos de compra dos membros organizados num só lugar.

A **Comunidade** usa IA para moderar os seus grupos do Telegram: ela apaga spam, golpe e outras mensagens proibidas e bane conforme as regras que você escolher. Também separa os feedbacks, relatos de compra, elogios e reclamações dos membros para você ler tudo num lugar só.

> **Módulo necessário:** a Comunidade faz parte do módulo **Grupos** e, por enquanto, atende só o Telegram.

## O que você ganha

- **Grupo limpo sem vigiar o dia todo:** no modo **Automático**, a IA apaga e bane conforme as regras.
- **Teste sem risco:** no modo **Observar**, você vê o que a IA faria sem ela mexer em nada.
- **Regras prontas para grupo de ofertas:** um botão configura todas as regras de uma vez.
- **Feedbacks organizados:** relatos de compra, elogios e reclamações ficam separados por filtro.
- **Pontos para quem ajuda:** feedback útil, mesmo negativo, pode render pontos de **[reputação](/docs/telegram/reputacao/)**.

## Antes de começar

- O bot precisa ser **administrador do grupo** no Telegram, com permissão para **apagar mensagens** e **banir membros**.
- A cobrança prevista da IA é só pelo uso, sem mensalidade extra: cada mensagem analisada conta uma vez, e cada foto lida conta mais uma. O modo **Observar** também consome. Acompanhe em **Plano e módulos › Consumo de IA**.

## Como configurar

1. No painel, abra **Grupos e canais** e clique na aba **Proteção**.
2. Escolha o grupo na lista **Grupo ou canal**. Dá para buscar por nome ou @.
3. Confira o card **Permissões do bot**. Se você mudou algo no Telegram, clique em **Verificar novamente**.
4. Em **Modo de proteção**, escolha **Observar** para testar ou **Automático** para a IA agir.
5. Clique em **Aplicar regras para ofertas**.

<img src="/docs/telegram/comunidade-protecao.webp" alt="Card Proteção deste grupo: em Modo de proteção, as opções Desligado, Observar e Automático, com Automático marcado; abaixo, Regras para grupos de ofertas com o botão Aplicar regras para ofertas e a linha que resume quantas regras estão em Revisar, Apagar mensagem e Apagar e banir" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

6. Se o grupo ainda não tem modo salvo, marque **Aplicar este modo à IA, à cobrança do canal e à limpeza deste grupo**.
7. Clique em **Salvar proteção**.

Cada grupo é configurado separado: a mudança vale só para o grupo escolhido, e grupo novo não entra sozinho.

### Os três modos

- **Desligado:** sem IA e sem a cobrança de inscrição no canal neste grupo.
- **Observar:** a IA registra na aba **Atividade** o que faria, sem apagar, banir nem avisar ninguém.
- **Automático:** a IA apaga e bane conforme as regras, e apaga e avisa quem fala no grupo sem estar inscrito no canal.

> **Atenção:** em supergrupos, banir alguém também apaga as mensagens dessa pessoa, por regra do Telegram. Desbanir depois não traz essas mensagens de volta.

## Ajustes opcionais

- **Personalizar regras:** escolha o que fazer em cada regra (como **Spam**, **Golpes** e **Pornografia**): **Ignorar**, **Revisar**, **Apagar mensagem** ou **Apagar e banir**.
- **CAS nas mensagens:** consulta uma base externa de reputação de contas ([Powered by CAS](https://cas.chat/)). Fica **Desligada**, em **Consultar como evidência** ou em **Banir quando listado e sem inscrição verificada**.
- **Bots confiáveis e convites permitidos:** até 100 bots e 100 convites liberados, um por linha.
- Em **Todos os grupos** ficam a **Punição automática nos grupos sem modo de proteção**, que vale para o bot inteiro, e a lista de **Infratores**.

## Ver feedbacks e relatos de compra

Na aba **Atividade**, escolha o grupo em **Grupo da atividade** e use os filtros **Feedbacks**, **Relatos de compra**, **Elogios**, **Reclamações** ou **Possíveis infrações**. A busca aceita nome, @ ou trecho da mensagem.

Em cada registro você pode **Abrir no Telegram**, **Marcar como revisada**, **Descartar análise** (devolve os pontos que ela deu) ou **Desbanir**. Um print de pedido indica uma possível compra, mas não prova pagamento nem entrega.

As análises ficam guardadas por 30 dias, e só os administradores do bot veem.

## Como saber se funcionou

Depois de salvar, espere chegar uma mensagem nova no grupo e abra a aba **Atividade**. A análise aparece lá. No modo **Observar**, o registro diz o que a IA teria feito e que nada foi feito no grupo.

## Se algo não der certo

- **Aparece "Módulo Grupos inativo":** ative o módulo **Grupos**. Sem ele, você ainda vê o histórico e pode desbanir, mas não muda a configuração.
- **Aparece "Análises de IA pausadas":** clique em **Ver consumo** para ver o motivo, como IA não liberada, falta de autorização de consumo ou limite atingido. O Porteiro e as regras automáticas continuam funcionando.
- **A IA não age no grupo:** confira no Telegram se o bot é administrador, com permissão para apagar mensagens e banir membros, e clique em **Verificar novamente**. Se o grupo exige inscrição num canal, o bot também precisa ser administrador desse canal.
- **Alguém foi banido por engano:** use **Desbanir** no registro. **Descartar análise** não desfaz o banimento.

## Próximos passos

- Configure o Porteiro de cada grupo em **[Grupos](/docs/telegram/grupos/)**.
- Ligue pontos e níveis para os membros em **[Reputação](/docs/telegram/reputacao/)**.

---

# DOC: Mensagens e variáveis: personalize os textos do bot
URL: https://botdoafiliado.com/docs/telegram/mensagens-e-variaveis/
Atualizado: 2026-11-08
Descrição: Mude os textos que o bot manda no Telegram, como a boas-vindas, e use variáveis como {nome} e {link} para cada mensagem sair com o nome da pessoa e o link certo.

Na tela **Respostas do bot** você muda os textos que o bot manda no Telegram, como a boas-vindas do **/start**, as respostas de comandos e os avisos. Com **variáveis**, como `{nome}`, o bot troca cada uma pelo dado real na hora de enviar.

## O que você ganha

- **Bot com a sua voz:** os textos falam do jeito do seu canal, não do jeito padrão.
- **Mensagem com o nome da pessoa:** `{nome}` chama cada um pelo primeiro nome.
- **Teste antes de salvar:** **Pré-visualizar** mostra como a mensagem vai ficar.
- **Post de oferta do seu jeito:** as variáveis de oferta montam o post em **[Aparência das ofertas › Texto e rodapé](/docs/telegram/ofertas/)**.

## Como editar um texto

1. No painel, abra **Configurar › Respostas do bot**.
2. Use **Buscar respostas…** para achar o texto que quer mudar.
3. Clique em **Editar** na linha.
4. Mude o texto na caixa. Para colocar uma variável, digite o nome dela entre chaves, como `{nome}`. Quando o texto tem **Variáveis mais comuns**, é só clicar no botão da variável.
5. Clique em **Pré-visualizar** para ver o resultado.
6. Clique em **Salvar**.

<img src="/docs/telegram/templates-editor.webp" alt="Janela da Mensagem de boas-vindas (/start): o texto com {nome} e {bot}, o botão Pré-visualizar e, embaixo, a prévia com o nome da pessoa e o nome do bot no lugar das variáveis" style="display:block;margin:18px auto;max-width:560px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Variáveis das mensagens

| Variável | O que aparece |
|---|---|
| `{nome}` | Primeiro nome da pessoa |
| `{@usuario}` | Menção clicável da pessoa |
| `{bot}` | Nome do seu bot |
| `{link}` | O link de afiliado gerado |
| `{titulo}` | Nome do produto, quando a loja informa |
| `{preco}` | Preço do produto, quando a loja informa |
| `{data}` e `{hora}` | Data e hora de Brasília |

Alguns textos têm variáveis próprias. Os botões em **Variáveis mais comuns** mostram as que valem para o texto aberto.

Modelo de boas-vindas para copiar:

```
Olá {nome}, seja bem-vindo ao {bot}!
Fique de olho: as ofertas chegam por aqui.
```

## Variáveis do post de oferta

Valem em **Configurar › Aparência das ofertas**, aba **Texto e rodapé**. O editor mostra como botões só as que funcionam no formato aberto.

| Variável | O que aparece |
|---|---|
| `{titulo}` | Nome do produto |
| `{linhadopreco}` | A linha do preço pronta: com preço riscado quando há preço anterior e com parcelas quando houver. Some sem preço. |
| `{linhadocupom}` | A linha do cupom pronta, com o código ou o link de resgate. Some sem cupom. |
| `{link}` | O seu link de afiliado |
| `{cta}` | A chamada, como *Compre aqui 👇*. Só aparece onde você colocar. |
| `{footer}` | O rodapé, geral ou da loja |
| `{itens}` | A lista de produtos, num post com vários itens |

Modelo de post de 1 produto para copiar. Cada linha se ajusta sozinha, com ou sem preço riscado e com ou sem cupom:

```
{cta}

➡️ <b>{titulo}</b>

{linhadopreco}
{linhadocupom}

🛒 {link}

{footer}
```

<img src="/docs/telegram/customizar-formato.webp" alt="Card Editar o formato: o seletor Formato que deseja editar em 1 produto, as variáveis em botões verdes, o editor com o modelo acima e a Prévia do rascunho com a foto e o post do produto" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Colocar o preço anterior riscado

1. Em **Configurar › Aparência das ofertas**, aba **Texto e rodapé**, abra o formato **1 produto** (ou **Item da lista**) e troque a linha de preço por `{linhadopreco}`. Se aparecer o atalho **Usar linha de preço**, ele faz a troca.
2. Abra **Ajustar os dados da prévia**, preencha **Preço anterior (riscado)** e confira a prévia.
3. Clique em **Salvar** em cada formato que você mudou.

> **Atenção:** não deixe a linha de preço antiga junto de `{linhadopreco}`, senão o preço sai repetido. O riscado só aparece quando o preço anterior é maior que o de venda.

Para conferir com um produto de verdade, cole o link em **Teste com sua oferta**. A prévia mostra imagem, título e preço, sem salvar nem publicar.

<img src="/docs/telegram/customizar-preview.webp" alt="Prévia do rascunho com um produto de verdade: foto, título, preço anterior riscado, preço de venda, parcelas, cupom, link e rodapé" style="display:block;margin:18px auto;max-width:600px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

Depois de salvar a boas-vindas, mande **/start** para o seu bot no Telegram. A mensagem nova tem que aparecer com o seu nome no lugar de `{nome}`.

## Se algo não der certo

- **A variável sumiu na mensagem:** ela foi escrita errada ou não existe naquele texto, e por isso virou vazio. Copie o nome da tabela acima ou use os botões, quando houver.
- **Não acho o texto do post de oferta:** ele não fica aqui, e sim em **[Aparência das ofertas › Texto e rodapé](/docs/telegram/ofertas/)**.

## Próximos passos

- Monte o post de oferta em **[Aparência das ofertas › Texto e rodapé](/docs/telegram/ofertas/)**.
- Use variáveis nos **[comandos personalizados](/docs/telegram/comandos/)** e no **[broadcast](/docs/telegram/broadcast/)**.

---

# DOC: Reputação no grupo: pontos, níveis e votos +1/−1 no Telegram
URL: https://botdoafiliado.com/docs/telegram/reputacao/
Atualizado: 2026-11-08
Descrição: Dê pontos e níveis aos membros do seu grupo no Telegram, deixe eles votarem uns nos outros com +1 e o bot posta sozinho o Top 10 da semana.

A **reputação** dá pontos e níveis aos membros do seu grupo no Telegram. Quem participa sobe de nível, e os próprios membros premiam uns aos outros respondendo uma mensagem com **+1** ou 👍.

> **Módulo necessário:** a reputação faz parte do módulo **Grupos** e vem **desligada**.

## O que você ganha

- **Grupo mais participativo:** cada mensagem rende XP e o membro sobe de nível.
- **Quem ajuda é reconhecido:** os colegas dão pontos com um +1.
- **Top da semana sozinho:** todo domingo à tarde o bot posta o Top 10 onde você escolher.
- **Incentivo para compartilhar:** quem posta um link que o bot converte no grupo ganha pontos extras.
- **Você no controle:** ajuste pontos à mão e veja cada voto no histórico.

## Como configurar

1. No painel, abra **Grupos e canais** e clique na aba **Reputação**.
2. Ligue **Sistema de reputação ativo**.
3. Se quiser, ligue **Anunciar no grupo quando alguém sobe de nível**.
4. Para o Top da semana, ligue **Postar o Top 10 da semana (domingo à tarde), com o que cada membro ganhou na semana** e adicione os grupos e canais em **Onde postar o Top da semana**.

<img src="/docs/telegram/reputacao.webp" alt="Aba Reputação: no card Como funciona, as chaves Sistema de reputação ativo, Anunciar no grupo quando alguém sobe de nível e Postar o Top 10 da semana, ligadas; abaixo, o card Onde postar o Top da semana com um grupo na lista e os botões Adicionar dos outros canais e grupos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

5. Clique em **Salvar**, na barra que aparece no fim da tela.

## Como funciona no grupo

- **Votar:** responda a mensagem da pessoa com `+1`, 👍 ou 👏 para dar ponto, ou com `-1` ou 👎 para tirar. Com texto junto ("👍 valeu"), não é voto.
- **Limite:** membro comum vota 1 vez por semana. Admin do grupo vota sem limite. Ninguém vota em si mesmo nem em bots.
- **XP e nível:** cada mensagem dá XP (padrão: 1 a cada 10 minutos por pessoa). O XP define o nível: Iniciante, Membro, Ativo, Veterano e Lenda. XP não vira reputação.
- **Ranking:** soma XP e reputação. Quem participa todo dia sobe, e os votos dos colegas somam por cima.
- **`/reputacao`** (ou `/rep`): mostra os seus pontos e nível, ou os da pessoa respondida. **`/reputacao top`** mostra os 10 melhores.
- **`/perfil`:** responde com um card com nome, nível, pontos e quanto falta para o próximo nível. Também funciona respondendo a mensagem de alguém.

## Ajustes opcionais

- **Pontuação:** **XP por atividade (mensagem no grupo)**, **Peso do voto (+1/−1 aplica ± este valor)**, **Intervalo entre votos de um membro (dias)** (0 = sem limite) e **Bônus por compartilhar oferta (pontos)**.
- **Decaimento mensal (%):** todo dia 1 os pontos caem essa porcentagem, para o ranking seguir disputado.
- **Alerta anti-brigada (votos −1 em 24h):** avisa no painel quando alguém recebe muitos votos negativos, para você conferir e devolver os pontos se for abuso.
- **Níveis:** troque nomes e pontos mínimos de cada faixa (até 20) e crie novos com **Adicionar nível**.
- **Ranking:** use **+1** e **−1** em cada linha, ou o **ID do Telegram** e os **Pontos (+ ou −)** (ex.: 10 ou -5) com **Aplicar**. Os textos que o bot responde ficam em **Configurar › Respostas do bot** (veja **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**).

## Como saber se funcionou

No grupo, responda a mensagem de outro membro com `+1`. O bot confirma na hora, com o total de pontos e o nível.

## Se algo não der certo

- **Respondeu 👍 e o bot não falou nada:** no voto por emoji, o bot só responde quando o voto conta. A pessoa pode já ter votado na semana ou ter respondido a um bot, a um post do canal ou a si mesma. Com `+1`, o bot explica por que não contou.
- **Grupo com Tópicos:** só vale responder a uma mensagem. Mensagem solta no tópico não é voto.
- **O Top da semana não saiu:** confira se há grupos em **Onde postar o Top da semana**. Com a lista vazia, o bot não posta. Quem não ganhou nada na semana não aparece.
- **A mudança não valeu:** clique em **Salvar** na barra do fim da tela. **Descartar** volta ao que estava salvo.

## Próximos passos

- Deixe a IA moderar o grupo com a **[Comunidade IA](/docs/telegram/comunidade-ia/)**.
- Veja tudo o que o módulo faz em **[Grupos](/docs/telegram/grupos/)**.

---

# DOC: Seguidores dos canais de WhatsApp
URL: https://botdoafiliado.com/docs/whatsapp/canais/
Atualizado: 2026-11-08
Descrição: Veja quantos seguidores cada canal do WhatsApp tem e quanto ele ganhou ou perdeu em 24 horas e em 7 dias, direto no painel.

Em **WhatsApp › Canais** você vê, para cada canal do WhatsApp que os seus números seguem ou administram, quantos **Seguidores** ele tem e quanto ganhou ou perdeu em 24 horas e em 7 dias.

## O que você ganha

- **Crescimento à vista:** o total de seguidores e o saldo de 24 horas e de 7 dias.
- **Histórico:** a evolução por dia ou por hora, em até 30 dias.
- **Quem manda ofertas:** cada cartão mostra quais campanhas mandam ofertas para o canal (**Recebe ofertas de**).

## Como ver

1. Abra **WhatsApp › Canais**.
2. No cartão do canal, veja **Seguidores**, **Saldo 24 h** e **Saldo 7 dias**.
3. Para o histórico, clique em **Ver série**, escolha o **Período** (24 horas, 7 ou 30 dias) e **Agrupar por** **Dia** ou **Hora**.

<img src="/docs/whatsapp/canais.webp" alt="Aba Canais da tela WhatsApp com dois cartões de canal: cada um mostra Seguidores, Saldo 24 h e Saldo 7 dias, o selo Seu número é admin ou Seu número só segue, o Recebe ofertas de e o botão Ver série" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como ler os números

- **Saldo** compara duas medições. Não é o número de inscrições novas.
- Um traço **—** quer dizer que ainda não há medição suficiente. **0** é saldo zero de verdade.
- **Seu número é admin** ou **Seu número só segue** mostra a relação do seu número com o canal. Só canal em que o seu número é admin pode receber ofertas.

## Se nenhum canal aparecer

- Clique em **Atualizar grupos e canais** no cartão do número, na aba **Números**.
- Com a assinatura pausada, a aba fica desligada até você reativar.

## Próximos passos

- **[Criar campanhas](/docs/whatsapp/criar-campanha/)**: mande ofertas para o seu canal.
- **[Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)**: conecte o número que administra o canal.

---

# DOC: Equipe e segurança no módulo WhatsApp: quem pode mexer e como o número é protegido
URL: https://botdoafiliado.com/docs/whatsapp/equipe-e-seguranca/
Atualizado: 2026-11-08
Descrição: Veja quem da sua equipe pode mexer nos números, campanhas e fontes do WhatsApp, e como o Bot protege o seu número e as suas conversas.

No módulo WhatsApp, só o dono e os administradores mexem em números, campanhas e fontes. Os outros membros da equipe veem tudo, mas não mudam nada. O acesso ao seu número fica guardado de forma protegida e não aparece na tela.

## O que você ganha

- **Controle de quem mexe:** só você e os administradores alteram o que importa.
- **Equipe sem susto:** quem só acompanha não consegue mudar nada.
- **Suas conversas ficam com você:** as mensagens que chegam no número não são guardadas.

## Quem pode fazer o quê

- **Dono e administrador:** conectam e desconectam números, escolhem a função de cada um, editam campanhas e fontes, reenviam e apagam envios e controlam o aquecimento.
- **Membro:** só vê. Na tela Campanhas aparece **Somente leitura. O dono ou administrador pode editar campanhas.**

Para convidar alguém, veja **[equipe e papéis](/docs/comecando/equipe-e-papeis/)**. Ao tirar a pessoa da equipe, o acesso dela sai junto.

## Escolher a função de cada número

Em **WhatsApp › Números**, no cartão do número, escolha a **Função**: **Envia ofertas**, **Cria grupos e envia ofertas**, **Só cria grupos**, **Segurança: só admin** (fica de admin nos grupos, sem mandar ofertas nem criar grupos) ou **Vigia: apaga post de quem não é admin (grátis)**. Número novo, depois do primeiro, entra como **Vigia**.

Para pôr um número como admin em vários grupos de uma vez, use **Administrar grupos › Adicionar admins** ([Link de entrada e grupos](/docs/whatsapp/link-e-grupos/)).

## Como o seu número fica protegido

- O número entra como **aparelho vinculado** do WhatsApp. Para desligar, remova em **Aparelhos conectados** no celular.
- O acesso ao número fica guardado de forma cifrada e não aparece na tela ([segurança e tokens](/docs/referencia/seguranca-e-tokens/)).
- O Bot só acompanha quem entra e sai dos grupos, para contar as pessoas.

Quando um número cai, o dono recebe o aviso **Número desconectado** por e-mail e Telegram, e o **Número reconectado** quando ele volta ([Incidentes e notificações](/docs/whatsapp/incidentes-e-alertas/)).

## Boas práticas

- Use um número **só para a operação**, nunca o pessoal.
- Tenha **mais de um número** nos grupos importantes: se um cair, o outro assume ([Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)).
- Convide só quem opera: dono e administrador podem desconectar números.

---

# DOC: Webhooks de saída: receba os eventos do Bot no Make, n8n, Zapier ou no seu servidor
URL: https://botdoafiliado.com/docs/api/webhooks/
Atualizado: 2026-10-21
Descrição: Como cadastrar uma URL HTTPS e receber um POST assinado quando um lead entra ou sai, um convite quebra, um número cai, uma campanha fica sem grupo aberto ou um envio falha.

Um webhook de saída é uma URL sua que o Bot chama, com um `POST` em JSON, toda vez que acontece algo que você assinou. Serve para automações no Make, n8n e Zapier, ou para o seu próprio servidor.

## Cadastrar

O cartão **Webhooks** fica em **Organização**: no menu **Conta e organização** (rodapé do menu lateral), abra **Organização e membros**. O administrador chega pela busca (**Ctrl+K** → **Ir para Organização**). Veja [Organização](/docs/comecando/organizacao/).

1. Clique em **Novo webhook**.
2. Em **URL (https)**, cole o endereço. Só `https://` público: porta, IP, usuário e senha na URL e endereços internos não são aceitos.
3. Marque os eventos, um a um, ou **Todos os eventos**.
4. Clique em **Cadastrar**.

Cada organização pode ter até 5 webhooks; o cartão mostra quantos estão em uso. Só dono e administrador criam, editam, testam e apagam. Sem o módulo Conexão IA e API, o cartão mostra **Webhooks fazem parte do acesso à API**.

Na criação o Bot mostra o **secret uma única vez**, com **Copiar** e **Já guardei**. Guarde-o: é com ele que você confere a assinatura. Se perder, use **Gerar outro segredo**: o novo também aparece uma vez só.

## Gerenciar

Cada webhook mostra a URL, os eventos, o último HTTP e um selo de estado: **Ativo**, **Pausado**, falhas seguidas ou **Desativado por falhas**. O interruptor **Webhook ativo** pausa e religa. Os botões:

- **Últimas entregas**: abre a tabela das últimas 20 entregas.
- **Testar**: manda um `webhook.teste` só para aquele webhook e mostra o resultado.
- **Editar**: troca a URL e os eventos; **Salvar** ou **Cancelar**.
- **Gerar outro segredo**: troca o secret.
- **Apagar**: pede confirmação em **Apagar de vez?** → **Sim, apagar**.

## Eventos

| Evento | Quando dispara |
|---|---|
| `lead.entrou` | alguém entrou num grupo acompanhado (Telegram ou WhatsApp) |
| `lead.saiu` | alguém saiu ou foi removido |
| `grupo.convite_invalido` | o link de convite do grupo parou de funcionar |
| `grupo.suspenso` | o WhatsApp suspendeu o grupo |
| `grupo.recuperado` | o grupo voltou a operar |
| `numero.caiu` | um número do WhatsApp desconectou |
| `numero.voltou` | o número reconectou |
| `campanha.sem_grupo_aberto` | a campanha não tem grupo com vaga para receber quem clicou |
| `campanha.pausada` | a trava de segurança pausou a campanha: o mesmo conteúdo chegou 10 vezes em 10 minutos, sinal de laço entre chats |
| `envio.falhou` | um envio da fila do WhatsApp esgotou as tentativas |
| `oferta.clicada` | uma pessoa clicou numa oferta sua (link curto ou página de cópia); robôs e prévias de link não entram |
| `venda.atribuida` | uma venda casou com um clique seu ou com o código do grupo; venda com mais de 7 dias não sai |
| `venda.estornada` | a loja cancelou uma venda que já tinha saído para este webhook |
| `lead.email_confirmado` | alguém confirmou o e-mail pelo código no porteiro de entrada; o e-mail não vai no evento |
| `lead.ficou_30d` | alguém completou 30 dias no grupo sem sair, em grupo que o bot acompanha |

Assinar `*` recebe todos, inclusive os que forem criados depois. O botão **Testar** manda um `webhook.teste` só para aquele webhook.

## O que chega

```
POST https://sua-url
content-type: application/json
x-bot-event: lead.entrou
x-bot-delivery: whd_9f3c…
x-bot-timestamp: 1789900000
x-bot-signature: sha256=…

{"id":"whd_9f3c…","evento":"lead.entrou","workspace_id":"7","ocorrido_em":"2026-09-16T12:00:00.000Z","dados":{"grupo_id":"…","campanha_id":"…"}}
```

Responda `2xx` em até 10 segundos e processe depois. Redirecionamentos não são seguidos: cadastre a URL final. A mesma entrega pode chegar mais de uma vez se a sua resposta se perder na rede; use o `x-bot-delivery` para não processar em dobro (em preparação: o mesmo fato passa a ter sempre o mesmo `x-bot-delivery`). Entradas e saídas trazem apenas identificadores internos, nunca telefone.

## Conferir a assinatura

`x-bot-signature` é `sha256=` seguido do HMAC-SHA256, em hexadecimal, do texto `timestamp + "." + corpo cru`, usando o secret do webhook. O timestamp é o do cabeçalho `x-bot-timestamp` e muda a cada tentativa.

```js
import crypto from 'node:crypto';
const ts = req.get('x-bot-timestamp');
const esperado = 'sha256=' + crypto.createHmac('sha256', SECRET).update(`${ts}.${corpoCru}`).digest('hex');
const ok = crypto.timingSafeEqual(Buffer.from(esperado), Buffer.from(req.get('x-bot-signature') ?? ''));
```

No Make, n8n e Zapier o módulo "Webhook" recebe o corpo direto; a assinatura é opcional lá.

## Reentregas e pausa

| Resposta | O que o Bot faz |
|---|---|
| `2xx` | entrega concluída |
| `410 Gone` | desativa o webhook na hora |
| outro status, redirecionamento, timeout ou erro de rede | tenta de novo em 1 min, 5 min, 30 min e 2 h; a quinta tentativa é a última |
| 20 falhas seguidas | pausa o webhook e avisa o dono uma vez |
| venda cancelada antes de a entrega sair | a `venda.atribuida` não é enviada |

Religar o webhook no painel zera a contagem. Em **Últimas entregas**, cada linha mostra **Evento**, **Status**, **Tentativas**, **Resposta**, **Quando** e **Próxima tentativa**. O corpo enviado não aparece na tela.

Os avisos de queda do webhook (**Webhook desativado por falhas**) e os canais em que cada aviso operacional sai pelo webhook se escolhem em [Notificações](/docs/whatsapp/incidentes-e-alertas/).

---

# DOC: Extensão do Chrome: capture produtos e poste ofertas sem sair da loja
URL: https://botdoafiliado.com/docs/comecando/extensao-chrome/
Atualizado: 2026-11-08
Descrição: Viu um produto bom? Com a extensão do Chrome você gera o seu link, o texto e a foto da oferta num clique e posta nos seus canais sem sair da loja.

A **extensão do Chrome** põe o Bot do Afiliado do lado da loja que você está vendo. Achou um produto bom, abre o painel lateral, clica em **Gerar oferta desta página** e sai com o seu link, o texto da oferta e a foto prontos para postar.

A extensão funciona sem módulo pago. Para postar direto nos canais no formato do seu bot, você precisa do módulo **Ofertas**.

## O que você ganha

- **Oferta pronta num clique:** link de afiliado, texto formatado e foto, sem copiar nada da loja.
- **Todas as suas lojas:** funciona em qualquer loja conectada no seu bot.
- **Posta de onde estiver:** manda para os seus canais e, junto, para a sua **[Vitrine](/docs/comecando/vitrine/)**.
- **Login das lojas sempre em dia:** mantém conectados no bot os plugins da Amazon e do Mercado Livre, sem você colar nada.
- **Preço completo:** traz o preço, o preço riscado e o parcelamento que a página mostra.

## Instalar

1. Abra a **[extensão na Chrome Web Store](https://chromewebstore.google.com/detail/bot-do-afiliado-%E2%80%94-postador/ngfhfiffemmlmnlpcolaibfagekidcaa)** e clique em **Usar no Chrome** › **Adicionar extensão**.
2. Fixe o ícone azul com **B** na barra do navegador.

Pela Chrome Web Store ela se atualiza sozinha. Funciona também no Edge.

**Sem a Chrome Web Store:** baixe o **[arquivo da extensão (.zip)](/extensao/botdoafiliado-postador.zip)**, descompacte numa pasta que você não vá apagar, abra `chrome://extensions`, ligue o **Modo do desenvolvedor** e clique em **Carregar sem compactação**, escolhendo essa pasta. Assim ela não se atualiza sozinha.

## Conectar

Ao instalar, abre a **configuração inicial**, que guia você por estes passos. Para conectar depois:

1. Entre no painel do Bot do Afiliado neste navegador.
2. Clique no ícone da extensão e na **engrenagem**.
3. Na aba **Conta**, escolha **Entrar com o painel** e clique em **Conectar com o painel**.
4. Se você tem mais de um bot, escolha qual.

Aparece **Conectado ao bot @seubot**. Não precisa colar chave nenhuma.

Também dá para conectar pelo modo **Chave de API**, que precisa do módulo **Conexão IA e API**. Quem usa só o Painel do Afiliado não precisa conectar bot: veja **Para o Painel do Afiliado**, mais abaixo.

## Gerar e postar uma oferta

1. Abra a página do produto na loja.
2. Abra o painel lateral da extensão e clique em **Gerar oferta desta página**. Ela busca título, foto e preços e gera o seu link.
3. Se quiser, ajuste a **chamada**, o preço "de/por" e o **cupom**.
4. Escolha o que fazer:
   - **Copiar texto de disparo:** texto pronto para colar no WhatsApp ou no Telegram. **Ver prévia** mostra o texto antes.
   - **Postar no canal:** marque os canais e grupos da sua lista e clique em **Postar agora**. A oferta também entra na sua Vitrine.

> **Dica:** a extensão lê o que a página mostra. Algumas lojas mudam o preço conforme a cor, o vendedor ou a forma de pagamento, então confira preço e parcelas antes de postar e ajuste à mão se precisar.

Para usar uma foto sua, clique no ícone de upload no canto superior direito da imagem (JPG, PNG, WebP ou GIF, até 5 MB). Isso exige a conexão **Entrar com o painel**.

O painel guarda as últimas 10 capturas. Em cada uma, **Texto** copia a oferta no formato do seu bot e **Link** copia o seu link. Marque duas ou mais e use **Copiar N como lista** para montar um post com vários produtos.

**Lista do Postar no canal:** canal novo não entra sozinho. Adicione os canais e grupos em **Configurações › Canais** ou no botão **Adicionar**, no painel lateral.

## Cookies das lojas

O cookie é o login da loja guardado no seu Chrome. A extensão manda esse login para o Bot do Afiliado (para gerar o link) e para o Painel do Afiliado (para ler as suas vendas), e mantém tudo em dia sozinha. **Tudo vem desligado**: nada sai até você ligar.

### Para o Bot do Afiliado

É assim que você conecta os plugins **Mercado Livre** e **Amazon** (SiteStripe) à sua conta da loja.

1. Entre na sua conta da **Amazon** e/ou do **Mercado Livre** neste mesmo Chrome.
2. Conecte a extensão como dono ou admin do bot, pelo **Entrar com o painel**.
3. Na **engrenagem**, abra a aba **Cookies das lojas** e ligue cada loja.
4. Clique em **Sincronizar agora**.

Se o plugin da loja tem mais de uma conta, escolha em **Conta do plugin que recebe o cookie** qual recebe. Na Amazon, vale só para amazon.com.br. Mais em **[SiteStripe da Amazon](/docs/integracoes/amazon-sitestripe/)** e **[Mercado Livre](/docs/integracoes/mercado-livre/)**.

### Para o Painel do Afiliado

Não precisa ter o Bot do Afiliado nem conectar um bot.

1. Entre no **[paineldoafiliado.com](https://paineldoafiliado.com)** neste Chrome, como dono ou admin da organização, e no site de cada loja.
2. Na **engrenagem**, em **Cookies das lojas**, ligue **Enviar ao Painel do Afiliado**.

Funciona com a **Magalu** (admin do Magazine Você), o **Mercado Livre** e a **Amazon** (Associados). Com isso, você não precisa colar o cookie à mão no Painel.

## Ajustes opcionais

- **Tema:** em **Configurações › Aparência › Tema**, escolha **Claro**, **Escuro** ou **Sistema**. O botão de lua/sol no topo troca na hora.
- **Campos:** em **Configurações › Campos**, escolha **Simples**, **Padrão** ou **Completo** para mostrar menos ou mais campos no painel lateral. Esconder um campo não muda o post.

## Como saber se funcionou

Abra a página de um produto e clique em **Gerar oferta desta página**. Se aparecer o seu link, a extensão está conectada. Nos cookies, embaixo de cada loja deve aparecer **Cookie atualizado no bot em …** ou **Em dia: o bot já tem este cookie**, e o card do plugin no painel mostra **Conectado pela extensão do Chrome**.

## Se algo não der certo

- **Nada foi salvo: o bot ainda não tem conta no plugin:** no painel, abra **Configurar › Lojas**, crie a conta da loja com a sua etiqueta (Mercado Livre: **Etiqueta de afiliado**; Amazon: **Tag de associado**), salve e clique em **Sincronizar agora**.
- **Pede para entrar na Amazon ou no Mercado Livre:** faça login na loja neste mesmo perfil do Chrome.
- **A conta do Mercado Livre deste Chrome não é a da conta escolhida do plugin:** entre com a conta certa. O bot mantém o login anterior até lá.
- **Sem permissão para alterar plugins ou sessão do painel expirou:** entre de novo no painel e conecte como dono ou admin do bot.

## Próximos passos

- Monte a sua **[Vitrine](/docs/comecando/vitrine/)** para publicar as ofertas num site seu.
- Conecte mais lojas em **[Integrações](/docs/integracoes/como-funcionam/)**.

---

# DOC: Rastreio na sua landing page: links de entrada e canal do WhatsApp
URL: https://botdoafiliado.com/docs/referencia/rastreio-na-landing/
Atualizado: 2026-11-08
Descrição: Cole um código na sua landing page para não perder a origem do anúncio quando a pessoa toca no botão do grupo, e para o botão do canal do WhatsApp contar clique.

Se o seu anúncio leva a pessoa para a **sua landing page** e só depois ela toca no botão do grupo, a origem do anúncio fica para trás. Este código, colado na landing, leva essa origem junto para o link de entrada da campanha e faz o botão do **canal do WhatsApp** contar clique.

Se o anúncio já leva direto ao link de entrada (`ofertou.ai/e/...`), você não precisa dele.

## O que você ganha

- **Origem do anúncio preservada:** quem veio do anúncio e entrou pelo botão da landing aparece com a origem certa em **Pessoas e resultados**, mesmo que tenha passado por outras páginas antes.
- **Tráfego da landing separado:** quem chegou sem anúncio aparece como vindo da sua landing.
- **Clique no canal do WhatsApp:** o botão do canal passa a contar clique na campanha.
- **Pixel avisado (opcional):** cada toque num botão do bot marca um evento no Pixel da Meta e no GA4 que já estão na página.

## Antes de começar

- Acesso para colar código na sua landing page.
- Para o botão do canal: o canal precisa estar em **WhatsApp › Grupos e canais**, seguido por um número conectado da sua organização.

## Como configurar

1. Abra o editor da sua landing, na parte onde dá para colar código no fim da página (antes de `</body>`).
2. Cole este código:

   ```html
   <script src="https://botdoafiliado.com/rastreio/landing.js"
     data-campanha="seu-endereco"
     data-evento="Contact"
     defer></script>
   ```

3. Troque `seu-endereco` pelo **Endereço personalizado** da campanha, que é o nome depois de `ofertou.ai/e/`. Só é preciso para o botão do canal.
4. Em `data-evento`, deixe `Contact`. Se não quiser marcar nada no Pixel, apague essa linha.
5. Deixe os botões com os links normais: `ofertou.ai/e/seu-endereco` no do grupo e o link `whatsapp.com/channel/...` no do canal. O código ajusta tudo no toque.
6. Publique a página.

## Como saber se funcionou

1. Abra a landing com `?fbclid=teste&utm_campaign=teste` no fim do endereço.
2. Toque no botão do grupo, volte e toque no do canal.
3. Em **Métricas** da campanha, os dois cliques aparecem em **Cliques de pessoas**.

## Se algo não der certo

- **Aparece "Canal não encontrado nesta campanha":** o canal não é da sua organização. Ele precisa estar em **WhatsApp › Grupos e canais**, seguido por um número conectado.
- **Quem segue o canal não aparece nas métricas:** é normal. O WhatsApp não avisa quem segue um canal, então o bot conta só o clique. Por isso a taxa de entrada da campanha cai quando o canal recebe muitos cliques.
- **A página não aceita código de outro site:** copie o conteúdo de [`landing.js`](https://botdoafiliado.com/rastreio/landing.js) para dentro de uma tag `<script>` e coloque esta linha antes dela:

  ```html
  <script>window.botDoAfiliado = { campanha: 'seu-endereco', evento: 'Contact' };</script>
  ```

- **Não dá para colar código nenhum:** no botão do canal, use direto `https://ofertou.ai/e/seu-endereco?canal=<código>`, em que o código é o final do link do canal (`whatsapp.com/channel/<código>`).

## Próximos passos

- Veja quem entrou e de onde veio em **[Pessoas e resultados](/docs/referencia/trafego-campanhas/)**.
- Ligue a Meta e o GA4 em **[Rastreio e destinos de eventos](/docs/referencia/rastreio-e-eventos/)**.

---

# 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/
Atualizado: 2026-11-08
Descrição: Os Alertas de canal avisam quando aparece no seu canal do Telegram um link que não foi gerado pelo seu bot, para você conferir se algum post saiu sem o seu link.

Os **Alertas de canal** avisam quando aparece, num canal seu, um link que **não foi gerado pelo seu bot**. Assim você confere se algum post saiu sem o seu link de afiliado. Ele só avisa: não troca nem apaga nada no canal.

## O que você ganha

- **Nenhum link passa sem você ver:** o painel mostra o canal, o link e a hora.
- **Revisão rápida:** **Ver no canal** abre o post direto no Telegram.
- **Sem aviso à toa:** os links gerados pelo bot e os que estão em **[Deixar passar sem converter](/docs/telegram/whitelist/)** não geram alerta.
- **Vale para post editado:** link trocado depois, na edição, também é conferido.

## Antes de começar

O bot precisa ser **administrador** do canal. Ele só vê as postagens dos canais em que é administrador.

## Como revisar um alerta

1. No painel, abra **Grupos e canais** e clique na aba **Alertas de canal**.
2. Clique em **Ver no canal** para ver o post.
3. Se o link é confiável (um parceiro, o seu site), ponha o domínio ou o link em **[Deixar passar sem converter](/docs/telegram/whitelist/)**.
4. Se o link deveria ser de afiliado, gere de novo pelo bot e edite o post.
5. Clique em **Excluir** para tirar o alerta da lista.

Para achar um canal ou um link, use a busca **Buscar canal ou link…**.

<img src="/docs/telegram/alertas-de-canal.webp" alt="Aba Alertas de canal: a busca Buscar canal ou link… e a lista com o Canal, o Link encontrado e Quando, com Ver no canal e Excluir em cada linha" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

Poste no seu canal um link de loja que não passou pelo bot. Ele deve aparecer em **Alertas de canal**.

## Se algo não der certo

- **Nenhum alerta aparece:** confira se o bot é administrador do canal.
- **Alerta de um link antigo que é seu:** o bot não reconheceu esse link no histórico dele. Gere o link de novo pelo mesmo bot ou, depois de conferir, ponha em **[Deixar passar sem converter](/docs/telegram/whitelist/)**.

## Próximos passos

- Entenda o **[Deixar passar sem converter](/docs/telegram/whitelist/)**.
- Veja como o bot cuida dos **[grupos](/docs/telegram/grupos/)**.
- Conheça a **[conversão automática](/docs/telegram/conversao-automatica/)**.

---

# DOC: Problemas comuns no módulo WhatsApp: parou de sair, post não saiu, link sem vaga
URL: https://botdoafiliado.com/docs/whatsapp/problemas-comuns/
Atualizado: 2026-11-08
Descrição: O que fazer quando as ofertas param de chegar no WhatsApp, um post não sai, o link diz que os grupos lotaram, chega duplicado ou o número é bloqueado.

Ache o seu problema abaixo e siga os passos. Quase tudo se resolve em três lugares: a aba **Números**, a campanha em **Campanhas** e o cartão **Últimos envios** da aba **Envios**.

## Parou de sair tudo de uma vez

1. Abra **WhatsApp › Números**. Se o cartão mostra **Fora do ar**, clique em **Reconectar** e leia o QR code (ou use o código). Grupos, fontes e campanhas continuam valendo.
2. Se o número está conectado, confira no Telegram se o seu bot continua **administrador** do canal.
3. Em **Campanhas**, veja se a campanha pausou. Ela pausa sozinha quando recebe o mesmo post muitas vezes em poucos minutos. Confira as fontes e clique em **Retomar encaminhamentos**.

## Um post não saiu

Abra **WhatsApp › Envios** e procure o post em **Últimos envios**:

- **Descartado:** uma regra barrou ou o tipo não passa. Leia o motivo e confira as regras da campanha e do grupo ("só com imagem ou vídeo", palavras-chave, palavras bloqueadas). Enquete e sticker animado não passam ([o que chega](/docs/whatsapp/o-que-chega/)).
- **Falhou:** leia o motivo. Se o grupo estava sem número conectado, o filtro **Sem número enviando**, em **Grupos e canais**, mostra quais estão assim.
- **Falha na conversão do link:** confira a loja em **Configurar › Lojas** ([como ativar plugins](/docs/integracoes/ativar-plugin/)).
- **Não achou o post:** confira se o bot ainda é administrador do canal, se a fonte não tem o selo **fora de campanha** e se a campanha não tem o selo **sem destino de conteúdo**. Post antigo, de antes de o bot virar administrador, não sai.

Antes de usar **Reenviar**, confira o grupo: o post pode ter chegado mesmo sem confirmação.

## O link diz que os grupos lotaram

Para o link criar grupo novo sozinho, na seção **Link de entrada** da campanha, **Criar grupos automaticamente quando lotar** precisa estar ligado, o **Limite de grupos criados** não pode ter sido atingido e precisa haver um número conectado que possa criar grupos.

Sem criação automática, faça uma destas:

- aumente o **Máximo de pessoas por grupo**;
- em **WhatsApp › Grupos e canais**, mude **Novos membros** de um grupo trancado para **Aberto**;
- adicione outro grupo na seção **Destinos** da campanha.

Veja mais em [Link de entrada e grupos](/docs/whatsapp/link-e-grupos/).

## Chegou duplicado no grupo

- **Duas campanhas com a mesma fonte e o mesmo grupo:** cada uma manda a sua mensagem. Deixe o grupo em só uma delas.
- **Duas fontes que publicam o mesmo conteúdo:** tire uma delas da campanha.
- **Reenvio de algo que já tinha chegado:** confira o grupo antes de usar **Reenviar**.

Se não for nenhum desses casos, mande o print para o suporte.

## Meu número foi bloqueado

O Bot do Afiliado não consegue desbloquear: o pedido de revisão é entre você e o WhatsApp. O plano B é ter um **segundo número** conectado nos mesmos grupos, que assume os envios sozinho (com a **Função** trocada para mandar ofertas: número novo entra como **Vigia**). O que reduz o risco está em [Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/).

## Não consigo pôr mais um número para mandar ofertas

Número novo entra como **Vigia**, que é grátis e não ocupa vaga. Para ele mandar ofertas, troque a **Função** no cartão; se você já chegou à quantidade contratada, clique em **aumentar** no topo da tela ou desconecte um número que não usa ([Preço e limites](/docs/whatsapp/planos-e-limites/)).

## O canal do WhatsApp não aparece

O número precisa seguir o canal e estar conectado. No cartão do número, clique em **Atualizar grupos e canais** e procure na aba **Canais**. Se aparecer **Só admin do canal pode receber ofertas.**, o seu número só segue o canal: ele precisa ser admin para mandar ofertas.

---

# DOC: Organização: dados do bot, Central do Afiliado, módulos, membros e integrações
URL: https://botdoafiliado.com/docs/comecando/organizacao/
Atualizado: 2026-11-08
Descrição: Na tela Organização e membros você convida a equipe, vê os módulos ativos e liga o bot à Central do Afiliado para juntar os dados com o Painel e o Pixel do Afiliado.

Na tela **Organização e membros** você cuida da conta do seu bot: quem tem acesso, quais módulos estão ativos e a ligação com a Central do Afiliado.

## O que você ganha

- **Equipe organizada:** convide pessoas e escolha o que cada uma pode fazer.
- **Dados juntos:** ligado à Central do Afiliado, o bot compartilha dados com o Painel e o Pixel do Afiliado.
- **Assinatura à vista:** veja quais módulos estão ativos e quando algum vai expirar.

## Como chegar

- **Dono:** no rodapé do menu lateral, abra **Conta e organização › Organização e membros**.
- **Admin e postador:** abra a busca (**Ctrl+K** ou **⌘K**) e escolha **Ir para Organização**.

## Convidar a equipe

1. Na aba **Bot e membros**, no cartão **Membros**, escolha **Postador — gera link e promoções** ou **Admin — configurar o bot**.
2. Clique em **Gerar link de convite**, depois em **Copiar**, e mande o link para a pessoa.

<img src="/docs/comecando/organizacao-membros.webp" alt="Cartão Membros: o campo de e-mail (opcional), o seletor de papel com Postador — gera link e promoções, os botões + Mais e Gerar link de convite e, embaixo, a tabela com cada membro, o papel e o botão Remover" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Na tabela, troque o papel pelo seletor da linha ou clique em **Remover**. Só o dono faz isso. Veja **[Equipe e papéis](/docs/comecando/equipe-e-papeis/)**.

## Ligar o bot à Central do Afiliado

O cartão **Central do Afiliado** mostra se o bot está **Vinculado** ou **Independente**.

- **Ainda não tem a Central:** clique em **Vincular à Central do Afiliado** (pode ser outro e-mail).
- **Já tem organização na Central:** escolha a organização e clique em **Vincular este bot**.

Só o dono do bot vincula ou clica em **Desvincular**. Veja **[Central do Afiliado](/docs/integracoes/central-do-afiliado/)**.

## Ver os módulos ativos

O cartão **Assinaturas e módulos** mostra cada módulo como **ativo** ou com a data em que **expira**. Para mudar, o dono clica em **Gerenciar assinaturas**.

> **Atenção:** **Deletar bot**, no cartão **Bot**, manda um link de confirmação ao seu e-mail. Confirmado, o bot e a organização são apagados em 7 dias, e até lá dá para clicar em **Cancelar exclusão**. Depois disso, não tem como desfazer.

## Ajustes opcionais

- **Rastreio das campanhas** (aba **Rastreio**): escolhe como saem os links das ofertas nos grupos: **Direto**, **Pelo ofertou.ai** ou **Pela Vitrine**.
- **Destinos de eventos** (aba **Eventos (Meta e Google Analytics)**): envia entradas no grupo, cliques, cópias de cupom e compras para a Meta e o Google Analytics 4.
- **Webhooks** (aba **Webhooks**): avisam um sistema seu quando um lead entra ou sai, ou um convite quebra. Exigem o módulo Conexão IA e API ([API](/docs/api/visao-geral/)).

Dono e admin mudam esses três. Detalhes em **[Rastreio e destinos de eventos](/docs/referencia/rastreio-e-eventos/)**.

## Próximos passos

- Gerencie o plano e os módulos em **[Assinaturas](/docs/planos/gerenciar-assinatura/)**.
- Entenda os papéis em **[Equipe e papéis](/docs/comecando/equipe-e-papeis/)**.

---

# DOC: Como conectar AliExpress no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/aliexpress/
Atualizado: 2026-11-08
Descrição: Conecte a sua conta de afiliado do AliExpress uma vez e todo link do AliExpress que passar pelo bot sai com o seu código, com foto e cupom do produto quando houver.

Conectando o AliExpress, todo link do AliExpress que passar pelo bot sai com o **seu link de afiliado**, com foto e cupom quando o produto tem. Você só faz isso uma vez.

## O que você ganha

- **Comissão no seu nome:** todo link sai com o seu tracking ID.
- **Ofertas mais completas:** o bot busca a imagem e o cupom do produto.
- **Comprador na loja certa:** link de versão estrangeira leva para a loja brasileira, com preço em real.
- **Vale em todo lugar:** no bot, no painel, na extensão e na API.

## Antes de começar

Você precisa de uma conta aprovada no **programa de afiliados do AliExpress** (AliExpress Portals).

## Como configurar

### 1. Copie o seu tracking ID (PID)

Abra o **[Tracking ID do AliExpress Portals](https://portals.aliexpress.com/affiportals/web/tracking_id.htm)** (menu **Account › Tracking ID**) e copie o seu tracking ID. É ele que credita a comissão.

### 2. Crie as chaves no AliExpress

1. Entre no **[AliExpress Open Service](https://openservice.aliexpress.com/)** pelo **login rápido com a sua conta AliExpress**.

<img src="/docs/integracoes/ali-login.png" alt="Login rápido no AliExpress Open Service com a conta AliExpress" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. No menu, abra o **App Console** e clique para criar um app.

<img src="/docs/integracoes/ali-app-console.png" alt="App Console do AliExpress Open Service, onde se cria o app" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

<img src="/docs/integracoes/ali-criar-app.png" alt="Criação de um novo app no AliExpress Open Service" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

3. Escolha o tipo **app de afiliado** e conclua.

<img src="/docs/integracoes/ali-app-afiliado.png" alt="Escolha do tipo app de afiliado no AliExpress Open Service" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. Copie o **appKey** e o **appSecret** do app. Guarde como uma senha.

<img src="/docs/integracoes/ali-appkey-secret.png" alt="Tela do app no AliExpress mostrando onde copiar o appKey e o appSecret" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

### 3. Cole no Bot do Afiliado

1. No painel do bot, abra **Configurar › Lojas** e escolha **AliExpress**.
2. Clique em **Conectar AliExpress**.
3. Cole o appKey em **App Key** e o appSecret em **App Secret**.
4. Abra **Mais opções: nome, prioridade e rastreamento** e cole o seu PID em **Rastreamento padrão**.
5. Clique em **Salvar**.

<video src="/docs/integracoes/aliexpress-conectar.mp4" poster="/docs/integracoes/aliexpress-conectar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Configurar › Lojas, escolher o AliExpress, clicar em Conectar AliExpress, colar a App Key e o App Secret, ver o Teste da conta mostrar Funcionando, colar o PID em Rastreamento padrão e clicar em Salvar" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/integracoes/aliexpress-conectar.gif" alt="Vídeo: em Configurar › Lojas, escolher o AliExpress, clicar em Conectar AliExpress, colar a App Key e o App Secret, ver o Teste da conta mostrar Funcionando, colar o PID em Rastreamento padrão e clicar em Salvar" /></video>

## Como saber se funcionou

O card **Teste da conta** roda sozinho com as chaves preenchidas e mostra se deu certo.

<img src="/docs/integracoes/aliexpress-validacao.webp" alt="Card Teste da conta do AliExpress mostrando Funcionando, com as duas verificações OK" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Depois, mande um link do AliExpress para o seu bot no Telegram. Se voltar um link novo, ele já é o seu.

## Se algo não der certo

- **O teste da conta falhou:** confira se o appKey e o appSecret foram colados inteiros e se a sua conta de afiliado já foi aprovada.
- **A oferta saiu sem cupom ou sem foto:** nem todo produto tem. O link continua com o seu código.

## Próximos passos

- Conecte outras lojas: **[Amazon](/docs/integracoes/amazon/)**, **[Shopee](/docs/integracoes/shopee/)** e **[Mercado Livre](/docs/integracoes/mercado-livre/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)**.

---

# DOC: Encurtador de links de afiliado (ofertou.ai)
URL: https://botdoafiliado.com/docs/telegram/encurtador/
Atualizado: 2026-11-08
Descrição: Saiba quando o bot encurta o seu link de afiliado e use /encurtar e /soencurtar para mandar links curtos sem perder a comissão.

Depois de gerar o seu link de afiliado, o bot deixa o link curto sempre que isso não atrapalha a comissão. Você não precisa fazer nada: cada loja sai no formato certo. Para encurtar um link na hora, use os comandos `/encurtar` e `/soencurtar`.

## O que você ganha

- **Links limpos nos posts:** o link fica curto e a comissão continua sua.
- **Sem configurar nada:** o bot escolhe sozinho o formato de cada loja.
- **Mesmo link, mesmo curto:** mandar o mesmo link de novo devolve o mesmo link curto.
- **Cliques no Painel:** com o Painel do Afiliado conectado, os cliques nos links `ofertou.ai` aparecem na seção **Público**.

## Como cada loja sai

- **Amazon:** em `amzn.to`, o link curto oficial da Amazon.
- **Shopee, AliExpress e Mercado Livre:** com o link da própria loja, sem encurtar. A exceção são as campanhas configuradas para mandar o link pelo `ofertou.ai`.
- **Demais lojas:** pelo encurtador `ofertou.ai`.

## Como ligar os comandos

1. No painel, abra **Configurar › Comandos** e vá até o card **Comandos de encurtar**.
2. Ligue **Encurtador de links** para usar o `/encurtar` e **Só encurtar** para usar o `/soencurtar`.

<img src="/docs/telegram/comandos-encurtar.webp" alt="Card Comandos de encurtar: as chaves Encurtador de links e Só encurtar, as duas ligadas" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Depois, no Telegram:

- **`/encurtar`**: troca pelo seu link de afiliado, quando a loja tem conversão, e encurta. Exemplo: `/encurtar https://...`
- **`/soencurtar`**: só encurta, sem trocar pelo link de afiliado. Exemplo: `/soencurtar https://...`

## Como saber se funcionou

Mande `/encurtar` seguido de um link para o bot. Se ele responder com um link curto, está funcionando.

## Cliques no Painel do Afiliado

Com o Painel do Afiliado conectado ao bot, cada clique num link `ofertou.ai` aparece na seção **Público** do Painel: hora (de Brasília), site de origem, região aproximada, tipo de aparelho e o link. O Painel não recebe IP nem identifica a pessoa. Idade e gênero só aparecem quando a própria loja fornece esses números.

Links da Shopee, AliExpress e Mercado Livre e os `amzn.to` da Amazon não passam pelo `ofertou.ai`, então não aparecem nessa seção.

Quem clica num link `ofertou.ai` encontra a política de privacidade e o botão **Não me reconhecer neste navegador** em [ofertou.ai/privacidade](https://ofertou.ai/privacidade).

## Se algo não der certo

- **O link da Shopee, AliExpress ou Mercado Livre não ficou curto:** é normal. Essas lojas saem com o link delas.
- **`/encurtar` ou `/soencurtar` não responde:** ligue **Encurtador de links** ou **Só encurtar** no card **Comandos de encurtar**, em **Configurar › Comandos**.
- **Liguei Remover https:// e o link não encurtou:** essa opção da aba **[Resposta do /c](/docs/telegram/conversao-automatica/)** só esconde o `https://` do começo do link. Ela não encurta.

## Próximos passos

- Veja todos os **[comandos](/docs/telegram/comandos/)**.
- Ligue outros recursos em **[Funcionalidades](/docs/comecando/funcionalidades/)**.

---

# DOC: Aquecimento do WhatsApp
URL: https://botdoafiliado.com/docs/whatsapp/aquecimento/
Atualizado: 2026-11-08
Descrição: O Bot aquece o seu número de WhatsApp sozinho, com conversas no ritmo e no horário que você escolhe, e você acompanha tudo pelo painel.

No aquecimento, o Bot conversa pelo seu número aos poucos, com métodos próprios, no ritmo e no horário que você escolher. Você configura uma vez e acompanha pelo painel.

Número dedicado e aquecido aos poucos é uma das recomendações para reduzir o risco de bloqueio ([Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)). Nenhum método garante que o número nunca será bloqueado.

## O que você ganha

- **Sem trabalho manual:** o Bot conduz as conversas por você.
- **Ritmo de gente:** a espera entre mensagens muda a cada envio.
- **No seu horário:** só envia dentro da janela e até o limite do dia.
- **Para sozinho se der problema:** pausa e avisa você por e-mail e Telegram.

## Antes de começar

O número precisa estar conectado e liberado no seu módulo WhatsApp. Só o dono ou administrador da organização cria e controla o aquecimento.

## Como configurar

1. Abra **WhatsApp › Números**.
2. No cartão do número, clique em **Aquecer**.
3. Escolha o início, o máximo de mensagens por dia (até 200), o intervalo entre mensagens em minutos e a janela de horário (de Brasília). Na dúvida, deixe o que já vem: 10 por dia, de 15 a 45 minutos, das 9h às 18h.
4. Salve o rascunho.
5. Confira e clique em **Iniciar**.

> **Atenção:** salvar o rascunho não começa nada. O aquecimento só começa em **Iniciar**.

## Pausar, retomar e cancelar

**Pausar** segura os próximos envios, **Retomar** continua de onde parou e **Cancelar** encerra. Para mudar o ritmo, cancele e crie outro. Cada número tem um aquecimento por vez, e cada organização cria até 20 a cada 30 dias.

## Como saber se funcionou

O cartão do número mostra o selo **aquecendo** com os contatos já alcançados. Em **Ver aquecimento**, você vê quem respondeu, as falhas e o horário do próximo envio.

## Se algo não der certo

- **Pausou sozinho:** o motivo aparece no painel (por exemplo, o número perdeu a liberação do módulo ou a assinatura mudou). Resolva e clique em **Retomar**.
- **O número caiu:** o aquecimento espera e tenta de novo sozinho.

## Próximos passos

- Veja como **[conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)** com menos risco.
- Escolha por onde receber o aviso **Aquecimento pausado** em **[Incidentes e notificações](/docs/whatsapp/incidentes-e-alertas/)**.

---

# DOC: Incidentes, notificações e busca
URL: https://botdoafiliado.com/docs/whatsapp/incidentes-e-alertas/
Atualizado: 2026-11-08
Descrição: Veja o que fazer quando um grupo ou campanha do WhatsApp dá problema, escolha por onde receber cada aviso e ache qualquer tela pela busca rápida.

Quando algo dá errado num grupo ou numa campanha do WhatsApp, o problema aparece em **WhatsApp › Incidentes** com o que fazer, e você recebe um aviso. Em **Configurar › Notificações** você escolhe por onde cada aviso chega.

## O que você ganha

- **Fica sabendo na hora:** o aviso chega por e-mail e Telegram.
- **Sabe o que fazer:** cada incidente vem com a orientação.
- **Fecha sozinho:** resolvido o problema, o incidente se encerra.

## Onde ver os incidentes

Abra **WhatsApp › Incidentes**. A aba mostra quantos estão abertos. Filtre por **Abertos**, **Fechados** ou **Todos** e use os atalhos **Ver grupo no WhatsApp** e **Ver campanha**. Na aba **Visão geral**, o cartão **Saúde dos grupos** mostra quantos estão **saudáveis** e **com problema**.

<img src="/docs/whatsapp/incidentes.webp" alt="Aba Incidentes da tela WhatsApp: os filtros Abertos, Fechados e Todos, o botão Configurar alertas e dois incidentes abertos, Convite inválido e Campanha sem grupo aberto, cada um com o que fazer e o atalho Ver grupo no WhatsApp ou Ver campanha" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## O que fazer em cada incidente

- **Convite inválido:** gere um novo convite no grupo pelo WhatsApp e confira se o seu número continua administrador.
- **Grupo suspenso:** o WhatsApp suspendeu o grupo. Abra o grupo no celular e siga a orientação do WhatsApp. Ele volta a receber ofertas quando se recuperar.
- **Sem acesso:** confira se o seu número ainda está no grupo e é administrador. Coloque de volta e espere a próxima verificação.
- **Número desconectado:** o grupo ficou sem número conectado e as ofertas não saem para ele. Reconecte em **WhatsApp › Números**.
- **Campanha sem grupo aberto:** reabra um grupo com vagas ou adicione outro grupo na campanha.
- **Número que cria os grupos indisponível:** troque o **Número que cria os grupos** no **Link de entrada** da campanha (ou volte para **Automático**) e salve.
- **Edição que não chegou ao WhatsApp:** alguns grupos ficaram com o texto antigo do post. Clique em **Apagar nos grupos** (vale até 2 dias depois do envio) ou em **Deixar como está**.

> **Dica:** para a edição chegar no WhatsApp, edite o post nos primeiros 15 minutos depois de publicar.

## Escolher por onde receber os avisos

1. Abra **Configurar › Notificações** (ou clique em **Configurar alertas** na aba Incidentes).
2. Em cada aviso, ligue ou desligue **E-mail**, **Telegram** e **Webhook**.
3. Espere a confirmação **Preferência salva.**

Todos os avisos começam ligados. E-mail e Telegram vão para o dono da organização; webhook é para quem tem o módulo de API. Os alertas de segurança e de login ficam sempre ligados.

## Se algo não der certo

- **A tela WhatsApp mostra um cadeado:** Incidentes precisa do módulo WhatsApp ([módulos](/docs/planos/modulos/)). Com a assinatura pausada, a aba fica desligada até você reativar.
- **Não consigo mudar as notificações:** só o dono ou administrador altera.
- **Um canal aparece como indisponível:** a própria linha diz o que falta configurar.

## Busca rápida

Aperte **Ctrl+K** (Windows) ou **⌘K** (Mac), ou clique em **Buscar** no topo do menu lateral. Ela abre telas, troca de bot e encontra campanhas, grupos, números e incidentes. Também tem atalhos como **Ir para Bots** e **Ir para Organização**.

## Próximos passos

- Resolva o resto em **[Problemas comuns](/docs/whatsapp/problemas-comuns/)**.
- Reconecte um número em **[Conectar o WhatsApp](/docs/whatsapp/conectar-whatsapp/)**.

---

# DOC: Plugin Amazon no Bot do Afiliado: o que é obrigatório e o que é opcional
URL: https://botdoafiliado.com/docs/integracoes/amazon/
Atualizado: 2026-11-08
Descrição: Para ganhar comissão nos links da Amazon pelo bot, basta colar a sua tag de associado. Com a Creators API, as ofertas ainda vêm com nome, foto e preço.

Para os links da Amazon saírem com a sua comissão, você só precisa colar a sua **tag de associado** (ex.: `seunome-20`). Depois, se quiser, ligue a **Creators API** para as ofertas virem com nome, foto e preço.

## O que você ganha

- **Comissão em todo link:** a sua tag vai em todo link da Amazon que passa pelo bot.
- **Um campo só:** a tag é o único item obrigatório.
- **Ofertas completas:** com a Creators API, o bot preenche nome, foto e preço sozinho.
- **Link de marca, se quiser:** com o SiteStripe, o post mostra `link.amazon` em vez de `amzn.to`.

## Qual opção escolher

- **Só quer começar:** cole a tag e pronto. É o caminho mais fácil. Os links saem curtos, como `amzn.to`.
- **Quer nome, foto e preço nas ofertas (recomendado):** depois da tag, ligue a **[Creators API](/docs/integracoes/amazon-creators/)**. A Amazon libera sem pedir vendas mínimas.
- **Quer o link como `link.amazon`:** ligue o **[SiteStripe](/docs/integracoes/amazon-sitestripe/)** pela extensão do Chrome. É opcional e funciona junto com a Creators API.

A comissão é a mesma em todos os casos.

## Antes de começar

Você precisa de uma conta no **Amazon Associados** e da sua tag (o ID de rastreamento que termina em `-20`).

## Como configurar

1. No **[Amazon Associados](https://associados.amazon.com.br/home/account/tag/manage)**, em **Gerenciar IDs de rastreamento**, copie a sua tag.
2. No painel do bot, abra **Configurar › Lojas** e escolha **Amazon**.
3. Clique em **Conectar Amazon**.
4. Cole a tag no campo **Tag de associado**.
5. Clique em **Salvar**.

<img src="/docs/integracoes/amazon-plugin.webp" alt="Credenciais da Amazon com a tag colada no campo Tag de associado" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

A Creators API e o SiteStripe podem ficar em branco agora. Quando quiser, siga o guia de cada um.

## Ajustes opcionais

- **Link completo:** no card **Formato do link**, marque **Mandar o link longo (sem encurtar)** para o link sair inteiro.

## Como saber se funcionou

Mande um link de produto da Amazon para o seu bot no Telegram. Se ele responder com um link novo, esse link já leva a sua tag.

## Se algo não der certo

- **A oferta saiu sem foto e sem preço:** isso vem da Creators API. Sem ela, o link sai com a sua tag, só sem esses dados.
- **Você esperava `link.amazon` e veio `amzn.to`:** a conexão do SiteStripe venceu. Veja **[SiteStripe da Amazon](/docs/integracoes/amazon-sitestripe/)**.

## Próximos passos

- Ofertas com nome, foto e preço: **[Creators API](/docs/integracoes/amazon-creators/)**.
- Conecte outras lojas: **[Shopee](/docs/integracoes/shopee/)** e **[AliExpress](/docs/integracoes/aliexpress/)**.

---

# DOC: Perfil e segurança da conta: nome, Google, chaves de acesso, sessões e verificação em duas etapas
URL: https://botdoafiliado.com/docs/comecando/perfil-e-seguranca/
Atualizado: 2026-11-08
Descrição: Proteja a sua conta em poucos cliques. Ative a verificação em duas etapas, entre pela digital com uma chave de acesso e saia de aparelhos que ficaram logados.

A tela **Perfil e segurança** guarda os dados de acesso da sua conta e os controles de segurança: nome, login com Google, chaves de acesso, aparelhos conectados e verificação em duas etapas. Ela vale para você, não para o bot.

## O que você ganha

- **Conta protegida:** com a verificação em duas etapas, todo login também pede o código do seu celular.
- **Login mais rápido:** com uma chave de acesso, você entra pela digital, pelo rosto ou pelo PIN do aparelho, sem e-mail nem senha.
- **Controle dos aparelhos:** você vê onde a conta está aberta e fecha o que não reconhece.

## Como chegar

No rodapé do menu lateral, abra **Conta e organização** e clique em **Perfil e segurança**. Em **Configurar › Perfil e acesso** também há o atalho **Meu perfil e segurança**.

## Ativar a verificação em duas etapas

Você vai precisar de um **aplicativo autenticador** no celular. É um app que mostra um código novo de 6 dígitos a cada pouco tempo.

1. No cartão **Verificação em duas etapas**, clique em **Ativar**.
2. Guarde os **Códigos de recuperação** com **Copiar códigos**. Eles servem para entrar se você perder o celular.
3. No seu aplicativo autenticador, adicione uma conta nova com a **Chave do autenticador** que aparece na tela.

<img src="/docs/comecando/perfil-duas-etapas.webp" alt="Cartão Verificação em duas etapas depois de clicar em Ativar: a Chave do autenticador, o campo Código com os botões Confirmar e Cancelar e, embaixo, os Códigos de recuperação com o botão Copiar códigos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. Digite o código de 6 dígitos que o app mostra em **Código** e clique em **Confirmar**.

O cartão passa a mostrar **Ativada**. Para desligar, use **Desativar**.

> **Atenção:** os códigos de recuperação aparecem uma única vez, na ativação. Guarde num lugar seguro.

## Outros ajustes

- **Nome:** edite o campo no cartão **Conta** e clique em **Salvar**.
- **Login com Google:** **Vincular Google** liga o login pelo Google (precisa ser o mesmo e-mail da conta). **Desvincular** tira.
- **Chaves de acesso:** clique em **Adicionar chave de acesso** e confirme no aparelho. Para tirar, use **Remover**.
- **Sessões ativas:** mostra os aparelhos com a conta aberta, com o navegador e o sistema de cada um (ex.: Chrome no Windows). **Encerrar** fecha um; **Encerrar todas as outras sessões** fecha todos, menos o que você está usando.

Se você entra pela **Central do Afiliado**, a segurança é cuidada lá e vale para todos os produtos. Use **Gerenciar na Central do Afiliado**.

## Como saber se funcionou

Saia e entre de novo. Depois do login, a tela **Verificação em duas etapas** pede o código: digite o código de 6 dígitos em **Código do app autenticador** e clique em **Verificar**.

## Se algo não der certo

- **Perdeu o celular:** no login, clique em **Perdi o app: usar código de recuperação** e use um dos códigos guardados. Cada um funciona uma vez.
- **Errou o código várias vezes:** a verificação pode ficar bloqueada por alguns minutos. Espere e tente de novo.
- **Aviso de sessão expirada ao adicionar chave de acesso:** saia, entre de novo e tente outra vez.
- **O botão Desvincular está desligado:** o Google é o seu único jeito de entrar. Adicione e-mail ou chave de acesso antes.

## Próximos passos

- Veja **[como acessar o painel](/docs/comecando/acessar-painel/)**.
- Cuide também das suas chaves em **[Segurança e tokens](/docs/referencia/seguranca-e-tokens/)**.

---

# DOC: Bot AliExpress no Telegram: desconto de moedas e cupom secreto automático
URL: https://botdoafiliado.com/docs/telegram/aliexpress-moedas-cupom/
Atualizado: 2026-11-08
Descrição: Mande um link do AliExpress e o bot devolve o link com desconto de moedas e avisa se o produto tem cupom secreto, sempre com o seu link de afiliado.

Mande um link de produto do **AliExpress** para o bot e ele devolve o **link com desconto de moedas**, já com o seu link de afiliado. Se o produto tiver um **cupom secreto**, o bot avisa na mesma hora.

## O que você ganha

- **Desconto fácil de achar:** o link abre direto na página de moedas do app.
- **Desconto que o público nem sabia que existia:** o bot mostra o código, o desconto e o gasto mínimo do cupom secreto.
- **Sempre o seu link:** tudo sai com a sua tag de afiliado.
- **Funciona no PC também:** junto vai um link comum, que abre em qualquer lugar.

## Antes de começar

Conecte o **plugin do AliExpress** com a sua conta de afiliado. Veja **[Integração AliExpress](/docs/integracoes/aliexpress/)**.

## Como usar

1. Mande o link do produto do AliExpress para o bot, na conversa ou no grupo.
2. O bot responde com o link de desconto de moedas, que abre na página de moedas do app, e um link comum para PC.
3. Se o produto tiver um cupom secreto, o bot informa o código, o desconto e o gasto mínimo.

Na conversa, você também pode usar `/moedas` seguido do link. No grupo, o bot responde sozinho aos links do AliExpress quando o módulo **[Grupos](/docs/telegram/grupos/)** está ativo.

<img src="/docs/telegram/aliexpress-moedas.png" alt="Bot gerando o link de desconto de moedas do AliExpress, com aviso de que o desconto funciona no app e um link alternativo para PC" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Dica:** o desconto de moedas funciona no app. O link abre na página de moedas: é só tocar no primeiro produto da lista.

<img src="/docs/telegram/aliexpress-cupom-secreto.png" alt="Bot avisando de um cupom secreto num produto do AliExpress, com o código, o desconto e o valor mínimo de compra" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

Mande um link de produto do AliExpress para o bot. Se ele responder com o link de moedas e um link comum, está funcionando.

## Se algo não der certo

- **O produto não aparece na página de moedas:** o estoque pode ter acabado ou o produto não tem desconto de moedas. Use o link comum que o bot manda junto.
- **No PC o desconto não aparece:** o desconto de moedas costuma funcionar só no app.
- **O bot não respondeu no grupo:** o módulo **Grupos** precisa estar ativo.

## Próximos passos

- Veja os outros comandos do AliExpress (carrinho, links promocionais e pesquisas) em **[Comandos](/docs/telegram/comandos/)**.
- Conecte outras lojas em **[como funcionam as integrações](/docs/integracoes/como-funcionam/)**.

---

# DOC: Como conectar Amazon (Creators API) no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/amazon-creators/
Atualizado: 2026-11-08
Descrição: Com a Creators API, o bot preenche sozinho o nome, a foto e o preço dos produtos da Amazon nas ofertas. A Amazon libera sem pedir vendas mínimas.

A **Creators API** faz o bot preencher sozinho o **nome, a foto e o preço** dos produtos da Amazon nas ofertas. É opcional: só com a sua tag o link já sai com a sua comissão.

## O que você ganha

- **Ofertas prontas:** nome, foto e preço vêm sozinhos, sem você digitar.
- **Sem exigência de vendas:** a Amazon libera mesmo para quem ainda não vendeu.
- **Configuração curta:** já vem pronta para o Brasil; você só cola duas chaves.
- **Mesma comissão:** o link continua saindo com a sua tag.

## Antes de começar

Você precisa de uma conta no **Amazon Associados** e da sua tag (ex.: `seunome-20`). Veja **[Plugin Amazon](/docs/integracoes/amazon/)** se ainda não conectou a Amazon.

## Como configurar

1. Abra o **[console da Amazon Creators API](https://associados.amazon.com.br/creatorsapi)** e gere o **ID da credencial** e o **Segredo**.

<img src="/docs/integracoes/amazon-creators-app.png" alt="Aplicação criada no console da Amazon Creators API, com as chaves geradas" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. No painel do bot, abra **Configurar › Lojas** e escolha **Amazon**.
3. Clique em **Conectar Amazon**, ou em **Configurar** na conta que você já tem.
4. Em **Fonte dos dados do produto**, escolha **Creators API**.
5. Preencha **Tag de associado** com a sua tag, se estiver vazio.
6. Na seção **Creators API**, cole os dois nos campos de mesmo nome: **ID da credencial** e **Segredo**.
7. Clique em **Salvar**.

<img src="/docs/integracoes/amazon-creators-plugin.webp" alt="Credenciais da Amazon com a Fonte dos dados em Creators API, a tag preenchida e as duas chaves coladas" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Ajustes opcionais

- **Link como `link.amazon`:** ligue o **[SiteStripe](/docs/integracoes/amazon-sitestripe/)**. Sem ele, o link curto sai como `amzn.to`, com a mesma comissão.

## Como saber se funcionou

O card **Teste da conta** roda sozinho assim que as chaves estão preenchidas. Depois, mande um link de produto da Amazon para o seu bot no Telegram: a oferta deve vir com nome, foto e preço.

## Próximos passos

- Veja **[qual opção da Amazon escolher](/docs/integracoes/amazon/)**.
- Deixe o link com a cara da Amazon: **[SiteStripe](/docs/integracoes/amazon-sitestripe/)**.

---

# DOC: Postador: monte a oferta no painel e envie aos seus canais
URL: https://botdoafiliado.com/docs/telegram/formatador-tempo-real/
Atualizado: 2026-11-08
Descrição: Cole os links no Postador, confira a oferta pronta como ela vai aparecer no Telegram e envie para todos os seus canais, grupos e campanhas de uma vez.

O **Postador** é a tela do painel onde você cola os links, vê a oferta pronta como ela vai aparecer no Telegram e envia para os seus canais, grupos e campanhas de uma vez. Também serve para mandar um aviso que não é oferta, com texto e imagem.

> **Módulo necessário:** Ofertas. Veja **[módulos e preços](/docs/planos/modulos/)**.

## O que você ganha

- **Sem digitar comando:** é a versão visual do **[/oferta](/docs/telegram/ofertas/)**.
- **Cola do jeito que está:** links, preços e cupom misturados; o Postador separa e troca os links pelos seus.
- **Vê antes de postar:** a prévia mostra a oferta exatamente como vai sair.
- **Vários destinos num clique:** todos os canais, grupos e campanhas marcados recebem juntos.
- **Foto e título lembrados:** a foto e o título que você escolher voltam sozinhos quando colar o mesmo link.

## Antes de começar

O bot precisa ser **administrador** nos canais e grupos onde vai postar. Grupo comum, que ainda não virou supergrupo, não aparece na lista.

## Como postar uma oferta

1. No painel, abra **Postar › Postador** e deixe selecionado o modo **Oferta**.
2. Na primeira vez, abra a aba **Canais e grupos (N)**, clique em **Adicionar canal ou grupo** e adicione onde você vai postar. A lista começa vazia.
3. Cole no campo **Links, preços e cupons** o post do jeito que ele está, por exemplo `CUPOM15 R$ 49,90 https://...`.
4. Se quiser, mude **Cupom de desconto**, **Preço de venda**, **Preço anterior** e **Chamada da oferta**.
5. Confira a prévia do Telegram e veja em **Status dos Links** se cada link ficou **Convertido**.
6. Em **Canais e grupos de envio**, marque onde a oferta vai sair. Se tiver campanhas, marque também em **Enviar para campanhas**.
7. Clique em **Postar**, ou em **Copiar texto** para colar a oferta em outro lugar. O botão mostra quantos destinos vão receber, como **Postar em 2 chats**.

<img src="/docs/telegram/formatador-completo.webp" alt="Tela do Postador no painel: à esquerda a composição da oferta, com o link, o cupom detectado e os preços, e embaixo os canais de envio com o botão Postar em 1 chat; à direita a prévia do Telegram e o status dos links" style="display:block;margin:18px auto;max-width:760px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Ao colar, o primeiro preço vai para o primeiro link, o segundo para o segundo, e o que sobra vira cupom. Texto entre aspas, como `"Compre aqui 👇"`, vira a chamada. O que o Postador achou sozinho aparece com o selo **detectado**.

<img src="/docs/telegram/formatador-oferta.webp" alt="Prévia do Telegram com a oferta montada: foto do produto, título, preço de antes riscado e preço novo, cupom e link de afiliado" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

<img src="/docs/telegram/formatador-canais.webp" alt="Card Canais e grupos de envio do Postador: a busca, os botões Todos e Nenhum, o canal Ofertas do Dia marcado e o botão Postar em 1 chat" style="display:block;margin:18px auto;max-width:520px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Atenção:** preço de venda, preço anterior, desconto e parcelas que você digita valem só para o **primeiro produto** da oferta.

<video src="/docs/telegram/postador-oferta.mp4" poster="/docs/telegram/postador-oferta.webp" autoplay muted loop playsinline controls aria-label="Vídeo: no Postador, colar o cupom, o preço e o link do produto, ver a prévia do Telegram montada sozinha, marcar o canal Ofertas do Dia e conferir o botão Postar em 1 chat" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/telegram/postador-oferta.gif" alt="Vídeo: no Postador, colar o cupom, o preço e o link do produto, ver a prévia do Telegram montada sozinha, marcar o canal Ofertas do Dia e conferir o botão Postar em 1 chat" /></video>

## Ajustes opcionais

- **Menos campos na tela:** na aba **Campos** (ou no atalho **Campos: Padrão**), escolha **Simples** (só link e cupom), **Padrão** ou **Completo**. Vale também na **[extensão do Chrome](/docs/comecando/extensao-chrome/)** e no app.
- **Foto e título próprios:** em **Status dos Links**, use **📷 Usar minha foto** (até 5 MB), **🎨 Arte** ou **✎ Título e chamada próprios**. Ficam salvos para aquele produto.
- **Desconto do cupom:** informe em % ou R$ e o Postador calcula o preço final. Se o código estiver em **[Cupons](/docs/telegram/cupons/)** com desconto, o campo se preenche sozinho.
- **Parcelamento do 1º produto:** use os dados da loja, informe as parcelas ou escolha **Não mostrar parcelas**.
- **Incluir imagem:** marcado, a oferta sai com foto; com vários links, as fotos saem numa grade.

## Mandar um aviso (Mensagem livre)

1. No topo do Postador, troque para **Mensagem livre**.
2. Escreva em **Mensagem**. Dá para usar negrito, itálico, link e outros estilos, até 4.096 caracteres.
3. Se quiser, em **Imagem (opcional)**, clique em **Escolher imagem** (até 5 MB) ou cole o link de uma imagem.
4. Deixe **Converter links de afiliado** ligado para trocar os links de loja pelos seus. Se algum link não converter, nada é enviado.
5. Marque os destinos e clique em **Enviar mensagem**.

## Como saber se funcionou

Poste uma oferta num canal seu. Depois do envio, aparece um aviso dizendo quantas saíram e quais não foram enviadas, com o motivo. Abra o canal no Telegram e confira o post.

## Se algo não der certo

- **Meu canal não aparece para marcar:** adicione na aba **Canais e grupos (N)**. Se não estiver nem lá, ponha o bot como administrador no canal e clique em **Recarregar**.
- **A chamada não saiu:** o formato precisa da variável `{cta}`. Coloque em **[Aparência das ofertas › Texto e rodapé](/docs/telegram/ofertas/)**.
- **O preço riscado ou as parcelas não aparecem:** o formato precisa de `{linhadopreco}`. Veja **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- **O botão Postar não libera:** espere a prévia terminar de atualizar (**Atualizando prévia…**).

## Próximos passos

- Deixe o post com a cara do seu canal em **[Aparência das ofertas › Texto e rodapé](/docs/telegram/ofertas/)**.
- Crie ofertas direto da página da loja com a **[extensão do Chrome](/docs/comecando/extensao-chrome/)**.
- Mande ofertas para Telegram e WhatsApp com uma **[campanha](/docs/whatsapp/criar-campanha/)**.

---

# DOC: Fotos e chamada: foto própria, chamada salva, arte da oferta e marca d'água
URL: https://botdoafiliado.com/docs/telegram/fotos-e-ctas/
Atualizado: 2026-11-08
Descrição: Salve a sua foto e a sua chamada por produto para o bot reaplicar sozinho, ponha o seu logo nas fotos das ofertas e um fundo seu na arte da oferta.

A aba **Fotos e chamada** (em **Configurar › Aparência das ofertas**) guarda a foto, a chamada e o título que você deu a cada produto, para o bot usar de novo quando ele voltar numa oferta. Nela você também põe o seu **logo nas fotos** e um fundo seu na **arte da oferta**. Fotos e chamadas salvas precisam do módulo de **Ofertas**.

## O que você ganha

- **Sua foto volta sozinha:** o produto que reaparece numa oferta já sai com a foto que você enviou.
- **Chamada lembrada:** a chamada que você usou num produto é sugerida de novo no Postador.
- **Sua marca em toda foto:** o seu logo ou o @ do canal entra na foto das ofertas.
- **Arte da oferta com a sua cara:** fundo, cores e @ do bot na arte que o Postador e a extensão geram.

## Marca d'água nas fotos

1. No painel, abra **Configurar › Aparência das ofertas**, aba **Fotos e chamada**, e desça até o card **Marca d'água nas fotos**.
2. Clique em **Enviar logo** (SVG ou PNG sem fundo ficam melhores) e, se quiser, escreva um **Texto**, como o @ do seu canal.
3. Escolha a **Posição** e ajuste **Tamanho** e **Opacidade** olhando a **Prévia ao vivo**.
4. Ligue **Aplicar nas fotos das ofertas**.
5. Clique em **Salvar**.

<img src="/docs/telegram/fotos-marca-dagua.webp" alt="Card Marca d'água nas fotos: Enviar logo, o Texto @ofertasdodia, a Posição Canto inferior direito, Tamanho e Opacidade, a chave Aplicar nas fotos das ofertas ligada e, ao lado, a Prévia ao vivo com o @ no canto da foto" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Atenção:** a prévia muda na hora, mas as ofertas só usam a marca depois de **Salvar**. Desligado o **Aplicar nas fotos das ofertas**, a marca só vale pela **[API](/docs/api/product/)** (o link **Usar pela API** do card leva até lá).

**Para testar:** em **Testar numa foto de produto (opcional)**, cole o link de um produto e clique em **Usar**.

## Fotos próprias

A sua foto entra no lugar da imagem da loja sempre que o produto volta numa oferta. Para incluir, abra o **[Postador](/docs/telegram/formatador-tempo-real/)** e, em **Status dos Links**, clique em **📷 Usar minha foto**. Aqui você usa **Trocar** (até 5 MB) ou **Remover**.

## Chamadas e títulos salvos

A chamada é a frase que chama para a compra, como "Compre aqui 👇". A chamada salva é sugerida no campo **Chamada da oferta** do Postador quando o produto volta. Ela é salva quando você posta no Postador uma oferta de **1 produto** com chamada, ou aqui, no card **Chamadas salvas**: cole o **Link do produto**, escreva a chamada (até 200 caracteres) e clique em **Adicionar**.

Para um título próprio, clique em **Definir** ou **Editar** na coluna **Título** (até 250 caracteres) e em **Salvar**.

## Arte da oferta

É a imagem com um cartão branco de foto, preço e cupom sobre um fundo seu. Sai pelo botão **🎨 Arte** do Postador e pela extensão.

1. Crie no Canva (botão **Abrir o Canva**) o **Fundo do feed (1080×1080)** e o **Fundo do story (1080×1920)**, com o centro livre.
2. Clique em **Enviar** em cada fundo (PNG, JPG ou WebP, até 5 MB).
3. Se quiser, escolha **Cor do destaque (preço/desconto)** e **Cor do botão (chamada)**.
4. Clique em **Salvar** e depois em **Testar arte**.

Deixe livres as bordas: 84 px no feed; no story, 170 px em cima e embaixo e 64 px nos lados.

## Se algo não der certo

- **A marca d'água não aparece nas ofertas:** confira se **Aplicar nas fotos das ofertas** está ligado e clique em **Salvar**.
- **O arquivo não sobe:** foto, fundo e logo vão até 5 MB; logo em SVG, até 1 MB.

## Próximos passos

- Monte ofertas com **[Ofertas](/docs/telegram/ofertas/)**.
- Traga ofertas de outros canais com o **[Puxador](/docs/telegram/userbot/)**.

---

# DOC: SiteStripe da Amazon (opcional): link.amazon pela extensão do Chrome
URL: https://botdoafiliado.com/docs/integracoes/amazon-sitestripe/
Atualizado: 2026-11-08
Descrição: O SiteStripe é opcional e faz os seus links da Amazon saírem como link.amazon em vez de amzn.to. Liga pela extensão do Chrome, sem copiar nada à mão.

O **SiteStripe** faz os seus links da Amazon saírem como **`link.amazon`**, o link curto da própria Amazon, em vez de `amzn.to`. É opcional: sem ele, o bot converte normalmente, com a mesma tag e a mesma comissão. Se não faz diferença para você, pode deixar desligado.

## O que você ganha

- **Link com a cara da Amazon:** o post mostra `link.amazon` em vez de `amzn.to`.
- **Nada para copiar:** a extensão do Chrome conecta e mantém a conexão em dia sozinha.
- **Nunca para de converter:** se a conexão cair, os links voltam a sair como `amzn.to` sozinhos.
- **Um link por produto:** por 30 dias, o mesmo produto gera sempre o mesmo `link.amazon`.

## Antes de começar

- O **[plugin Amazon](/docs/integracoes/amazon/)** já conectado com a sua tag.
- O Chrome no computador, com a **[extensão do Bot do Afiliado](/docs/comecando/extensao-chrome/)**.
- Ser dono ou admin do bot.

## Como configurar

1. Instale a extensão pela **[Chrome Web Store](https://chromewebstore.google.com/detail/bot-do-afiliado-%E2%80%94-postador/ngfhfiffemmlmnlpcolaibfagekidcaa)** e conecte com o painel.
2. No mesmo Chrome, entre em **[www.amazon.com.br](https://www.amazon.com.br/)** com a conta do **Amazon Associados**.
3. Clique na **engrenagem** da extensão.
4. No card **Cookies das lojas**, ligue a **Amazon** (ela vem desligada). Se o plugin Amazon tiver mais de uma conta, escolha qual recebe.

> **Atenção:** não clique em **Sair** na Amazon nesse Chrome. Sair desfaz a conexão. Se sair, é só entrar de novo que a extensão conecta outra vez.

## Como saber se funcionou

No painel, abra **Configurar › Lojas**, escolha **Amazon** e clique em **Configurar** na sua conta. O card **SiteStripe: link.amazon (opcional)** mostra **Conectado pela extensão do Chrome**, com a hora da última atualização.

<img src="/docs/integracoes/amazon-sitestripe-conectado.webp" alt="Card SiteStripe: link.amazon (opcional) mostrando Conectado pela extensão do Chrome, com a data e a hora da última atualização" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Depois, mande um link da Amazon para o seu bot no Telegram. Ele deve voltar como `link.amazon`.

## Se algo não der certo

- **Os links voltaram a sair como `amzn.to`:** a conexão com a Amazon venceu. Isso acontece quando o bot passa mais de um dia sem converter link da Amazon, quando você sai da conta no navegador ou quando a Amazon encerra a sessão. Entre de novo na Amazon no Chrome da extensão. Os `link.amazon` que já saíram continuam funcionando.
- **O link sai completo, sem `link.amazon` nem `amzn.to`:** a opção **Mandar o link longo (sem encurtar)**, no card **Formato do link**, está marcada. Desmarque e salve.
- **O card não mostra a conexão:** confira se você entrou na Amazon com a conta do **Amazon Associados** e se a Amazon está ligada em **Cookies das lojas**.

## Próximos passos

- Ofertas com nome, foto e preço: **[Creators API](/docs/integracoes/amazon-creators/)**.
- Tudo sobre a extensão: **[Extensão do Chrome](/docs/comecando/extensao-chrome/)**.

---

# DOC: Como conectar Shopee no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/shopee/
Atualizado: 2026-11-08
Descrição: Conecte a sua conta de afiliado da Shopee em poucos minutos e todo link da Shopee que passar pelo bot sai com o seu código, pronto para render comissão.

Conectando a Shopee, todo link da Shopee que você mandar para o bot (ou que ele postar por você) já sai com o **seu link de afiliado**. Você só faz isso uma vez.

## O que você ganha

- **Comissão garantida:** nenhum link da Shopee sai sem o seu código.
- **Menos trabalho:** você cola o link comum da Shopee e o bot devolve o seu link pronto.
- **Ofertas mais bonitas:** o bot puxa sozinho o nome e a foto do produto para montar o post.
- **Vendas separadas por origem:** com o Rastreamento padrão, o relatório da Shopee mostra o que veio do bot.

## Antes de começar

Você precisa de uma conta aprovada no **Programa de Afiliados da Shopee**. Se ainda não tem, faça o cadastro no site da Shopee Afiliados e espere a aprovação.

## Como configurar

1. Entre no **painel da Shopee Afiliados** e abra **Abrir API**.
2. Copie o **AppID** e o **Secret**. Se **Abrir API** não estiver liberada na sua conta, peça para a sua **gerente** da Shopee ou para o **suporte pelo chat do app**.
3. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **Shopee** e clique em **Conectar Shopee**.
4. Cole o AppID em **ID do app** e o Secret em **Chave secreta**.
5. Abra **Mais opções: nome, prioridade e rastreamento** e, em **Rastreamento padrão**, escreva uma etiqueta para identificar as suas vendas (por exemplo, o nome do seu canal). É o código que vai no link quando ninguém escolheu outro.
6. Clique em **Salvar**.

<video src="/docs/integracoes/shopee-conectar.mp4" poster="/docs/integracoes/shopee-conectar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: em Configurar › Lojas, clicar em Conectar Shopee, colar o ID do app e a Chave secreta, ver o Teste da conta mostrar Funcionando e clicar em Salvar" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/integracoes/shopee-conectar.gif" alt="Vídeo: em Configurar › Lojas, clicar em Conectar Shopee, colar o ID do app e a Chave secreta, ver o Teste da conta mostrar Funcionando e clicar em Salvar" /></video>

> **Dica:** assim que o ID do app e a Chave secreta estão preenchidos, o card **Teste da conta** confere sozinho se os dados estão certos, sem precisar de link de exemplo, e mostra **Funcionando** ou **Não funcionou**. Para conferir de novo, clique em **Testar de novo**.

## Como saber se funcionou

Em **Configurar › Lojas**, a Shopee aparece como **Conectada** e a sua conta fica com o status **Ativa**.

<img src="/docs/integracoes/shopee-conta.webp" alt="Card da Shopee com a conta conectada e o status Ativa" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Depois, mande um link de produto da Shopee para o seu bot no Telegram. Se ele responder com um link novo, pronto: esse link já é o seu.

## Se algo não der certo

- **O bot devolveu o mesmo link:** confira se o **ID do app** e a **Chave secreta** foram colados inteiros, sem espaço no começo ou no fim, e salve de novo.
- **O Teste da conta mostrou Não funcionou:** a sua conta de afiliado pode ainda não estar aprovada, ou a **Abrir API** não está liberada. Fale com a Shopee.

## Próximos passos

- Conecte outras lojas: **[AliExpress](/docs/integracoes/aliexpress/)**, **[Amazon](/docs/integracoes/amazon/)** e **[Mercado Livre](/docs/integracoes/mercado-livre/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender a tela de Plugins.

---

# DOC: Deixar passar sem converter (whitelist): links e domínios que ficam nos grupos
URL: https://botdoafiliado.com/docs/telegram/whitelist/
Atualizado: 2026-11-08
Descrição: No card Deixar passar sem converter você marca os sites e links que podem ficar nos seus grupos sem virar link de afiliado, como redes sociais e os seus canais, para eles não serem apagados.

O card **Deixar passar sem converter** (antes Lista liberada, ou whitelist) guarda os sites e links que podem ficar nos seus grupos mesmo sem virar link de afiliado. Nos grupos, o bot apaga o link que não consegue converter; o que está na lista fica.

## O que você ganha

- **Sua divulgação fica no grupo:** os links dos seus canais e redes sociais não são apagados.
- **Comissão continua sua:** nos grupos, link de loja que tem conversão vira o seu link de afiliado, mesmo estando na lista.
- **Menos aviso à toa:** o que está na lista não aparece em **[Alertas de canal](/docs/telegram/alertas-de-canal/)** nem em **Domínios pendentes**.
- **Configura uma vez:** a lista vale para todos os grupos do bot.

## Como configurar

1. No painel, abra **Configurar › Links sem loja** e vá até o card **Deixar passar sem converter**.
2. Escolha o tipo: **domínio** (o site inteiro, ex.: `youtube.com`) ou **link** (um endereço e o que vem depois dele, ex.: `https://t.me/seucanal`).
3. Digite o domínio ou o link. Em **Será salvo como:**, confira o que vai entrar.
4. Clique em **Adicionar**.

<img src="/docs/telegram/whitelist.webp" alt="Card Deixar passar sem converter: o tipo domínio escolhido, um link do YouTube digitado no campo, Será salvo como youtube.com logo abaixo, o botão Adicionar e a lista com Tipo, Valor e Excluir em cada linha" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Dica:** os mais comuns são `youtube.com`, `tiktok.com`, `instagram.com` e o link dos **seus** canais (`https://t.me/seucanal`).

## Ajustes opcionais

- Para tirar um item, clique em **Excluir** na linha dele.
- No card **Domínios pendentes**, **Liberar domínio** e **Liberar só este link** põem o item direto na lista.

## Como saber se funcionou

Espere cerca de 1 minuto e peça para um membro postar no grupo um link do site que você liberou. A mensagem deve continuar lá.

## Se algo não der certo

- **Um link encurtado (bit.ly, cutt.ly) foi apagado:** o bot não olha para onde o encurtador leva. Ponha o próprio encurtador na lista.
- **Acabei de adicionar e ainda apagou:** espere cerca de 1 minuto e teste de novo.
- **Quero que o link saia sem converter nem encurtar no post:** ponha o domínio neste mesmo card. No /c, no Puxador e nas campanhas ele sai como veio.

## Próximos passos

- Veja como o bot cuida dos **[grupos](/docs/telegram/grupos/)**.
- Entenda os **[links que não converteram](/docs/integracoes/loja-nao-mapeada/)**.
- Revise os **[Alertas de canal](/docs/telegram/alertas-de-canal/)**.

---

# DOC: Como conectar Awin no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/awin/
Atualizado: 2026-11-08
Descrição: Conecte a sua conta da Awin uma vez e o bot traz sozinho as lojas em que você foi aprovado. Todo link delas sai com o seu código e já encurtado.

A **Awin** é uma rede de afiliados: com uma conta só você divulga centenas de lojas. Conectando a Awin, todo link dessas lojas que passar pelo bot sai com o **seu link de afiliado**, já encurtado. Veja as lojas atendidas na **[lista de plugins](/plugins/)**.

## O que você ganha

- **Várias lojas numa conta só:** um cadastro na Awin cobre todas as lojas em que você foi aprovado.
- **Lojas entram sozinhas:** ao salvar, o bot traz as suas lojas aprovadas. Você não digita nada loja por loja.
- **Link pronto e curto:** você cola o link comum da loja e o bot devolve o seu link encurtado.
- **Cupom do link continua valendo:** se o link da loja já ativa um cupom, ele continua ativando.

## Antes de começar

Você precisa de uma conta de **publisher** (afiliado) aprovada na Awin. Depois, dentro da Awin, peça participação nos programas das lojas que quer divulgar.

## Como configurar

1. Na Awin, copie o seu **publisher ID** (o número da sua conta) em **[ui.awin.com/user](https://ui.awin.com/user)**.
2. Gere um **token de API** em **[ui.awin.com/awin-api](https://ui.awin.com/awin-api)** e copie. O token funciona como uma senha que deixa o bot usar a sua conta da Awin.
3. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **Awin** e clique em **Conectar Awin**.
4. Cole o publisher ID em **ID da conta** e o token em **Chave da API**. O país já vem como **BR**.
5. Espere o card **Teste da conta** mostrar **Funcionando** e clique em **Salvar**.

<img src="/docs/integracoes/awin-conta.webp" alt="Janela Conectar Awin com o ID da conta, a Chave da API escondida, o país BR e o Teste da conta mostrando Funcionando" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Ao salvar, o bot traz sozinho as lojas que você tem aprovadas na Awin.

## Ajustes opcionais

- **Mais de uma conta Awin:** se você tem publisher IDs diferentes por loja (por exemplo, Casas Bahia, Samsung e Americanas), cadastre cada conta em **Adicionar outra conta**. O bot escolhe a certa para cada loja.

## Como saber se funcionou

Mande para o seu bot no Telegram um link de uma loja em que você foi aprovado na Awin. Se ele responder com um link novo, pronto: esse link já é o seu.

## Se algo não der certo

- **Uma loja não converte:** confira se você já foi aprovado nela dentro da Awin. Se a aprovação é recente, clique em **Configurar** na conta da Awin e depois em **Atualizar lojas**.
- **Faltou uma loja brasileira, como a LG BR:** na conta da Awin, abra **País e programas**, confira se o país está em **BR** e clique em **Atualizar lojas**.

## Próximos passos

- Conecte outra rede de lojas: **[Rakuten](/docs/integracoes/rakuten/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender a tela de Plugins.

---

# DOC: Shopee Live: fila de produtos, página pública e overlay para as suas lives
URL: https://botdoafiliado.com/docs/telegram/shopee-live/
Atualizado: 2026-11-08
Descrição: Organize os pedidos da sua live da Shopee: o público manda o produto pela página ou pelo grupo, você adiciona em lotes e os produtos passam na tela pelo OBS.

O **Shopee Live** organiza os pedidos da sua live da Shopee numa **fila**: o público manda o código ou o link do produto, e você adiciona na live em lotes. Vem com uma **página pública** para os pedidos e um **overlay para o OBS**, que mostra na transmissão os produtos que você colocou no ar.

> **Módulo pago:** R$ 299/mês. Precisa do **plano base** ativo.

## O que você ganha

- **Pedidos num lugar só:** o que chega pela página e pelo grupo do Telegram cai na mesma fila.
- **Menos copia e cola:** você copia até 100 links de uma vez e cola na live da Shopee.
- **Produto na tela:** o overlay mostra foto, nome e preço do que você adicionou.
- **Público avisado:** quem pediu acompanha o status na página e é avisado quando o produto entra na live.

## Antes de começar

Ative o módulo:

1. No painel, abra **Conta › Plano e módulos**.
2. Marque **Shopee Live** e gere o checkout.

Veja **[como assinar](/docs/planos/como-assinar/)**.

## Como configurar

1. No painel, abra **Postar › Shopee Live**.
2. No card **Página pública da live**, preencha o **Endereço**, o **Título** e o **Link da live na Shopee** e clique em **Salvar página**.
3. Copie a URL do overlay no card. No **OBS**, adicione uma **Fonte de Navegador**, cole a URL, marque **fundo transparente** e use **1920 × 140** (1080p) ou **1280 × 96** (720p), ancorada na **base** da tela.

O endereço é o final do link da página (`botdoafiliado.com/live/seu-endereco`): de 2 a 40 letras minúsculas, números ou hífen.

> **Dica:** no OBS, deixe marcados "Desligar a fonte quando não estiver visível" e "Atualizar o navegador quando a cena ficar ativa".

## Durante a live

1. Clique em **Abrir Live**, use **Limpar** para tirar os testes e **Divulgar página** para copiar o link da página para o público.
2. Em **Fila (N)**, escolha o **Lote**, clique em **Copiar lote (N)**, cole os links na live da Shopee e clique em **Pronto (N)**.
3. No fim, clique em **Encerrar live**. O bot para de pegar produtos do grupo.

<img src="/docs/telegram/shopee-live-fila.webp" alt="Tela da live aberta: no topo Ao vivo · 3 na fila, Divulgar página, Limpar, Encerrar live e Sair; o campo Puxar produtos do chat da live; a Fila com três produtos, o Lote e o botão Copiar lote; e um produto em Já adicionados com Repor na fila" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

Os produtos marcados com **Pronto** passam no overlay. **Sair** fecha a tela sem encerrar a live.

Com a live aberta, código curto da Shopee (como `FKG-RXB-VTE`) ou link de produto mandado no grupo vai para a fila, em vez de virar link convertido. Você também pode colar o chat da live em **Puxar produtos do chat da live** e clicar em **Extrair e adicionar à fila**.

## Ajustes opcionais

- **Mensagem de boas-vindas**, **Instruções de envio**, **Logo da página**, **Foto do cupom / banner**, **Cor 1** e **Cor 2** deixam a página com a sua cara.
- **Domínio próprio:** digite um subdomínio seu (como `live.sualoja.com.br`), clique em **Conectar** e crie, no DNS do seu domínio, o registro **CNAME** que a tela mostra. Fica pronto quando aparece **No ar ✓**.
- **↩ Repor na fila**, em **Já adicionados**, faz um produto passar de novo no overlay.

## Como saber se funcionou

Abra a live, clique em **Divulgar página** e mande um link de produto da Shopee pela página. Ele deve aparecer na **Fila**. Antes de começar de verdade, clique em **Limpar**.

## Se algo não der certo

- **A página não carrega ou Abrir Live não abre:** o módulo **Shopee Live** não está ativo.
- **A live fechou sozinha:** ela fecha uns 10 minutos depois que a tela da live fica fechada. Deixe a aba aberta durante a transmissão.
- **Overlay ou domínio não funciona:** salve a página antes. O mesmo domínio não pode estar na Vitrine e na live ao mesmo tempo.

## Próximos passos

- Veja os **[módulos e preços](/docs/planos/modulos/)**.
- Monte a sua **[Vitrine](/docs/comecando/vitrine/)**.

---

# DOC: Como conectar Rakuten no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/rakuten/
Atualizado: 2026-11-08
Descrição: Conecte a sua conta da Rakuten Advertising com três dados e o bot traz sozinho as lojas em que você foi aprovado. Todo link delas sai no seu nome e encurtado.

A **Rakuten Advertising** é uma rede de afiliados: com uma conta você divulga várias lojas. Conectando a Rakuten, todo link dessas lojas que passar pelo bot sai com o **seu link de afiliado**, já encurtado.

## O que você ganha

- **Várias lojas numa conta só:** um cadastro na Rakuten cobre todas as lojas em que você foi aprovado.
- **Lojas entram sozinhas:** ao salvar, o bot traz as suas lojas aprovadas. Você não digita nada loja por loja.
- **Nada para renovar:** a chave temporária da Rakuten é gerada pelo bot sozinho, sempre que precisa.
- **Link pronto e curto:** você cola o link comum da loja e o bot devolve o seu link encurtado.

## Antes de começar

Você precisa de uma conta de **publisher** (afiliado) aprovada na Rakuten Advertising. Depois, dentro da Rakuten, peça participação nas lojas (anunciantes) que quer divulgar.

## Como configurar

1. No painel da Rakuten, anote o seu **SID**. É o número da sua conta (Account ID), que aparece com `sid` na frente.
2. Abra o **[painel de API](https://developers.rakutenadvertising.com/default/dashboard/)** da Rakuten e clique em **Add Application**.
3. Copie o **Client ID** e o **Client Secret** da aplicação criada. Eles funcionam como um usuário e uma senha que deixam o bot usar a sua conta.

<img src="/docs/integracoes/rakuten-token.png" alt="Painel de API da Rakuten mostrando o Client ID e o Client Secret da aplicação" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

4. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **Rakuten** e clique em **Conectar Rakuten**.
5. Preencha **Número da conta (SID)**, **ID do app** (o Client ID) e **Chave secreta do app** (o Client Secret).
6. Clique em **Salvar**.

<img src="/docs/integracoes/rakuten-plugin.webp" alt="Janela Conectar Rakuten com o número da conta, o ID do app e a chave secreta preenchidos e o Teste da conta mostrando Funcionando" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Dica:** a Rakuten também oferece um "access token". Você não precisa gerar nem colar: o bot cria sozinho sempre que precisa.

Ao salvar, o bot traz sozinho as lojas que você tem aprovadas na Rakuten.

## Como saber se funcionou

Mande para o seu bot no Telegram um link de uma loja em que você foi aprovado na Rakuten. Se ele responder com um link novo, pronto: esse link já é o seu.

## Se algo não der certo

- **Uma loja não converte:** confira se você já foi aprovado nela dentro da Rakuten. Se a aprovação é recente, clique em **Configurar** na conta da Rakuten e depois em **Atualizar lojas**.

## Próximos passos

- Conecte outra rede de lojas: **[Awin](/docs/integracoes/awin/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender a tela de Plugins.

---

# DOC: Puxador: monitore canais de promoções e reposte com o seu link
URL: https://botdoafiliado.com/docs/telegram/userbot/
Atualizado: 2026-11-08
Descrição: O Puxador lê canais de promoções com a sua conta do Telegram, troca os links pelos seus e deixa cada oferta esperando o seu OK antes de ir para o seu canal.

O **Puxador** (antes chamado Userbot) usa a **sua conta do Telegram** para ler os canais de promoções que você escolher. Quando sai uma oferta nova, ele troca os links pelos seus de afiliado e coloca a oferta numa **fila de aprovação**. Nada vai ao ar sem o seu OK.

> **Módulo pago:** **R$ 99,90/mês**, além do **plano base**. Contrate em **Conta › Plano e módulos** ([como assinar](/docs/planos/como-assinar/)).

> **Atenção:** quem entra nos canais é a **sua conta pessoal**, não um bot. Automação em conta de usuário vai contra o uso comum do Telegram, e a conta pode ser limitada. O risco é seu: pense bem antes de conectar a sua conta principal.

## O que você ganha

- **Comissão sua:** os links de cada oferta saem trocados pelos seus de afiliado.
- **Você decide o que sai:** cada oferta espera o seu OK no painel e num grupo do Telegram.
- **Sem oferta repetida:** se o mesmo produto já saiu no seu canal nas últimas 2 horas (o prazo dá para mudar), a oferta ganha o selo **Já postado**.
- **Sem oferta velha:** oferta com mais de 3 horas sai da fila sozinha, porque preço de promoção muda rápido.
- **Computador desligado:** tudo roda no nosso servidor.

## Antes de começar

- O módulo **Puxador** ativo.
- Um **grupo do Telegram** para aprovar as ofertas, com o seu bot como **administrador**. Cada canal de origem ganha um tópico próprio nesse grupo.
- O **canal** onde as ofertas aprovadas vão sair.
- A sua conta do Telegram precisa ser **membro** de cada canal de promoções que você quer acompanhar.

Para escolher cada canal e grupo, você busca pelo nome ou cola o @ ou o link do t.me. Se preferir usar o **ID** (o número que o Telegram usa para identificá-lo, que começa com `-100`), clique em **Avançado: colar o ID -100…**. Para descobrir o ID, encaminhe uma mensagem do canal ou grupo para o `@userinfobot` (ou o `@getidsbot`) e ele responde com o número.

## Como configurar

No painel, abra **Postar › Puxador** e vá na aba **Configuração**. O card **Como ligar o Puxador** mostra os quatro passos e quantos já estão prontos.

<img src="/docs/telegram/puxador-configuracao.webp" alt="Aba Configuração do Puxador: o card Como ligar o Puxador com 2 de 4 passos prontos e, embaixo, as telas Conta e captura, Onde aprovar e publicar, Regras de destino, Texto, foto e bloqueio, Post de cupom e Aprovação automática" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

1. **Conectar a conta:** abra **Conta e captura**, clique em **Conectar conta**, digite o seu telefone com +55 e DDD (ex.: `+5511999998888`) e clique em **Enviar código**. Digite o código que chegou no app do Telegram em **Confirmar código** e, se a sua conta tiver verificação em duas etapas, a senha em **Confirmar senha**.
2. **Grupo e destino:** em **Onde aprovar e publicar**, escolha o **Grupo de aprovação** e o **Canal de destino padrão**. Busque na lista ou cole o @ ou o link do t.me.
3. **Canais de origem:** na aba **Fontes**, busque cada canal de promoções ou cole o @ ou o link do t.me (o **Apelido (opcional)** ajuda a reconhecer) e clique em **Adicionar e configurar**. Da segunda fonte em diante, clique antes em **Adicionar mais**.
4. **Ligar o Puxador:** em **Conta e captura**, ligue a chave **Puxador ligado** e clique em **Salvar configuração**.

Com os quatro passos feitos, o card some.

## Como aprovar as ofertas

As ofertas aparecem na aba **Aprovação** e no seu grupo de aprovação. Em cada uma, clique em **Aprovar**, **Corrigir** ou **Descartar**.

- **Já postado às 14:32:** esse produto já saiu no seu canal. Se quiser publicar de novo, use **Postar mesmo assim**.
- **Link em erro:** algum link não virou link seu. Dá para aprovar assim mesmo, mas confira antes.
- Saiu algo errado? Em **Corrigir**, ajuste o texto à mão ou com **Corrigir com IA** e salve. Em alguns erros, o painel sugere uma regra para os próximos posts daquele canal, que só vale se você clicar em **Aplicar ao canal**.

A aba **Histórico** mostra o que chegou de cada canal e como ficou.

<video src="/docs/telegram/puxador-aprovar.mp4" poster="/docs/telegram/puxador-aprovar.webp" autoplay muted loop playsinline controls aria-label="Vídeo: na aba Aprovação do Puxador, conferir uma oferta da fila com o link de afiliado, clicar em Aprovar e ver a fila passar de 3 para 2 ofertas" style="display:block;margin:18px auto;max-width:860px;width:100%;border-radius:12px;border:1px solid var(--border)"><img src="/docs/telegram/puxador-aprovar.gif" alt="Vídeo: na aba Aprovação do Puxador, conferir uma oferta da fila com o link de afiliado, clicar em Aprovar e ver a fila passar de 3 para 2 ofertas" /></video>

## Ajustes opcionais

- **O que publicar:** em **Configuração › Texto, foto e bloqueio**, escolha se o **Texto** e a **Foto** vêm da **Fonte** (o post do canal, só com os seus links) ou da **Loja** (título e foto do produto na loja, igual ao seu `/oferta`).
- **Regras de destino:** mande ofertas para outros canais por palavra no título ou no texto, em **Configuração › Regras de destino**, botão **Nova regra**.
- **Post de cupom:** em **Configuração › Post de cupom**, use um modelo de texto seu e uma imagem para cada loja.
- **Bloquear em todos os canais:** palavras que descartam a oferta antes de ela chegar na fila.
- **Publicar na Vitrine ao aprovar** e **Cadastrar cupons no módulo Cupons ao aprovar:** levam a oferta aprovada para a sua **[Vitrine](/docs/comecando/vitrine/)** e o código do cupom para o módulo **[Cupons](/modulos/cupons/)**.

## Como saber se funcionou

Na aba **Configuração**, em **Conta e captura**, a **Conta do Telegram** aparece como **Conectada · capturando**. Quando um canal de origem postar uma oferta, ela aparece na aba **Aprovação** e no seu grupo de aprovação.

<img src="/docs/telegram/puxador-aprovacao.webp" alt="Oferta na fila de aprovação do Puxador: Pronta para aprovar, o canal de origem e o destino, o preço, a foto, o texto com o link de afiliado e os botões Aprovar, Corrigir, Copiar e Descartar" style="display:block;margin:18px auto;max-width:520px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Se algo não der certo

- **A conta aparece como Sessão inválida — reconecte:** clique em **Conectar conta** e faça o login de novo.
- **Nenhuma oferta chega:** confira se a chave **Puxador ligado** está ligada, se a sua conta é membro dos canais de origem e se o bot é administrador do grupo de aprovação.
- **A oferta sumiu da fila:** passou de 3 horas. Ela vai para o **Histórico** como descartada.
- **O card mostra Confira se chegou:** abra o canal de destino. Se a oferta chegou, cole o link da mensagem em **Links das mensagens que chegaram** e clique em **Conferi: a oferta chegou**. Se não chegou, clique em **Conferi: não chegou**.

## Próximos passos

- Ajuste o texto das ofertas em **[Aparência das ofertas › Texto e rodapé](/docs/telegram/ofertas/)**.
- Configure a foto e a marca d'água em **[Fotos e chamada](/docs/telegram/fotos-e-ctas/)**.
- Veja **[módulos e preços](/docs/planos/modulos/)**.

---

# DOC: Parceiro Magalu: links no automático
URL: https://botdoafiliado.com/docs/integracoes/magalu/
Atualizado: 2026-11-08
Descrição: Cole um link de afiliado seu do Magalu e o bot acha sozinho o seu promoter ID. Com o nome da sua loja, até vitrines e páginas especiais saem no seu nome.

Conectando o **Magalu**, todo link do Magalu que passar pelo bot vira o **seu link do Parceiro Magalu / Magazine Você**. Você não precisa procurar o seu código: basta colar um link de afiliado seu que o bot acha o resto.

## O que você ganha

- **Sem caçar código:** você cola um link seu e o bot preenche sozinho o seu **promoter ID** (o código que identifica você como parceiro Magalu).
- **Comissão garantida:** links de produto e de oferta saem com o seu código.
- **Vitrines também:** com o identificador da sua loja, vitrines e páginas especiais saem no seu nome.
- **Links de divulgação aceitos:** links do divulgador do Magalu também são convertidos.

## Antes de começar

Você precisa ser **Parceiro Magalu / Magazine Você** e conseguir gerar os seus links de afiliado lá.

## Como configurar

1. No **Parceiro Magalu / Magazine Você**, gere um link de afiliado de qualquer produto, ou copie um link da sua vitrine.
2. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **Magalu** e clique em **Conectar Magalu**.
3. Cole o link no campo **Cole um link do Magalu** e clique em **Ler o link**. O campo **ID de afiliado** é preenchido sozinho.
4. Confira o campo **Identificador da sua loja**. Se estiver vazio, abra a sua vitrine e copie o trecho que vem logo depois de `magazinevoce.com.br/` no endereço (por exemplo, `magazineminhaloja`).
5. Clique em **Salvar**.

<img src="/docs/integracoes/magalu-plugin.webp" alt="Janela Conectar Magalu depois de Ler o link, com o ID de afiliado e o Identificador da sua loja preenchidos sozinhos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Dica:** sem o identificador da loja, os links de produto já saem com o seu promoter ID, mas vitrines e páginas especiais não convertem. Preencha para cobrir tudo.

## Ajustes opcionais

- **Editar a conta:** clique em **Configurar** na linha dela. Abre com os dados salvos e o **ID de afiliado** para conferir ou mudar.

## Como saber se funcionou

Mande um link de produto do Magalu para o seu bot no Telegram. Se ele responder com um link novo, pronto: esse link já é o seu.

## Se algo não der certo

- **Vitrine ou página especial não converte:** preencha o **Identificador da sua loja** e salve de novo.
- **O identificador da loja sumiu:** ler outro link troca os dados detectados e apaga o identificador quando o novo link não traz a loja. Preencha de novo antes de salvar.

## Próximos passos

- Conecte outras lojas: **[Mercado Livre](/docs/integracoes/mercado-livre/)**, **[Shopee](/docs/integracoes/shopee/)** e **[Amazon](/docs/integracoes/amazon/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender a tela de Plugins.

---

# DOC: Mercado Livre Afiliados: link no automático
URL: https://botdoafiliado.com/docs/integracoes/mercado-livre/
Atualizado: 2026-11-08
Descrição: Coloque a sua etiqueta e conecte o Mercado Livre pela extensão do Chrome uma vez. Depois todo link do ML sai com a sua comissão, sem você copiar nada.

Conectando o **Mercado Livre**, todo link do ML que passar pelo bot sai com a **sua etiqueta de afiliado**. O bot também mostra os dados e o histórico de preços do produto. Você configura uma vez: a etiqueta no painel e o login pela **[extensão do Chrome](/docs/comecando/extensao-chrome/)**.

## O que você ganha

- **Comissão garantida:** todo link do Mercado Livre sai com a sua etiqueta.
- **Sem copiar nada:** a extensão do Chrome leva o seu login do Mercado Livre para o bot e mantém atualizado sozinha.
- **Link que abre o produto certo:** o bot confere cada link e, se ele abrir o lugar errado, gera de novo com outra etiqueta sua.
- **Histórico de preços:** o bot mostra quanto o produto já custou.

## Antes de começar

- O **programa de afiliados** do Mercado Livre ativado na sua conta.
- O **Google Chrome** no computador, para instalar a extensão.
- Ser **dono ou admin** do bot no painel.

## Como configurar

### Parte 1: a etiqueta

1. Abra o **[Administrador de etiquetas](https://www.mercadolivre.com.br/afiliados/adminlabel#hub)** do Mercado Livre e copie a etiqueta (tag) em uso. A etiqueta é o nome que marca os seus links no relatório do ML.
2. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **Mercado Livre** e clique em **Conectar Mercado Livre**.
3. Em **Etiqueta de afiliado**, cole a sua etiqueta (por exemplo, `minhaetiqueta`).
4. Clique em **Salvar**.

### Parte 2: o login pela extensão

1. Instale a extensão pela **[Chrome Web Store](https://chromewebstore.google.com/detail/bot-do-afiliado-%E2%80%94-postador/ngfhfiffemmlmnlpcolaibfagekidcaa)** e conecte com o painel (veja **[extensão do Chrome](/docs/comecando/extensao-chrome/)**).
2. No mesmo Chrome, entre no **Mercado Livre** com a sua conta de afiliado.
3. Na **engrenagem** da extensão, no card **Cookies das lojas**, ligue o **Mercado Livre**. Ele vem desligado.

> **Dica:** crie pelo menos mais uma etiqueta no **Administrador de etiquetas**. Às vezes o Mercado Livre gera um link que abre o lugar errado, e com uma etiqueta extra o bot consegue gerar de novo. A comissão continua na mesma conta.

## Ajustes opcionais

- **Etiquetas reserva:** escolha quais etiquetas o bot usa quando precisa gerar de novo, separadas por vírgula. Se deixar vazio, ele usa as outras etiquetas da sua conta (até 3).
- **Duas ou mais contas no plugin:** na extensão, escolha qual delas recebe o login.

## Como saber se funcionou

Em **Configurar › Lojas**, escolha **Mercado Livre** e clique em **Configurar** na sua conta. O card **Credenciais Mercado Livre** mostra **Conectado pela extensão do Chrome**, com a hora da última atualização. Depois mande um link do Mercado Livre para o seu bot no Telegram. Se ele responder com um link novo, esse link já é o seu.

<img src="/docs/integracoes/ml-plugin.webp" alt="Card Credenciais Mercado Livre com a Etiqueta de afiliado preenchida e o aviso Conectado pela extensão do Chrome" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Se algo não der certo

- **A conversão deu erro e o link não veio:** o Mercado Livre gerou um link que abre outro lugar (o seu perfil ou o anúncio de outro vendedor) e nenhuma etiqueta resolveu. Crie mais uma etiqueta e tente de novo.
- **Não aparece "Conectado pela extensão do Chrome":** confira se você está logado no Mercado Livre no mesmo Chrome da extensão e se o Mercado Livre está ligado em **Cookies das lojas**.
- **Entrei com outra conta do Mercado Livre:** o login de outra conta não é gravado, para o link não sair no nome de outra pessoa. Entre com a sua conta de afiliado.

## Próximos passos

- Veja tudo o que a **[extensão do Chrome](/docs/comecando/extensao-chrome/)** faz.
- Use o histórico de preços pelos **[comandos do Telegram](/docs/telegram/comandos/)**.

---

# DOC: Afiliado Terabyte: como entrar no programa
URL: https://botdoafiliado.com/docs/integracoes/terabyte/
Atualizado: 2026-11-08
Descrição: Entre no programa de afiliados da Terabyte, coloque o seu identificador no bot e todo link da Terabyteshop vira o seu link de afiliado, já encurtado.

Conectando a **Terabyte**, todo link da Terabyteshop que você manda ao bot, cola no painel ou na extensão vira o **seu link de afiliado**, já encurtado. Antes, você precisa entrar no programa de afiliados da loja.

## O que você ganha

- **Sem gerar link um por um:** você usa o link comum da Terabyteshop e o bot devolve o seu.
- **Venda no seu nome:** o bot coloca o seu identificador de afiliado em cada link.
- **Configuração simples:** não precisa de chave de API, só os dados do seu programa.
- **Link curto:** o link sai encurtado, pronto para postar.

## Como entrar no programa

1. No site da **Terabyteshop**, procure a área de **afiliados**. O cadastro é feito direto com a loja.
2. Envie a sua inscrição, dizendo onde você divulga (canal do Telegram, grupo de WhatsApp, site, YouTube).
3. Aprovado, gere um link pelo programa. O valor que vem depois de `?p=` no link é o seu **identificador de afiliado**. Guarde esse valor.

Comissão e regras de pagamento mudam por categoria e campanha. Confira os valores atuais na página oficial do programa.

Se a Terabyte é só uma das lojas que você divulga, veja também o **[guia de afiliação por marketplace](/blog/guia-de-afiliacao-por-marketplace/)**.

## Como configurar

1. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **Terabyte** e clique em **Conectar Terabyte**.
2. Em **ID de afiliado**, cole o seu identificador de afiliado (o valor depois de `?p=`).
3. Em **Origem**, **Meio** e **Campanha** (no link, `utm_source`, `utm_medium` e `utm_campaign`), preencha os UTMs que o programa passou (por exemplo, o nome da campanha). UTM é uma etiqueta no link que mostra à loja de onde veio a visita.
4. Clique em **Salvar**.

<img src="/docs/integracoes/terabyte-plugin.webp" alt="Janela Conectar Terabyte com o ID de afiliado e os UTMs preenchidos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

Mande um link de produto da Terabyteshop para o seu bot no Telegram. Se ele responder com um link curto, pronto: esse link já é o seu.

## Próximos passos

- Converta links da Terabyteshop também pela **[extensão do Chrome](/docs/comecando/extensao-chrome/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para conectar outras lojas.

---

# DOC: Como conectar Pague Menos no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/pague-menos/
Atualizado: 2026-11-08
Descrição: Coloque o seu código de consultor da plataforma Mais uma vez e todo link da Pague Menos sai no seu nome, encurtado e com o seu código lembrado no post.

Com o plugin **Pague Menos**, todo link de `paguemenos.com.br` que passar pelo bot vira o **seu link de afiliado da plataforma Mais**, com o seu código de consultor. O post ainda lembra o seu código, que dá desconto a quem compra.

## O que você ganha

- **Venda no seu nome:** todo link da Pague Menos sai com o seu código, e códigos de outras redes saem do link.
- **Desconto para o cliente:** o fim do post lembra o seu código de consultor, pronto para copiar.
- **Configuração simples:** é um campo só. Não precisa de senha nem chave da loja.
- **Link curto:** o bot devolve o link já encurtado.

## Antes de começar

Tenha em mãos o seu **código de consultor** (ou de afiliado) da **plataforma Mais**, da Pague Menos.

## Como configurar

1. No painel do Bot do Afiliado, abra **Configurar › Lojas** e escolha **Pague Menos**.
2. Clique em **Conectar Pague Menos**. Abre o card **Dados da Pague Menos**.
3. Em **Código do consultor**, escreva o seu código.
4. Clique em **Salvar**.

<img src="/docs/integracoes/pague-menos-plugin.webp" alt="Janela Conectar Pague Menos com o Código do consultor preenchido" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Ajustes opcionais

- **Texto do código de consultor:** para mudar a frase do fim do post, abra **Configurar › Aparência das ofertas**, aba **Texto e rodapé**, e em **Formato que deseja editar** escolha **Pague Menos (consultor)** (no grupo **Cupom por loja**). Use `{consultor}` onde o código deve aparecer.

## Como saber se funcionou

Mande um link de produto da Pague Menos para o seu bot no Telegram. Se ele responder com um link curto, pronto: esse link já é o seu.

## Se algo não der certo

- **Apareceu "Configure o seu código de consultor no plugin Pague Menos.":** o campo **Código do consultor** está vazio. Preencha e salve.
- **Apareceu "URL inválida para Pague Menos.":** o texto colado não é um link completo. Cole o link inteiro, começando com `https://`.
- **O link sai sem o seu código:** em **Configurar › Lojas**, confira se a conta da Pague Menos está ativa e com a maior prioridade.

## Próximos passos

- Ajuste o texto dos posts em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender prioridade e contas.

---

# DOC: Como conectar Braé no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/brae/
Atualizado: 2026-11-08
Descrição: Coloque o seu código de parceiro da Braé uma vez e todo link da loja sai no seu nome, encurtado e, se quiser, com o seu cupom no post.

Com o plugin **Braé**, todo link de `brae.com.br` que passar pelo bot vira o **seu link de afiliado**, com o seu código de parceiro. Se você cadastrar um cupom, o post já sai com o código pronto para copiar.

## O que você ganha

- **Venda no seu nome:** se o link trazia o código de outra pessoa, o seu entra no lugar.
- **Configuração simples:** basta o seu código de parceiro. Não precisa de senha nem chave da loja.
- **Link curto:** o bot devolve o link já encurtado.
- **Cupom pronto para copiar:** com um cupom cadastrado, o post ganha uma linha com o código, que a pessoa copia com um toque.

## Antes de começar

Tenha em mãos o seu **código de parceiro** da Braé. É o mesmo código que aparece nos links que você gera no programa de parceiros da loja.

## Como configurar

1. No painel do Bot do Afiliado, abra **Configurar › Lojas** e escolha **Braé**.
2. Clique em **Conectar Braé**. Abre o card **Dados da Braé**.
3. Em **Código de parceiro**, escreva o seu código.
4. Se quiser, preencha **Cupom (opcional)** com o cupom que você divulga (por exemplo, `BRAE10`).
5. Clique em **Salvar**.

<img src="/docs/integracoes/brae-plugin.webp" alt="Janela Conectar Braé com o Código de parceiro e o cupom preenchidos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Dica:** o post mostra o cupom como **Cupom 10% OFF**. Para mudar esse texto, abra **Configurar › Aparência das ofertas**, aba **Texto e rodapé**, e em **Formato que deseja editar** escolha **Brae** (no grupo **Cupom por loja**). Use `{cupom}` onde o código deve aparecer.

## Como saber se funcionou

Mande um link de produto da Braé para o seu bot no Telegram. Se ele responder com um link curto, pronto: esse link já é o seu.

## Se algo não der certo

- **Apareceu "Configure o seu código de parceiro no plugin Braé.":** o campo **Código de parceiro** está vazio. Preencha e salve.
- **Apareceu "URL inválida para Braé.":** o texto colado não é um link completo. Cole o link inteiro, começando com `https://`.
- **Link de outra loja não converte:** este plugin só atende a Braé. Para outras lojas, conecte o plugin delas.

## Próximos passos

- Ajuste o texto dos posts em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para conectar outras lojas.

---

# DOC: Central do Afiliado: contas e compartilhamento
URL: https://botdoafiliado.com/docs/integracoes/central-do-afiliado/
Atualizado: 2026-11-08
Descrição: A Central do Afiliado é a sua conta única do Bot do Afiliado. Entre no painel com ela e ligue o bot ao Painel do Afiliado para ver as suas vendas no dashboard.

A **[Central do Afiliado](https://central.botdoafiliado.com)** é a sua conta única do Bot do Afiliado. Com ela você entra no painel e liga o bot ao **Painel do Afiliado**, para ver as suas vendas direto no dashboard do bot.

> **Atenção:** não confunda com a "Central do Afiliado" da Shopee, que é o portal de afiliados da loja. A do Bot fica em `central.botdoafiliado.com`.

## O que você ganha

- **Uma conta só:** você entra no painel do bot com a Central e organiza nela os seus produtos (Bot, Painel do Afiliado e Pixel).
- **Vendas no dashboard do bot:** com o bot e o Painel na mesma organização, o dashboard do bot mostra as vendas e o catálogo do Painel.
- **Conferir se as vendas chegaram:** a Central mostra a última importação de vendas do Painel para o bot, com horário, quantidade e erros.

## Entrar no painel

Ao abrir o **[painel](https://app.botdoafiliado.com/)**, você passa pela Central e volta já logado. Se não entrar, a tela **Entrar** oferece e-mail, Google, passkey e o botão **Entrar com a Central do Afiliado**. Mais em **[acessar o painel](/docs/comecando/acessar-painel/)**.

## Como ver as vendas do Painel no bot

Você precisa ser **owner** (dono) do bot e também da organização na Central. Quem não é dono não consegue ligar.

1. No painel do bot, abra o menu da conta, no rodapé, e clique em **Organização e membros**.
2. No card **Central do Afiliado**, escolha a organização da Central em que está o seu Painel do Afiliado (se você só tem uma, ela já aparece) e clique em **Vincular este bot**.
3. Confira se essa organização tem **um só** Painel do Afiliado.
4. Confira se o Painel está ligado à **mesma** organização. Se ele foi movido ou desligado, os dados somem do bot.

<img src="/docs/integracoes/central-vincular.webp" alt="Card Central do Afiliado com a organização Minha Loja de Ofertas e o botão Vincular este bot" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

O card **Central do Afiliado** passa a mostrar **Vinculado**. Abra o dashboard do bot: o card do Painel do Afiliado passa a mostrar as suas vendas.

## Se algo não der certo

- **O card diz que há mais de um Painel vinculado:** deixe só um Painel na organização. O bot não escolhe nenhum no seu lugar.
- **O card diz "Não deu para consultar a Conta do Afiliado agora. Recarregue em instantes.":** espere um pouco e recarregue a página.
- **A Central recusou o vínculo:** só o owner da organização na Central pode ligar o bot a ela.
- **Vendas novas não aparecem:** na Central, veja se a sincronização automática está ligada. Desligada, as vendas novas precisam ser importadas pelo bot. Só abrir a Central não importa nada.

## Outros produtos

O **Pixel** também aparece entre os produtos da Central. O **Nota do Afiliado** aparece, mas continua com o próprio login.

## Próximos passos

- Veja como funciona a tela **[Organização](/docs/comecando/organizacao/)**.
- Conheça o **[dashboard](/docs/comecando/dashboard/)** do bot.

---

# DOC: Resgate de cupons Mercado Livre por horário
URL: https://botdoafiliado.com/docs/referencia/resgate-mercado-livre/
Atualizado: 2026-11-08
Descrição: O resgate de cupons do Mercado Livre por horário é usado pela operação Nerd Ofertas e não é uma configuração para assinantes. Veja como cadastrar cupons no seu bot.

O resgate por horário é um recurso da operação **Nerd Ofertas**: ela acompanha os horários da campanha do Mercado Livre, resgata cada cupom assim que ele é liberado e só publica depois de confirmar que ele está ativo na conta. **Não é uma configuração disponível para assinantes.**

## Como funciona na prática

- O cupom é resgatado assim que o botão é liberado na página da campanha do Mercado Livre.
- Ele só é publicado depois de aparecer na lista de cupons ativos da conta e quando a validade já começou.
- O mesmo cupom não sai repetido nos canais.
- O rodapé das mensagens mostra quantos cupons do Mercado Livre estão ativos e leva para nerdcupons.com/mercado-livre.

## Próximos passos

- Para cadastrar cupons no seu bot, veja **[Cupons](/docs/telegram/cupons/)**.
- Para converter links do Mercado Livre com a sua conta, veja **[Mercado Livre](/docs/integracoes/mercado-livre/)**.

---

# DOC: Como conectar Beleza na Web no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/belezanaweb/
Atualizado: 2026-11-08
Descrição: Coloque o seu código de consultor da Beleza na Web uma vez e todo link da loja sai no seu nome, encurtado e, se quiser, com o seu cupom no post.

Com o plugin **Beleza na Web**, todo link de `belezanaweb.com.br` que passar pelo bot vira o **seu link de afiliado**, com o seu código de consultor. Se você cadastrar um cupom, o post já sai com o código pronto para copiar.

## O que você ganha

- **Venda no seu nome:** todo link da Beleza na Web sai com o seu código, mesmo que ele tenha vindo de outro afiliado.
- **Configuração simples:** basta o seu código de consultor. Não precisa de senha nem chave da loja.
- **Link curto:** o bot devolve o link já encurtado.
- **Cupom pronto para copiar:** com um cupom cadastrado, o post ganha uma linha com o código, que a pessoa copia com um toque.

## Antes de começar

Tenha em mãos o seu **código de consultor** do programa da Beleza na Web.

## Como configurar

1. No painel do Bot do Afiliado, abra **Configurar › Lojas** e escolha **Beleza na Web**.
2. Clique em **Conectar Beleza na Web**. Abre o card **Dados da Beleza na Web**.
3. Em **Código do consultor**, escreva o seu código.
4. Se quiser, preencha **Cupom (opcional)** com o cupom que você divulga.
5. Clique em **Salvar**.

<img src="/docs/integracoes/belezanaweb-plugin.webp" alt="Janela Conectar Beleza na Web com o Código do consultor e o cupom preenchidos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

> **Dica:** o post mostra o cupom como **Cupom 10% OFF**. Para mudar esse texto, abra **Configurar › Aparência das ofertas**, aba **Texto e rodapé**, e em **Formato que deseja editar** escolha **Beleza na Web** (no grupo **Cupom por loja**). Use `{cupom}` onde o código deve aparecer.

## Como saber se funcionou

Mande um link de produto da Beleza na Web para o seu bot no Telegram. Se ele responder com um link curto, pronto: esse link já é o seu.

## Se algo não der certo

- **Apareceu "Configure o seu código de consultor no plugin Beleza na Web.":** o campo **Código do consultor** está vazio. Preencha e salve.
- **Apareceu "URL inválida para Beleza na Web.":** o texto colado não é um link completo. Cole o link inteiro, começando com `https://`.
- **O link não converte:** confira em **Configurar › Lojas** se a conta está ativa e, em **Configurar › Rotas próprias**, se a Beleza na Web aparece.

## Próximos passos

- Ajuste o texto dos posts em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender a tela de Plugins.

---

# DOC: Como conectar Natura no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/natura/
Atualizado: 2026-11-08
Descrição: Coloque o seu código de consultoria Natura uma vez e todo link da Natura, inclusive da loja de consultora, sai no seu nome, encurtado e com o seu cupom.

Com o plugin **Natura**, todo link de `natura.com.br` ou da loja de consultora `minhaloja.natura.com` que passar pelo bot vira o **seu link de consultoria**. Se você cadastrar um cupom, o post já sai com o código.

## O que você ganha

- **Venda no seu nome:** se o link colado é da consultoria de outra pessoa, o código dela sai e o seu entra.
- **Natura e Avon:** links da loja de consultora com produtos Avon também saem com o seu código.
- **Configuração simples:** basta o seu código de consultoria. Uma conta cobre todos os sites da Natura.
- **Link curto e cupom pronto:** o bot devolve o link encurtado e, com um cupom cadastrado, o código aparece no post.

## Antes de começar

Tenha em mãos o seu **código de consultoria** Natura.

## Como configurar

1. No painel do Bot do Afiliado, abra **Configurar › Lojas** e escolha **Natura**.
2. Clique em **Conectar Natura**. Abre o card **Dados da Natura**.
3. Em **Código do consultor**, escreva o seu código de consultoria.
4. Se quiser, preencha **Cupom (opcional)** com o cupom que você divulga (por exemplo, `NATURA10`).
5. Clique em **Salvar**.

<img src="/docs/integracoes/natura-plugin.webp" alt="Janela Conectar Natura com o Código do consultor e o cupom preenchidos" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Ajustes opcionais

- **Texto do cupom:** para mudar a linha do cupom no post, abra **Configurar › Aparência das ofertas**, aba **Texto e rodapé**, e em **Formato que deseja editar** escolha **Natura** (no grupo **Cupom por loja**). Use `{cupom}` onde o código deve aparecer.

## Como saber se funcionou

Mande um link de produto da Natura para o seu bot no Telegram. Se ele responder com um link curto, pronto: esse link já é o seu.

## Se algo não der certo

- **Apareceu "Configure o código da sua consultoria no plugin Natura.":** o campo **Código do consultor** está vazio. Preencha e salve.

## Próximos passos

- Ajuste o texto dos posts em **[mensagens e variáveis](/docs/telegram/mensagens-e-variaveis/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para conectar outras lojas.

---

# DOC: Como conectar CityAds no Bot do Afiliado e gerar links e ofertas automaticamente
URL: https://botdoafiliado.com/docs/integracoes/cityads/
Atualizado: 2026-11-08
Descrição: Conecte a sua conta da CityAds e o bot traz sozinho as suas lojas brasileiras. Todo link delas vira o seu link de afiliado, até de páginas internas da loja.

Conectando a **CityAds**, o bot traz sozinho as lojas brasileiras que você tem na rede, e todo link delas vira o **seu link de afiliado**. O link pode levar a qualquer página da loja, não só à página inicial.

## O que você ganha

- **Lojas entram sozinhas:** ao salvar, o bot traz as lojas brasileiras que você já tem conectadas na CityAds.
- **Link para qualquer página:** produto, categoria ou promoção, o link leva direto à página certa da loja.
- **Cupom do link continua valendo:** se o link da loja já ativa um cupom, ele continua ativando.
- **Você escolhe as lojas:** a loja que você não quer converter, você tira em **Configurar › Rotas próprias**.

## Antes de começar

Você precisa de uma conta na **CityAds** com as lojas que quer divulgar já conectadas (aprovadas).

## Como configurar

1. No painel da CityAds, abra **Perfil › API**.
2. Copie o **clientId** e o **clientSecret**. Eles funcionam como um usuário e uma senha que deixam o bot usar a sua conta.
3. Na mesma área, na seção **API** ou **Legacy**, copie o **remoteAuth**.
4. No painel do Bot do Afiliado, abra **Configurar › Lojas**, escolha **CityAds** e clique em **Conectar CityAds**.
5. Cole o clientId em **ID do cliente**, o clientSecret em **Segredo do cliente** e o remoteAuth em **Chave da API antiga**.
6. Espere o card **Teste da conta** mostrar **Funcionando** e clique em **Salvar**.

> **Atenção:** preencha os três campos. O bot precisa de todos para trazer as lojas e montar os links.

Ao salvar, o bot traz sozinho as suas lojas brasileiras conectadas.

## Ajustes opcionais

- **Loja nova aprovada:** clique em **Configurar** na conta da CityAds e depois em **Atualizar lojas** para ela entrar.
- **Tirar uma loja:** cada loja aparece em **Configurar › Rotas próprias**, no card **Rotas**, com o endereço dela. Exclua a linha da loja que você não quer converter.

<img src="/docs/integracoes/cityads-rotas.webp" alt="Card Rotas filtrado por cityads: as lojas trazidas da CityAds, uma por linha, cada uma com o botão Excluir" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Como saber se funcionou

Mande para o seu bot no Telegram um link de uma loja conectada na CityAds. Se ele responder com um link novo, pronto: esse link já é o seu. O link da CityAds tem um endereço diferente do da loja, e isso é normal.

## Se algo não der certo

- **Uma loja não aparece:** só entram as lojas brasileiras já conectadas na sua conta e liberadas pela CityAds para link direto. Se a aprovação é recente, clique em **Configurar** na conta da CityAds e depois em **Atualizar lojas**.

## Próximos passos

- Conecte outras redes de lojas: **[Awin](/docs/integracoes/awin/)** e **[Rakuten](/docs/integracoes/rakuten/)**.
- Veja **[como ativar plugins](/docs/integracoes/ativar-plugin/)** para entender a tela de Plugins.

---

# DOC: Loja não mapeada: o que fazer quando o link não converte
URL: https://botdoafiliado.com/docs/integracoes/loja-nao-mapeada/
Atualizado: 2026-11-08
Descrição: O bot não trocou o link pelo seu link de afiliado? Veja onde aparecem esses links e como resolver: conectar a loja, conferir as chaves ou deixar o link passar.

Quando o bot não troca um link pelo seu link de afiliado, quase sempre é porque **a loja não está conectada** no seu bot ou **as chaves estão erradas**. A tela **Links sem loja** mostra esses links e deixa você resolver em poucos cliques.

## Onde ver

Abra **Configurar › Links sem loja**. O card **Domínios pendentes** lista o que chegou ao bot e ficou sem conversão. Use **Buscar link ou domínio…** para achar uma loja.

<img src="/docs/integracoes/links-sem-loja.webp" alt="Card Domínios pendentes com os links que chegaram sem conversão, quantas vezes cada um apareceu e o botão Liberar domínio" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## O que conferir primeiro

1. **A loja tem plugin ativo?** Veja em **Configurar › Lojas**. Se não tem, conecte seguindo **[Como ativar um plugin](/docs/integracoes/ativar-plugin/)**.
2. **As chaves estão certas?** Abra a conta da loja em **Configurar** e veja o card **Teste da conta**.
3. **É uma loja de rede (Awin, Rakuten, CityAds)?** Você precisa ser aprovado naquela loja dentro da rede. Depois, abra a conta da rede e clique em **Atualizar lojas** para a loja entrar.

## Se o link não é de loja

Link de rede social, do seu site ou da sua página de cupons não tem versão de afiliado. Libere para o bot deixar passar:

- Na linha do **Domínios pendentes**, clique em **Liberar domínio**. Para liberar só aquele link, use **Liberar só este link** no menu da linha.
- Ou, no card **Deixar passar sem converter** (antes **Links preservados** e **Lista liberada**), escolha **domínio** ou **link**, cole e clique em **Adicionar**.

O que está liberado sai como veio no /c, no **[Puxador](/docs/telegram/userbot/)** e nas campanhas, sem converter nem encurtar. Nos grupos, a mensagem não é apagada e não vira alerta de canal. Para só tirar uma linha dos pendentes, sem liberar, use **Remover da lista**.

> **Atenção:** só libere o que não é loja. Link liberado sai sem o seu código. Já link de loja que não converte e não está liberado continua travando o envio.

## Se a loja não está conectada

- **Loja dentro de uma rede (Awin, Rakuten, CityAds):** basta ter aprovação na loja e trazer os programas da rede. Veja **[Awin](/docs/integracoes/awin/)** e **[Rakuten](/docs/integracoes/rakuten/)**.
- **Programa que usa um código no próprio link (UTM, tag ou ID):** você mesmo cria a rota em **Configurar › Rotas próprias**, no botão **Nova rota**. A tela traz um exemplo passo a passo no card **Como funcionam as rotas próprias**.
- **Loja com programa próprio, que pede integração:** fale com o suporte em **[contato@botdoafiliado.com](mailto:contato@botdoafiliado.com)** para avaliarmos.

## Próximos passos

- **[Como ativar um plugin](/docs/integracoes/ativar-plugin/)**.
- Mais sobre deixar links passar: **[Lista liberada (whitelist)](/docs/telegram/whitelist/)**.

---

# DOC: Acessar o painel
URL: https://botdoafiliado.com/docs/comecando/acessar-painel/
Atualizado: 2026-11-08
Descrição: Entre no painel do Bot do Afiliado pela Central do Afiliado, por link ou código no e-mail, Google ou passkey, e caia direto no seu bot.

Para entrar no painel do Bot do Afiliado, abra [app.botdoafiliado.com](https://app.botdoafiliado.com/) e entre na **Central do Afiliado** com o e-mail do seu cadastro. Ela é o login padrão e devolve você ao painel já logado.

## Outras formas de entrar

Se a entrada pela Central não terminar, ou logo depois que você sair, aparece a tela **Entrar**:

- **Email** e **Enviar link**: um link de acesso chega no seu e-mail.
- **Receber código por email**: digite o código em **Código do email** e clique em **Confirmar código**.
- **Entrar com a Central do Afiliado**, **Continuar com Google** ou **Entrar com Passkey**.

No aplicativo do Bot do Afiliado no celular, a tela pede só o código por e-mail. Com a verificação em duas etapas ligada, o painel pede também o código do aplicativo autenticador ou um código de recuperação.

## Depois de entrar

Se você já tem um bot, o painel abre o **Dashboard** dele (o item **Início** do menu). O menu **Conta e organização**, no rodapé do menu lateral, tem **Perfil e segurança**, **Meus bots**, **Organização e membros**, **Plano e módulos**, **Indique e ganhe** e **Sair**. **Organização e membros** aparece só para o owner (o dono da conta); **Plano e módulos**, para o owner e para o admin a quem ele liberar o faturamento.

> **Dica:** **Ctrl+K** no Windows ou **⌘K** no Mac abre a busca rápida por telas, bots e ações.

## Se algo não der certo

- **A Central voltou para a tela Entrar:** abra o painel numa janela anônima e entre com o mesmo e-mail do seu cadastro.
- **Apareceu a tela Vamos começar, mas você já tem bot:** confira o seletor de bot, no topo do menu lateral. Com o bot listado, abra **Início** pelo menu. Não cadastre outro token do Telegram.

## Próximos passos

- Proteja a conta em **[Perfil e segurança](/docs/comecando/perfil-e-seguranca/)**.
- Ainda não tem bot? Siga os **[Primeiros passos](/docs/comecando/primeiros-passos/)**.

---

# COMPARATIVO: Bot do Afiliado ou Acelera Afiliado: qual usar
URL: https://botdoafiliado.com/comparativo/acelera-afiliado/
Atualizado: 2026-11-05
Descrição: Preço, plano grátis, post pronto, cópia de concorrentes, WhatsApp e lojas no Bot do Afiliado e no Acelera Afiliado, conferidos nas páginas oficiais em 17/10/2026.

Os dois são bots de Telegram que convertem links de afiliado e montam o post. Para converter links, o Bot do Afiliado custa R$ 99 por mês, e o Acelera, R$ 199. Para o post pronto, o Bot fica nos mesmos R$ 99, e o Acelera, a R$ 349, com o Modo Espião, que copia posts de concorrentes.

> Este comparativo é do Bot do Afiliado. Os números do Acelera Afiliado vêm da página oficial dele, conferida em 17/10/2026, e o link está em Fontes. Preço muda: confira na página de cada um antes de assinar.

## Os dois lado a lado

Na coluna do Bot, cada linha aponta a página de onde o número saiu. Na do Acelera, tudo vem de [aceleraafiliado.com](https://aceleraafiliado.com/), seções "Planos" e "FAQ", em 17/10/2026, com o preço mensal.

| | Bot do Afiliado | Acelera Afiliado |
|---|---|---|
| **Converter links** | Plano base, R$ 99 por mês: o link de afiliado de qualquer site ou loja, com desconto de moedas no AliExpress ([módulos](/docs/planos/modulos/)) | IA Starter, R$ 199 por mês: links automáticos, encurtador próprio para Amazon, Magalu e Kabum e rastreamento por SubID |
| **Post pronto, com foto e preço** | Módulo Ofertas, grátis no plano base: R$ 99 ([módulos](/docs/planos/modulos/)) | IA Pro, R$ 349 por mês |
| **Plano grátis** | Não há: o base é o mínimo para o bot funcionar ([módulos](/docs/planos/modulos/)) | 15 dias do IA Pro sem cartão; depois, plano grátis com todas as lojas e até 60 posts por mês, sem Modo Espião, WhatsApp e relatórios |
| **Copiar posts de concorrentes** | O [Puxador](/modulos/puxador/), de R$ 99,90 por mês, monitora canais do Telegram que a sua conta acompanha e monta a oferta com o seu link, para você aprovar | Modo Espião: 5 concorrentes no IA Pro; de 10 a 99 no IA Premium |
| **WhatsApp** | Módulo de R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões, com grupos e canais sem limite e sem cota de mensagens ([WhatsApp](/docs/whatsapp/planos-e-limites/)) | IA Pro: até 5 grupos ou canais, com 1 número. IA Premium: de R$ 449 (2 números, 15 grupos ou canais) a R$ 1.899 (30 números, 300) |
| **Cupons** | Módulo Cupons, R$ 99: menu de cupons com IA e cupons secretos no AliExpress ([módulos](/docs/planos/modulos/)) | IA Pro: cupons e parcelamento no post |
| **Lojas** | 340 sites listados ([sites](/sites)) e guia de integração para Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin, Rakuten, CityAds, Terabyte e outras ([integrações](/docs/integracoes/como-funcionam/)) | 50 plataformas integradas |
| **Pagamento** | Mensal, sem fidelidade: cada módulo liga e desliga no painel ([preços](/pricing/)) | Mensal, semestral com 10% de desconto ou anual com 18%; garantia de 7 dias com reembolso |

## Quando cada um faz mais sentido

- **Acelera Afiliado:** você quer copiar posts de concorrentes no automático (Modo Espião) e espelhar para o WhatsApp no mesmo plano. Também quando você quer começar de graça, com até 60 posts por mês.
- **Bot do Afiliado:** você quer converter links e montar o post pagando menos, a R$ 99 com os links e o post pronto. Também quando todo link enviado no seu grupo do Telegram tem que virar o seu (já no plano base), ou quando você vai integrar por API ou ligar o Claude e o ChatGPT por MCP (módulo Conexão IA e API, R$ 99). No WhatsApp, o preço é por número, com grupos sem limite.

## Antes de assinar qualquer um

- Os dois dependem das suas contas nos programas de afiliados. Shopee, Mercado Livre, Amazon e as outras lojas pedem cadastro e aprovação, e algumas pedem chave de API.
- No WhatsApp, nenhuma ferramenta garante que a conta não seja restringida. Publique só onde você tem permissão.

## Fontes

- Bot do Afiliado: [preços](/pricing/), [módulos e preços](/docs/planos/modulos/), [módulo WhatsApp](/docs/whatsapp/planos-e-limites/) e [sites suportados](/sites), em 17/10/2026; o preço do WhatsApp, em 05/11/2026.
- Acelera Afiliado: [aceleraafiliado.com](https://aceleraafiliado.com/), seções "Planos" e "FAQ", conferidas em 17/10/2026.

P: Qual sai mais barato, o Bot do Afiliado ou o Acelera Afiliado?
R: Para converter links, o Bot do Afiliado: R$ 99 por mês, contra R$ 199 do IA Starter. Para o post pronto com foto e preço, o Bot fica nos mesmos R$ 99 (o módulo Ofertas vem grátis no plano base), e o Acelera, a R$ 349 no IA Pro, que inclui o Modo Espião e o espelhamento para até 5 grupos de WhatsApp. O Acelera tem plano grátis de até 60 posts por mês, e o Bot não tem plano grátis. Preços de 17/10/2026.
P: O Bot do Afiliado tem algo como o Modo Espião?
R: Sim, para canais do Telegram. O Puxador, módulo de R$ 99,90 por mês, monitora os canais que a sua conta acompanha e monta a oferta com o seu link, para você aprovar. No Acelera, o Modo Espião copia posts de até 5 concorrentes no IA Pro e de 10 a 99 no IA Premium.
P: Os dois publicam no WhatsApp?
R: Sim. No Bot do Afiliado, o módulo WhatsApp custa R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões, com grupos e canais sem limite. No Acelera, o IA Pro espelha para até 5 grupos ou canais com 1 número, e o IA Premium vai de R$ 449, com 2 números e 15 grupos ou canais, a R$ 1.899, com 30 números e 300 grupos ou canais.
P: Quantas lojas cada um converte?
R: O Bot do Afiliado lista 340 sites e tem guia de integração para Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin, Rakuten, CityAds, Terabyte e outras lojas. O Acelera anuncia 50 plataformas integradas.

---

# COMPARATIVO: Bot do Afiliado ou Afilira: qual usar
URL: https://botdoafiliado.com/comparativo/afilira/
Atualizado: 2026-11-05
Descrição: Preço, canais, lojas, limites e de onde vêm as ofertas no Bot do Afiliado e no Afilira, conferidos nas páginas oficiais em 17/10/2026.

O Afilira copia ofertas de grupos de WhatsApp e republica com o seu link, a partir de R$ 47 por mês. O Bot do Afiliado é um bot seu no Telegram que converte links de 340 sites e monta o post, a partir de R$ 99. Para levar os posts ao WhatsApp, o Bot cobra R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional.

> Este comparativo é do Bot do Afiliado. Os números do Afilira vêm da página oficial dele, conferida em 17/10/2026, e o link está em Fontes. Preço muda: confira na página de cada um antes de assinar.

## Os dois lado a lado

Na coluna do Bot, cada linha aponta a página de onde o número saiu. Na do Afilira, tudo vem de [afilira.com](https://afilira.com/), seções "Preços" e "Perguntas frequentes", em 17/10/2026.

| | Bot do Afiliado | Afilira |
|---|---|---|
| **Preço de entrada** | Plano base, R$ 99 por mês ([preços](/pricing/)) | Starter, R$ 47 por mês |
| **O que a entrada faz** | Um bot seu no Telegram gera o link de afiliado de qualquer site ou loja, com desconto de moedas no AliExpress ([módulos](/docs/planos/modulos/)) | 1 número de WhatsApp; busca ofertas em até 3 grupos e envia para até 2; Shopee, Amazon, Mercado Livre, Magalu e AliExpress |
| **Acima da entrada** | Ofertas, Broadcast e Sub-bots grátis no base. Módulos somados ao base: Grupos (R$ 49), Tracking por usuário (R$ 49,90), Cupons e Conexão IA e API (R$ 99 cada) e Shopee Live (R$ 299) ([módulos](/docs/planos/modulos/)) | Professional, R$ 97: 3 números, busca em até 50 grupos e envia para até 20. Enterprise, R$ 197: 10 números, grupos sem limite e API |
| **De onde vêm as ofertas** | Do link que você ou o seu público manda ao bot; com o módulo Ofertas, ele devolve o post pronto, com foto, preço e o seu link ([módulos](/docs/planos/modulos/)) | Dos grupos que você escolhe monitorar e das ofertas compartilhadas pela comunidade |
| **Copiar ofertas de outros grupos** | O [Puxador](/modulos/puxador/), de R$ 99,90 por mês, monitora canais do Telegram que a sua conta acompanha e monta a oferta com o seu link, para você aprovar; de grupos de WhatsApp, não | Sim, desde o Starter |
| **Telegram** | O seu bot, criado pelo painel ([primeiros passos](/docs/comecando/primeiros-passos/)) | A partir do Professional |
| **WhatsApp** | Módulo de R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões, com grupos e canais sem limite e sem cota de mensagens; leva os posts do seu canal do Telegram ([WhatsApp](/docs/whatsapp/planos-e-limites/)) | Grupos desde o Starter e Status a partir do Professional; 1 número no Starter, 3 no Professional e 10 no Enterprise |
| **Lojas** | 340 sites listados ([sites](/sites)) e guia de integração para Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin, Rakuten, CityAds, Terabyte e outras ([integrações](/docs/integracoes/como-funcionam/)) | 5 lojas no Starter; 7 lojas mais Awin e Lomadee no Professional e no Enterprise |
| **API e IA** | Módulo Conexão IA e API, R$ 99: API key e MCP para o Claude e o ChatGPT ([módulos](/docs/planos/modulos/)) | API HTTP e webhooks no Enterprise |
| **Antes de pagar** | Não há plano grátis: o base é o mínimo para o bot funcionar ([módulos](/docs/planos/modulos/)) | Conta grátis e sem cartão para configurar; publicar exige plano |
| **Fidelidade** | Nenhuma: cada módulo liga e desliga no painel ([preços](/pricing/)) | Nenhuma: planos mensais, com Pix ou cartão |

## Quando cada um faz mais sentido

- **Afilira:** você quer repassar ofertas de grupos de WhatsApp que já acompanha, sem montar post, e começar pagando menos. O Starter, de R$ 47, cobre 1 número e 2 grupos de destino.
- **Bot do Afiliado:** você quer um bot seu no Telegram, que converte o link que você ou o seu público mandar, em 340 sites. Também quando todo link enviado no seu grupo do Telegram tem que virar o seu (já no plano base), ou quando você vai integrar por API ou ligar o Claude e o ChatGPT por MCP. Para levar os posts ao WhatsApp, some o módulo de R$ 49,90/mês, com a 1ª conexão grátis, e R$ 29,90 por conexão adicional.

## Antes de assinar qualquer um

- Os dois dependem das suas contas nos programas de afiliados. Shopee, Mercado Livre, Amazon e as outras lojas pedem cadastro e aprovação, e algumas pedem chave de API.
- No WhatsApp, nenhuma ferramenta garante que a conta não seja restringida. Os dois enviam com intervalo entre as mensagens. Publique só onde você tem permissão.

## Fontes

- Bot do Afiliado: [preços](/pricing/), [módulos e preços](/docs/planos/modulos/), [módulo WhatsApp](/docs/whatsapp/planos-e-limites/) e [sites suportados](/sites), em 17/10/2026; o preço do WhatsApp, em 05/11/2026.
- Afilira: [afilira.com](https://afilira.com/), seções "Preços" e "Perguntas frequentes", conferidas em 17/10/2026.

P: Qual é mais barato, o Bot do Afiliado ou o Afilira?
R: Na entrada, o Afilira: o Starter custa R$ 47 por mês, e o plano base do Bot do Afiliado, R$ 99. Os dois fazem coisas diferentes nesse preço. O Starter copia ofertas de até 3 grupos de WhatsApp para até 2 grupos. O plano base do Bot é um bot seu no Telegram que gera o link de afiliado de qualquer site. Preços de 17/10/2026.
P: O Bot do Afiliado copia ofertas de outros grupos, como o Afilira?
R: De canais do Telegram, sim: o Puxador, módulo de R$ 99,90 por mês, monitora os canais que a sua conta acompanha e monta a oferta com o seu link, para você aprovar. De grupos de WhatsApp, não. No Afilira, copiar ofertas de grupos de WhatsApp é o recurso principal, desde o Starter.
P: Os dois publicam no WhatsApp e no Telegram?
R: Sim, de jeitos diferentes. O Bot do Afiliado publica no Telegram pelo seu bot, e o módulo WhatsApp, de R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, leva os posts do seu canal para grupos e canais de WhatsApp. O Afilira publica em grupos de WhatsApp desde o Starter, e no Telegram e no Status do WhatsApp a partir do Professional, de R$ 97.
P: Quantas lojas cada um converte?
R: O Bot do Afiliado lista 340 sites e tem guia de integração para Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin, Rakuten, CityAds, Terabyte e outras lojas. O Afilira converte 5 lojas no Starter, e 7 lojas mais a Awin e a Lomadee no Professional e no Enterprise.
P: Algum dos dois publica de graça?
R: Não. No Afilira, criar a conta é grátis e sem cartão, mas publicar exige um plano a partir de R$ 47. No Bot do Afiliado, o plano base de R$ 99 é o mínimo para o bot funcionar.

---

# COMPARATIVO: Bot do Afiliado ou FluxoPromo: qual usar
URL: https://botdoafiliado.com/comparativo/fluxopromo/
Atualizado: 2026-11-05
Descrição: Preço, WhatsApp, lojas e de onde vêm as ofertas no Bot do Afiliado e no FluxoPromo, conferidos nas páginas oficiais em 17/10/2026.

O FluxoPromo publica sozinho ofertas de 7 a 42 lojas, conforme o plano, no WhatsApp e no Telegram, a partir de R$ 97 por mês, com 3 números de WhatsApp já no Essencial. O Bot do Afiliado é um bot seu no Telegram que converte o link que você manda, em 340 sites, a partir de R$ 99. O WhatsApp entra como módulo, de R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional.

> Este comparativo é do Bot do Afiliado. Os números do FluxoPromo vêm da página oficial dele, conferida em 17/10/2026, e o link está em Fontes. Preço muda: confira na página de cada um antes de assinar.

## Os dois lado a lado

Na coluna do Bot, cada linha aponta a página de onde o número saiu. Na do FluxoPromo, tudo vem de [fluxopromo.com](https://fluxopromo.com/), seção "Planos e Preços", e do [llms.txt](https://fluxopromo.com/llms.txt) dele, em 17/10/2026.

| | Bot do Afiliado | FluxoPromo |
|---|---|---|
| **Preço de entrada** | Plano base, R$ 99 por mês ([preços](/pricing/)) | Essencial, R$ 97 por mês; R$ 67,90 por mês no anual |
| **O que a entrada faz** | Um bot seu no Telegram gera o link de afiliado de qualquer site ou loja, com desconto de moedas no AliExpress ([módulos](/docs/planos/modulos/)) | Até 150 ofertas por dia de 7 lojas (Mercado Livre, Amazon, Shopee, SHEIN, Magalu, AliExpress e Terabyte), 3 números de WhatsApp com 10 grupos e 10 canais cada, 3 canais do Telegram e cópia de 10 grupos |
| **Acima da entrada** | Ofertas, Broadcast e Sub-bots grátis no base. Módulos somados ao base: Grupos (R$ 49), Tracking por usuário (R$ 49,90), Cupons e Conexão IA e API (R$ 99 cada) e Shopee Live (R$ 299) ([módulos](/docs/planos/modulos/)) | Pro, R$ 197: 10 lojas, sem limite fixo de ofertas, 5 números e cópia de 60 grupos. Expert, R$ 397: 42 lojas, 15 números, cópia sem limite e cupons das lojas parceiras |
| **De onde vêm as ofertas** | Do link que você ou o seu público manda ao bot; com o módulo Ofertas, ele devolve o post pronto, com foto, preço e o seu link ([módulos](/docs/planos/modulos/)) | Das lojas, no automático, dos grupos que você escolhe copiar e de um feed em que você escolhe a oferta e envia |
| **Copiar ofertas de outros grupos** | O [Puxador](/modulos/puxador/), de R$ 99,90 por mês, monitora canais do Telegram que a sua conta acompanha e monta a oferta com o seu link, para você aprovar | Sim, desde o Essencial |
| **Telegram** | O seu bot, criado pelo painel ([primeiros passos](/docs/comecando/primeiros-passos/)) | 3 canais no Essencial, 10 no Pro e sem limite no Expert |
| **WhatsApp** | Módulo de R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões, com grupos e canais sem limite e sem cota de mensagens; leva os posts do seu canal do Telegram ([WhatsApp](/docs/whatsapp/planos-e-limites/)) | Incluso: 3, 5 ou 15 números, conforme o plano, e funciona sem Telegram |
| **Link de entrada que não lota** | O link da campanha cria o próximo grupo de WhatsApp quando os outros enchem ([link e grupos](/docs/whatsapp/link-e-grupos/)) | Sim, desde o Essencial |
| **Lojas** | 340 sites listados, em todos os planos, entre eles [KaBuM](/sites/kabum.com.br), [Terabyte](/sites/terabyteshop.com.br), [Nike](/sites/nike.com.br), [Centauro](/sites/centauro.com.br), [O Boticário](/sites/boticario.com.br) e [Fast Shop](/sites/fastshop.com.br); a SHEIN não está na lista ([sites](/sites)) | 7 no Essencial, 10 no Pro e 42 no Expert |
| **API e IA** | Módulo Conexão IA e API, R$ 99: API key e MCP para o Claude e o ChatGPT ([módulos](/docs/planos/modulos/)) | A página de preços não cita API |
| **Antes de pagar** | Não há plano grátis: o base é o mínimo para o bot funcionar ([módulos](/docs/planos/modulos/)) | Conta de demonstração sem cartão e garantia de 7 dias com reembolso |
| **Fidelidade** | Nenhuma: cada módulo liga e desliga no painel ([preços](/pricing/)) | Nenhuma no mensal; trimestral com 10% e anual com 30% de desconto |

## Quando cada um faz mais sentido

- **FluxoPromo:** você quer que a ferramenta ache e publique as ofertas sozinha, principalmente no WhatsApp, com vários números. No Essencial, R$ 97 cobrem 3 números. No Bot, o base e 3 conexões somam R$ 208,70.
- **Bot do Afiliado:** você escolhe as ofertas e quer o seu link em qualquer uma das 340 lojas da lista, sem depender do plano. Também quando todo link enviado no seu grupo do Telegram tem que virar o seu (já no plano base), ou quando você vai integrar por API ou ligar o Claude e o ChatGPT por MCP.

## Antes de assinar qualquer um

- Os dois dependem das suas contas nos programas de afiliados. Shopee, Mercado Livre, Amazon e as outras lojas pedem cadastro e aprovação, e algumas pedem chave de API.
- No WhatsApp, nenhuma ferramenta garante que a conta não seja restringida. Os dois enviam com intervalo entre as mensagens. Publique só onde você tem permissão.

## Fontes

- Bot do Afiliado: [preços](/pricing/), [módulos e preços](/docs/planos/modulos/), [módulo WhatsApp](/docs/whatsapp/planos-e-limites/), [link de entrada e grupos](/docs/whatsapp/link-e-grupos/) e [sites suportados](/sites), em 17/10/2026; o preço do WhatsApp, em 05/11/2026.
- FluxoPromo: [fluxopromo.com](https://fluxopromo.com/), seção "Planos e Preços", e [fluxopromo.com/llms.txt](https://fluxopromo.com/llms.txt), conferidos em 17/10/2026.

P: Qual é mais barato, o Bot do Afiliado ou o FluxoPromo?
R: Na entrada, os dois ficam perto: o Essencial do FluxoPromo custa R$ 97 por mês, e o plano base do Bot do Afiliado, R$ 99. Com WhatsApp, o FluxoPromo sai mais barato: o Essencial já inclui 3 números, e no Bot o módulo WhatsApp custa R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, então base e 3 conexões somam R$ 208,70. Preços do FluxoPromo de 17/10/2026; do Bot, de 05/11/2026.
P: Quantas lojas cada um converte?
R: O Bot do Afiliado lista 340 sites, entre eles KaBuM, Terabyte, Nike, Centauro, O Boticário e Fast Shop, e todos estão em todos os planos. A SHEIN não está na lista. O FluxoPromo publica no automático 7 lojas no Essencial, 10 no Pro e 42 no Expert.
P: O WhatsApp está incluso no preço?
R: No FluxoPromo, sim: 3 números no Essencial, 5 no Pro e 15 no Expert, e o WhatsApp funciona sem Telegram. No Bot do Afiliado, o WhatsApp é um módulo de R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, com grupos e canais sem limite e sem cota de mensagens, e leva os posts do seu canal do Telegram.
P: Quem acha as ofertas?
R: No FluxoPromo, a ferramenta: ela publica ofertas das lojas no automático e copia ofertas dos grupos que você escolhe. No Bot do Afiliado, as ofertas partem do link que você ou o seu público manda ao bot. O Puxador, módulo de R$ 99,90 por mês, monitora canais do Telegram e monta a oferta com o seu link, para você aprovar.
P: Dá para testar antes de pagar?
R: O FluxoPromo tem uma conta de demonstração sem cartão e garantia de 7 dias com reembolso. O Bot do Afiliado não tem plano grátis: o base é o mínimo para o bot funcionar, e cada módulo liga e desliga no painel, sem fidelidade.

---

# COMPARATIVO: Bot do Afiliado ou Pro Afiliados: qual usar
URL: https://botdoafiliado.com/comparativo/pro-afiliados/
Atualizado: 2026-11-05
Descrição: Preço, plano grátis, canais, lojas e o link que sai publicado no Bot do Afiliado e no Pro Afiliados, conferidos nas páginas oficiais em 17/10/2026.

O Pro Afiliados copia ofertas de grupos e canais e republica no WhatsApp e no Telegram com o seu link. Ele tem plano grátis de até 2 horas por dia e planos de R$ 50 e R$ 100. O Bot do Afiliado é um bot seu no Telegram que converte links de 340 sites e monta o post, a partir de R$ 99.

> Este comparativo é do Bot do Afiliado. Os números do Pro Afiliados vêm da página oficial dele, conferida em 17/10/2026, e o link está em Fontes. Preço muda: confira na página de cada um antes de assinar.

## Os dois lado a lado

Na coluna do Bot, cada linha aponta a página de onde o número saiu. Na do Pro Afiliados, tudo vem de [proafiliados.com](https://proafiliados.com/), seções "Preços" e "Dúvidas", em 17/10/2026.

| | Bot do Afiliado | Pro Afiliados |
|---|---|---|
| **Preço** | Plano base, R$ 99 por mês, mais os módulos que você ligar, de R$ 49 a R$ 299 ([módulos](/docs/planos/modulos/)) | Grátis; Premium, R$ 50 por mês; Premium Plus, R$ 100 por mês. Pagando 3, 6 ou 12 meses pelo Pix, 10%, 20% ou 30% de desconto |
| **Plano grátis** | Não há: o base é o mínimo para o bot funcionar ([módulos](/docs/planos/modulos/)) | Até 2 horas por dia, com uma linha de crédito no fim de cada mensagem e 1 post da Pro Afiliados a cada 30 envios por grupo |
| **De onde vêm as ofertas** | Do link que você ou o seu público manda ao bot; com o módulo Ofertas, ele devolve o post pronto, com foto, preço e o seu link ([módulos](/docs/planos/modulos/)) | Dos grupos e canais que você marca para copiar, da busca por palavra-chave e de canais de outros afiliados, em 22 nichos |
| **Copiar ofertas de outros grupos** | O [Puxador](/modulos/puxador/), de R$ 99,90 por mês, monitora canais do Telegram que a sua conta acompanha e monta a oferta com o seu link, para você aprovar | Sim, em todos os planos |
| **Como conecta** | Telegram: o seu bot, criado pelo painel ([primeiros passos](/docs/comecando/primeiros-passos/)). WhatsApp: o número entra como aparelho vinculado ([WhatsApp](/docs/whatsapp/comecando/)) | WhatsApp por QR Code ou código de 8 dígitos; Telegram com o seu número e o código do app, sem criar bot |
| **WhatsApp** | Módulo de R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões, com grupos e canais sem limite e sem cota de mensagens ([WhatsApp](/docs/whatsapp/planos-e-limites/)) | Em todos os planos, com grupos sem limite; cada número a mais precisa de assinatura própria |
| **Lojas** | 340 sites listados ([sites](/sites)) e guia de integração para Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin, Rakuten, CityAds, Terabyte e outras ([integrações](/docs/integracoes/como-funcionam/)) | 13 lojas e redes: Shopee, Mercado Livre, Amazon, AliExpress, Magalu, SHEIN, Terabyte, Pró Spin, Americanas, Natura e Avon, mais as redes Awin, Lomadee e Rakuten |
| **Link publicado** | Shopee: o shortlink de afiliado da Open API da Shopee ([Shopee](/docs/integracoes/shopee/)). Amazon: amzn.to pelo plugin Amazon ([Amazon](/docs/integracoes/amazon/)). Nas outras, depende do conversor, e alguns usam o encurtador do bot ([como funcionam](/docs/integracoes/como-funcionam/)) | Shopee, Mercado Livre, Amazon, Magalu e lojas Awin saem por sshopee.me, melila.me, amzzn.me, magazineluiza.me e awin1.me, que tentam abrir o app da loja |
| **Fidelidade** | Nenhuma: cada módulo liga e desliga no painel ([preços](/pricing/)) | Nenhuma: pagamento pelo Pix, para 1, 3, 6 ou 12 meses |

## Quando cada um faz mais sentido

- **Pro Afiliados:** você quer copiar ofertas de grupos e canais, seus ou da comunidade, e publicar no WhatsApp e no Telegram ao mesmo tempo, com grupos sem limite. Também quando você quer testar de graça antes, aceitando as 2 horas por dia e a marca deles nas mensagens.
- **Bot do Afiliado:** você quer um bot seu no Telegram, para o seu público pedir links e ofertas, com conversão em 340 sites. Também quando todo link enviado no seu grupo do Telegram tem que virar o seu (já no plano base), ou quando você vai integrar por API ou ligar o Claude e o ChatGPT por MCP (módulo Conexão IA e API, R$ 99).

## Antes de assinar qualquer um

- Os dois dependem das suas contas nos programas de afiliados. Shopee, Mercado Livre, Amazon e as outras lojas pedem cadastro e aprovação, e algumas pedem chave de API.
- No WhatsApp, nenhuma ferramenta garante que a conta não seja restringida. Os dois enviam com intervalo entre as mensagens. Publique só onde você tem permissão.

## Fontes

- Bot do Afiliado: [módulos e preços](/docs/planos/modulos/), [módulo WhatsApp](/docs/whatsapp/planos-e-limites/), [conversor da Shopee](/docs/integracoes/shopee/), [plugin Amazon](/docs/integracoes/amazon/) e [sites suportados](/sites), em 17/10/2026; o preço do WhatsApp, em 05/11/2026.
- Pro Afiliados: [proafiliados.com](https://proafiliados.com/), seções "Preços" e "Dúvidas", conferidas em 17/10/2026.

P: O Pro Afiliados é grátis?
R: Tem plano grátis com todas as funções, mas o robô fica ligado até 2 horas por dia, cada mensagem termina com uma linha de crédito da ferramenta e sai 1 post da Pro Afiliados a cada 30 envios por grupo. O Premium, de R$ 50 por mês, deixa o robô ligado 24 horas e tira a linha. O Premium Plus, de R$ 100, tira também os posts deles. O Bot do Afiliado não tem plano grátis: o plano base, de R$ 99, é o mínimo. Preços de 17/10/2026.
P: O Bot do Afiliado copia ofertas de outros grupos, como o Pro Afiliados?
R: De canais do Telegram, sim: o Puxador, módulo de R$ 99,90 por mês, monitora os canais que a sua conta acompanha e monta a oferta com o seu link, para você aprovar. No Pro Afiliados, copiar de grupos e canais é o recurso principal, em todos os planos.
P: O link publicado sai com o domínio da loja?
R: No Bot do Afiliado, o link da Shopee é o shortlink de afiliado gerado pela Open API da Shopee, e o da Amazon sai em amzn.to pelo plugin Amazon. Nas outras lojas, depende do conversor, e alguns usam o encurtador do bot. No Pro Afiliados, os links de Shopee, Mercado Livre, Amazon, Magalu e das lojas Awin saem pelos domínios sshopee.me, melila.me, amzzn.me, magazineluiza.me e awin1.me, que tentam abrir o aplicativo da loja.
P: Quantas lojas cada um converte?
R: O Bot do Afiliado lista 340 sites e tem guia de integração para Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin, Rakuten, CityAds, Terabyte e outras lojas. O Pro Afiliados converte 13 lojas e redes, entre elas Shopee, Mercado Livre, Amazon, AliExpress, Magalu e SHEIN, e as lojas das redes Awin, Lomadee e Rakuten.
P: Posso usar mais de um número de WhatsApp?
R: Nos dois. No Bot do Afiliado, o módulo WhatsApp custa R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões. No Pro Afiliados, cada número a mais é uma conexão extra, com assinatura própria.

---

# COMPARATIVO: Bot do Afiliado ou PromoBot: qual usar
URL: https://botdoafiliado.com/comparativo/promobot/
Atualizado: 2026-11-05
Descrição: Preço, lojas, canais e quem acha as ofertas no Bot do Afiliado e no PromoBot (ofertasbot.com), conferidos nas páginas oficiais em 17/10/2026.

O PromoBot, de ofertasbot.com, procura as ofertas sozinho na KaBuM e na Terabyte e posta no seu canal do Telegram, a partir de R$ 47 por mês. O link de afiliado automático começa no Pro, de R$ 97. O Bot do Afiliado não procura ofertas nas lojas: é um bot seu no Telegram que converte o link que você manda, em 340 sites, a partir de R$ 99.

> Este comparativo é do Bot do Afiliado. Os números do PromoBot vêm da página oficial dele, conferida em 17/10/2026, e o link está em Fontes. Existe outro produto chamado PromoBot, vendido em outro site, e esta página não fala dele. Preço muda: confira na página de cada um antes de assinar.

## Os dois lado a lado

Na coluna do Bot, cada linha aponta a página de onde o número saiu. Na do PromoBot, tudo vem de [ofertasbot.com](https://ofertasbot.com/), seção de planos, e do [llms.txt](https://ofertasbot.com/llms.txt) dele, em 17/10/2026.

| | Bot do Afiliado | PromoBot |
|---|---|---|
| **Preço de entrada** | Plano base, R$ 99 por mês ([preços](/pricing/)) | Básico, R$ 47 por mês |
| **O que a entrada faz** | Um bot seu no Telegram gera o link de afiliado de qualquer site ou loja, com desconto de moedas no AliExpress ([módulos](/docs/planos/modulos/)) | Ofertas da KaBuM e da Terabyte em 1 canal do Telegram, com filtros por loja, desconto e horário, cupons verificados e o link de afiliado posto à mão |
| **Acima da entrada** | Ofertas, Broadcast e Sub-bots grátis no base. Módulos somados ao base: Grupos (R$ 49), Tracking por usuário (R$ 49,90), Cupons e Conexão IA e API (R$ 99 cada) e Shopee Live (R$ 299) ([módulos](/docs/planos/modulos/)) | Pro, R$ 97: link de afiliado automático, até 3 canais e painel em tempo real. Ultra, R$ 197: canais sem limite, Modo Spy e API. Marca Própria, R$ 497 |
| **Quem acha as ofertas** | Você ou o seu público, mandando o link ao bot; com o módulo Ofertas, ele devolve o post pronto, com foto, preço e o seu link ([módulos](/docs/planos/modulos/)) | O PromoBot, varrendo a KaBuM e a Terabyte 24 horas por dia |
| **Acompanhar outros canais** | O [Puxador](/modulos/puxador/), de R$ 99,90 por mês, monitora canais do Telegram que a sua conta acompanha e monta a oferta com o seu link, para você aprovar | Modo Spy, no Ultra: mostra o que canais concorrentes postam |
| **Lojas** | 340 sites listados, entre eles [KaBuM](/sites/kabum.com.br) e [Terabyte](/sites/terabyteshop.com.br) ([sites](/sites)) | KaBuM e Terabyte; as próximas estão na fila |
| **Telegram** | O seu bot, criado pelo painel ([primeiros passos](/docs/comecando/primeiros-passos/)) | 1 canal no Básico, 3 no Pro e sem limite no Ultra |
| **WhatsApp** | Módulo de R$ 49,90/mês com a 1ª conexão grátis e R$ 29,90 por conexão adicional, de 1 a 20 conexões, com grupos e canais sem limite e sem cota de mensagens; leva os posts do seu canal do Telegram ([WhatsApp](/docs/whatsapp/planos-e-limites/)) | A página fala só de canais do Telegram |
| **API e IA** | Módulo Conexão IA e API, R$ 99: API key e MCP para o Claude e o ChatGPT ([módulos](/docs/planos/modulos/)) | API no Ultra |
| **Antes de pagar** | Não há plano grátis: o base é o mínimo para o bot funcionar ([módulos](/docs/planos/modulos/)) | Um canal público no Telegram mostra as ofertas que o bot acha |
| **Fidelidade** | Nenhuma: cada módulo liga e desliga no painel ([preços](/pricing/)) | Nenhuma: mensal, sem taxa de adesão |

## Quando cada um faz mais sentido

- **PromoBot:** o seu canal é de hardware e tecnologia, e você quer que as ofertas da KaBuM e da Terabyte cheguem sozinhas, filtradas por desconto e preço. Para o link sair automático, o plano é o Pro, de R$ 97.
- **Bot do Afiliado:** você escolhe as ofertas, em qualquer uma das 340 lojas da lista, e quer o post pronto com o seu link. Também quando todo link enviado no seu grupo do Telegram tem que virar o seu (já no plano base), quando os posts têm que ir também ao WhatsApp, ou quando você vai integrar por API ou ligar o Claude e o ChatGPT por MCP.

## Antes de assinar qualquer um

- Os dois dependem das suas contas nos programas de afiliados. A KaBuM, a Terabyte e as outras lojas pedem cadastro e aprovação.
- Oferta que chega sozinha ainda é responsabilidade de quem publica: confira preço e estoque antes de fixar no canal.

## Fontes

- Bot do Afiliado: [preços](/pricing/), [módulos e preços](/docs/planos/modulos/), [módulo WhatsApp](/docs/whatsapp/planos-e-limites/) e [sites suportados](/sites), em 17/10/2026; o preço do WhatsApp, em 05/11/2026.
- PromoBot: [ofertasbot.com](https://ofertasbot.com/), seção de planos, e [ofertasbot.com/llms.txt](https://ofertasbot.com/llms.txt), conferidos em 17/10/2026.

P: Qual é mais barato, o Bot do Afiliado ou o PromoBot?
R: Na entrada, o PromoBot: o Básico custa R$ 47 por mês, com 1 canal do Telegram e o link de afiliado posto à mão. O link automático começa no Pro, de R$ 97. O plano base do Bot do Afiliado custa R$ 99 e converte o link de qualquer site da lista. Preços de 17/10/2026.
P: O PromoBot acha as ofertas sozinho?
R: Sim. Ele varre a KaBuM e a Terabyte 24 horas por dia e manda ao seu canal as ofertas que passam nos seus filtros de loja, categoria, preço e desconto. O Bot do Afiliado não procura ofertas nas lojas: ele converte o link que você ou o seu público manda. O Puxador, módulo de R$ 99,90 por mês, monitora canais do Telegram e monta a oferta com o seu link, para você aprovar.
P: Quais lojas cada um cobre?
R: O PromoBot monitora a KaBuM e a Terabyte e diz que as próximas lojas estão na fila. O Bot do Afiliado lista 340 sites, entre eles a KaBuM e a Terabyte, a Shopee, o Mercado Livre, a Amazon e o AliExpress.
P: Os dois publicam no WhatsApp?
R: A página do PromoBot fala só de canais do Telegram. No Bot do Afiliado, o módulo WhatsApp, de R$ 49,90/mês com a 1ª conexão (número de WhatsApp) grátis e R$ 29,90 por conexão adicional, leva os posts do seu canal do Telegram para grupos e canais de WhatsApp.
P: Tem fidelidade?
R: Nenhum dos dois. O PromoBot é mensal e se cancela quando quiser. No Bot do Afiliado, cada módulo liga e desliga no painel.

---

# BLOG: Robô para afiliados: venda no automático
URL: https://botdoafiliado.com/blog/robo-para-afiliados-automacao-vendas/
Publicado: 2026-07-26
Descrição: O que é um robô para afiliados, o que dá para automatizar (conversão de links, ofertas com foto e preço, cupons, broadcast) e como montar o seu em minutos.

**Um robô para afiliados** (também chamado de **bot para afiliados**) é um programa que faz sozinho o trabalho repetitivo de quem vive de comissão: **converte qualquer link em link de afiliado**, monta o **post de oferta com foto e preço**, **publica no canal do Telegram**, gerencia **cupons** e dispara **broadcast** para a audiência. Você cuida da estratégia; o robô cuida do braçal — e nenhum link sai sem a sua comissão.

## O que é um robô de vendas para afiliados

Na prática, um **robô de vendas para afiliados** é um bot (geralmente no **Telegram**) conectado aos seus programas de afiliado — Shopee, Mercado Livre, Amazon, AliExpress, Magalu, Awin e outros. Ele fica de plantão 24h: recebe um link de produto, devolve o link **já convertido** com o seu ID de afiliado e, se você quiser, já publica a oferta formatada no seu canal ou grupo.

A diferença para "usar o painel da rede" é a **velocidade e a escala**. Quem posta 30, 50, 100 ofertas por dia não consegue abrir o gerador de links de cada plataforma, baixar foto, digitar preço e formatar post um por um. O robô faz isso em segundos, do jeito certo, todas as vezes.

Se você nunca viu um funcionando, o **[Bot do Afiliado](/docs/comecando/o-que-e/)** é exatamente isso: um robô seu, com o seu nome, rodando dentro do Telegram.

## O que dá para automatizar (na prática)

### Conversão de links de afiliado

O básico que muda tudo: você manda **qualquer link de loja** (até encurtado ou cheio de parâmetros) e o robô devolve **o seu link de afiliado**, encurtado e pronto para postar. Sem abrir painel de rede, sem comando, sem copiar e colar em gerador. Veja **[como converter links no Telegram](/blog/como-converter-links-no-telegram/)**.

### Ofertas prontas com foto e preço

Em vez de devolver só o link, o robô monta o **post completo**: imagem do produto, título, preço atual, preço riscado, cupom e o botão/CTA — tudo no **seu template**. O que levava 5 minutos por post vira um envio de link.

### Postagem automática no canal

O robô publica direto no seu **canal ou grupo de ofertas**, na hora. É o que transforma um canal parado em um **[canal de ofertas no piloto automático](/blog/criar-canal-de-ofertas-no-telegram-piloto-automatico-2026/)**: cadência constante sem você ficar preso ao celular.

### Cupons

Cadastro de cupons por loja, comando para a audiência consultar (`/cupom`) e limpeza automática dos **expirados** — nada de canal recomendando cupom morto.

### Broadcast

Saiu uma promoção relâmpago? Um **broadcast** avisa todos os seus usuários e grupos de uma vez, com a oferta já formatada e o seu link dentro.

## Manual vs automático: onde a comissão vaza

| Tarefa | No manual | Com o robô |
|---|---|---|
| Gerar link de afiliado | Abrir o painel da rede, colar a URL, copiar o link | Manda o link, volta convertido em segundos |
| Post de oferta | Baixar foto, digitar preço, formatar, revisar | Foto, preço e template prontos no automático |
| Postar no canal | Você, colado no celular o dia todo | Publicação direta no automático |
| Cupons | Planilha que ninguém atualiza | Cadastro central + expirados removidos |
| Avisar a audiência | Copiar e colar em cada grupo | Broadcast de uma vez |
| Link sem afiliado | Acontece toda semana (comissão perdida) | Não passa nenhum |

O ponto não é só tempo. **Link postado sem conversão é venda sem comissão** — e no manual isso acontece mais do que a gente admite.

## Como montar o seu robô para afiliados em minutos

Você não precisa programar nada. O caminho com o **Bot do Afiliado**:

1. **Crie a conta** no painel: [app.botdoafiliado.com](https://app.botdoafiliado.com). O assistente te guia na criação do seu bot no Telegram (via @BotFather) — o robô fica com o **seu nome e a sua cara**.
2. **Conecte as suas lojas**: ative os plugins dos programas em que você já é afiliado (Shopee, Mercado Livre, Amazon, AliExpress, Awin e mais). É colar as credenciais de cada programa uma única vez — veja **[como ativar um plugin](/docs/integracoes/ativar-plugin/)**.
3. **Teste a conversão**: mande um link de produto para o seu bot. Ele devolve o link convertido (ou a oferta completa, se você preferir).
4. **Monte o template de oferta**: defina como o post sai — emoji, preço, cupom, CTA. Uma vez configurado, todo post sai padronizado.
5. **Aponte para o seu canal**: adicione o bot como administrador do canal ou grupo e as ofertas passam a ser publicadas no automático.

Do zero ao primeiro post convertido dá para fazer em uma sentada — sem servidor, sem código, sem depender de programador.

## Quanto custa um robô para afiliados (e se vale a pena)

Existem três caminhos:

- **Programar o seu próprio bot**: flexível, mas você vira desenvolvedor — API do Telegram, API de cada marketplace, servidor, manutenção quando algo muda (e muda toda semana).
- **Scripts prontos vendidos por aí**: baratos na entrada, mas sem suporte e quebram na primeira mudança das lojas.
- **SaaS pronto** (o caso do Bot do Afiliado): você assina, conecta as suas contas e usa. As integrações são mantidas pela plataforma; quando um marketplace muda a API, quem corrige não é você.

O modelo do Bot do Afiliado é **modular**: você começa **a partir do plano base** e liga só os módulos que fazem sentido para a sua operação (grupos, broadcast, live, tracking…). Os valores atuais estão em **[/pricing/](/pricing/)**.

A conta do "vale a pena" é simples: se o robô te devolve horas por dia e garante que **100% dos links saem com a sua comissão**, ele se paga com poucas vendas que você estaria perdendo no manual.

## Perguntas frequentes

**O que é um robô de vendas para afiliados?**
É um bot que automatiza a operação de quem vende por comissão: converte links em links de afiliado, monta posts de oferta com foto e preço, publica no canal, gerencia cupons e dispara broadcast. Você foca em audiência e curadoria; ele executa.

**O que faz um bot divulgador de links de afiliados?**
Um **bot divulgador de links de afiliados** recebe (ou encontra) ofertas, troca o link comum pelo seu link rastreado e divulga nos seus canais e grupos, já formatado. No Bot do Afiliado isso funciona com Shopee, Mercado Livre, Amazon, AliExpress, Magalu, redes como Awin e mais.

**Como funciona a automação para afiliados?**
A **automação para afiliados** conecta os seus programas de afiliado a um bot: ele autentica nas plataformas com as suas credenciais, gera os links pelos caminhos de afiliado de cada programa (API oficial quando existe) e cuida da publicação. Tudo continua na **sua** conta de afiliado — a comissão é sua, o robô só elimina o trabalho manual.

**Qual o melhor bot de ofertas Telegram?**
O melhor **bot de ofertas Telegram** é o que (1) converte links de todas as lojas que você usa, (2) monta o post com foto e preço sozinho, (3) posta no seu canal no automático e (4) não exige programação. É esse o desenho do [Bot do Afiliado](/docs/comecando/o-que-e/) — e o bot é seu, com o seu nome, não um bot compartilhado de terceiro.

**Preciso saber programar para ter um robô para afiliados?**
Não. Em plataforma pronta, a configuração é por painel: criar o bot guiado, colar as credenciais dos programas e escolher o template. Programação só é necessária se você optar por construir o seu do zero.

**Um robô para afiliados pode derrubar a minha conta nas plataformas?**
O robô gera os links pelos caminhos de afiliado de cada programa — o mesmo resultado que você teria no painel de cada plataforma, só que automatizado, sempre com as suas próprias credenciais. O que derruba conta é spam e violação de regra de divulgação, com ou sem robô.

## Comece agora

1. Crie o seu robô em **[app.botdoafiliado.com](https://app.botdoafiliado.com)** — o assistente guia a criação do bot no Telegram.
2. Ative as suas lojas em **[Integrações](/docs/integracoes/ativar-plugin/)** e mande o primeiro link.

Veja também: **[como criar um canal de ofertas no piloto automático](/blog/criar-canal-de-ofertas-no-telegram-piloto-automatico-2026/)** e **[como converter links no Telegram](/blog/como-converter-links-no-telegram/)**.

---

# BLOG: Bot publica, painel mede: o fluxo completo de quem vive de afiliado
URL: https://botdoafiliado.com/blog/bot-publica-painel-mede-fluxo-do-afiliado/
Publicado: 2026-06-28
Descrição: Os dois lados do jogo: automatizar a divulgação (links, ofertas, cupons) e medir o resultado (comissão por marketplace, produto e canal). Como encaixar o Bot do Afiliado e o Painel do Afiliado.

<img src="/blog/bot-publica-painel-mede-fluxo-do-afiliado.svg" alt="Bot do Afiliado publica e converte os links; Painel do Afiliado mede a comissão" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

Quem trabalha com afiliação acaba esbarrando em dois trabalhos diferentes — e quase ninguém faz os dois bem ao mesmo tempo na mão. **Divulgar** (converter link, montar oferta, postar todo dia) e **medir** (saber o que de fato pagou comissão). A saída não é escolher um; é automatizar os dois e deixá-los conversando.

## Lado 1 — divulgar no automático

A divulgação é volume e consistência: várias ofertas por dia, todas com o link convertido com a **sua** atribuição, bem formatadas, com cupom e foto. Fazer isso manualmente queima o seu tempo e gera erro (link sem tag = comissão perdida).

O **[Bot do Afiliado](https://botdoafiliado.com)** cuida dessa ponta:

- Converte qualquer link (Shopee, AliExpress, Amazon, Mercado Livre…) na hora, com a sua tag.
- Publica a oferta formatada no seu canal do Telegram, com preço, foto e cupom.
- Automatiza cupons (extrai, reativa expirados) e ofertas recorrentes.
- Ainda expõe uma **API** e conexão **MCP** para puxar dados e gerar links via código ou IA.

## Lado 2 — medir o que converteu

Publicar sem medir é like sem venda. Para saber o que virou comissão, cada link precisa carregar um **Sub-ID/etiqueta** por canal — e as vendas precisam voltar para um relatório que some tudo.

O **[Painel do Afiliado](https://paineldoafiliado.com)** é essa ponta: junta as conversões de todos os marketplaces e redes em BRL e mostra comissão, conversão, **EPC**, **status** (pendente/confirmado/cancelado) e **momentum** de produtos — por marketplace, por produto e por canal.

## Por que os dois juntos rendem mais

Separados, cada um resolve metade. Juntos, viram um ciclo:

1. O bot publica e converte com a atribuição certa (e um Sub-ID por canal).
2. O painel mostra qual canal, qual produto e qual horário realmente pagou.
3. Você ajusta a curadoria e a frequência com base em dados — e o bot executa de novo.

É a diferença entre "postar bastante e torcer" e **operar um sistema**: divulgação que escala com medição que aponta para onde crescer.

> Comece a automatizar a divulgação com o **[Bot do Afiliado](https://botdoafiliado.com)** e feche o ciclo medindo no **[Painel do Afiliado](https://paineldoafiliado.com)**.

---

# BLOG: Como medir as vendas dos seus links de afiliado (comissão, EPC e conversão)
URL: https://botdoafiliado.com/blog/medir-vendas-do-link-de-afiliado/
Publicado: 2026-06-28
Descrição: Publicar é fácil; saber o que vendeu é o que separa quem cresce de quem estaciona. Veja como acompanhar comissão, cliques, conversão e EPC de todos os marketplaces num painel só.

<img src="/blog/medir-vendas-do-link-de-afiliado.svg" alt="Painel do Afiliado mostrando comissão, cliques, EPC e conversão de todos os marketplaces" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

Você converte os links, publica as ofertas, o engajamento vem — e no fim do mês fica a dúvida: **qual oferta realmente deu comissão?** Divulgar sem medir é trabalhar no escuro. A boa notícia é que dá para fechar esse ciclo sem planilha.

## Por que a comissão "bruta" engana

Olhar só o total de comissão esconde o que importa. Dois afiliados com o mesmo número podem ter resultados muito diferentes:

- Um vende produtos de **ticket alto** com pouca venda; o outro, volume de ticket baixo.
- Um tem **5% de cancelamento**; o outro, 30% — e metade da "comissão" some depois.
- Um precisa de **2.000 cliques** para uma venda; o outro converte com 50.

Para enxergar isso você precisa de três métricas juntas: **taxa de comissão** (comissão ÷ vendas), **conversão** (cliques que viram pedido) e o **EPC** (ganho por clique), que junta preço e conversão num número só.

## Cada link precisa carregar a origem

A peça que liga "publiquei" a "vendeu" é a **etiqueta / Sub-ID**: um marcador por canal ou campanha dentro do link de afiliado. Com ele, cada venda volta sabendo de onde veio — qual grupo, qual post, qual horário.

Se você já usa o **[Bot do Afiliado](https://botdoafiliado.com)** para converter e publicar, ele aplica a sua atribuição automaticamente. Falta só o outro lado: o relatório.

## O painel que fecha o ciclo

O **[Painel do Afiliado](https://paineldoafiliado.com)** reúne as vendas de Shopee, AliExpress, Amazon, Mercado Livre, Magalu e das redes (AWIN, Rakuten, CityAds) num só lugar, convertidas em BRL. Ele mostra:

- Comissão, conversão, ticket e **EPC** por **marketplace**, **produto** (com foto) e **canal**.
- **Status** de cada comissão (pendente, confirmado, cancelado) — para você não contar dinheiro que ainda pode cair.
- **Momentum**: o que está acelerando e o que esfriou, comparando janelas de tempo.

## O fluxo completo

1. O **[Bot do Afiliado](https://botdoafiliado.com)** converte o link (com a sua tag e um Sub-ID por canal) e publica a oferta.
2. As vendas entram no **[Painel do Afiliado](https://paineldoafiliado.com)** já etiquetadas pela origem.
3. Você decide com dados: dobra no que converte, corta o que só dá clique.

Um publica, o outro mede. Junto, vira um sistema — e não mais um "achismo bem postado".

---

# BLOG: Novidade: Automação para Shopee Live
URL: https://botdoafiliado.com/blog/automacao-shopee-live/
Publicado: 2026-06-24
Descrição: O Bot do Afiliado agora tem um módulo dedicado de automação para as suas lives da Shopee. Ative no painel e ganhe uma aba dedicada para conduzir a transmissão.

Novidade no **Bot do Afiliado**: chegou o módulo de **automação para Shopee Live**.

É um módulo **dedicado** para quem faz **live na Shopee** — pensado para agilizar a sua transmissão ao vivo, direto do painel e com o apoio do bot.

## O que é

Uma **aba dedicada** no seu painel, focada nas suas **lives da Shopee**. Ative o módulo e ela aparece no seu bot, pronta para usar.

## Disponível agora

O Shopee Live é um **módulo opcional** (R$ 299/mês) e precisa do **plano base** ativo. Ative quando quiser, direto no painel — e desligue com a mesma facilidade.

**[Ativar no painel](https://app.botdoafiliado.com/)** · **[Ver módulos e preços](/pricing/)** · **[Documentação](/docs/telegram/shopee-live/)**.

---

# BLOG: API de afiliados do Mercado Livre: como gerar link e pegar dados do produto
URL: https://botdoafiliado.com/blog/api-de-afiliados-do-mercado-livre/
Publicado: 2026-06-19
Descrição: O Mercado Livre não tem uma API oficial de afiliados para gerar link nem consultar produto. Veja como fazer isso com a API do Bot do Afiliado (X-API-Key, /convert-links e /product), com exemplos reais.

<img src="/blog/api-de-afiliados-do-mercado-livre.png" alt="API de afiliados do Mercado Livre: gerar link de afiliado e obter dados de produto com a API do Bot do Afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

Procurando a **API de afiliados do Mercado Livre** para **gerar link de afiliado** ou **consultar dados de um produto** por código? A resposta curta é: **o Mercado Livre não oferece uma API pública oficial de afiliados** para isso. O programa de afiliados do ML é operado pelo painel (gerador de links e administrador de etiquetas) — não há um endpoint documentado e suportado que você possa chamar do seu sistema para transformar uma URL na versão com a sua **tag**, nem para puxar título, preço e imagem de forma confiável.

Se você precisa automatizar — montar ofertas, alimentar um site, um bot ou uma planilha — a saída prática é usar a **API do Bot do Afiliado**: uma API REST que **gera o link de afiliado** e **retorna os dados do produto** do Mercado Livre (e de outras lojas), com a **sua** atribuição.

## Por que o Mercado Livre não resolve isso por API

O programa de afiliados do Mercado Livre é pensado para uso **manual**, pelo painel:

- O **[gerador de links](https://www.mercadolivre.com.br/afiliados/linkbuilder#hub)** cria um link por vez, no navegador.
- O **[administrador de etiquetas](https://www.mercadolivre.com.br/afiliados/adminlabel#hub)** mostra a sua **tag** (etiqueta).
- Não há uma API pública de afiliados documentada para **gerar link** programaticamente nem para **consultar dados de produto** já com a sua atribuição.

Ou seja: para qualquer fluxo automatizado, você precisaria reimplementar o fluxo interno do gerador de links — incluindo manter um **cookie de sessão** válido. É exatamente esse trabalho que o Bot do Afiliado encapsula para você.

## A alternativa: a API do Bot do Afiliado

O Bot do Afiliado expõe uma **API REST** que usa a **mesma engine** do bot do Telegram. Depois de configurar o Mercado Livre uma vez (sua **tag** + a sessão da conta pela **extensão do Chrome** — veja o **[guia do Mercado Livre](/docs/integracoes/mercado-livre/)**), você chama dois endpoints:

| Endpoint | Método | O que faz |
|---|---|---|
| `/api/v1/convert-links` | POST | Gera o link de afiliado (1 ou até 150 de uma vez) |
| `/api/v1/product` | POST | Retorna título, preço, imagem e histórico de preços + o link |

- **Base URL:** `https://botdoafiliado.com/api/v1/`
- **Autenticação:** header `X-API-Key` (chave gerada no painel, formato `bk_...`). Veja **[autenticação](/docs/api/autenticacao/)**.
- **Pré-requisitos:** o **[módulo de API](/docs/planos/modulos/)** ativo e o **[plugin do Mercado Livre](/docs/integracoes/mercado-livre/)** configurado.

> 💡 O endpoint **detecta o site automaticamente** a partir da URL. Você não envia `site` nem `provider`: cole a URL do Mercado Livre e a API usa a rota certa.

## Gerar link de afiliado do Mercado Livre

Use `POST /api/v1/convert-links` com a URL do produto. No modo single, envie `url`:

```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.mercadolivre.com.br/produto/p/MLB123456789"}'
```

Resposta (200):

```json
{
  "success": true,
  "url_original": "https://www.mercadolivre.com.br/produto/p/MLB123456789",
  "url_resolvida": "https://www.mercadolivre.com.br/produto/p/MLB123456789",
  "affiliate_url": "https://mercadolivre.com/sec/...",
  "final_url": "https://encurtado.com/...",
  "site": "mercadolivre",
  "provider": "mercadolivre",
  "tracking_id": "..."
}
```

Divulgue sempre o **`final_url`** — é a versão com a sua atribuição e o encurtamento do bot. A **`X-API-Key` já identifica o bot**; você não precisa enviar `bot_id`.

### Vários links de uma vez (batch)

Para converter uma lista, envie `urls` (de 1 a **150** por requisição). No modo batch, cada item tem o seu próprio `ok` — uma URL com erro **não derruba** a requisição inteira:

```bash
curl -X POST "https://botdoafiliado.com/api/v1/convert-links" \
  -H "content-type: application/json" \
  -H "X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"urls":[
        "https://www.mercadolivre.com.br/produto/p/MLB111",
        "https://produto.mercadolivre.com.br/MLB-222...",
        "https://mercadolivre.com.br/..."
      ]}'
```

```json
{
  "success": true,
  "items": [
    { "ok": true, "url_original": "...", "affiliate_url": "...", "final_url": "...", "site": "mercadolivre", "provider": "mercadolivre" },
    { "ok": false, "url_original": "...", "affiliate_url": null, "final_url": null, "error": "..." }
  ]
}
```

Faça **retry apenas dos itens** com `ok: false`. Detalhes em **[convert-links](/docs/api/convert-links/)**.

## Pegar dados do produto do Mercado Livre

Para obter **título, preço, imagem e histórico de preços** — além do link — use `POST /api/v1/product`:

```bash
curl -X POST "https://botdoafiliado.com/api/v1/product" \
  -H "content-type: application/json" \
  -H "X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"url":"https://www.mercadolivre.com.br/produto/p/MLB123456789","history_limit":10}'
```

Resposta (200):

```json
{
  "success": true,
  "url_original": "https://www.mercadolivre.com.br/produto/p/MLB123456789",
  "url_resolvida": "https://www.mercadolivre.com.br/produto/p/MLB123456789",
  "affiliate_url": "https://mercadolivre.com/sec/...",
  "final_url": "https://encurtado.com/...",
  "tracking_id": "...",
  "site": "mercadolivre",
  "provider": "mercadolivre",
  "product": {
    "title": "Nome do produto",
    "price": "199.90",
    "price_number": 199.9,
    "currency": "BRL",
    "image_url": "https://..."
  },
  "price_history": [
    { "createdAt": "2026-06-01T12:34:56.000Z", "price": "219.90", "priceNumber": 219.9, "currency": "BRL" }
  ]
}
```

Os campos de `product.*` podem vir `null` quando não foi possível extrair, e `price_history` pode ser `[]`. O parâmetro `history_limit` aceita de 1 a 50 (padrão 10). Veja **[product](/docs/api/product/)**.

## Erros mais comuns

- **`401` `invalid_api_key`** — a `X-API-Key` está ausente, errada, revogada ou o **[módulo de API](/docs/planos/modulos/)** não está ativo.
- **`400` `conversion_failed`** — não há rota/conversor elegível para a URL (geralmente o **plugin do Mercado Livre não está configurado** ou a **sessão expirou**). Reconecte pela extensão, como no **[guia do Mercado Livre](/docs/integracoes/mercado-livre/)**.

Tabela completa em **[erros e limites](/docs/api/erros-e-limites/)**.

## Resumindo

Não existe uma API oficial de afiliados do Mercado Livre para gerar link ou consultar produto por código. Com a **API do Bot do Afiliado** você faz os dois — `/convert-links` para o **link de afiliado** e `/product` para os **dados do produto** — autenticando com `X-API-Key`, e o mesmo padrão vale para AliExpress, Amazon, Shopee, Magalu e mais.

## Próximos passos

- **[Configurar o Mercado Livre](/docs/integracoes/mercado-livre/)** (tag + extensão do Chrome)
- Docs da API: **[visão geral](/docs/api/visao-geral/)** · **[autenticação](/docs/api/autenticacao/)** · **[convert-links](/docs/api/convert-links/)** · **[product](/docs/api/product/)**
- Sem código? Use a **IA**: **[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/)**

> Precisa do **[módulo de API](/docs/planos/modulos/)** (gera as chaves usadas nas chamadas). Comece no **[painel](https://app.botdoafiliado.com/)**.

---

# 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: Programa de afiliados da Casas Bahia: cadastro grátis na Awin, até 9% de comissão, cookie de 7 dias e promos convertidas em link no automático.

<img src="/blog/afiliado-casas-bahia-programa-privado.png" alt="Como ser afiliado da Casas Bahia: programa privado na Awin com até 9% de comissão e links convertidos no automático" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

**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: Afiliado Época Cosméticos: passo a passo
URL: https://botdoafiliado.com/blog/seja-afiliado-epoca-cosmeticos/
Publicado: 2026-06-07
Descrição: Quer ser afiliado da Época Cosméticos? A entrada é por e-mail de parceria. Veja o passo a passo, copie o modelo pronto e automatize os links no Telegram.

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.

<img src="/blog/automacao-de-cupons-extrair-reativar-expirados.png" alt="Automação de cupons: extrair cupons de um texto e reativar os expirados no Bot do Afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/cupons-ia-extrator.webp" alt="Aba Extrair com IA do módulo de Cupons: o texto de um post de cupom colado e o formulário já preenchido pela IA com a loja, o código, a descrição e o link" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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:

<img src="/docs/telegram/cupons-sites.webp" alt="Aba Sites do módulo de Cupons: lista das lojas com domínio, ordem e situação, e o formulário Novo site" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/bot-moedas-aliexpress.png" alt="Bot do Afiliado conectado ao AliExpress: bot de Telegram que gera o link de desconto de moedas e acha cupons secretos, com moedas e selo de -70%" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/aliexpress-moedas.png" alt="Bot gerando o link de desconto de moedas do AliExpress, com aviso de que o desconto funciona no app e um link alternativo para PC" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

- 📲 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**:

<img src="/docs/telegram/aliexpress-cupom-secreto.png" alt="Bot detectando um cupom secreto em um produto do AliExpress, mostrando o código, o desconto e o valor mínimo de compra" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/broadcast-de-ofertas-no-privado.png" alt="Broadcast de ofertas no privado do Telegram, em fila e sem flood, com o Bot do Afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/broadcast-novo.webp" alt="Tela Novo broadcast no painel: imagem opcional, mensagem com formatação, a pré-visualização de como fica no Telegram, a opção de fixar a mensagem e o botão Enviar Broadcast" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

No Telegram, dá também para usar **`/broadcast`** (admin) e **`/broadcastcompin`** (envia e fixa):

<img src="/docs/telegram/broadcast-enfileirado.png" alt="Comando de broadcast no Telegram: o bot responde que o broadcast foi enfileirado, com o número do job" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/canal-de-ofertas-no-chatgpt-claude-mcp.png" alt="Operar um canal de ofertas dentro do ChatGPT ou do Claude via conexão MCP do Bot do Afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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/)**.

<img src="/docs/ia/mcp-conectar.webp" alt="Card Conectar com login na aba IA (MCP): a URL do bot com o botão Copiar URL e os cards Claude.ai e ChatGPT, cada um com o seu botão de conectar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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:

<img src="/docs/telegram/formatador-oferta.webp" alt="Prévia de uma oferta montada: imagem do produto, título, preço, cupom e link de afiliado encurtado" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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.

<img src="/blog/chatgpt-claude-gerenciar-canal-de-achadinhos.png" alt="Gerenciar um canal de achadinhos pelo ChatGPT ou Claude via MCP do Bot do Afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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.

<img src="/docs/ia/mcp-conectar.webp" alt="Card Conectar com login na aba IA (MCP): a URL do bot com o botão Copiar URL e os cards Claude.ai e ChatGPT, cada um com o seu botão de conectar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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: 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.

<img src="/blog/conexao-mcp-de-afiliado-para-ia.png" alt="Conectar o Bot do Afiliado à IA via MCP — links, ofertas e cupons por conversa no ChatGPT/Claude" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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**).

<img src="/docs/ia/mcp-conectar.webp" alt="Card Conectar com login na aba IA (MCP): a URL do bot com o botão Copiar URL e os cards Claude.ai e ChatGPT, cada um com o seu botão de conectar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

- **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`.

<img src="/docs/api/api-keys.webp" alt="Aba Chaves de API: o card Criar chave de API com nome, nível e o botão Criar, e a lista de chaves com Nome, Chave, Nível e Origem padrão" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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: 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.

<img src="/blog/conheca-o-bot-do-afiliado.png" alt="Bot do Afiliado: converte links de afiliado e monta ofertas no Telegram para AliExpress, Shopee, Mercado Livre e mais de 30 lojas" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/aliexpress-moedas.png" alt="Bot gerando o link de desconto de moedas do AliExpress, com link de app e alternativa para PC" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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:

<img src="/blog/moedas-cupom-secreto-grupo.png" alt="Conversa em um grupo do Telegram: o bot converte o link, avisa que o desconto de moedas funciona no app e detecta um cupom secreto do produto com valor de desconto e gasto mínimo" style="display:block;margin:18px auto;max-width:340px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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: 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.

<img src="/blog/converter-todos-os-links-do-site.png" alt="Converter todos os links do seu site em links de afiliado com um script embed, sem backend" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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 `<script>` no `<head>` e pronto: todos os **links de loja** na página viram os **seus** links de afiliado — inclusive em conteúdo que carrega depois (rolagem infinita, SPA).

<img src="/blog/script-site-chaves.png" alt="Aba Script do site no painel: a chave gerada com os domínios autorizados, o passo a passo e o snippet do script pronto para copiar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Seguro por padrão (Embed Key)

A **Embed Key** é **diferente da sua API key**:

- é **travada por domínio** — só funciona nos sites que **você** autorizar;
- **não** expõe a sua API key nem o ID do bot, e **não** dá acesso ao painel;
- é **revogável** a qualquer momento.

Ou seja: mesmo sendo um script público na sua página, ela não abre nenhuma porta para a sua conta.

## O passo a passo

1. No painel, em **API e IA MCP → Script do site**, dê um **nome** e liste os **domínios autorizados** (um por linha). Clique em **Gerar chave** e **copie o token agora** — ele não é mostrado de novo.

<img src="/docs/api/script-do-site.webp" alt="Card Nova chave de site: o nome da chave, os domínios autorizados, um por linha, e o botão Gerar chave" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. Cole no `<head>` do seu site:

```html
<script src="https://app.botdoafiliado.com/embed/v1/affiliate.js?token=SEU_TOKEN" async></script>
```

3. Pronto. Para **não** converter um link específico, adicione o atributo `data-no-affiliate` na tag `<a>`.

## Funciona em WordPress, Wix, Blogger e afins

Serve para **qualquer site** onde você consiga colar um script no `<head>` — 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: 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.

<img src="/blog/criar-canal-de-ofertas-no-telegram-piloto-automatico-2026.png" alt="Como criar um canal de ofertas no Telegram e vender no piloto automático com o Bot do Afiliado postando ofertas com link de afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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.

<img src="/docs/comecando/o-que-e-conversa.png" alt="Conversa no Telegram: links enviados e o bot respondendo com uma oferta formatada (imagem, preços e links de afiliado)" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/criar-primeiro-template-de-oferta.png" alt="Criar o seu primeiro template de oferta no Bot do Afiliado com variáveis e prévia" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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.

<img src="/docs/telegram/customizar-formato.webp" alt="Card Customização do formato no painel: o seletor Formato que deseja editar, as variáveis do post em botões, o editor e a Prévia do rascunho com o produto" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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:

<img src="/docs/telegram/ofertas-post.png" alt="Post de oferta gerado no Telegram: grade de fotos dos produtos, título, preço e link curto" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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:

<img src="/docs/telegram/customizar-preview.webp" alt="Prévia do rascunho com um produto de verdade: foto, título, preço anterior riscado, preço de venda, parcelas, cupom, link e rodapé" style="display:block;margin:18px auto;max-width:600px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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: 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.

<img src="/blog/cupom-no-piloto-automatico-ia.png" alt="Cadastrar cupom no piloto automático com IA (ChatGPT/Claude) já com o link de afiliado" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/cupons-ia-extrator.webp" alt="Aba Extrair com IA do módulo de Cupons: o texto de um post de cupom colado e o formulário já preenchido pela IA com a loja, o código, a descrição e o link" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

É 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: 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.

<img src="/blog/formatar-posts-de-ofertas-profissionais-telegram.png" alt="Formatar posts de oferta profissionais no Telegram: grade de fotos, rodapé e CTA" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/ofertas-post.png" alt="Post de oferta gerado no Telegram: grade de fotos dos produtos, título, preço e link curto" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/gerar-link-de-afiliado-na-ia-chatgpt.png" alt="Gerar link de afiliado dentro do ChatGPT em linguagem natural, com a sua tag" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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/)**.

<img src="/docs/ia/mcp-conectar.webp" alt="Card Conectar com login na aba IA (MCP): a URL do bot com o botão Copiar URL e os cards Claude.ai e ChatGPT, cada um com o seu botão de conectar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/gerar-ofertas-de-afiliado-na-ia.png" alt="Gerar posts de oferta de afiliado pela IA — título, preço, cupom e CTA prontos" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/formatador-oferta.webp" alt="Prévia de uma oferta montada: imagem do produto, título, preço, cupom e link de afiliado encurtado" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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: 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.

<img src="/blog/grupos-de-cupom-no-telegram-evitar-bloqueios.png" alt="Grupos de cupom no Telegram sem tomar bloqueio: boas práticas anti-spam para crescer" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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.

<img src="/docs/telegram/broadcast-novo.webp" alt="Tela Novo broadcast no painel: imagem opcional, mensagem com formatação, a pré-visualização de como fica no Telegram e a opção de fixar após enviar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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 API), Mercado Livre, Magalu — e nas redes Awin, Rakuten e CityAds, com o guia de cada uma.

<img src="/blog/guia-de-afiliacao-por-marketplace.png" alt="Guia de afiliação por marketplace: como ser afiliado e gerar links em AliExpress, Amazon, Shopee, Mercado Livre e Magalu" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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.

<img src="/docs/integracoes/plugins-aba.webp" alt="Tela Lojas do painel: a lista mostra quais lojas estão conectadas e, à direita, a loja escolhida com o botão Conectar Magalu" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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). → **[guia Amazon](/docs/integracoes/amazon/)** · **[Creators API](/docs/integracoes/amazon-creators/)**
- **Mercado Livre** — sua **tag** + a sessão da conta pela **extensão do Chrome**. → **[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: 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.

<img src="/blog/integrar-shopee-e-aliexpress-no-bot-telegram.png" alt="Integrar Shopee e AliExpress no bot de Telegram e converter todos os links automaticamente" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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).

<img src="/docs/integracoes/plugins-aba.webp" alt="Tela Lojas do painel: a lista mostra quais lojas estão conectadas e, à direita, a loja escolhida com o botão Conectar Magalu" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## Shopee

1. Na **[Open API da Shopee Afiliados](https://affiliate.shopee.com.br/open_api)**, copie o **appId** e o **secret**:

<img src="/docs/integracoes/shopee-appid-secret.png" alt="Área Open API da Shopee Afiliados mostrando onde copiar o appId e o secret" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. Em **Plugins → Shopee**, cole `appId` e `secret`, informe o tracking ID e clique em **Validar** e **Salvar**:

<img src="/docs/integracoes/shopee-conectar.webp" alt="Card da Shopee no painel com a conta conectada" style="display:block;margin:18px auto;max-width:560px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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:

<img src="/docs/integracoes/ali-app-console.png" alt="App Console do AliExpress Open Service: onde criar o app de afiliado" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

2. Copie o **appKey** e o **appSecret** do app:

<img src="/docs/integracoes/ali-appkey-secret.png" alt="Tela do app no AliExpress mostrando onde copiar o appKey e o appSecret" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

3. Em **Plugins → AliExpress**, cole `appKey`/`appSecret`, informe o **tracking ID (PID)** e **valide**:

<img src="/docs/integracoes/aliexpress-validacao.webp" alt="Card Teste da conta do AliExpress mostrando Funcionando, com as duas verificações OK" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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: 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.

<img src="/blog/mcp-shopee-mercado-livre-amazon-afiliados.png" alt="Afiliado Shopee, Mercado Livre e Amazon via MCP: converter e buscar produtos pela IA" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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.

<img src="/docs/ia/mcp-conectar.webp" alt="Card Conectar com login na aba IA (MCP): a URL do bot com o botão Copiar URL e os cards Claude.ai e ChatGPT, cada um com o seu botão de conectar" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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.

<img src="/blog/posts-de-oferta-que-convertem.png" alt="Posts de oferta que convertem no Telegram: template, preço, cupom e CTA bem montados" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/customizar-formato.webp" alt="Card Customização do formato no painel: o seletor Formato que deseja editar, as variáveis do post em botões, o editor e a Prévia do rascunho com o produto" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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:

<img src="/docs/telegram/customizar-preview.webp" alt="Prévia do rascunho com um produto de verdade: foto, título, preço anterior riscado, preço de venda, parcelas, cupom, link e rodapé" style="display:block;margin:18px auto;max-width:600px;width:100%;border-radius:12px;border:1px solid var(--border)" />

## 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.

<img src="/blog/programas-de-afiliados-qual-paga-mais.png" alt="Comparativo de programas de afiliados: qual marketplace paga mais comissão — Shopee, AliExpress, Amazon e Magalu" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

"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/)**
- **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.

<img src="/docs/integracoes/plugins-aba.webp" alt="Tela Lojas do painel: a lista mostra quais lojas estão conectadas e, à direita, a loja escolhida com o botão Conectar Magalu" style="display:block;margin:18px auto;max-width:720px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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.

<img src="/blog/transformar-links-em-afiliado-no-telegram.png" alt="Transformar qualquer link de produto em link de afiliado no Telegram — AliExpress, Shopee, Amazon" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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**.

<img src="/docs/telegram/conversao-auto.png" alt="Conversa no Telegram: link enviado e o bot respondendo com a versão convertida, preço e cupom" style="display:block;margin:18px auto;max-width:380px;width:100%;border-radius:12px;border:1px solid var(--border)" />

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.

<img src="/blog/como-converter-links-no-telegram.png" alt="Como converter links em links de afiliado no Telegram, automaticamente, com a sua tag" style="display:block;margin:0 auto 28px;max-width:760px;width:100%;border-radius:16px;border:1px solid var(--border)" />

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/)