> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> 仅接收您想要的通知到您选择的URL，您可以从使用情况、支付、订阅和试用通知中进行选择

## Webhook 配置

要配置您希望作为 webhook 接收到指定 URL 的通知：

<Steps>
  <Step title="账户和设置">
    在[**登录到仪表板**](https://dashboard.decodo.com)后，点击右上角的`账户和设置`图标。
  </Step>

  <Step title="设置">
    然后，点击`设置`。
  </Step>

  <Step title="Webhooks">
    最后，点击 `Webhooks` 选项卡打开它。
  </Step>

  <Step title="输入 URL">
    输入您希望接收 webhook 的 URL（您可以随时更改 URL）。

    <img src="https://mintcdn.com/decodo/IsWPiMoisao6W8vC/images/docs/d551d305729acdcea642218e9652ad070a3c2f6bd4d45a8b8c803ad979ea6f52-Group_427323110.png?fit=max&auto=format&n=IsWPiMoisao6W8vC&q=85&s=5035349880ff9a902c0f40dc4d2217ff" alt="" width="3448" height="1512" data-path="images/docs/d551d305729acdcea642218e9652ad070a3c2f6bd4d45a8b8c803ad979ea6f52-Group_427323110.png" />
  </Step>

  <Step title="选择 Webhooks">
    仅选择您想在 URL 接收的 webhook，不想接收的留空（您可以激活的 webhook 数量没有限制，并且可以随时更改这些设置）
  </Step>

  <Step title="保存">
    点击右下角的**保存**
  </Step>
</Steps>

<Note>
  * 您可以随时启用希望接收的通知的 webhook，并且只会在适用时收到它们
    * ***例如，如果您为 PAYG 自动充值成功设置了 webhook，只有当您有活跃的 PAYG 计划、达到流量的 90%（0.9 GB）并自动充值另一个 GB 时，您才会收到该 webhook***
</Note>

***

## 可用的 Webhooks

### 支付详情

* 支付失败（包括逾期警报）- 我们无法为您的定期订阅收费
* 预计费警报 - 3 天后，您将被收取定期订阅费用
* 自动充值失败 - 我们无法为您的自动 GB 充值功能收费（这会关闭自动充值功能，要使其再次工作，您需要手动启用它）

### 流量使用详情

* 80% / 100% 使用警报（按流量付费计划）- 您的总流量限制达到 80% 或 100%

### 抓取解决方案详情

* 抓取 API 试用已开始 - 您的抓取 API 试用已准备好使用
* 抓取 API 试用将在 1 天后过期 - 您的抓取 API 试用将在 1 天后过期
* 抓取 API 订阅已过期 - 您的抓取 API 试用已过期

### 按需付费详情

* PAYG 自动充值失败 - 我们无法为您的 PayG 计划的另一个 GB 收费
* PAYG 自动充值成功 - 您已使用当前 PayG 流量的 90%（0.9 GB），并已为另一个 GB 收费
* PAYG 取消成功 - 您已成功关闭自动 PayG 支付，该支付在达到当前 GB 的 90%（0.9 GB）后发生（您仍然可以在 12 个月内使用剩余流量，**除非您在此之前购买另一个住宅计划**）

### 账户详情

* 账户被封禁 - 您的账户已被暂停

<Warning>
  Webhooks 对所有代理类型都是全局的 - 您无法为不同的代理类型配置 webhook，并且将接收适用于您启用的 webhook 的所有代理类型的 webhook
</Warning>

***

## 禁用所有已启用的 Webhooks

如果您不想再接收 webhook 或只是重置它们并设置新配置，请按照以下步骤操作：

<Steps>
  <Step title="账户和设置">
    在[**登录到仪表板**](https://dashboard.decodo.com)后，点击右上角的`账户和设置`图标。
  </Step>

  <Step title="设置">
    然后，点击`设置`。
  </Step>

  <Step title="Webhooks">
    点击 `Webhooks` 选项卡打开它。
  </Step>

  <Step title="清除偏好设置">
    点击`清除偏好设置`。
  </Step>

  <Step title="确认">
    在弹出窗口中，点击`是`以确认您要禁用所有当前启用的 webhook。

    <img src="https://mintcdn.com/decodo/7Hj3tfc-1rGMirwk/images/docs/cf17c61be24363dddf4c752cb4f290ef6c790e16b9e437db073eca7d5a18dc9f-Group_427323111.png?fit=max&auto=format&n=7Hj3tfc-1rGMirwk&q=85&s=ecea398cc07a4bd80c5bee4eeb14da87" alt="" width="3448" height="1532" data-path="images/docs/cf17c61be24363dddf4c752cb4f290ef6c790e16b9e437db073eca7d5a18dc9f-Group_427323111.png" />
  </Step>
</Steps>

***

## 主体示例

#### 您将收到的不同 webhook 的 `JSON` 负载

###### 支付失败（包括逾期警报）

<CodeGroup>
  ```json JSON theme={null}
  {
  "date_time":"2023-01-19 15:26:42",
  "event_name":"subscription_past_due",
  "subscription_uuid":"<your_sub_uuid>"
  }
  ```
</CodeGroup>

###### 预计费警报

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-20 12:53:54",
    "event_name": "impending_payment",
    "subscription_uuid": "<your_sub_uuid>"
  }
  ```
</CodeGroup>

###### 自动充值失败

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-20 14:16:32",
    "event_name": "subscription_top_up_failed",
    "subscription_uuid": "<your_sub_uuid>"
  }
  ```
</CodeGroup>

###### 流量使用详情

<CodeGroup>
  ```json JSON theme={null}
  {
    "usage": "80%",
    "username": "<your_username>",
    "date_time": "2023-01-20 13:13:04",
    "event_name": "traffic_usage"
  }
  ```
</CodeGroup>

###### 抓取 API 试用已开始

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-20 11:20:42",
    "event_name": "serp_trial_created",
    "subscription_uuid": "<your_sub_uuid>"
  }
  ```
</CodeGroup>

###### 抓取 API 试用将在 1 天后过期

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-20 12:49:42",
    "event_name": "serp_expires_tomorrow",
    "subscription_uuid": "<your_sub_uuid>"
  }
  ```
</CodeGroup>

###### 抓取 API 订阅已过期

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-19 15:41:01",
    "event_name": "serp_subscription_expired",
    "subscription_uuid": "<your_sub_uuid>"
  }
  ```
</CodeGroup>

###### PayG 自动充值失败

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-20 12:40:20",
    "event_name": "payg_auto_top_up_failed"
  }
  ```
</CodeGroup>

###### PayG 自动充值成功

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-01-20 12:22:20",
    "event_name": "payg_auto_topped_up"
  }
  ```
</CodeGroup>

###### PAYG 取消成功

<CodeGroup>
  ```json JSON theme={null}
  {
    "date_time": "2023-03-08 13:02:19",
    "event_name": "payg_deactivated"
  }
  ```
</CodeGroup>

###### 账户被封禁

<CodeGroup>
  ```json JSON theme={null}
  {
  "date_time":"2023-01-19 12:58:24",
  "event_name":"user_deactivated"
  }
  ```
</CodeGroup>

***

<Columns cols={2}>
  <Card title="支持" href="https://direct.lc.chat/12092754" cta="让我们聊聊！">
    需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
    您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。
  </Card>

  <Card title="反馈" href="mailto:feedback@decodo.com" cta="分享反馈">
    找不到您要找的内容？请求一篇文章！ \
    有反馈意见？分享您对我们如何改进的想法。
  </Card>
</Columns>