Hermes + WhatsApp oficial: monta un agente de IA en el WhatsApp de tu negocio

Un agente de IA en el WhatsApp de tu negocio

Meter un agente de inteligencia artificial en el WhatsApp de un negocio es de las cosas más potentes que puedes montar ahora mismo. Imagínatelo respondiendo a clientes a cualquier hora, cogiendo citas, resolviendo dudas y cualificando leads sin que nadie esté delante. El canal donde tus clientes ya están, atendido 24/7 por un asistente que no duerme.

El problema es que casi todos los tutoriales que ves por ahí lo hacen con métodos no oficiales (tipo Baileys): funcionan dos días y acaban con el número baneado. Y ese número es el de tu cliente, así que la has liado bien. Hoy lo hacemos como se hace de verdad: por la vía oficial, la WhatsApp Cloud API de Meta conectada a Hermes. La misma que puedes montarle a cualquier empresa y dejar en producción sin miedo a que se caiga al día siguiente o te baneen el teléfono.

Te lo enseño entero, de principio a fin: la parte de Meta, la configuración de Hermes y los errores típicos que bloquean a todo el mundo y que casi nadie cuenta. Vamos a ello.

Si aún no tienes Hermes montado, empieza por la guía definitiva de Hermes Agent (instalación en VPS, app de escritorio y modelos gratis) y por las novedades de la versión 0.17 (que es la que usamos aquí para crear perfiles). Si no sabes qué es Hermes: un agente de IA gratis y de código abierto de Nous Research que corre en tu propia infraestructura, con memoria persistente y capaz de mejorarse solo.

Vía oficial vs. vía “atajo”: por qué importa tanto

Hay dos formas de conectar WhatsApp a un agente:

• La vía atajo (Baileys y similares). Librerías no oficiales que se hacen pasar por la app móvil de WhatsApp. Funcionan… hasta que Meta detecta comportamiento de bot (por ejemplo, si lanzas una campaña y se inician muchas conversaciones de golpe). Cuando eso pasa, Meta marca el número como bot y te lo capa. Pierdes el teléfono del negocio. Inaceptable en producción.
• La vía oficial (WhatsApp Cloud API de Meta). La API alojada por Meta, diseñada exactamente para esto. Es estable, cumple las políticas y está pensada para dejarla en producción atendiendo a clientes reales. Es la que vamos a usar.

La WhatsApp Cloud API es gratuita como plataforma (no pagas por usar la API), pero las conversaciones se facturan según su tipo — lo veremos en detalle más abajo, porque en producción esto importa.

Cómo funciona la conexión (las 3 piezas)

El montaje tiene tres piezas encajadas:

1. Hermes = el cerebro. El agente que recibe el mensaje, lo procesa y responde. Es la conexión que ya tienes hecha.
2. La API oficial de WhatsApp. El canal por el que entran y salen los mensajes, gestionado desde Meta.
3. El webhook + un túnel HTTPS. Un webhook es la “puerta” por la que Meta entrega a Hermes cada mensaje entrante. Como Hermes vive en tu servidor, necesitas exponer esa puerta por HTTPS seguro, y para eso usamos un túnel de Cloudflare (cloudflared).

Y aquí está lo bonito del enfoque: Hermes hace casi todo el trabajo técnico por ti. Tú solo tocas a mano la parte de Meta (crear la app, copiar IDs y tokens, pegar el webhook y suscribir los mensajes). El resto — arrancar el gateway, levantar el túnel de Cloudflare, configurar el adaptador de WhatsApp — se lo pides a Hermes en lenguaje natural y lo ejecuta él.

Lo que necesitas antes de empezar

• Hermes instalado y funcionando (idealmente en un VPS, versión 0.17 o superior).
• Una cuenta de Meta con un portfolio de negocio (lo creamos durante el proceso si no lo tienes).
• Cloudflare para exponer el webhook en HTTPS de forma segura (lo maneja Hermes).
• Un número de teléfono para WhatsApp. Para empezar vale el número de pruebas que da Meta; para producción, un número propio (con una condición importante que veremos).

Paso a paso

1. Crear la aplicación en Meta

1. Entra en developers.facebook.com → Mis aplicaciones → Crear aplicación.
2. Ponle nombre (por ejemplo, Hermes Agent) y confirma el email.
3. En casos de uso, activa únicamente “Conecta con los clientes a través de WhatsApp”.
4. Elige un portfolio empresarial. Si no tienes uno, ve a business.facebook.com y créalo antes (rellena los datos de la empresa). Conectando solo WhatsApp no necesitas requisitos de publicación, así que te deja avanzar sin fricción.
5. Revisa el resumen y crea la aplicación (puede pedirte la contraseña como doble factor).

2. Crear un perfil de WhatsApp en Hermes

Conviene no conectar WhatsApp al perfil por defecto (el Hermes con el que hablas siempre), sino a un perfil dedicado. Con la versión 0.17 lo creas en dos clics:

1. Crea un nuevo perfil y llámalo whatsapp (en minúsculas; no admite mayúsculas).
2. Dile que clone la configuración, skills, etc. del default para partir de una base completa.

3. Pedirle a Hermes que haga el trabajo técnico

Vuelve a tu sesión default, abre una sesión nueva y pásale una instrucción como esta (ajusta el nombre del perfil si lo llamaste distinto):

Quiero conectar WhatsApp Business Cloud API (oficial) al perfil "whatsapp"
de Hermes. Yo haré la parte de Meta, pero encárgate tú de todo el trabajo
técnico: adapter, gateway, túnel HTTPS y configuración. Hazlo lo más simple
posible y ve pidiéndome dato por dato lo que necesites.

Hermes inspeccionará cómo está instalado, comprobará que existe el perfil whatsapp y su adaptador, revisará dependencias (incluido Cloudflare) y empezará a pedirte, uno a uno, los cuatro datos que necesita. Dónde sacar cada uno:

Dato 1 — phone_number_id (identificador del número de teléfono). En Meta: Casos de uso → Conecta WhatsApp → Personalizar → Configuración de la app. Ahí verás el identificador del número de teléfono. Cópialo y pásaselo a Hermes.

Dato 2 — Access token de Meta. Con el número seleccionado, genera un token de acceso sobre ese número (el generador de token de acceso). Cópialo y dáselo a Hermes.

Dato 3 — App secret. En Meta: Configuración → Información básica. Ahí está la clave secreta de la app: pulsa “Mostrar” y cópiala (⚠️ no le des a “Restablecer”). Pásasela a Hermes.

Dato 4 — Tu número permitido para pruebas. Hermes bloquea mensajes entrantes si no defines una lista de números permitidos. Antes, en Meta (Configuración de la API) añade tu número personal como destinatario de pruebas; luego pásaselo a Hermes en formato internacional, solo números (por ejemplo, 34 + tu móvil, sin +, espacios ni guiones).

Con esos cuatro datos, Hermes arranca el gateway del perfil whatsapp y levanta el túnel HTTPS de Cloudflare, y te devuelve la URL pública y un verify token para el webhook.

4. Configurar el webhook en Meta

1. En Meta, ve a Configuración (de la API) → editar webhook.
2. Pega la URL de callback que te ha dado Hermes y el verify token.
3. Pulsa Verificar y guardar.
4. Abajo, suscribe el campo messages (aparecerá el aviso en verde de suscripción correcta).

Si la verificación falla, casi siempre es porque falta el https:// en la URL. Añádelo a mano y vuelve a verificar. Es el error nº1 en este paso.

5. Primera prueba

Desde Meta, en Configuración de la API, envía el mensaje de plantilla de prueba a tu número. Ábrelo en tu WhatsApp, responde con un “Hola, Hermes” y verás cómo contesta el agente por la API oficial. Ya lo tienes hablando por WhatsApp.

De pruebas a producción: token permanente + número real

Lo anterior funciona, pero con un token temporal (caduca en ~24 horas) y un número de pruebas. Para producción hay que dar dos pasos más.

Requisito crítico del teléfono

El número que uses en producción no puede tener WhatsApp ni WhatsApp Business instalado. La API oficial exige un número “limpio”. Recomendación: usa un teléfono/SIM completamente nuevo que nunca haya tenido WhatsApp. Si ese número tuvo WhatsApp antes, tras borrarlo pueden pasar varias horas hasta que Meta te deje activarlo.

Token permanente con un System User

El token permanente se genera con un usuario del sistema (System User) en el Business Manager:

1. En business.facebook.com → Configuración, crea (o usa) un usuario del sistema con rol admin.
2. Asigna activos: selecciona la aplicación y dale control sobre ella.
3. Genera el token eligiendo “el identificador que no caduque nunca”.
4. Asigna los permisos de WhatsApp: como mínimo whatsapp_business_management y whatsapp_business_messaging.
5. Genera el identificador y guárdalo (solo se muestra una vez).

Un System User es una cuenta de servicio, no una persona: mantiene el token de tu negocio independiente de cualquier login individual, que es justo lo que quieres en producción.

Sustituir los datos en Hermes

Vuelve a la conversación con Hermes y dile algo como: “He configurado un número nuevo y ahora tengo un token permanente. Sustituye todo lo que configuraste antes por estos datos nuevos” — y pásale los nuevos valores. Él se encarga de reconfigurarlo todo.

Lo que casi nadie te cuenta: las reglas de Meta

Aquí es donde la mayoría se estrella en producción. La API oficial tiene políticas estrictas que debes conocer antes de lanzar:

La ventana de 24 horas

Cuando un usuario te escribe, se abre una ventana de atención al cliente de 24 horas. Dentro de esa ventana puedes responderle libremente con mensajes normales (y cada vez que el usuario vuelve a escribir, el contador se reinicia a 24h). Es lo que usa tu agente para conversar.

Plantillas aprobadas para iniciar conversación

Fuera de esa ventana de 24 horas, no puedes enviar un mensaje libre: solo puedes iniciar la conversación con una plantilla de mensaje previamente aprobada por Meta. Es decir, para “arrancar” tú una conversación (recordatorio de cita, seguimiento, etc.) necesitas plantillas aprobadas. Para responder dentro de las 24h, no.

Opt-in obligatorio

Solo puedes escribir a usuarios que (a) te hayan dado su número y (b) te hayan dado permiso explícito (opt-in) para recibir tus mensajes. Y debes respetar cualquier petición de baja. Saltarse esto es la vía rápida a que te reporten y te limiten la cuenta.

Precios 2026 (resumen práctico)

En 2026 Meta cambió el modelo hacia facturación por mensaje en los mensajes de plantilla iniciados por la empresa. Lo que necesitas tener claro:

• Las respuestas de servicio iniciadas por el cliente (tus contestaciones dentro de la ventana de 24h) son gratis en todo el mundo. Es decir, un agente que atiende consultas entrantes tiene un coste bajísimo.
• Los mensajes iniciados por la empresa se facturan por categoría: marketing (los más caros), utilidad y autenticación (bastante más baratos). El precio varía por país.
• Anuncios click-to-WhatsApp: si el cliente llega desde un anuncio que abre WhatsApp, tienes una ventana de 72 horas de mensajes sin coste.
• La verificación de negocio (el tick verde) es gratuita y va aparte.

Traducción para un negocio: montar a Hermes como soporte/atención entrante es muy barato; lo que cuesta es el outbound proactivo (campañas, recordatorios), y ahí conviene planificar categorías y plantillas.

Errores típicos que bloquean a todo el mundo

• “Falta el identificador de acceso” tras salir y entrar de la pantalla. El token de pruebas se invalida si sales de la pantalla de configuración de la API. Solución: genera un token nuevo justo antes de probar (o, mejor, monta ya el permanente). Si lo haces todo del tirón sin salir de esa pantalla, no te pasa.
• El webhook no valida. Suele ser el https:// que falta en la URL de callback. Añádelo a mano.
• El teléfono no se deja activar. Tenía WhatsApp instalado. Bórralo y espera horas, o usa un número virgen.
• Un mensaje de estado raro que no desaparece. El truco de Kilian: mándale a Hermes una captura del error y pídele que lo diagnostique. Detecta la causa, reinicia el gateway las veces que haga falta y lo deja limpio. Que el propio agente se autorrepare es una de las ventajas de hacerlo con Hermes en vez de a mano por terminal.

Para qué sirve esto en un negocio

Con Hermes en el WhatsApp oficial puedes desplegar, entre otras cosas:

• Soporte 24/7 que responde al instante a cualquier hora.
• Reserva y gestión de citas directamente en el chat.
• Cualificación de leads automática antes de pasarlos a un humano.
• Asistente interno para tu equipo (Hermes es multicanal: escritorio, Telegram y WhatsApp a la vez, con la misma memoria).
• Chatbots personalizados por empresa, cada uno con su perfil y su personalidad.

Conclusión

Conectar Hermes a la API oficial de WhatsApp te da algo que la vía no oficial nunca podrá darte: un agente en producción estable, que cumple las políticas de Meta y que no te va a costar el número del negocio. Y con el enfoque de dejar que Hermes haga el trabajo técnico, el montaje es sorprendentemente simple: tú tocas Meta, él toca lo demás.

En ExpertBrain montamos exactamente esto — chatbots y agentes de IA sobre WhatsApp oficial para empresas y organismos, en producción, con soporte, citas y cualificación de leads reales. Si quieres uno para tu negocio (o montárselo a tus clientes), hablemos.