skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
shoplazza/shoplazza-cli60 installs

shoplazza-webhook

Use when an app developer needs to manage webhook subscriptions on a Shoplazza store through the CLI — subscribe to store events (order created, product updated, …) so the platform pushes notifications to an app's endpoint, and list / get / update / delete / count those subscriptions. Triggers include webhook / 事件订阅 / 事件回调 / 事件通知 / 推送通知 / 回调地址 / subscribe to an event / event notification. NOT the events themselves in shoplazza-orders / shoplazza-products — this domain owns the SUBSCRIPTION. NOT verifying webhook HMAC signatures (webhook 验签 → shoplazza-docs).

How do I install this agent skill?

npx skills add https://github.com/shoplazza/shoplazza-cli --skill shoplazza-webhook
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides standard functionality for managing store webhooks through the Shoplazza CLI. It incorporates safety mechanisms, such as mandatory user confirmation for destructive actions and cross-referencing a central common skill for authentication and platform-wide rules.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

shoplazza CLI — webhook module

CRITICAL — before anything else, use Read on ../shoplazza-common/SKILL.md. It owns every cross-cutting mechanic: access tiers, the output envelope (.data), --dry-run, --jq, schema, api rest, auth / profiles, and the safety protocol. This file covers only the webhook domain and never repeats them.

Overview

The webhook module manages event subscriptions: a webhook binds a store event topic (e.g. orders/create) to an address (an HTTPS endpoint the platform calls when the event fires). It is spec-leaf only — no +shortcuts. Full CRUD + count.

Command map

Intent → command. Authoritative params/body live in shoplazza schema webhook.<cmd>.

User intentCommand
Subscribe to an event (create)webhook create --data '{"webhook":{"topic":"<event>","address":"<https-url>"}}'
List all webhookswebhook list
Count webhooks (optionally filtered)webhook count --params '{"address":"<url>","topic":"<event>"}' (params optional)
Get one webhookwebhook get --params '{"id":"<id>"}'
Update a webhook's address / topicwebhook update --params '{"id":"<id>"}' --data '{"webhook":{"address":"<url>","topic":"<event>"}}'
Delete a webhook (destructive → --dry-run first)webhook delete --params '{"id":"<id>"}' --dry-run

Event topics look like orders/create, orders/fulfilled, products/update, etc. The full topic list isn't introspectable from the binary — confirm a topic with shoplazza schema webhook.create / the Open Platform docs; don't invent one.

Acting on a request

  1. Match intent to the leaf (no shortcuts here).
  2. create needs two required fields — ask with AskUserQuestion if either is missing, never fabricate: the event topic and the address (HTTPS endpoint). For update/get/ delete, the webhook id is required.
  3. create/update are safe to run directly once required fields are present (subscriptions don't move money); use --dry-run first only if the user asks.
  4. delete is destructive — it silently stops event delivery and cannot be undone. It follows the shoplazza-common safety protocol: --dry-run first, restate which subscription (topic + address, not just the id), then stop and wait for the user's go-ahead.

Boundaries

Reads like an event/order/product task, actually belongs here:

Sounds like orders / productsActually belongs toCommand
"订单发货后自动通知我的系统" / notify my system when an order shipsHERE (webhook) — it's a subscriptionwebhook create --data '{"webhook":{"topic":"orders/fulfilled",…}}'
"商品更新时通知我" / get notified when a product is updatedHERE (webhook)webhook create --data '{"webhook":{"topic":"products/update",…}}'

Subscribing to an event is a webhook, not an orders/products command. (Serves the event-webhook routing collision.)

Permissions · Scope

Authorization is by domain. Grant: auth login --domain webhook. Look up exact scope literals with shoplazza auth scopes.

Gotchas

Domain-specific only (generic rules are in shoplazza-common).

SymptomCauseFix
Guessed a topic and it was rejectedThe topic enum isn't in the binary's helpConfirm via schema webhook.create / Open Platform docs; ask the user if unsure — don't invent
create failstopic and address are both required in the webhook body--data '{"webhook":{"topic":"…","address":"…"}}'
address rejectedEndpoints must be reachable HTTPS URLsPass a full https:// URL

Recipes

# 1. Subscribe: push order-created events to an endpoint
webhook create --data '{"webhook":{"topic":"orders/create","address":"https://api.myapp.com/hooks/orders"}}'

# 2. List current subscriptions
webhook list

# 3. Update a webhook's address
webhook update --params '{"id":"246"}' --data '{"webhook":{"address":"https://new.example.com/hook"}}'

# 4. Delete a subscription: look up what it is, preview, then STOP for the user's go-ahead
webhook get --params '{"id":"135"}' --jq '.data.webhook | {topic, address}'
webhook delete --params '{"id":"135"}' --dry-run

# 5. Count webhooks pointing at an address
webhook count --params '{"address":"https://api.myapp.com/hooks"}'

References

  • Per-command flags: shoplazza webhook <cmd> --help
  • Params / body / response: shoplazza schema webhook.<cmd>
  • Cross-cutting mechanics (auth / tiers / output envelope / --dry-run / safety): ../shoplazza-common/SKILL.md

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/shoplazza/shoplazza-cli/shoplazza-webhook">View shoplazza-webhook on skillZs</a>