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

> Connect Codex to your WhatsApp.

## What works

| You want to | Codex |
| - | - |
| Get messages from it | Text, photos, videos, audio, documents, locations, contacts, reactions |
| Answer it with a tap | Buttons and lists; it waits for your tap |
| Write first from WhatsApp | Yes, it answers in about 6 seconds, even when the session is idle |
| Keep a question open for hours | Yes, there is no time limit |

WhatsApp: zapbip

## How it listens

Wake type: **Local**. A connector on your computer resumes your Codex session with `codex exec resume` each time you write, in about 6 seconds. If Codex already has the session open in its app, the resume waits until the session is free.

* Keep the connector running. To keep it alive after you close the terminal, follow [Run the connector as a service](https://docs.zapbip.com/developers/background-running.md).

When your AI asks you something, zapbip holds the question and answers "pending" at most every 50 seconds. Codex then calls again, and keeps calling again until you answer. There is no time limit.

The 900 second tool timeout that the install sets in Codex bounds one call, not the listening. When a call ends, Codex starts the next one.

Codex waits up to 15 minutes for a single answer and asks again, so there is no limit overall.

## Set up from zero

1. **Message the zapbip number on WhatsApp.** Send any text, for example `hi`.

   [Open WhatsApp](https://mcp.zapbip.com/start?lang=en) to message zapbip.

2. **Ask for a new agent.** An agent is one AI you connect.

   WhatsApp: zapbip

3. **Paste the line into Codex.**

   `Connect yourself to my WhatsApp with zapbip: read https://mcp.zapbip.com/i/zb_inst_<code> and follow the instructions.`

   Codex reads the instructions and follows them in order. Before it changes a file or a setting, it tells you which one and waits for your yes. The link is secret, so keep it out of chats you share.

4. **Say yes.** Codex then does the rest, in this order.

5. **Add zapbip to Codex.** After your yes, it replaces the `[mcp_servers.zapbip]` table in `~/.codex/config.toml` with `url = "<connectionLink>"`, `tool_timeout_sec = 900` and `default_tools_approval_mode = "approve"`. Approval mode lets zapbip tools run without asking you each time, and Codex tells you so.

6. **Start the connector.** It runs `ZAPBIP_CONNECTION_URL=<connectionLink> npx zapbip@0.1.0 connect --client codex` in the background. It keeps listening and resumes your session with `codex exec resume`.

7. **Test it.** In a fresh process it runs `codex exec -c 'mcp_servers.zapbip.default_tools_approval_mode="approve"' "Call send_message with the text '✅ installed'"`. A `send_message` with ✅ installed reaches your WhatsApp. If the command fails, it stops and shows the last 20 lines. Then restart Codex.

## Check it works

Ask Codex to send `✅ installed` to your WhatsApp. It should arrive in a few seconds.

WhatsApp: zapbip

If nothing arrives, see [Troubleshooting](https://docs.zapbip.com/help/troubleshooting.md).


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