Converter links
convert_linksConverte um link ou um lote usando as integrações do seu bot.
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.
convert_linksPeç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.
Pesquise por termo, faixa de preço e ordenação nas lojas cobertas pela busca, desde que o conversor correspondente esteja ativo.
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ê.
Com o módulo Cupons, consulte os registros e categorias. Cadastrar, remover e reativar cupons também exige permissão para gerenciar.
Consulte campanhas, métricas e histórico de atividade já registrados na sua organização. As ferramentas de campanhas são de leitura.
Na conexão por login, escolha o bot e autorize as permissões. Consulte os apps conectados e desconecte cada um pelo painel.
23 ferramentas no catálogo desta versão. A lista que o seu cliente recebe ao conectar depende da versão publicada, dos módulos do workspace e das permissões que você autorizar. Campanhas e Userbot estão sujeitos à liberação; confira a lista no seu cliente antes de usá-los.
convert_linksConverte um link ou um lote usando as integrações do seu bot.
get_productObtém título, preço, imagem e histórico quando a integração oferece esses dados.
create_offer_postGera o texto da oferta com o template do bot; não é um disparo de broadcast.
search_productsPesquisa produtos nos marketplaces habilitados para o bot.
run_commandExecuta os comandos permitidos de conversão, busca e geração de conteúdo.
list_couponsConsulta cupons com filtros e paginação.
list_coupon_categoriesLista as categorias de cupons cadastradas.
add_couponAdiciona um cupom com condições e validade; exige permissão de escrita.
remove_couponRemove um cupom do bot; exige permissão de escrita.
activate_couponReativa um cupom; exige permissão de escrita.
get_templateConsulta os modelos de texto usados nas mensagens do bot.
set_templateAtualiza templates permitidos; exige permissão de escrita.
get_bot_infoConsulta os recursos e integrações disponíveis para o bot conectado.
get_userbot_configLê as configurações do monitoramento de canais.
set_userbot_configAltera as configurações permitidas; exige permissão de escrita.
get_userbot_historyConsulta as mensagens processadas e seus resultados.
preview_userbot_rulesMostra como as regras tratariam um texto, sem publicá-lo.
list_campaignsConsulta as campanhas do workspace autorizado.
get_campaignConsulta grupos, cliques, entradas, saídas e atribuição da campanha.
campaign_metricsConsulta uma série por dia ou por hora no período permitido.
list_whatsapp_groupsConsulta vagas, saúde e incidentes; convites são mascarados sem escrita.
activity_historyConsulta eventos da operação no período selecionado.
activity_statsResume a atividade por tipo e ação dentro do workspace.
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 explica o funcionamento do conector, e o catálogo desta página mostra as ferramentas que o servidor oferece.
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.
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 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 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.
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.
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; criar, remover ou reativar registros pede acesso de gerenciamento. A combinação está descrita no Combo IA e Cupons.
As ferramentas do Userbot dependem desse módulo, que está em piloto controlado e fora do checkout público. 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.
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 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.
https://app.botdoafiliado.com/mcp.Use a URL específica mostrada no painel para cada bot. Não envie sua senha, token do Telegram ou API key numa conversa com a IA.
Abra Personalizar (Customize) → Conectores, adicione um conector personalizado com a URL do bot e conecte sua conta. Em organizações, o responsável pode precisar habilitar o conector.
No ChatGPT web → Configurações → Apps, confira a disponibilidade de apps personalizados e do modo desenvolvedor. Em um workspace, o administrador pode precisar habilitar o acesso. Crie o app MCP remoto com a URL do bot, escolha OAuth e autorize na Central do Afiliado. As ações de leitura e escrita disponíveis dependem do plano e das permissões da organização.
claude mcp add --transport http bot-do-afiliado https://app.botdoafiliado.com/mcpDepois, use /mcp no Claude Code para autenticar. Documentação oficial.
Em .cursor/mcp.json, use a configuração abaixo. Você pode trocar a URL geral pela URL exata do bot, copiada do painel.
{
"mcpServers": {
"bot-do-afiliado": {
"url": "https://app.botdoafiliado.com/mcp"
}
}
}Ative o servidor no cliente e conclua o login OAuth que ele pedir. No mcp-remote, o navegador abre para a autorização.
Documentação do CursorEm .vscode/mcp.json, use a configuração abaixo. Você pode trocar a URL geral pela URL exata do bot, copiada do painel.
{
"servers": {
"bot-do-afiliado": {
"type": "http",
"url": "https://app.botdoafiliado.com/mcp"
}
}
}Ative o servidor no cliente e conclua o login OAuth que ele pedir. No mcp-remote, o navegador abre para a autorização.
Documentação do VS CodeEm Configuração MCP do cliente (requer Node.js), use a configuração abaixo. Você pode trocar a URL geral pela URL exata do bot, copiada do painel.
{
"mcpServers": {
"bot-do-afiliado": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.botdoafiliado.com/mcp"
]
}
}
}Ative o servidor no cliente e conclua o login OAuth que ele pedir. No mcp-remote, o navegador abre para a autorização.
Documentação do Cliente local via mcp-remoteEntre pela Central do Afiliado e abra Conta › Assinaturas. O dono da organização seleciona Conexão IA e API junto do plano base.
Em Configuração › Plugins, conecte e valide as lojas que você pretende usar. A IA utiliza essas mesmas configurações para converter links.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
No painel, abra Conta › Assinaturas, marque Conexão IA e API e conclua o pagamento. O módulo pode ser desligado quando você quiser.