tray-scripts-externos

Estrelas13

Forks0

Atualizado18 de junho de 2026 às 12:06

API de Scripts Externos da Tray. Utilize quando o desenvolvedor precisar gerenciar scripts JavaScript customizados injetados na vitrine da loja, incluindo listagem, cadastro, atualização e exclusão.

Instalação

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Fonte

tray-tecnologia

tray-tecnologia/tray-api-ai-plugin

Abrir repositório GitHub Ver repositórios do creator

Download

Ocupações relacionadasSOC

Baseado na classificação ocupacional SOC

Desenvolvedores de softwareInformática e Matemática·SOC 15-1252

Explorador de arquivos

11 arquivos

SKILL.md

readonly

name	tray-scripts-externos
description	API de Scripts Externos da Tray. Utilize quando o desenvolvedor precisar gerenciar scripts JavaScript customizados injetados na vitrine da loja, incluindo listagem, cadastro, atualização e exclusão.
when_to_use	Use quando o desenvolvedor mencionar: script externo, JavaScript na vitrine, tag de pixel, GET /external_scripts, POST /external_scripts, injetar script, Google Tag Manager, pixel de rastreio ou código customizado na loja.
when_not_to_use	Não use para webhooks de eventos (use tray-webhooks). Use apenas para injetar scripts JavaScript externos na vitrine da loja.

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 em skills/tray-dev/SKILL.md.
Use os trechos retornados como fonte primária; este SKILL.md é resumo.

Nota: este recurso ainda não tem validate.mjs local. 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_token não aparece como literal string no código gerado.
Confirme que esta é a skill correta para o recurso (leia when_not_to_use no 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 Script e define a location correta (head/body/footer)
Garante HTTPS na URL do script
Define active: 1 ou 0 conforme 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_token configurado
URL pública em HTTPS do script a ser injetado

Mais deste repositório

mesmo repositório

tray-informacoes-loja

tray-tecnologia/tray-api-ai-plugin

API de Informações da Loja da Tray. Utilize quando o desenvolvedor precisar consultar dados de configuração da loja como nome, razão social, CNPJ, endereço, contatos, URLs (domínio) e status interno da loja.

2026-07-0213

tray-produtos

tray-tecnologia/tray-api-ai-plugin

API de Produtos da Tray. Utilize quando o desenvolvedor precisar listar, consultar, cadastrar, atualizar ou excluir produtos no catálogo de uma loja Tray. Inclui todos os campos do produto (nome, preço, estoque, EAN, NCM, dimensões, SEO), filtros de listagem, paginação, ordenação e exclusão de kits.

2026-06-2213

tray-clientes

tray-tecnologia/tray-api-ai-plugin

API de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar dados de clientes da loja: listagem, consulta, cadastro, atualização e exclusão. Inclui campos de pessoa física (CPF) e jurídica (CNPJ), validações brasileiras e gestão de newsletter.

2026-06-2213

tray-cupons

tray-tecnologia/tray-api-ai-plugin

API completa de cupons de desconto da Tray (recurso `discount_coupons`). Cobre criar, editar, listar, consultar e excluir cupons (CRUD) e gerenciar os relacionamentos do cupom com clientes, produtos, categorias, marcas, fretes e cupom-presente, além da geração de cupom de troca a partir de um pedido. Total de 21 endpoints. DISAMBIGUATION: o endpoint base é `/discount_coupons` (NÃO `/coupons`) e o wrapper de payload/resposta é `DiscountCoupon` (NÃO `Coupon`). Cupom é desconto por CÓDIGO aplicado no checkout — não confundir com preço permanente por grupo de cliente (lista de preço B2B).

2026-06-2213

tray-enderecos-cliente

tray-tecnologia/tray-api-ai-plugin

API de Endereços de Clientes da Tray. Utilize quando o desenvolvedor precisar gerenciar os endereços cadastrados dos clientes, incluindo listagem, consulta individual, criação e exclusão. Suporta endereços de entrega e cobrança, com campos completos do padrão brasileiro (CEP, bairro, cidade, estado, complemento).

2026-06-2213

tray-marcas

tray-tecnologia/tray-api-ai-plugin

API de Marcas da Tray. Utilize quando o desenvolvedor precisar gerenciar as marcas (fabricantes) dos produtos da loja, incluindo listagem, consulta individual, criação, atualização e exclusão. Inclui os campos da marca (brand, slug), paginação e filtros.

2026-06-2213

name	tray-scripts-externos
description	API de Scripts Externos da Tray. Utilize quando o desenvolvedor precisar gerenciar scripts JavaScript customizados injetados na vitrine da loja, incluindo listagem, cadastro, atualização e exclusão.
when_to_use	Use quando o desenvolvedor mencionar: script externo, JavaScript na vitrine, tag de pixel, GET /external_scripts, POST /external_scripts, injetar script, Google Tag Manager, pixel de rastreio ou código customizado na loja.
when_not_to_use	Não use para webhooks de eventos (use tray-webhooks). Use apenas para injetar scripts JavaScript externos na vitrine da loja.

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 em skills/tray-dev/SKILL.md.
Use os trechos retornados como fonte primária; este SKILL.md é resumo.

Nota: este recurso ainda não tem validate.mjs local. 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_token não aparece como literal string no código gerado.
Confirme que esta é a skill correta para o recurso (leia when_not_to_use no 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 Script e define a location correta (head/body/footer)
Garante HTTPS na URL do script
Define active: 1 ou 0 conforme 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_token configurado
URL pública em HTTPS do script a ser injetado