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

# connect_agent

> WhatsAppでオーナーが許可したあとで、新しいエージェントを接続します。

新しいエージェントを、名前を指定してこのアカウントに接続します。オーナーには、呼び出したエージェントとしてWhatsAppで確認が届き、呼び出しは返答を待ちます。`新規エージェント`コマンドと同じユースケースを実行するため、名前のルール、8エージェントまでの上限、インストールリンクは同じです。[AIにzapbipを任せる](https://docs.zapbip.com/ja/features/let-your-ai-manage-zapbip.md)をご覧ください。

## 入力

| フィールド | 型 | 備考 |
| - | - | - |
| `name` | string | コマンドと同じく簡略化されます。小文字、アクセントなし、空白はハイフン、最大20文字。 |

## 質問

3つのボタン、**Allow**、**Allow, send to agent**、**Deny**が、質問の末尾の短い参照とともに表示されます。呼び出しは最長50秒待ちます。ボタンでの返信だけが有効で、入力したテキストはDenyとして扱われます。Denyと無反応では何も変わらず、待機後の返信でも何も変わりません。その場合、同じリクエストは10分間拒否されます(`cooling_down`)。

## 出力

`{ "status": "applied" | "denied" | "timed_out" | "refused", "agent": string | null, "reason": string | null, "install_prompt": string | null }`。

* `applied`: エージェントが接続されました。**Allow**の場合、インストールリンクはWhatsAppでオーナーに届き、`install_prompt`は`null`です。**Allow, send to agent**の場合、`install_prompt`には新しいエージェントに貼り付ける2行が入ります。リンクやキーがツールの結果に届くのは、この方法だけです。
* `denied`と`timed_out`: 何も変わりません。
* `refused`: `reason`は`invalid_name`、`reserved_name`、`name_taken`、`limit_reached`、`cooling_down`、`window_closed`、`send_failed`、`suspended`、`waitlisted`のいずれかです。無効な名前や予約済みの名前は、オーナーに確認する前に拒否されます。リンクを送れなかった場合は、新しい接続が再び無効化されます。

操作を行う呼び出し(`connect_agent`、[revoke\_agent](https://docs.zapbip.com/ja/mcp-reference/revoke-agent.md)、[sign\_in\_link](https://docs.zapbip.com/ja/mcp-reference/sign-in-link.md))は、1接続につき1分間に最大3回です。次の呼び出しは、`rate_limited`で始まるエラーになります。


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