Tình huống sử dụng

Một ngày với PushWard

Một homelab, một ngày đẩy thông báo. Chọn một thời điểm để xem dịch vụ nào gửi gì, đi vào bằng đường nào và hiện lên iPhone ra sao.

Script ngày làm việc

Bắt đầu ngày làm việc bằng một lần chạm

Lúc 7:00, một script nhỏ đặt câu hỏi trên Màn hình khóa. Chạm Start để trả lời, và thẻ chuyển thành bộ đếm ngược tám tiếng.

REST API
Hoạt động trực tiếp

Cách kết nối

workday.sh

# 07:00 from cron or launchd
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "approval-request",
      "name": "Workday"
    }'

curl -X PATCH https://api.pushward.app/activities/approval-request \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
      "state": "ongoing",
      "content": {
        "template": "approval",
        "state": "Start your workday?",
        "source": "Script",
        "icon": "calendar",
        "accent_color": "blue",
        "details": [
          {
            "label": "Calendar",
            "value": "3 meetings, first at 9:30"
          }
        ],
        "options": [
          {
            "id": "start",
            "title": "Start",
            "style": "primary"
          },
          {
            "id": "later",
            "title": "Later",
            "style": "secondary"
          }
        ]
      }
    }'

Đọc hướng dẫn

Tìm cách thiết lập của bạn

Vẫn những luồng đó, được nhóm theo người sẽ vận hành chúng. Mở một mục để xem cấu hình.

Homelab

Máy chủ, công cụ giám sát, tải xuống và sao lưu tự báo cáo.

Gatus Webhook Relay

Biết khi nào trang web sập và khi nào hoạt động lại

Cách kết nối

gatus/config.yaml

alerting:
  custom:
    url: "https://relay.pushward.app/gatus"
    method: "POST"
    headers:
      Content-Type: "application/json"
      Authorization: "Bearer hlk_YOUR_KEY"
    # body: see the Gatus entry in the Relay guide

Đọc hướng dẫn

Unraid Plugin Unraid

Tác vụ ban đêm trên NAS
Cách kết nối
Plugins > Install Plugin

https://github.com/mac-lucky/pushward-unraid-plugin/raw/main/pushward-unraid.plg
Đọc hướng dẫn

SABnzbd Cầu nối Docker

Tải xuống kèm tốc độ và thời gian còn lại

Cách kết nối

compose.yaml

services:
  pushward-sabnzbd:
    image: ghcr.io/mac-lucky/pushward-sabnzbd:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_SABNZBD_URL: http://sabnzbd:8080/api
      PUSHWARD_SABNZBD_API_KEY: your-sabnzbd-api-key
    restart: unless-stopped

Đọc hướng dẫn

Backrest Webhook Relay

Sao lưu tự báo cáo
Cách kết nối
Backrest > Hooks > Shoutrrr

generic+https://relay.pushward.app/backrest?@authorization=Bearer+hlk_YOUR_KEY&contenttype=application/json
Đọc hướng dẫn
Komodo Webhook Relay

Cảnh báo container từ Komodo
Cách kết nối
Komodo > Alerter > Custom

https://pushward:[[PUSHWARD_KEY]]@relay.pushward.app/komodo
Đọc hướng dẫn

Nhà phát triển và CI

Bản dựng, triển khai và cảnh báo trên Màn hình khóa, từ bất kỳ forge nào.

GitHub Actions Cầu nối Docker

Theo dõi job CI từng bước

Cách kết nối

compose.yaml

services:
  pushward-github:
    image: ghcr.io/mac-lucky/pushward-github:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_GITHUB_TOKEN: github_pat_YOUR_TOKEN
      PUSHWARD_GITHUB_OWNER: your-username
    restart: unless-stopped

Đọc hướng dẫn

Argo CD Webhook Relay

Theo dõi một lần triển khai từ đồng bộ đến healthy

Cách kết nối

argocd-notifications-cm.yaml

data:
  service.webhook.pushward: |
    url: https://relay.pushward.app/argocd
    headers:
    - name: Authorization
      value: Bearer $pushward-key
  # plus the sync-running / sync-succeeded / deployed
  # templates and triggers from the Argo CD guide

Đọc hướng dẫn

Forgejo Actions CLI

Báo cáo từ bất kỳ CI nào bằng CLI

Cách kết nối

.forgejo/workflows/release.yml

env:
  PUSHWARD_API_TOKEN: ${{ secrets.PUSHWARD_API_TOKEN }}
steps:
  - run: pushward activity start release --name "Release v2.4.0" --template steps --step 1/3 --step-labels Build,Test,Ship --text Building
  - run: make build
  - run: pushward activity update release --step 2/3 --text Testing && make test
  - run: pushward activity update release --step 3/3 --text Shipping && make publish
  - run: pushward activity end release --status success

Đọc hướng dẫn

Grafana Plugin Grafana

Cảnh báo kèm biểu đồ riêng

Cách kết nối

grafana.ini

[plugins]
allow_loading_unsigned_plugins = pushward-alerts-app

# Then Apps > PushWard: paste the key, pick alert rules
# for timelines and PromQL queries for widgets.

Đọc hướng dẫn

Nhà thông minh

Máy in, thiết bị gia dụng và lời nhắc từ khắp ngôi nhà.

Bambu Lab Cầu nối Docker

Theo dõi bản in 3D từng lớp

Cách kết nối

compose.yaml

services:
  pushward-bambulab:
    image: ghcr.io/mac-lucky/pushward-bambulab:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_KEY
      PUSHWARD_BAMBULAB_HOST: your-printer-ip
      PUSHWARD_BAMBULAB_ACCESS_CODE: your-access-code
      PUSHWARD_BAMBULAB_SERIAL: your-printer-serial
    restart: unless-stopped

Đọc hướng dẫn

Home Assistant Tích hợp HACS

Lời nhắc và nhiệt độ phòng

Cách kết nối

Home Assistant

HACS > search "PushWard" > Download > restart
Settings > Devices & Services > Add Integration > PushWard

PushWard > Add tracked to-do list   todo.reminders
PushWard > Add tracked widget        sensor.living_room_temperature, ...

Đọc hướng dẫn

Home Assistant Tích hợp HACS

Bất kỳ thực thể nào thành Hoạt động trực tiếp
Cách kết nối
Home Assistant

Settings > Devices & Services > PushWard > Add tracked entity sensor.dishwasher_status
Đọc hướng dẫn

Tác nhân AI

Những tác nhân luôn cập nhật cho bạn và hỏi trước khi hành động.

Tác nhân AI tự host Máy chủ MCP

Để tác nhân hỏi trước khi hành động

Cách kết nối

MCP

# Connect the agent once
claude mcp add --transport http pushward https://mcp.pushward.app/mcp

# What it calls before it orders
create_activity      approval card "Place the grocery order?"  [Approve] [Not now]
wait_for_answer      blocks until a button is tapped -> "approve"
create_notification  "Order placed"

Đọc hướng dẫn

Tác nhân AI tự host Máy chủ MCP

Lời nhắc định kỳ do tác nhân tạo
Cách kết nối
MCP

# "Remind me every Friday at 16:00 to do the weekly review" create_scheduled_notification cron "0 16 * * 5" "Weekly review"
Đọc hướng dẫn

Bảng điều khiển cá nhân

Số liệu và thói quen của riêng bạn trên Màn hình chính và Màn hình khóa.

Script ngày làm việc REST API

Bắt đầu ngày làm việc bằng một lần chạm

Cách kết nối

workday.sh

# 07:00 from cron or launchd
curl -X POST https://api.pushward.app/activities \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "approval-request",
      "name": "Workday"
    }'

curl -X PATCH https://api.pushward.app/activities/approval-request \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/merge-patch+json" \
  -d '{
      "state": "ongoing",
      "content": {
        "template": "approval",
        "state": "Start your workday?",
        "source": "Script",
        "icon": "calendar",
        "accent_color": "blue",
        "details": [
          {
            "label": "Calendar",
            "value": "3 meetings, first at 9:30"
          }
        ],
        "options": [
          {
            "id": "start",
            "title": "Start",
            "style": "primary"
          },
          {
            "id": "later",
            "title": "Later",
            "style": "secondary"
          }
        ]
      }
    }'

Đọc hướng dẫn

Ứng dụng ngân sách REST API

Ngân sách của bạn trên Màn hình chính

Cách kết nối

budget-sync.sh

curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "budget-trend",
      "name": "Spending",
      "content": {
        "template": "trend",
        "icon": "chart.line.uptrend.xyaxis",
        "label": "Budget used",
        "subtitle": "October",
        "value": 68,
        "unit": "%",
        "min_value": 0,
        "points": [
          4,
          9,
          12,
          18,
          21,
          27,
          30,
          34,
          41,
          44,
          49,
          53,
          58,
          61,
          64,
          68
        ],
        "trend": "up",
        "accent_color": "mint"
      }
    }'

Đọc hướng dẫn

Script trên Mac REST API

Script trên Mac của bạn

Cách kết nối

ai-limits.sh

# every 30 minutes from launchd
curl -X POST https://api.pushward.app/widgets \
  -H "Authorization: Bearer hlk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "slug": "ai-limits",
      "name": "AI usage",
      "content": {
        "template": "stat_list",
        "icon": "sparkles",
        "label": "AI usage",
        "accent_color": "purple",
        "stat_rows": [
          {
            "label": "Work account",
            "value": "5h 38% · 7d 61%"
          },
          {
            "label": "Personal",
            "value": "5h 0% · 7d 12%"
          }
        ]
      }
    }'

Đọc hướng dẫn

Tám đường kết nối

Mỗi luồng trên trang này dùng một trong số đó. Hầu hết chỉ mất vài phút để thiết lập.

Kết nối dịch vụ đầu tiên của bạn

Lấy khóa tích hợp trong ứng dụng, chọn một trong các đường kết nối ở trên, và vài phút sau thẻ đầu tiên của bạn đã có trên Màn hình khóa.

Bắt đầu Playground