Skill tray-tecnologia/tray-api-ai-plugin/skills/newsletter

API de Newsletter da Tray. Utilize quando o desenvolvedor precisar gerenciar assinaturas de newsletter da loja, incluindo listagem de assinantes, inscrição e confirmação de cadastro.From its SKILL.md

Install

npx -y skills add tray-tecnologia/tray-api-ai-plugin --skill newsletter

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.7 KB, as published. Nobody here has run it

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=newsletter "<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 Newsletter — Tray

Documentação oficial: https://developers.tray.com.br/#apis-de-newsletter

Endpoints

Método	Endpoint	Descrição
GET	`/newsletters`	Listagem de assinantes da newsletter
POST	`/newsletters`	Cadastrar assinante
POST	`/newsletters/confirm`	Confirmar cadastro de newsletter

Autenticação: ?access_token={token}

Exemplo de Inscrição

{
  "Newsletter": {
    "email": "[email protected]",
    "name": "João Silva"
  }
}

Campos

Campo	Tipo	Obrigatório	Descrição
`email`	string	Sim	E-mail do assinante (único). Sem ele → HTTP 400.
`name`	string	Não	Nome do assinante

⚠️ email é obrigatório na inscrição. A confirmação (double opt-in) aceita email ou token no corpo.

Fluxo de Inscrição

POST /newsletters — cadastra o e-mail
POST /newsletters/confirm — confirma a inscrição (double opt-in)

Paginação

limit (máximo 50, padrão 30), page.

Boas Práticas

LGPD — obtenha consentimento explícito antes de inscrever
Double opt-in — use o endpoint de confirmação para validar o e-mail

Como Usar no Claude Code

Exemplos de Prompt

"inscreve um cliente na newsletter com double opt-in"
"lista todos os assinantes da newsletter da loja"
"implementa o fluxo completo de inscrição com confirmação por e-mail"

O que o Claude faz

Gera o código de inscrição com wrapper Newsletter (nome + e-mail)
Gera o código de confirmação via POST /newsletters/confirm
Explica o fluxo double opt-in e a obrigatoriedade de consentimento (LGPD)

O que você recebe

Código de inscrição com {"Newsletter": {"email": "...", "name": "..."}}
Código de confirmação double opt-in
Listagem de assinantes com paginação

Pré-requisitos

access_token configurado
Consentimento explícito do usuário (LGPD)