MANDATORY: Tool Call Required Before Answering
Esta chamada é OBRIGATÓRIA, não opcional. Execute-a antes de gerar qualquer código ou payload. Se você está respondendo sem ter chamado a ferramenta abaixo, pare e chame agora.
Buscar documentação atualizada (sempre)
node skills/tray-dev/scripts/search_docs.mjs --topic=scripts-externos "<termo da pergunta>"
<TOPIC_SLUG>: ver tabela emskills/tray-dev/SKILL.md.- Use os trechos retornados como fonte primária; este SKILL.md é resumo.
Nota: este recurso ainda não tem
validate.mjslocal. Você é responsável por revisar campos obrigatórios contra a doc retornada e o resumo abaixo.
Antes de responder
Execute estas verificações antes de gerar qualquer payload ou código:
- Confirme o método HTTP e endpoint correto para a operação solicitada.
- Identifique os campos obrigatórios listados neste documento — não omita nenhum.
- Verifique que
access_tokennão aparece como literal string no código gerado. - Confirme que esta é a skill correta para o recurso (leia
when_not_to_useno frontmatter).
API de Scripts Externos — Tray
Documentação oficial: https://developers.tray.com.br/#apis-de-scripts-externos
Endpoints
| Método | Endpoint | Descrição |
|---|---|---|
| GET | /scripts |
Listagem de scripts externos |
| POST | /scripts |
Cadastrar script externo |
| PUT | /scripts/:id |
Atualizar script |
| DELETE | /scripts/:id |
Excluir script |
Autenticação: ?access_token={token}
Campos
| Campo | Tipo | Descrição |
|---|---|---|
url |
string | URL do script JavaScript |
location |
string | Posição na página: head, body ou footer |
active |
number | 0=inativo, 1=ativo |
Exemplo de Cadastro
{
"Script": {
"url": "https://cdn.exemplo.com/meu-script.js",
"location": "footer",
"active": 1
}
}
Boas Práticas
- Use
footer— para não bloquear o carregamento da página - Scripts leves — evite scripts pesados que impactem a performance
- HTTPS obrigatório — a URL deve usar HTTPS
Como Usar no Claude Code
Exemplos de Prompt
- "injeta o script do Google Tag Manager na vitrine da loja"
- "adiciona o pixel do Facebook no footer da loja"
- "lista todos os scripts externos ativos na loja"
- "desativa o script ID 5 sem excluí-lo"
O que o Claude faz
- Gera o código de cadastro com wrapper
Scripte define alocationcorreta (head/body/footer) - Garante HTTPS na URL do script
- Define
active: 1ou0conforme o caso - Gera o código de listagem e atualização de scripts existentes
O que você recebe
- Código de cadastro com
{"Script": {"url": "...", "location": "footer", "active": 1}} - Código de atualização para ativar/desativar um script existente
- Listagem de scripts ativos via
GET /scripts
Pré-requisitos
access_tokenconfigurado- URL pública em HTTPS do script a ser injetado