Bot do Afiliado

Script do site (Embed): converter links de afiliado no seu site

Adicione conversão automática de links de afiliado ao seu site com uma Embed Key travada por domínio — sem backend e sem expor sua API key.

Nesta página

O Script do site (Embed) adiciona conversão automática de links de afiliado ao seu site — sem backend próprio e sem expor a sua API key. Ele encontra os links de loja na página e troca pelos seus links de afiliado.

A Embed Key é diferente da API key: ela é travada por domínio (só funciona nos sites que você autorizar) e serve apenas para converter links no navegador. Para integrações server-to-server, use a API key.

1) Gerar a Embed Key

No painel: API e IA MCP → Script do site.

  1. Informe um nome (ex.: “Meu blog”).
  2. Liste os domínios autorizados (um por linha — ex.: meusite.com.br).
  3. Clique em Gerar chave e copie o token agora (ele não é mostrado de novo).
Aba Script do site no painel: campo de nome e domínios autorizados para gerar a Embed Key

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 Embed Key é travada por host — só funciona a partir dos domínios cadastrados.
  • Não expõe a API key nem o ID do bot.
  • É revogável a qualquer momento no painel.

Veja também: Autenticação da API e POST /convert-links.

Perguntas frequentes

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

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

O script do site (Embed Key) expõe a minha API key do Bot do Afiliado?

Não. A Embed Key é diferente da API key — ela só funciona a partir dos domínios que você autorizar (travada por host) e não dá acesso ao painel.

A Embed Key do script funciona em qualquer site ou só nos domínios autorizados?

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

Posso editar os domínios autorizados da Embed Key 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 o token. A mudança vale em até 30 segundos.

Onde encontro o snippet do script do site depois de gerar a Embed Key?

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

Como revogar a Embed Key do script do site no painel?

No painel, em Script do site, use Revogar ao lado da chave. Ela para de funcionar na hora.

Pronto para automatizar suas comissões?

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

Criar meu bot Ver módulos e preços