How do I install the Tray Newsletter skill?

Run npx skillmds@latest add tray-tecnologia/tray-newsletter in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tray Newsletter safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tray Newsletter?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tray Newsletter free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tray Newsletter?

tray-tecnologia (@tray-tecnologia) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tray Newsletter by tray-tecnologia — Agent Skill

Name: Tray Newsletter
Author: tray-tecnologia

File contents

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": "cliente@exemplo.com",
    "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)

---name: tray-newsletterdescription: 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.---## 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)```bashnode 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:1. Confirme o método HTTP e endpoint correto para a operação solicitada.2. Identifique os campos obrigatórios listados neste documento — não omita nenhum.3. Verifique que `access_token` não aparece como literal string no código gerado.4. Confirme que esta é a skill correta para o recurso (leia `when_not_to_use` no frontmatter).# API de Newsletter — TrayDocumentaçã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```json{ "Newsletter": { "email": "cliente@exemplo.com", "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ção1. `POST /newsletters` — cadastra o e-mail2. `POST /newsletters/confirm` — confirma a inscrição (double opt-in)## Paginação`limit` (máximo 50, padrão 30), `page`.## Boas Práticas1. **LGPD** — obtenha consentimento explícito antes de inscrever2. **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 faz1. Gera o código de inscrição com wrapper `Newsletter` (nome + e-mail)2. Gera o código de confirmação via `POST /newsletters/confirm`3. 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)

Frequently asked questions

Tray Newsletter