> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/conversations/webhook.md).

# Webhook

## 用途 <a href="#usage" id="usage"></a>

開発者は、システムがデータを送信できるように、API エンドポイント（言わば URL のようなもの）を 1 つ用意する必要があります。MaiAgent の AI アシスタントが対話プラットフォーム上で回答を生成すると、その回答は設定したこの Webhook エンドポイントへ自動的に送信されます。

このように設定することで、AI の回答を自社システムに統合できます。たとえば、回答を記録したり、ユーザーへ再転送したり、その他の用途に活用したりできます。

これらの Webhook の送信履歴は、システムがこのページに集約して表示しますので、いつでも確認・追跡・問題の切り分けを行えます。

{% hint style="info" %}
[API の連携方法について](/tech/api-integration/quickstart.md)
{% endhint %}

<figure><img src="/files/mkGqJQ9sI0e1XoBs9aWb" alt=""><figcaption></figcaption></figure>

## 活用シーン <a href="#use-cases" id="use-cases"></a>

### **カスタマーサポートシステムとの統合** <a href="#customer-service-system-integration" id="customer-service-system-integration"></a>

AI アシスタントがユーザーの質問に回答した後、Webhook を通じて回答内容を企業のカスタマーサポートシステムへ同期します。これにより、サポート担当者は対話履歴を確認し、後続の対応や有人対応への引き継ぎを行えます。

### **リアルタイム通知のプッシュ** <a href="#real-time-notification-push" id="real-time-notification-push"></a>

AI アシスタントの回答や特定のイベント（異常の発生など）を Slack、Line Notify、Email などのコミュニケーションツールへプッシュ送信し、関係者へ即時対応を促します。

### **データ分析と記録のアーカイブ** <a href="#data-analytics-and-archiving" id="data-analytics-and-archiving"></a>

すべての AI 対話データをデータウェアハウス、クラウドデータベース、または Google Sheets へ自動的に送信し、利用行動の分析、品質評価、インタラクション記録のアーカイブ作成を行います。

### **社内業務フローの自動化** <a href="#internal-workflow-automation" id="internal-workflow-automation"></a>

ユーザーが AI アシスタントを通じて問題を報告したり、リソースを申請したり、異常を通知したりする場合、Webhook はこれらのデータを社内フォームシステムやタスク管理ツール（Jira、Notion など）へ自動的に連携し、後続の追跡を行えるようにします。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/conversations/webhook.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
