Script do site: converter links de afiliado no seu site

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.

Publicado em · Atualizado em · Versão em Markdown

Recurso do módulo API de links · R$ 99/mês

Nesta página

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.

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.

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

2) Colar o script no site

Cole no <head> do seu site:

<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:

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 e POST /convert-links.

Perguntas frequentes

Preciso de servidor próprio para converter links de afiliado no meu site com o script?

Não. O script roda no navegador do visitante e chama o endpoint /embed/v1/convert-links com a chave do site.

O script do site expõe a minha chave de API do Bot do Afiliado?

Não. A chave do site é diferente da chave de API — ela só funciona a partir dos domínios que você autorizar e não dá acesso ao painel.

A chave do site funciona em qualquer site ou só nos domínios autorizados?

Não. Só nos domínios que você cadastrar. Pedidos de outros domínios são recusados.

Posso editar os domínios autorizados da chave do site depois de criar o script?

Sim. No painel, em Script do site, clique em Editar na chave para alterar o nome e os domínios autorizados, sem precisar trocar a chave. A mudança vale em até 30 segundos.

Onde encontro o código do script do site depois de gerar a chave?

Na própria aba Script do site, no card "Como funciona". O código do <script> fica sempre visível (troque SEU_TOKEN pela chave que você guardou na criação).

Como revogar a chave do script do site no painel?

No painel, em Script do site, use Revogar ao lado da chave. Ela para de funcionar em até 30 segundos.

Pronto para automatizar suas comissões?

Crie seu bot, conecte suas integrações e comece a converter links em segundos.

Criar meu botVer módulos e preços