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

# set_wake

> Diz ao zapbip como alcançar este agente quando ele não está ouvindo.

Salva como esta conexão é acordada quando você escreve e nenhuma chamada está esperando. Veja a [escada de despertar](https://docs.zapbip.com/pt-br/concepts/wake-ladder.md) e o [guia de despertar por webhook](https://docs.zapbip.com/pt-br/developers/webhook-wake.md).

## Entrada

| Campo | Tipo | Notas |
| - | - | - |
| `mode` | string | `local` acorda pelo [conector](https://docs.zapbip.com/pt-br/developers/local-connector.md); `webhook` salva um webhook; `scheduled` faz o agente olhar a caixa de entrada num intervalo; `standby` entrega suas mensagens a outro agente; `none` limpa o despertar. |
| `url` | string, opcional | Obrigatório para `webhook`. `https`, sem usuário e senha, sem fragmento, porta 443 ou ausente, até 512 caracteres. O host escolhe o provedor. |
| `token` | string, opcional | Obrigatório para `webhook`. Imprimível, sem espaços, de 16 a 512 caracteres. Em um webhook genérico é a chave de assinatura, com pelo menos 32 caracteres. |
| `interval_minutes` | inteiro, opcional | Obrigatório para `scheduled`. De 1 a 1440 minutos. O ChatGPT e o claude.ai rodam tarefas agendadas a cada 60 minutos no mínimo. |
| `standby_agent` | string, opcional | Obrigatório para `standby`. O nome de outra conexão da mesma conta que não esteja ela mesma em espera. |

Campos de outro modo devem estar ausentes.

## Agendada

Um agente que não pode ser iniciado de fora roda uma tarefa num intervalo que chama [check\_inbox](https://docs.zapbip.com/pt-br/mcp-reference/check-inbox.md). Assim ele ouve sem limite de tempo e responde cada mensagem com `send_message`.

```json theme={null}
{ "mode": "scheduled", "interval_minutes": 60 }
```

Quando você escreve, o zapbip diz quando esperar a resposta. Se nenhuma olhada acontece por o dobro do intervalo, você recebe um aviso e suas mensagens esperam na caixa de entrada até a próxima olhada.

## Local

Peça ao seu agente para chamar esta ferramenta com `{ "mode": "local" }` enquanto o [conector](https://docs.zapbip.com/pt-br/developers/local-connector.md) roda no seu computador.

## Em espera

Um agente que não pode ser despertado indica outro agente da mesma conta para responder no lugar dele. O zapbip copia sua mensagem para a conexão em espera e a desperta; ela responde como ela mesma.

```json theme={null}
{ "mode": "standby", "standby_agent": "grok-bot" }
```

Uma conexão em espera nunca repassa para outra em espera: é um salto só. Se a conexão em espera não existe, foi removida ou está ela mesma em espera, nada é copiado e sua mensagem espera com o primeiro agente.

## Provedores

O provedor é escolhido pelo host da URL, nunca por um campo.

| Provedor | Host | Caminho | Autenticação |
| - | - | - | - |
| `grok_routine` | `api2.cursor.sh` | `/automations/webhook/<routine-id>` | `Authorization: Bearer <token>` |
| `claude_routine` | `api.anthropic.com` | `/v1/claude_code/routines/<trigger-id>/fire` | `Authorization: Bearer <token>` |
| `generic` | qualquer host `https` público | qualquer | `X-Zapbip-Timestamp` e `X-Zapbip-Signature`, nenhum segredo enviado |

## Saída

`{ "status": "saved", "wake_mode": string, "effective_rung": string, "provider": string | null }`. `provider` vem preenchido só para `webhook`. `effective_rung` é `inbox` quando a conexão em espera não pode ser usada, e para `local` enquanto nenhum conector está conectado, porque a mensagem então espera na caixa de entrada. A URL, o token e o host nunca são devolvidos.

## Erros

Um erro da ferramenta nomeia o campo inválido (`url`, `token`, `interval_minutes`, `standby_agent` ou `mode`) e o limite dele, e nunca repete o valor. Nada é salvo e o despertar anterior continua. O zapbip não chama o provedor ao salvar: um token errado aparece no primeiro despertar, como um aviso para você no WhatsApp.


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