# Webhook

> Shoplazza AI Toolkit 中 shoplazza-webhook 技能的自然语言指令示例：订阅店铺事件、查看与统计订阅、修改回调地址、删除订阅。

`shoplazza-webhook` 技能的自然语言指令——应用的事件订阅。每条请求前加 `/shoplazza-webhook` 前缀，再描述任务。

## 前置条件

* [快速开始](../get-started)
* 按[快速开始](../get-started#3-认证)对店铺完成认证。Webhook 命令本身不需要 OAuth scope（`--domain webhook` 不会展开出任何 scope），所以只带 `--domain webhook` 的店铺登录会因没有请求任何 scope 而被拒绝。

## 示例

### 1. 订阅事件

```
/shoplazza-webhook 订阅 orders/create 事件,推送到 https://example.com/hook
```

用 topic `orders/create` 和该地址运行 `webhook create`。

### 2. 查看订阅

```
/shoplazza-webhook 现在注册了哪些 webhook?
```

运行 `webhook list --format table`。

### 3. 改回调地址

```
/shoplazza-webhook 把 webhook 123 改成指向 https://example.com/webhooks/orders-v2
```

用新地址运行 `webhook update --params '{"id":"123"}'`。

### 4. 删除订阅

```
/shoplazza-webhook 删掉 webhook 123
```

运行 `webhook delete --params '{"id":"123"}'`。作为写操作，智能体会先 `--dry-run` 预览并确认。

### 5. 统计订阅数

```
/shoplazza-webhook 我有多少个 webhook?
```

运行 `webhook count`。

## 域边界

本技能负责**订阅**本身；事件本身（订单创建、商品更新）由 `orders`、`products` 域产生。

## 参见

* [Shoplazza CLI:webhook 命令](/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/webhook)
* [Webhook 概述](/zh-CN/docs/app/building-blocks/webhooks/overview)