Automação Gumroad

Automação do Gumroad

Automatize sua loja no Gumroad -- liste produtos, acompanhe vendas, verifique licenças e gerencie webhooks em tempo real -- tudo por meio de comandos em linguagem natural.

Documentação do toolkit: composio.dev/toolkits/gumroad

---

Configuração

1. Adicione o servidor MCP do Composio à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta do Gumroad quando solicitado (autenticação por chave de API).
3. Comece a emitir comandos em linguagem natural para gerenciar sua loja Gumroad.

---

Fluxos de Trabalho Principais

1. Listar Todos os Produtos

Recupere todos os produtos da sua conta Gumroad autenticada para obter IDs de produtos para operações posteriores.

Ferramenta: GUMROAD_LIST_PRODUCTS

Exemplo de prompt:

"Liste todos os meus produtos do Gumroad"

Parâmetros: Nenhum necessário -- retorna todos os produtos da conta autenticada.

---

2. Acompanhar Vendas com Filtros

Recupere vendas bem-sucedidas com filtragem opcional por e-mail, intervalo de datas, produto ou paginação.

Ferramenta: GUMROAD_GET_SALES

Exemplo de prompt:

"Mostre todas as vendas do Gumroad de janeiro de 2025 para o produto prod_ABC123"

Parâmetros principais:

• after -- Data/hora no formato ISO8601 para filtrar vendas após (ex.: 2025-01-01T00:00:00Z)
• before -- Data/hora no formato ISO8601 para filtrar vendas antes
• email -- Filtrar por endereço de e-mail do cliente
• product_id -- Filtrar por ID de produto específico
• page -- Número da página para resultados paginados (mínimo 1)

---

3. Verificar Chaves de Licença

Verifique se uma chave de licença é válida para um produto específico, inspecione o número de usos ou confira direito a assinatura.

Ferramenta: GUMROAD_VERIFY_LICENSE

Exemplo de prompt:

"Verifique a chave de licença ABCD-EFGH-IJKL-MNOP para o produto prod_ABC123"

Parâmetros principais (todos obrigatórios):

• product_id -- O ID do produto a ser verificado (obrigatório para produtos criados em ou após 9 de janeiro de 2023)
• license_key -- A string da chave de licença (ex.: ABCD-EFGH-IJKL-MNOP)
• increment_uses_count -- Se deve incrementar o contador de usos (padrão é verdadeiro)

---

4. Inscrever-se em Eventos de Webhook

Configure notificações de eventos em tempo real inscrevendo a URL do seu endpoint em eventos de recurso específicos do Gumroad.

Ferramenta: GUMROAD_SUBSCRIBE_TO_RESOURCE

Exemplo de prompt:

"Inscreva meu webhook https://example.com/hook em eventos de venda do Gumroad"

Parâmetros principais (todos obrigatórios):

• resource_name -- Um de: sale, refund, dispute, dispute_won, cancellation, subscription_updated, subscription_ended, subscription_restarted
• post_url -- A URL do seu endpoint que recebe notificações HTTP POST

---

5. Listar Inscrições Ativas de Webhook

Revise as inscrições de webhook existentes para um determinado tipo de recurso antes de adicionar novas, para evitar duplicatas.

Ferramenta: GUMROAD_GET_RESOURCE_SUBSCRIPTIONS

Exemplo de prompt:

"Mostre todas as minhas inscrições ativas de webhook do Gumroad para eventos de venda"

Parâmetros principais (obrigatórios):

• resource_name -- Um dos oito tipos de evento suportados (ex.: sale, refund)

---

Armadilhas Conhecidas

• ID do produto necessário para verificação de licença: Produtos criados em ou após 9 de janeiro de 2023 exigem o parâmetro product_id. Produtos mais antigos podem funcionar sem ele, mas é recomendado fornecê-lo.
• Paginação em vendas: Os resultados de vendas são paginados. Sempre verifique se há mais páginas incrementando o parâmetro page.
• Deduplicação de webhooks: Antes de se inscrever em um recurso, use GUMROAD_GET_RESOURCE_SUBSCRIPTIONS para verificar inscrições existentes e evitar webhooks duplicados.
• Formato de data ISO8601: Os filtros de data nas vendas devem usar o formato ISO8601 (ex.: 2025-01-01T00:00:00Z), não datas simples.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Listar produtos	GUMROAD_LIST_PRODUCTS	Nenhum
Obter vendas	GUMROAD_GET_SALES	Nenhum (todos os filtros opcionais)
Verificar licença	GUMROAD_VERIFY_LICENSE	product_id, license_key
Inscrever-se em eventos	GUMROAD_SUBSCRIBE_TO_RESOURCE	resource_name, post_url
Listar inscrições de webhook	GUMROAD_GET_RESOURCE_SUBSCRIPTIONS	resource_name

---

Desenvolvido por Composio