Automação Gumroad

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

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

Configuração

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

   https://rube.app/mcp
   

2. Conecte sua conta 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 Gumroad"

Parâmetros: Nenhum necessário -- retorna todos os produtos para a 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-me todas as vendas Gumroad de janeiro de 2025 para o produto prod_ABC123"

Parâmetros chave:

• after -- data/hora ISO8601 para filtrar vendas posteriores (por exemplo, 2025-01-01T00:00:00Z)
• before -- data/hora ISO8601 para filtrar vendas anteriores
• 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 em relação a um produto específico, inspecione a contagem de uso ou verifique o direito de associação.

Ferramenta: GUMROAD_VERIFY_LICENSE

Exemplo de prompt:

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

Parâmetros chave (todos obrigatórios):

• product_id -- O ID do produto para verificar (obrigatório para produtos criados em ou após 9 de janeiro de 2023)
• license_key -- A string da chave de licença (por exemplo, ABCD-EFGH-IJKL-MNOP)
• increment_uses_count -- Se deve incrementar a contagem de uso (padrão é true)

4. Assinar Eventos de Webhook

Configure notificações de eventos em tempo real assinando seu URL de endpoint a eventos específicos de recursos Gumroad.

Ferramenta: GUMROAD_SUBSCRIBE_TO_RESOURCE

Exemplo de prompt:

"Assine meu webhook https://example.com/hook aos eventos de venda Gumroad"

Parâmetros chave (todos obrigatórios):

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

5. Listar Assinaturas de Webhook Ativas

Revise as assinaturas 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 assinaturas de webhook Gumroad ativas para eventos de venda"

Parâmetros chave (obrigatório):

• resource_name -- Um dos oito tipos de evento suportados (por exemplo, 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 fornecê-lo é recomendado.
• Paginação em vendas: Os resultados de vendas são paginados. Sempre verifique se existem mais páginas incrementando o parâmetro page.
• Deduplicação de webhook: Antes de assinar um recurso, use GUMROAD_GET_RESOURCE_SUBSCRIPTIONS para verificar assinaturas existentes e evitar webhooks duplicados.
• Formato de data ISO8601: Filtros de data em vendas devem usar o formato ISO8601 (por exemplo, 2025-01-01T00:00:00Z), não datas simples.

Referência Rápida

Alimentado por Composio