> 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/ja/build/choose-channel/whatsapp.md).

# 会話プラットフォームとの連携：WhatsApp

WhatsApp の会話チャネルを連携します。Meta Business アカウントと WhatsApp Business API の認証情報を準備し、MaiAgent でチャネルを追加して Agent を紐付けます。

## 連携前の確認事項 <a href="#pre-integration-checklist" id="pre-integration-checklist"></a>

* [MaiAgent プラットフォーム](https://admin.maiagent.ai/)上で「AI アシスタント」を作成済みであること
* [Meta Business](https://business.facebook.com/) アカウントを保有していること
* WhatsApp Business アカウントを作成し、電話番号を紐付け済みであること

## 連携を開始する <a href="#start-integration" id="start-integration"></a>

### 1. 対話プラットフォーム連携ページを開く <a href="#step-go-to-channel-page" id="step-go-to-channel-page"></a>

左側メニューで <mark style="color:blue;">対話プラットフォーム</mark> をクリックし、右上の <mark style="color:blue;">対話プラットフォームを連携</mark> ボタンをクリックします。

### 2. WhatsApp を選択する <a href="#step-select-whatsapp" id="step-select-whatsapp"></a>

プラットフォーム選択ページで <mark style="color:blue;">WhatsApp</mark> をクリックします。

### 3. Facebook アカウントを接続する <a href="#step-connect-facebook-account" id="step-connect-facebook-account"></a>

<mark style="color:blue;">WhatsApp を接続</mark> ボタンをクリックすると、Facebook の OAuth ログインウィンドウが開きます。

1. ご自身の Facebook アカウントにログインします
2. MaiAgent に WhatsApp Business の管理権限へのアクセスを許可します
3. 許可が完了すると、ウィンドウは自動的に閉じて設定ページに戻ります

{% hint style="warning" %}
ブラウザでポップアップウィンドウが許可されていることを確認してください。許可されていない場合、OAuth ログインウィンドウがブロックされることがあります。
{% endhint %}

### 4. WhatsApp Business アカウントと電話番号を選択する <a href="#step-select-whatsapp-business-account-and-phone" id="step-select-whatsapp-business-account-and-phone"></a>

OAuth 認証が完了したら：

1. <mark style="color:blue;">WhatsApp Business アカウントを選択</mark> のドロップダウンメニューから、連携するビジネスアカウントを選択します
2. <mark style="color:blue;">電話番号を選択</mark> のドロップダウンメニューから、メッセージを受信する電話番号を選択します

### 5. 基本設定 <a href="#step-basic-settings" id="step-basic-settings"></a>

| 項目              | 説明                                         |
| --------------- | ------------------------------------------ |
| **対話プラットフォーム名** | この連携に識別しやすい名前を付けます                         |
| **AI アシスタント**   | 紐付ける AI アシスタントを選択します                       |
| **リセットコマンド**    | （任意）ユーザーが会話を最初からやり直すためのコマンドを設定します。例：「最初から」 |

### 6. 設定を保存する <a href="#step-save-settings" id="step-save-settings"></a>

設定内容に誤りがないことを確認したら、<mark style="color:blue;">保存</mark> をクリックして連携を完了します。

連携が完了すると、ユーザーが WhatsApp でその電話番号宛にメッセージを送信した際に、AI アシスタントが自動的に返信します。

{% hint style="info" %}
連携が成功すると、対話プラットフォーム一覧でこの連携を確認できます。編集をクリックすると、機能オプション（OCR 認識、時間帯別応答、権限管理など）をさらに設定できます。
{% endhint %}

## メッセージ形式と連続メッセージ <a href="#message-format-and-merging" id="message-format-and-merging"></a>

* **Markdown は自動的にテキストへ変換**：Agent の返信に含まれる見出し、リンク、表、コードなどの Markdown 構文は、WhatsApp に送信される前に自動的にプレーンテキストへ変換されます（リンクは「テキスト URL」の形になります）。太字は WhatsApp 独自の `*太字*` 形式に置き換えられます。有人対応のオペレーターが入力した文字は影響を受けません。[メッセージ内容のレンダリング最適化：メッセージングチャネル](/maiagent-user-guide/ja/build/choose-channel/web-chat/markdown-rendering.md#messaging-channels-plain-text)をご覧ください
* **連続メッセージを1ターンにまとめる**：ユーザーが画像を続けて複数送信した場合や、画像を送ってから文字を入力した場合、Agent はそれらのメッセージが揃うのを待ってから1回で回答します（画像のみのメッセージの場合は、最後のメッセージから約4秒間新しいメッセージがなければ回答し、最長で約20秒待ちます。文字を受信した場合はすぐに回答します）。同じ会話では、一度に1ターンずつ処理されます


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/choose-channel/whatsapp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.