Cómo Desplegar Hermes Agent En WhatsApp

WhatsApp es la app de mensajería que dos mil millones de personas abren cada día, así que parece el lugar obvio para poner tu agente de IA. Luego empiezas la configuración y descubres que es el canal más difícil para desplegar un agente personal - y Meta dedicó 2026 a hacerlo aún más difícil.

Esta guía recorre lo que realmente hace falta para que Hermes Agent hable por WhatsApp: las credenciales y el webhook que necesitas, los costes y límites que sorprenden a la gente, y la respuesta honesta a si deberías hacerlo siquiera.

Antes De Empezar: WhatsApp No Es Telegram

Si has leído Cómo Desplegar Hermes Agent En Telegram, olvida el plazo de cinco minutos. WhatsApp te da dos formas de entrar, y ambas tienen truco:

La WhatsApp Business Cloud API oficial (gestionada por Meta). Es la vía soportada y duradera. Requiere una cuenta de Meta Business, verificación del negocio, un número de teléfono dedicado, un webhook público y facturación por mensaje.
Bibliotecas no oficiales (WAHA, Baileys y similares) que automatizan WhatsApp Web. Gratis y rápidas, pero violan los términos de WhatsApp y conllevan un riesgo real de baneo permanente del número - más sobre esto abajo.

Para un despliegue en el que puedas confiar, quieres la Cloud API oficial. Toda la sección de configuración asume esa vía.

Lo Que Necesitas Para Desplegar Hermes En WhatsApp

Un despliegue funcional tiene cuatro credenciales y una pieza de infraestructura. Reúnelas todas antes de tocar la configuración de Hermes.

1. Una cuenta de Meta Business y una app de Cloud API

Inicia sesión en Meta for Developers, crea una app de tipo Business y añádele el producto WhatsApp. Meta te da un número de prueba en un sandbox de inmediato para que experimentes antes de verificar un negocio real.

2. Un phone number ID y un WhatsApp Business Account ID

Dentro de la configuración de WhatsApp de la app, registra el número de teléfono de negocio por el que fluirán los mensajes. Meta te muestra entonces dos valores que debes guardar: el Phone Number ID y el WhatsApp Business Account (WABA) ID. Identifican por qué número y qué cuenta envía Hermes - no son el número de teléfono en sí.

3. Un token de acceso permanente

El token temporal que Meta muestra en la pantalla de configuración caduca en 24 horas, lo cual sirve para una primera prueba y es inútil para un despliegue. Para algo real, crea un System User en Business Settings, asígnale tu app y tu cuenta de WhatsApp con control total, y genera un token permanente. Esta es la credencial que Hermes usa para autenticar cada envío.

4. Un endpoint de webhook público

Esta es la parte que Telegram no necesita. WhatsApp envía los mensajes entrantes a una URL que tú alojas, así que Hermes necesita un endpoint HTTPS público con un certificado válido. Registras la URL más un verify token de tu elección en Meta Business Manager, y Meta hace un saludo único llamando a tu endpoint con un valor hub.challenge que debes devolver. Una vez verificado, cada mensaje entrante llega como un webhook que tu gateway debe responder con un HTTP 200 en menos de 30 segundos.

Conectar WhatsApp Con Hermes

Con las cuatro piezas en la mano, el lado de Hermes resulta familiar si ya has configurado el gateway de Telegram. En config.yaml, añade tu proveedor y las credenciales de WhatsApp:

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here

whatsapp_phone_number_id: "123456789012345"
whatsapp_business_account_id: "987654321098765"
whatsapp_access_token: EAAG...your-permanent-token
whatsapp_verify_token: a-long-random-string-you-choose
whatsapp_allowed_users: "15551234567"

Dos campos merecen atención. El whatsapp_verify_token debe coincidir exactamente con el valor que escribiste en Meta Business Manager al registrar el webhook, de lo contrario el saludo falla en silencio. El campo whatsapp_allowed_users es tu cerradura de seguridad: Hermes solo responde a los números listados aquí (en formato internacional completo, sin +), de modo que un desconocido que escriba a tu número de negocio no pueda consumir tus créditos de modelo.

Arrancar El Gateway

Levanta el gateway de mensajería igual que harías para cualquier canal:

hermes gateway start --detach

El gateway expone la ruta del webhook, valida la firma de Meta en cada petición, encamina el cuerpo del mensaje hacia el runtime de Hermes y publica la respuesta del agente de vuelta por la Cloud API. Confirma que está vivo con hermes gateway status y envía un mensaje de prueba desde un número autorizado.

Los Costes Y Límites Que Nadie Menciona

Aquí es donde WhatsApp diverge claramente de una plataforma de bots gratuita, y donde muchos despliegues se deshacen en silencio.

WhatsApp pasó a precios por mensaje a mediados de 2025. Cada mensaje que tu agente inicia se factura por categoría y país del destinatario, aproximadamente de 0,004 a 0,046 dólares para mensajes de utilidad y hasta unos 0,14 dólares para mensajes de marketing en países de coste más alto. La propia API oficial se sitúa en una franja de 0-99 dólares al mes antes de esas tarifas por mensaje, y la mayoría de los equipos añaden un margen de un Business Solution Provider por encima.

Peor para un agente en concreto es la ventana de servicio al cliente de 24 horas. Después de que un usuario te escriba, puedes responder libremente durante 24 horas. Una vez que esa ventana se cierra no puedes enviar un mensaje de formato libre - solo una plantilla preaprobada, y cada envío de plantilla se factura. Un agente personal es proactivo por naturaleza: te avisa con un resumen matutino, te dice que una tarea larga terminó, te recuerda una factura tres días después. Cada una de esas cae fuera de la ventana, así que en WhatsApp se convierte en un envío de plantilla de pago. Lo desglosamos por completo en Telegram vs WhatsApp Para Un Agente De IA.

El Atajo No Oficial (Y Por Qué Sale Mal)

Busca "bot de WhatsApp gratis" y encontrarás WAHA, Baileys y una docena de envoltorios sobre WhatsApp Web. Son genuinamente rápidos de montar y no cuestan nada en tarifas de mensajes. También son una trampa para cualquier despliegue que te importe.

Estas bibliotecas están hechas por ingeniería inversa y violan los términos de servicio de WhatsApp. Meta ejecuta un sistema de detección de varias capas - huella digital de registro, análisis de comportamiento, denuncias de usuarios, patrones de contenido - y endureció la aplicación contra los chatbots de IA de terceros durante principios de 2026. El resultado realista de ejecutar un gateway no oficial autoalojado a cualquier volumen es un baneo permanente del número que usaste. Para una prueba desechable en una SIM de sobra, vale. Para el número por el que tus contactos te localizan de verdad, no merece la pena.

Fallos Más Comunes

El webhook nunca se verifica. El verify token en config.yaml no coincide con el de Meta Business Manager, o tu endpoint no es accesible por HTTPS con un certificado válido. Meta necesita devolver hub.challenge con éxito antes de enviar un solo mensaje.

Los mensajes llegan pero Hermes nunca responde. O el gateway no está corriendo (hermes gateway status) o el remitente no está en whatsapp_allowed_users. Comprueba que el número esté en formato internacional completo y sin +.

El token funciona un día y luego todo se detiene. Desplegaste con el token temporal de 24 horas en vez del token permanente de System User. Vuelve a generar el permanente y actualiza tu configuración.

Los mensajes proactivos fallan en silencio. Estás intentando enviar fuera de la ventana de 24 horas sin una plantilla aprobada. Esto es una regla de la plataforma, no un bug - es la razón central por la que los agentes sufren en WhatsApp. La mentalidad de diagnóstico de la guía de resolución de problemas de Telegram se traslada a cualquier gateway que ejecutes.

Mantenerlo En Marcha

Incluso después de que el bot responda, asumes una responsabilidad continua que no existe en canales más simples: un endpoint HTTPS público que debe seguir activo y con certificado válido, un token permanente que no debe filtrarse, aprobaciones de plantillas que gestionar y una factura por mensaje que vigilar. El gateway funciona mientras el proceso y el endpoint estén sanos, y se queda mudo en cuanto cae cualquiera de los dos. En un portátil o un contenedor reciclado, eso pasa más a menudo de lo que te gustaría.

Telegram Es El Mejor Hogar Para Un Agente Personal

Si te alejas de la mecánica de configuración, el veredicto es difícil de rebatir: para un agente de IA personal, Telegram gana en todos los ejes que importan.

Abierto y gratis. La Bot API de Telegram es pública, está documentada y no cuesta nada por mensaje. La Cloud API de WhatsApp está cerrada tras la verificación de Meta Business y te cobra por conversación.
Proactivo por defecto. Tu agente puede escribirte en cuanto termina una tarea, cada mañana, o tres días después por una factura - sin ventana de 24 horas, sin plantillas pre-aprobadas, sin tarifa por mensaje.
En marcha en minutos, no semanas. Sin verificación de empresa, sin número dedicado, sin un webhook público con certificado válido que mantener vivo.
Sin riesgo de baneo. Estás sobre una API soportada y de primera clase - no sobre una librería de ingeniería inversa a un barrido de detección de perder tu número.

WhatsApp puede hacerse funcionar si de verdad necesitas ese canal en concreto y aceptas el coste y la carga operativa. Para el resto, Telegram es sencillamente la opción más sensata por defecto.

Sáltate La Configuración: Ejecuta Tu Agente En Telegram Con Hermify

Hermify es un host gestionado de Hermes Agent, e integra de forma nativa con Telegram - el canal hecho justo para este tipo de agente personal siempre activo. Aportas una clave de modelo, el runtime se aprovisiona en infraestructura gestionada y le escribes a tu agente como a cualquier otro contacto. Sin servidor que cuidar, sin webhook que mantener vivo, sin factura por mensaje.

Eso te da un agente persistente que te recuerda, ejecuta skills programadas y vive en tu bolsillo - funcionando en cuanto terminas el registro, no tras una cola de verificación de Meta.

Empieza con Hermify y tu agente estará en marcha en Telegram en minutos.