> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# マルチデバイスとデバイス選択

> 一つのGOWAサーバー上で複数のWhatsAppアカウントを実行し、それぞれのリクエストがX-Device-IDで使用するものを選択します。

![GOWA Multi Device Whats App Architecture](https://mintcdn.com/gowa-docs/ccA2Yz4DVI9xOiS8/images/GOWA-Multi-Device-WhatsApp-Architecture.png?fit=max\&auto=format\&n=ccA2Yz4DVI9xOiS8\&q=85\&s=116b948218cb46aa9eca0b959634eaaf)

「マルチデバイス」とは、GOWAの2つのことを意味します:

* **WhatsAppのマルチデバイスプロトコル** GOWAはWhatsAppウェブのようなコンパニオンデバイスとしてアカウントにリンクします。 電話は、オンライン滞在する必要はありませんし、各アカウントは、最大4つのリンクされた仲間を可能にします。
* **1つのサーバーにつき複数のアカウント** 1つのGOWAプロセスは多くの**デバイススロット**を保持することができます。 各スロットは、別のWhatsAppアカウントで、または別の仲間と同じ番号でペア。

## デバイススロット

スロットには、選択したID(または生成されたUUID)とステートがあり、アカウントのJIDとペアリングされます。

| 都道府県： | 意味 |
| - | - |
| `disconnected` | WhatsAppに接続されていません. 新しいまたはログアウトスロットは、ここで開始します. |
| `connecting` | 接続中です。 |
| `connected` | ソケットを開いて、まだログインしていません（例えばQRスキャンを待っているときなど）。 |
| `logged_in` | ペアリングされ、送受信の準備ができています。 |

### スロットを管理

```bash theme={null}
# Create (device_id is optional)
curl -u admin:changeme -X POST http://localhost:3000/devices \
  -H "Content-Type: application/json" \
  -d '{"device_id": "sales"}'

# List
curl -u admin:changeme http://localhost:3000/devices

# Inspect / live status
curl -u admin:changeme http://localhost:3000/devices/sales
curl -u admin:changeme http://localhost:3000/devices/sales/status

# Pair, log out, reconnect
curl -u admin:changeme http://localhost:3000/devices/sales/login
curl -u admin:changeme -X POST "http://localhost:3000/devices/sales/login/code?phone=628123456789"
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/logout
curl -u admin:changeme -X POST http://localhost:3000/devices/sales/reconnect

# Remove the slot and its session and chat data
curl -u admin:changeme -X DELETE http://localhost:3000/devices/sales
```

`/devices/...`ルートはデバイスをパスから取得するため、`X-Device-Id`は必要ありません。スロットとセッションは再起動後も継続します。

## デバイスの選択

他のすべてのデバイススコープのルート (`/send/*`, `/message/*`, `/chat*`, `/group*`, `/user/*`, `/newsletter/*`, `/call/*`, `/app/metrics`を除いて、`/app/info`と`/app/*`) は、どのアカウントを動作させるかを知る必要があります。 GOWAはこの順序で解決します。

1. `X-Device-Id` ヘッダー (URL-decoded).
2. `device_id` クエリパラメータ。
3. どちらも与えられておらず、**正確に1つ**スロットが存在する場合は、そのスロットです。

値はスロットIDまたはアカウント JID にすることができます (例えば、 `628123456789@s.whatsapp.net`)。

```bash theme={null}
curl -u admin:changeme -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -H "X-Device-Id: sales" \
  -d '{"phone": "628123456789", "message": "Hi from the sales number"}'

# Equivalent, using the query parameter
curl -u admin:changeme -X POST "http://localhost:3000/send/message?device_id=sales" \
  -H "Content-Type: application/json" \
  -d '{"phone": "628123456789", "message": "Hi from the sales number"}'
```

> [!TIP]
>
> 1つのスロットであっても常に`X-Device-Id`を送信します。後で2つ目のスロットを追加すると、スコープなしの呼び出しはすべて`DEVICE_ID_REQUIRED`で失敗します。

### 選択エラー

| HTTP | `code` | 原因 |
| - | - | - |
| 400 | `DEVICE_ID_REQUIRED` | デバイスが指定されておらず、ゼロまたは複数のスロットが存在しません。 |
| 404 | `DEVICE_NOT_FOUND` | 指定されたIDまたはJIDに一致するスロットがありません。 |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` | サーバーの初期化が完了していません。 |

存在するがログインしていないスロットは、選択されたスロットに渡します。 その後、「ログインしていない」などのWhatsAppエラーで要求が失敗します。

## デバイス毎の機能

| 機能 | どのようにスコープされますか？ |
| - | - |
| Webhooks | 各ペイロードは `device_id` (アカウントJID) と `session_id` (スロットID) を持ちます。 スロットは `PATCH /devices/{device_id}/webhook` 独自のWebhookを持つことができます。 [Webhooks](https://gowa-docs.mintlify.site/ja/concepts/webhooks.md#%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9%E6%AF%8E%E3%81%AEwebhook%E6%95%B0) を参照してください。 |
| WebSocket | デバイスコンテキストを選択するには、`/ws?device_id=<id>`に接続します。 現在のハブは、接続されているすべてのソケットにイベントをブロードキャストします。そのため、クライアントはイベントのデバイス識別子によってフィルタリングしなければなりません。ブラウザのオリジンは信頼されなければなりません。 |
| スケジュールされた送信 | 作成したスロットには以下のように指定します。そのスロットの `X-Device-Id` でリストします。 |
| MCP | MCP 接続の `X-Device-Id` 、ツール呼び出しごとの `device_id` 引数。[MCP server](https://gowa-docs.mintlify.site/ja/integrations/mcp.md) を参照してください。 |
| Chatwoot | 1つの受信トレイの場合は`CHATWOOT_DEVICE_ID` 、または1スロットにつき1つの受信トレイの場合はデバイスごとに設定します。 [Chatwoot](https://gowa-docs.mintlify.site/ja/integrations/chatwoot.md) を参照してください。 |

## 制限と注意

* WhatsAppは、アカウントごとに最大4人のリンクされた仲間を可能にします。そのアカウントにペアリングされた各GOWAスロットは1つを使用します。
* 電話が約14日間オフラインのままである場合のWhatsAppはコンパニオンを解除します。
* ペアリング後の履歴の同期は、WhatsAppによって部分的に制御されます。GOWAはチャットストレージに受け取ったものを保存します。
* ユーザーが直面するチャットとメッセージの読み取りは、ログインアカウントのストレージIDを使用します。 別のスロットのメッセージを検索するときに、1つのスロットのデバイスヘッダを置き換えないでください。再ペアリングされたスロットは、現在のクライアントを通じてイベントを受信します。
* 各スロットは、完全なWhatsApp接続です. メモリとCPUは、スロットの数とトラフィックのボリュームで成長します.


## Related topics

- [APIリファレンス](https://gowa-docs.mintlify.site/ja/api-reference/introduction.md)
- [MCP サーバー](https://gowa-docs.mintlify.site/ja/integrations/mcp.md)
- [新しいデバイスを追加](https://gowa-docs.mintlify.site/ja/api-reference/device/新しいデバイスを追加.md)
- [アクティブなデバイスをログアウト (デバイススロットを保持)](https://gowa-docs.mintlify.site/ja/api-reference/app/アクティブなデバイスをログアウト-デバイススロットを保持.md)
- [デバイスのライブ更新サブスクリプションを一覧表示する](https://gowa-docs.mintlify.site/ja/api-reference/newsletter/デバイスのライブ更新サブスクリプションを一覧表示する.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.