# skill-whatsapp

Skill de [Claude Code](https://claude.com/claude-code) para consultar y enviar
mensajes de WhatsApp del beneficio Rio Frio (número **+504 9742-9865**, nombre
"Nucleo🌐🧠🤖") vía el servicio `whatsapp-bridge` desplegado en nucleo001
(`https://whatsapp.nucleoriofrio.com`).

> Mirror público del directorio local `~/.claude/skills/whatsapp/` en la PC
> del usuario humano. Existe para que el usuario pueda **auditar** lo que el
> bot lee y envía. Clonar y correr en otra máquina **no funciona
> out-of-the-box** — requiere bearer token del bridge en `.env` (no incluido)
> y acceso al endpoint público.

## Doc principal

Ver **[SKILL.md](SKILL.md)** — flujos típicos, endpoints disponibles
(read + write), reglas de comportamiento.

Cheat sheet en **[endpoints.md](endpoints.md)** y mapping de JIDs conocidos
en **[contacts.md](contacts.md)**.

## Estructura

```
.
├── SKILL.md             ← docs canónicas
├── endpoints.md         ← cheat sheet API del bridge
├── contacts.md          ← mapping JID → contacto/grupo conocido
├── .env.example
├── .gitignore
├── README.md            ← este archivo
└── scripts/
    └── query.sh         ← helper REST autenticado (Bearer token)
```

## Lo que NO está en este repo

- `.env` (token del bridge)

## Backend

El servicio `whatsapp-bridge` (Baileys) corre como stack en nucleo001 — código
fuente y deploy: [NucleOS/whatsapp-bridge](https://gitea.nucleoriofrio.com/NucleOS/whatsapp-bridge)
(repo del backend, no de esta skill).

## Dependencias

- `curl`
- `python` (parsear JSON)
- Token válido en `.env` (`WA_BRIDGE_TOKEN`)