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

# Claude Code

> Conecta Claude Code a tu WhatsApp.

## Qué funciona

| Quieres | Claude Code |
| - | - |
| Recibir mensajes suyos | Texto, fotos, vídeos, audio, documentos, ubicaciones, contactos, reacciones |
| Responderle con un botón | Botones y listas; espera tu respuesta |
| Escribir primero desde WhatsApp | Sí, responde en unos 7 segundos, incluso con la sesión inactiva |
| Dejar una pregunta abierta durante horas | Sí, no hay límite de tiempo |

WhatsApp: zapbip

## Cómo escucha

Tipo de activación: **Local**. Un conector en tu computadora despierta a Claude Code, así que responde unos 7 segundos después de que escribes.

* Inicia Claude Code con `claude --dangerously-load-development-channels server:zapbip-channel`. El canal de zapbip empuja entonces cada mensaje de WhatsApp a la sesión abierta en cuanto llega.
* Si la sesión está cerrada, el conector la reanuda en unos 7 segundos. Estar inactivo no gasta tokens; cada mensaje cuesta un turno.
* Mantén el listener en marcha. Para que siga vivo después de cerrar la terminal, sigue [Ejecuta el conector como servicio](https://docs.zapbip.com/es/developers/background-running.md).

Cuando tu IA te pregunta algo, zapbip guarda la pregunta y responde "pendiente" como máximo cada 50 segundos. Tu IA vuelve entonces a llamar, y sigue llamando otra vez hasta que respondas, sin límite de tiempo.

Usa un solo listener, nunca dos a la vez. Si el canal no está activo, Claude Code mantiene en marcha `npx zapbip@0.1.0 listen` y lo vigila con Monitor. Una vigilancia dura como máximo 30 minutos, así que Claude Code la rearma con cada aviso de tiempo agotado.

## Configúralo desde cero

1. **Escribe al número de zapbip en WhatsApp.** Envía cualquier texto, por ejemplo `hi`.

   [Abrir WhatsApp](https://mcp.zapbip.com/start?lang=es) para escribir a zapbip.

2. **Pide un agente nuevo.** Un agente es una IA que conectas.

   WhatsApp: zapbip

   Los comandos y las respuestas de zapbip están en español; también entiende los mismos comandos en inglés.

3. **Pega la línea en Claude Code.**

   `Conéctate a mi WhatsApp con zapbip: lee https://mcp.zapbip.com/i/zb_inst_<code> y sigue las instrucciones.`

   Claude Code lee las instrucciones y las sigue en orden. Antes de cambiar un archivo o un ajuste, te dice cuál y espera tu sí. El enlace es secreto, así que no lo dejes en chats que compartes.

4. **Di que sí.** Claude Code hace entonces el resto, en este orden.

5. **Añade zapbip a Claude Code.** Si existe una entrada antigua `zapbip` o `zapbip-channel`, Claude Code la elimina con `claude mcp remove --scope user zapbip` o `claude mcp remove --scope user zapbip-channel`. Luego ejecuta `claude mcp add --transport http --scope user zapbip <connectionLink>` para las herramientas, y `claude mcp add --scope user zapbip-channel -e ZAPBIP_CONNECTION_URL=<connectionLink> -- npx zapbip@0.1.0 channel` para el canal en vivo.

   Los comandos de estos pasos llevan tu enlace de conexión, así que queda en el historial de tu shell. Para evitarlo, pon `ZAPBIP_CONNECTION_URL` en un archivo de entorno como en [Ejecuta el conector como servicio](https://docs.zapbip.com/es/developers/background-running.md).

6. **Guarda la skill de zapbip.** Tras tu sí, escribe `~/.claude/skills/zapbip/SKILL.md`, para que cada sesión sepa usar WhatsApp, incluido cuándo llamar a `check_inbox`.

7. **Elige un solo listener.** Una conexión tiene un solo listener y un segundo reemplaza al primero, así que usa exactamente uno de estos, nunca dos a la vez. Para una sesión detenida ejecuta `ZAPBIP_CONNECTION_URL=<connectionLink> npx zapbip@0.1.0 connect --client claude-code` en segundo plano. El conector despierta tu sesión cuando escribes mientras Claude Code está inactivo, y reanuda una cerrada con `claude -p --resume`.

8. **Solo si los canales no están disponibles.** Ejecuta `ZAPBIP_CONNECTION_URL=<connectionLink> npx zapbip@0.1.0 listen` en segundo plano y lo vigila con Monitor, rearmándolo con cada aviso de tiempo agotado.

9. **Pruébalo.** En un proceso nuevo ejecuta `claude -p "Call send_message with the text '✅ listo'" --allowedTools=mcp__zapbip__send_message`. Un `send_message` con ✅ listo llega a tu WhatsApp. Si el comando falla, se detiene y muestra las últimas 20 líneas. Después reinicia Claude Code para usar las herramientas de zapbip.

## Comprueba que funciona

Pide a Claude Code que envíe `✅ listo` a tu WhatsApp. Debería llegar en unos segundos.

WhatsApp: zapbip

Si no llega nada, mira [Solución de problemas](https://docs.zapbip.com/es/help/troubleshooting.md).


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