# Dify 外掛：即時事件、推播通知與審批

> Dify 的工具外掛，提供四個可用於工作流程和 Agent 的工具：發布事件到頻道、發送推播通知、請人核准某個步驟，以及讀取對方的回答。

Source: https://hibira.io/zh-tw/guides/dify

Dify 的工具外掛，提供四個可用於工作流程和 Agent 的工具：發布事件到頻道、發送推播通知、請人核准某個步驟，以及讀取對方的回答。

Package: hibira-io/dify

- Request Approval 會傳送一次性連結給對方，用來核准或選擇一個選項，並可在節點內等待回答，最長 9 分鐘。Get Approval 可稍後讀取回答。
- 每個工具也能在 Dify Agent 中使用，由模型填入頻道、訊息或問題。
- Send Push Notification 依 interest 或使用者 ID 推播到 iOS、Android 和網頁裝置。
- 請求以 App secret 簽章，secret 本身不會被傳送。外掛只與 Hibira API 通訊，不儲存任何資料。

## 1. 安裝

```text
Plugins → Install plugin → Marketplace → Hibira
  or: Install plugin → Local package file →
      hibira-0.1.0.difypkg from github.com/hibira-io/dify/releases
```

## 2. 設定

```text
Tools → Hibira → API Key Authorization Configuration
  App ID:            YOUR_APP_ID
  Key:               YOUR_APP_KEY
  Secret:            YOUR_APP_SECRET
  Push Instance ID:  optional, for push notifications
  Push Secret Key:   optional
```

## 3. 請求審批

```text
Start (order, amount)
→ Hibira → Publish Event
    Channels:  orders      Event:  refund-requested
→ Hibira → Request Approval
    Question:  Refund order {{order}} for {{amount}}?
    Options:   Refund, Decline
    Wait for Answer (Minutes):  5
→ IF text starts with Approved → Hibira → Send Push Notification
```

## 開始之前

- 審批適用於在 Hibira 主控台建立的 app。回答連結只能使用一次，並在你設定的時間後失效。
- Wait for Answer 設為 0 時，Request Approval 會立即回傳，回答連結在 url 中。把連結傳給對方，再用 Get Approval 等待回答。
- Send Push Notification 需要 App 的 Push 分頁中的 Push Instance ID 和 Push Secret Key。

- [Dify Marketplace](https://marketplace.dify.ai/plugin/hibira/hibira)
- [GitHub](https://github.com/hibira-io/dify)