# 自動化

> Owner-built automations on triggers, with conditions, branches, delays, retries, custom triggers and HTTP actions.

> Markdown version of https://kanorio.com/ja/developers/products/automation. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/automation.md

Status: **Available**

自動化は、注文の支払い完了、フォームの送信、特定の日時の到来、あるいは独自のシステムによるイベント報告など、何らかの事象が発生した際にステップを実行します。メール送信は、数あるアクションの一つに過ぎません。

## コアオブジェクト

- **トリガーとアクション:** 各トリガーのデータと各アクションの入力に対するJSONスキーマを備えたカタログです。
- **自動化:** 管理画面またはAPIを通じて構築される、条件、分岐、遅延、レート制限です。
- **実行:** 再試行、失敗の詳細、再実行オプションを備えた、ステップごとの実行履歴です。
- **カスタムトリガー:** `POST /sites/{id}/automations/events` を使用して独自のイベントを報告し、自動化を開始できます。

## APIの活用方法

- Management APIを使用して、カタログの読み取り、自動化の作成・編集・テスト、実行履歴の読み取りや再試行が可能です。
- `automations.run.failed` Webhookを使用すると、実行が失敗した際に通知を受け取ることができます。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Automation engine: trigger/action catalog, owner-built flows, per-step runs, custom triggers | Available | Management API (REST/MCP) `automations.catalog.get`, `automations.templates.list`, `automations.flows.*` (list/get/validate/create/update/set_status/archive/delete/test), `automations.runs.*` (list/get/rerun), `automations.events.report`/`cancel`, `automations.triggers.*`, `automations.secrets.*`; preinstalled toggles via `automations.list`/`set_action_enabled`; signed inbound endpoint `POST /api/webhooks/automations/<token>` (Standard Webhooks) | — | `/automations`, `/automations/settings` | Every trigger in the catalog is also a subscribable webhook event; custom triggers accept signed inbound webhooks (planned) |

## API reference

- Management API: [Automations](https://kanorio.com/en/developers/management-api/automations) (27 operations)

## Webhook events

- `automations.run.failed`: Fired when a run of an owner-built automation ends in FAILED after retries (compensation already applied). Not fired for test runs or platform-default automations; at most once per automation revision every 30 days.
- `automations.flow.paused`: Fired when Kanorio turns an owner-built automation off automatically because its current revision ran more than 20 times in the past 7 days and 95% or more of those runs failed.

Payloads: https://kanorio.com/en/developers/webhooks/events