Conecta tu número de WhatsApp
con un agente de IA en minutos

Usando la API oficial de WhatsApp Business (Meta), tu número real recibe y responde mensajes de forma automática 24/7. Esta guía cubre todo el proceso desde cero.

Antes de empezar

Cuenta Meta Business

Necesitas una Meta Business Suite verificada. Crea una en business.facebook.com.

Número de teléfono

Un número de móvil o fijo que NO tenga ya instalado WhatsApp. Puede ser el de la empresa.

Acceso a Klara

Una empresa activa en Klara Automation con módulo de Agentes IA habilitado.

Configuración paso a paso

1

Crea una aplicación en Meta Developers

Accede a developers.facebook.com e inicia sesión con tu cuenta de Meta Business.

  1. Haz clic en Mis apps → Crear app.
  2. Selecciona tipo Business (o "Otro" si no aparece).
  3. Ponle nombre (ej: Klara Automation Bot), asocia tu cuenta Business y guarda.
  4. En el panel de la app, haz clic en Añadir producto y selecciona WhatsApp.
Si ya tienes una app con WhatsApp añadido, puedes saltar directamente al paso 2.
2

Añade y verifica tu número de teléfono

Dentro de tu app en Meta Developers, ve a WhatsApp → Configuración de la API.

  1. En la sección Números de teléfono, haz clic en Añadir número de teléfono.
  2. Introduce el nombre de tu empresa y el número (formato internacional, ej: +34 600 000 000).
  3. Elige recibir el código por SMS o llamada de voz.
  4. Introduce el código de verificación recibido y confirma.

Una vez verificado, copia el ID del número de teléfono que aparece debajo del número. Lo necesitarás más adelante.

# Ejemplo de Phone Number ID
1234567890123456
El número debe estar libre de WhatsApp convencional. Si ya lo tienes en una cuenta normal, primero debes eliminar la cuenta desde la app de WhatsApp → Ajustes → Cuenta → Eliminar cuenta.
3

Genera un token de acceso permanente

Los tokens temporales del panel de Meta caducan en 24 horas. Para producción necesitas un token de usuario del sistema.

  1. Ve a business.facebook.com → Configuración → Usuarios del sistema.
  2. Haz clic en Añadir, ponle nombre (ej: klara-bot) y selecciona rol Administrador.
  3. Una vez creado, haz clic en Añadir activos.
  4. Selecciona Apps, elige tu app (Klara Bot) y activa Control total.
  5. Haz clic en Generar nuevo token, selecciona tu app y marca estos dos permisos:
whatsapp_business_messagingEnviar y recibir mensajes de WhatsApp
whatsapp_business_managementGestionar números y configuración

Copia el token generado y guárdalo en un lugar seguro — solo se muestra una vez.

Este token no caduca, trátalo como una contraseña. No lo subas a ningún repositorio público ni lo compartas por email.
4

Configura el webhook en Meta

El webhook es la URL a la que Meta enviará los mensajes entrantes de tus clientes.

  1. En tu app de Meta Developers, ve a WhatsApp → Configuración.
  2. En la sección Webhook, haz clic en Editar.
  3. En URL de devolución de llamada, introduce:
https://api.klara-automation.com/webhook

En Token de verificación, introduce el token que Klara te haya proporcionado (lo encontrarás en la sección Agentes IA de tu panel).

  1. Haz clic en Verificar y guardar. Meta enviará una petición de verificación al servidor.
  2. Una vez verificado, haz clic en Administrar junto al webhook y suscríbete al campo messages.
Si la verificación falla, comprueba que el servidor de Klara Automation esté activo y que el token de verificación coincida exactamente (respeta mayúsculas y espacios).
5

Conecta el número en Klara Automation

Con el Phone Number ID y el token permanente ya en mano, entra en tu panel de Klara.

  1. Ve a Agentes IA en el menú lateral.
  2. Selecciona tu bot de WhatsApp (o crea uno nuevo).
  3. En la configuración del bot, introduce el Phone Number ID y el Access Token.
  4. Escribe el system prompt que definirá la personalidad del agente.
  5. Guarda los cambios.
Usa el botón de expandir ⤢ en el campo del prompt para escribir instrucciones largas sin perder el contexto.
6

Prueba el bot

Envía un mensaje de WhatsApp al número configurado desde cualquier teléfono. En pocos segundos verás:

Panel Klara Automation → Conversaciones

La conversación aparece en tiempo real con el mensaje del cliente.

Panel Klara Automation → Agentes IA

El agente marca la conversación como "IA activa" y responde automáticamente.

WhatsApp del cliente

El cliente recibe la respuesta del agente en segundos.

Errores frecuentes y soluciones

ErrorCausaSolución
400 — Object with ID does not existPhone Number ID incorrecto o token sin permisosVerifica que el Phone Number ID del panel Meta coincida con el guardado en Klara Automation. Regenera el token con los permisos correctos.
Webhook verification failedEl token de verificación no coincide o el servidor no respondeComprueba que el servidor esté activo (systemctl status klara-backend) y que el WEBHOOK_VERIFY_TOKEN en .env sea el mismo que introduces en Meta.
Token expirado en 24hSe usó un token temporal del panel de Meta en lugar de uno de usuario del sistemaGenera un token permanente siguiendo el paso 3 de esta guía (Meta Business → Usuarios del sistema).
El bot no responde pero llega el mensajeEl agente IA está pausado o el bot no tiene un número asociado correctamenteEn Klara Automation → Agentes IA comprueba que el bot está activo y que el Phone Number ID guardado corresponde al número real.

Valores que necesitas tener a mano

Un resumen de todo lo que hay que recopilar durante el proceso:

VariableDónde se obtiene
Phone Number IDMeta Developers → WhatsApp → Configuración de la API → Números de teléfono
Access Token permanenteMeta Business Suite → Configuración → Usuarios del sistema → Generar token
Webhook Verify TokenPanel Klara Automation → Agentes IA (se muestra al configurar el bot)
Webhook URLhttps://api.klara-automation.com/webhook (fija, no cambia)

¿Necesitas ayuda con la configuración?

Nuestro equipo puede configurar el bot de WhatsApp por ti en el mismo día. Solo necesitamos acceso temporal a tu Meta Business.

Solicitar configuración asistida