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

# Codex

> Conecte o Codex ao seu WhatsApp.

## O que funciona

| Você quer | Codex |
| - | - |
| Receber mensagens dele | Texto, fotos, vídeos, áudios, documentos, localizações, contatos, reações |
| Responder com um toque | Botões e listas; ele espera o seu toque |
| Escrever primeiro pelo WhatsApp | Sim, ele responde em cerca de 6 segundos, mesmo com a sessão parada |
| Deixar uma pergunta aberta horas | Sim, não há limite de tempo |

WhatsApp: zapbip

## Como ela escuta

Tipo de despertar: **Local**. Um conector no seu computador retoma a sua sessão do Codex com `codex exec resume` toda vez que você escreve, em cerca de 6 segundos. Se o Codex já estiver com a sessão aberta no app, a retomada espera a sessão ficar livre.

* Mantenha o conector rodando. Para ele continuar vivo depois de fechar o terminal, siga [Rode o conector como serviço](https://docs.zapbip.com/pt-br/developers/background-running.md).

Quando a sua IA faz uma pergunta, o zapbip a guarda e responde "pendente" no máximo a cada 50 segundos. O Codex então chama de novo, e continua chamando de novo até você responder, sem limite de tempo.

O limite de 900 segundos por ferramenta, que a instalação define no Codex, vale para uma chamada, não para a escuta. Quando uma chamada termina, o Codex começa a próxima.

O Codex espera até 15 minutos por uma resposta e pergunta de novo, então não há limite no total.

## Configure do zero

1. **Mande uma mensagem para o número do zapbip no WhatsApp.** Pode ser qualquer texto, por exemplo `oi`.

   [Abrir o WhatsApp](https://mcp.zapbip.com/start?lang=pt-BR) para mandar uma mensagem ao zapbip.

2. **Peça um novo agente.** Agente é uma IA que você conecta.

   WhatsApp: zapbip

3. **Cole a linha no Codex.**

   `Conecte-se ao meu WhatsApp pelo zapbip: leia https://mcp.zapbip.com/i/zb_inst_<code> e siga as instruções.`

   O Codex lê as instruções e as segue em ordem. Antes de mudar um arquivo ou uma configuração, ele diz qual é e espera o seu sim. O link é secreto, então não o deixe em conversas que você compartilha.

4. **Diga sim.** O Codex faz o resto, nesta ordem.

5. **Adicionar o zapbip ao Codex.** Depois do seu sim, ele troca a tabela `[mcp_servers.zapbip]` em `~/.codex/config.toml` por `url = "<connectionLink>"`, `tool_timeout_sec = 900` e `default_tools_approval_mode = "approve"`. O modo de aprovação deixa as ferramentas do zapbip rodarem sem pedir a cada vez, e o Codex avisa você disso.

6. **Iniciar o conector.** Ele roda `ZAPBIP_CONNECTION_URL=<connectionLink> npx zapbip@0.1.0 connect --client codex` em segundo plano. Ele continua escutando e retoma a sua sessão com `codex exec resume`.

7. **Testar.** Em um processo novo ele roda `codex exec -c 'mcp_servers.zapbip.default_tools_approval_mode="approve"' "Call send_message with the text '✅ instalado'"`. Um `send_message` com ✅ instalado chega ao seu WhatsApp. Se o comando falhar, ele para e mostra as últimas 20 linhas. Depois reinicie o Codex.

## Confira se funciona

Peça ao Codex para enviar `✅ instalado` ao seu WhatsApp. Deve chegar em poucos segundos.

WhatsApp: zapbip

Se nada chegar, veja [Solução de problemas](https://docs.zapbip.com/pt-br/help/troubleshooting.md).


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