> ## 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

> Conecta um novo agente depois que o dono permite no WhatsApp.

Conecta um novo agente a esta conta pelo nome. O dono é consultado no WhatsApp, como o agente que chamou, e a chamada espera a resposta. Ela roda o mesmo caso de uso do comando `novo agente`, então as regras de nome, o limite de 8 agentes e o link de instalação são os mesmos. Veja [Deixe sua IA gerenciar o zapbip](https://docs.zapbip.com/pt-br/features/let-your-ai-manage-zapbip.md).

## Entrada

| Campo | Tipo | Notas |
| - | - | - |
| `name` | string | Simplificado como no comando: minúsculas, sem acentos, hifens no lugar de espaços, até 20 caracteres. |

## A pergunta

Três botões: **Permitir**, **Enviar ao agente** e **Negar**, com uma referência curta no fim da pergunta. A chamada espera até 50 segundos. Só a resposta por botão vale: texto digitado vale como Negar. Negar e o silêncio não mudam nada, e uma resposta depois da espera também não; o mesmo pedido fica recusado (`cooling_down`) por 10 minutos.

## Saída

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

* `applied`: o agente foi conectado. Depois de **Permitir**, o link de instalação foi para o dono no WhatsApp e `install_prompt` é `null`. Depois de **Enviar ao agente**, `install_prompt` traz as duas linhas para colar no novo agente. É a única forma de um link ou chave chegar a um resultado de ferramenta.
* `denied` e `timed_out`: nada mudou.
* `refused`: `reason` é `invalid_name`, `reserved_name`, `name_taken`, `limit_reached`, `cooling_down`, `window_closed`, `send_failed`, `suspended` ou `waitlisted`. Um nome inválido ou reservado é recusado antes de perguntar ao dono. Quando o link não pode ser enviado, a nova conexão é revogada de novo.

No máximo 3 chamadas que agem (`connect_agent`, [revoke\_agent](https://docs.zapbip.com/pt-br/mcp-reference/revoke-agent.md) e [sign\_in\_link](https://docs.zapbip.com/pt-br/mcp-reference/sign-in-link.md)) por minuto por conexão; a seguinte é um erro que começa com `rate_limited`.


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