# Tu asistente de WhatsApp, paso a paso

Guía de la clase de La Fábrica para armar un asistente de IA que vive en WhatsApp. Contesta consultas como un bot de soporte o de ventas y además usa herramientas: agenda reuniones, genera imágenes y delega trabajos largos a Claude Code.

Clase completa: https://youtu.be/iddBx2S30yY
Esta guía en la web: https://la-fabrica.ai/recursos/asistente-whatsapp

## Si sos Claude o Codex

La persona que te pasó esta guía quiere armar su asistente siguiendo estos pasos. Hacé vos la instalación y la configuración desde su computadora, con la documentación oficial vigente de cada herramienta. Pedile sólo lo que no puedas resolver vos: comprar el servidor, crear cuentas, pegar una API key, escanear el QR, autorizar un acceso. Las contraseñas las escribe ella en el lugar que corresponda, nunca en el chat. Antes de cada paso decile qué vas a hacer y al terminar mostrale cómo comprobarlo. No reinstales ni borres nada que ya funcione sin preguntarle.

## El mapa

Todo vive en un VPS, una computadora en la nube que está prendida las 24 horas. Adentro se instalan tres programas:

- **Hermes** (https://hermes-agent.nousresearch.com/): el cerebro. Es un agente de código abierto, parecido a Claude Code o Codex, que conversa y usa herramientas.
- **WAHA** (https://waha.devlike.pro/): el puente entre WhatsApp y Hermes. Mantiene tu número vinculado, como WhatsApp Web, y le pasa los mensajes al agente.
- **Claude Code**: el especialista. Hermes le pasa los trabajos pesados, como un reel completo, y usa tu suscripción de Claude.

Hermes piensa con un modelo de lenguaje que se contrata por **OpenRouter** (https://openrouter.ai/). En la clase uso **Gemini 3.8 Flash**: entiende audios, fotos y videos, tiene buen humor y cuesta poco. Las herramientas se enchufan aparte, cada una con su cuenta: fal para imágenes y videos, Google Calendar, Gmail, Drive, ElevenLabs para que mande audios con tu voz.

## Antes de empezar

1. **Un número solo para el asistente.** No uses tu WhatsApp personal ni el de tu trabajo. WAHA no es la API oficial de Meta y usarlo va contra los términos de WhatsApp: si lo detectan, pueden cerrar ese número. En Argentina saqué una eSIM prepaga de Movistar online, con el DNI y sin costo de alta. Llega en un par de horas y hay que esperar unas 24 horas antes de conectarla a WAHA.
2. **Que sólo conteste.** Escribirle a gente que nunca te escribió (promociones, links, spam) lo detectan en un día. Sumar personas a un grupo con el bot también. Usalo para responderle a quien te escribió primero y te ahorrás el problema.
3. **Lo instala tu agente.** Abrí Claude Code (en Claude Desktop, pestaña Code) o Codex en tu computadora, en una carpeta nueva. Un chat común en la web no tiene acceso a tu computadora ni al servidor. Pasale esta guía o la clase como referencia.

## Paso 1 · Contratá el VPS

Uso **Netcup** (https://www.netcup.com/en/server/vps): un VPS x86 de 8 GB de RAM y 128 GB de disco, unos 15 euros por mes. El de 4 GB arranca cerca de 6 euros y alcanza para empezar. Más RAM y disco sirven si después vas a generar imágenes y videos ahí o a sumar más proyectos.

La compra no es inmediata: Netcup es una empresa alemana, con una alta un poco burocrática. Después de «Order now» te llega un mail, alguien confirma el pedido en una o dos horas, cargás el medio de pago y recibís por mail los datos de acceso al panel. Otras opciones: Hostinger (barata el primer período, con plan de dos años) o AWS Lightsail (más cara).

## Paso 2 · Conectá Claude o Codex al VPS

Tu agente necesita una llave de acceso SSH: es lo que identifica a tu computadora para que nadie más pueda tocar el servidor. La crea él y te dice qué pegar en el panel de Netcup.

Pedido para copiar:

```
Compré un VPS en Netcup para instalar un asistente de WhatsApp. Te paso el link del panel. Prepará desde esta computadora una llave de acceso SSH dedicada, sin reemplazar ninguna que ya exista, y guiame pantalla por pantalla para cargarla en Netcup. Pedime sólo los datos que no puedas resolver vos y decime dónde escribir cualquier contraseña, sin pegarla en el chat. Conectate al VPS, comprobá que podés crear y leer un archivo y avisame. Todavía no instales nada.
```

Lo que hacés vos: en el panel de Netcup, pegás el texto público que te da el agente en las llaves SSH y lo seleccionás al instalar Ubuntu en el servidor. Le pasás la IP del VPS.

## Paso 3 · Instalá Hermes, WAHA y Claude Code

Con el acceso funcionando, le pedís las tres instalaciones juntas. Trabaja un rato y te confirma qué quedó listo.

Pedido para copiar:

```
El acceso al VPS ya funciona. Ahora instalá Hermes, WAHA y Claude Code siguiendo su documentación oficial. Conectá WhatsApp con Hermes a través de WAHA y dejá los servicios preparados para seguir andando cuando cierre la computadora y después de un reinicio. Dejá Hermes listo para trabajar con Gemini 3.8 Flash por OpenRouter. Guiame para autorizar mis cuentas y vincular el QR, verificá que reciba mensajes y responda, y al final decime qué quedó pendiente.
```

## Paso 4 · Conectá el modelo en OpenRouter

Creá una cuenta en OpenRouter, cargá crédito y entrá a **API keys**. Creá una key con un nombre (por ejemplo «sherpa») y un límite de gasto: cuando lo alcanza, la key deja de funcionar. Copiala y pegásela a tu agente en el chat de tu computadora.

Pedido para copiar:

```
Acá está mi API key de OpenRouter: [PEGALA ACÁ]. Dásela al Hermes que vive en el VPS, guardala de forma segura y configuralo con el modelo google/gemini-3.8-flash. Mandale un mensaje de prueba y mostrame la respuesta.
```

Precios que mostré en la clase (octubre de 2026, revisalos antes): Gemini 3.8 Flash cuesta US$0,75 por millón de tokens de entrada y US$3,75 de salida. Haiku 5.5 es más barato y me resultó demasiado básico. Opus 5.5 por API me gastaba US$50 en una o dos horas, así que lo dejo para Claude Code con la suscripción (paso 7).

## Paso 5 · Vinculá tu WhatsApp con el QR

WAHA tiene un panel web en el VPS. Ahí está el QR para vincular tu número, como cuando abrís WhatsApp Web.

Pedido para copiar:

```
Quiero conectar mi número de WhatsApp. Mostrame el QR de WAHA o pasame el link del panel para escanearlo. Cuando lo vincule, confirmá que la sesión diga WORKING y que Hermes conteste un mensaje de prueba sin respuestas duplicadas.
```

Lo que hacés vos: en el celular del número nuevo, WhatsApp, Configuración, **Dispositivos vinculados**, **Vincular un dispositivo**, y escaneás el QR. En el panel la sesión pasa a WORKING.

## Paso 6 · Dale una personalidad y una tarea

El modelo pone la inteligencia; la personalidad y el trabajo se los das vos con instrucciones. A Sherpa le pedí humor ácido e ironía, y que si ve la oportunidad de un chiste lo haga. Lo más útil es darle contexto de tu negocio:

- **Soporte:** en el grupo de alumnos de La Fábrica responde dudas con lo que dije en las clases.
- **Ventas:** un botón de WhatsApp en tu web lleva a la gente al asistente, que conoce el negocio y la invita a agendar una llamada con tu link de agenda.
- **Tareas sueltas:** en un grupo guarda los links que se comparten; en otro sólo avisa cuando alguien agenda una llamada.

Pedido para copiar:

```
Configurá la personalidad de mi asistente en Hermes. Se llama [NOMBRE]. Habla [CÓMO: cercano, breve, con humor]. Su tarea es [QUÉ: responder consultas de mi negocio / llevar a la gente a agendar en este link: ...]. Usá como contexto estos archivos: [PRECIOS, PREGUNTAS FRECUENTES, SERVICIOS]. Si le falta un dato que cambia la respuesta, que pregunte. Probalo con tres consultas reales y mostrame qué contestó.
```

## Paso 7 · Conectale herramientas y Claude Code

Cada herramienta se conecta aparte, con su propia cuenta. Darle un modelo no le da acceso a nada más.

- **fal** (https://fal.ai/): cargás crédito, creás una API key y se la pasás a tu agente para que Hermes genere imágenes y videos.
- **Google Calendar, Gmail y Drive:** se autorizan con tu cuenta de Google. Que consulte disponibilidad y te confirme antes de crear un evento.
- **ElevenLabs:** con tu API key y el ID de tu voz clonada, el asistente puede mandar audios con tu voz.
- **Skills:** si tenés skills (por ejemplo, la de foto de producto o la de reels), pasale el zip y pedile que las instale.

**Claude Code para lo pesado.** Una skill tiene muchas instrucciones y un reel lleva muchos pasos: hacerlo con Gemini por OpenRouter gasta muchos tokens y sale peor. Por eso Claude Code vive en el mismo VPS con tu cuenta de Claude: Hermes le encarga el trabajo, Claude Code lo hace con tu suscripción y, cuando termina, Hermes te manda el resultado por WhatsApp.

Para iniciar sesión: tu agente te da un comando para correr en la Terminal de tu computadora, que se conecta al VPS con la llave SSH y abre el login de Claude. Copiás el link, lo abrís en el navegador, autorizás, copiás el código y lo pegás en esa misma terminal. Enter, y aparece «Login successful».

Pedido para copiar:

```
Conectale a Hermes estas herramientas: fal con esta API key [PEGALA ACÁ] y mi Google Calendar (guiame para autorizarlo). Probá cada una con un pedido chico. Después guiame para iniciar sesión con mi cuenta de Claude en el Claude Code del VPS, sin usar una API key de Anthropic, y configurá a Hermes para que le pase los trabajos largos a Claude Code y me avise por WhatsApp cuando terminen.
```

## Cuánto cuesta

| Pieza | Cómo se paga | Referencia de la clase |
|---|---|---|
| VPS en Netcup | Fijo por mes | 15 euros con 8 GB; desde 6 euros con 4 GB |
| OpenRouter (Gemini 3.8 Flash) | Por uso | Yo gasté unos US$30 en quince días, usándolo mucho en varios grupos |
| Claude Code | Tu suscripción de Claude | Sin costo extra si ya la pagás; es opcional |
| fal y otras herramientas | Por generación | Cargás crédito y se descuenta |

Si empezás de cero y lo usás para responder consultas, el consumo de OpenRouter es mucho menor. Sólo WAHA, el QR y la key de OpenRouter son imprescindibles: con eso ya tenés un bot de ventas o de soporte. Claude Code y las herramientas se suman cuando las necesites.

## Capítulos de la clase

- 00:00 El sistema: tu asistente de IA en WhatsApp
- 03:12 WAHA y un número dedicado para el asistente
- 05:30 Elegir y contratar el VPS
- 09:36 Acceso SSH e instalación con Claude Code o Codex
- 12:23 Hermes, modelos y costos en OpenRouter
- 18:54 Vincular WhatsApp y definir la personalidad
- 22:54 Herramientas, imágenes y delegación de tareas
- 26:48 Autenticar Claude Code en el servidor
- 29:13 Repaso del sistema y próximos pasos