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

- URL: https://botdoafiliado.com/docs/api/script-do-site/
- Publicado em: 2026-06-03
- Atualizado em: 2026-11-08
- Índice da documentação para IA: https://botdoafiliado.com/llms.txt

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

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