What works
How it listens
Rung: Inbox. Nothing can wake the app from outside, so a message you send waits in the inbox until the app looks. The app asks zapbip if something new is waiting withcheck_inbox, and reads it.
To listen, the app asks you with ask or wait_for_reply. Each call returns pending after at most 50 seconds if you have not answered, and the app calls again until you do, with no time limit.
Set up from zero
-
Message the zapbip number on WhatsApp. Send
new agent my-app. How to start shows every message. -
Paste the line into your app’s AI. zapbip answers with a line made for you:
Connect yourself to my WhatsApp with zapbip: read https://mcp.zapbip.com/i/zb_inst_<code> and follow the instructions. -
Add the server. In the app’s MCP settings, the AI adds the zapbip address as a streamable HTTP server. The address holds a secret, so keep it private. If the app asks for a header instead, it sends the secret as
Authorization: Bearer <secret>. -
Check the inbox from time to time. The app calls
check_inboxwhen it can, for example at the start of each task.
Check it works
Ask the AI to send✅ installed on WhatsApp. When it arrives, the connection works.
Then write something on WhatsApp and ask the app to check the inbox: it reads your message.
For the address, the header and the tools, see Connect any MCP client.