Guía de configuración de WhatsApp

Conecta tu número de WhatsApp Business a Menubot en aproximadamente 20–30 minutos. Necesitarás una cuenta de desarrollador de Meta y un número de WhatsApp Business verificado.

Gratis durante pruebas~20–30 min

Datos que necesitarás ingresar en Configuración

CredencialDónde encontrarla
Phone Number IDMeta → WhatsApp → Primeros pasos
Access TokenMeta → Configuración del negocio → Usuarios del sistema
App SecretMeta → tu app → Configuración de la app → Básica → App secret
Verify TokenYa está generado — cópialo desde Menubot → Configuración
0

Antes de empezar — tu página pública

Cuando creaste tu cuenta, Menubot generó automáticamente tu página pública en mimenubot.com/<tu-slug> (puedes ver y editar el slug en Configuración → Tu página pública).

Cuando Meta te pida la URL del sitio web del negocio en Business Manager Profile, pega esa URL. No uses una URL inventada ni dejes el campo vacío — Meta visita el sitio para verificar que el negocio existe y bloquea la cuenta si la URL no carga (código 131031).

1

Crea una cuenta de desarrollador de Meta

Ve a developers.facebook.com e inicia sesión con tu cuenta de Facebook.

Haz clic en Comenzar y sigue los pasos para registrarte como desarrollador.

2

Crea una aplicación de Meta

  1. Haz clic en Mis apps → Crear app.
  2. Cuando te pregunten para qué usarás la app, selecciona Otro y luego Empresa.
  3. Dale un nombre (por ejemplo, Menubot - Nombre del restaurante) e ingresa tu correo empresarial.
  4. Haz clic en Crear app.
3

Agrega el producto WhatsApp

  1. En el panel de la app, desplázate hacia abajo hasta Agrega productos a tu app.
  2. Encuentra WhatsApp y haz clic en Configurar.

Llegarás a la página de WhatsApp → Primeros pasos. Mantenla abierta para el siguiente paso.

4

Copia tu Phone Number ID y el token de acceso temporal

En la página de Primeros pasos, en el Paso 1:

  1. Copia el ID del número de teléfono — pégalo en Menubot → Configuración → Phone Number ID.
  2. Copia el Token de acceso temporal — puedes usarlo para probar ahora mismo (válido por 24 h). Reemplázalo con un token permanente en el Paso 7.
Nota: Meta te asigna un número de prueba gratuito por defecto. Para usar tu número empresarial real, completa el Paso 5 primero.
Nota: Si ya tienes un número de WhatsApp Business activo, puedes conectarlo en el Paso 5. Ten en cuenta que un número solo puede estar conectado a UNA API de WhatsApp Business a la vez. Si actualmente usas la app de WhatsApp Business en tu teléfono con ese número, deberás migrarlo a la Cloud API — lo que significa que ya no podrás usar la app del teléfono para ese número.
5

Agrega tu número de WhatsApp Business (opcional para pruebas)

Consejo: Omite este paso si quieres probar primero con el número de prueba gratuito de Meta.
  1. En Primeros pasos, haz clic en Agregar número de teléfono.
  2. Ingresa el nombre de tu negocio y la categoría.
  3. Escribe tu número de WhatsApp Business y elige el método de verificación (SMS o llamada de voz).
  4. Ingresa el código de verificación cuando llegue.
  5. Selecciona tu número verificado en el menú desplegable De — el Phone Number ID se actualizará automáticamente.
Consejo: Si no quieres migrar tu número principal, considera usar un segundo número (SIM virtual o número dedicado) exclusivamente para el bot. Así mantienes tu WhatsApp Business normal intacto para atención manual y el bot opera en un número separado.
6

Registra el webhook de Menubot

  1. En Menubot → Configuración, copia la URL del webhook y el Token de verificación.
  2. En Meta, ve a WhatsApp → Configuración (barra lateral izquierda).
  3. En la sección Webhook, haz clic en Editar.
  4. Pega la URL del webhook en el campo URL de devolución de llamada.
  5. Pega el Token de verificación en el campo Token de verificación.
  6. Haz clic en Verificar y guardar — una marca verde confirma que funcionó.
  7. Haz clic en Administrar en los campos del webhook, activa messages y haz clic en Listo.
7

Crea un token de acceso permanente

El token temporal del Paso 4 expira a las 24 horas. Crea uno que no expire:

  1. En Meta, haz clic en el menú superior derecho → Configuración del negocio.
  2. En la barra lateral izquierda, ve a Usuarios → Usuarios del sistema.
  3. Haz clic en Agregar, dale un nombre (por ejemplo, Menubot Bot), selecciona rol Empleado y haz clic en Crear usuario del sistema.
  4. Haz clic en Agregar activos → Apps, encuentra tu app, activa Administrar app y haz clic en Guardar cambios.
  5. Haz clic en Generar nuevo token junto a tu usuario del sistema.
  6. Selecciona tu app y activa los permisos: whatsapp_business_messaging y whatsapp_business_management.
  7. Haz clic en Generar token — cópialo de inmediato, no se mostrará de nuevo.

Pega este token en Menubot → Configuración → Access Token y guarda.

8

Copia tu App Secret

El App Secret autentica los mensajes que Meta envía a tu servidor. Sin él, el bot rechazará todos los webhooks entrantes.

  1. En Meta, ve a tu app → Configuración de la appBásica (barra lateral izquierda).
  2. Haz clic en Mostrar junto al campo App secret e ingresas tu contraseña de Facebook si se solicita.
  3. Copia el valor y pégalo en Menubot → Configuración → App secret.
Nota: El App Secret es sensible — trátalo como una contraseña. Nunca lo compartas públicamente.
9

Prueba tu bot

Envía un mensaje de WhatsApp a tu número. El bot debería responder en pocos segundos.

Si no responde, revisa la sección de solución de problemas a continuación.

Solución de problemas

La verificación del webhook falla

Causa: El servidor no está activo o la URL es incorrecta

Solución: Asegúrate de que Menubot esté desplegado y que la URL incluya /webhook/<tu-id>

El bot no responde

Causa: El token de acceso expiró

Solución: Genera un nuevo token permanente (Paso 7) y pégalo en Configuración

Error "número de teléfono no registrado"

Causa: El número no fue agregado a la app

Solución: Completa el Paso 5

Los mensajes se envían pero el bot responde al restaurante equivocado

Causa: Phone Number ID incorrecto en Configuración

Solución: Verifica el ID en WhatsApp → Primeros pasos

Quiero usar mi número de WhatsApp Business existente pero ya lo uso en la app

Causa: Un número no puede estar en la app móvil y en la Cloud API al mismo tiempo

Solución: Migra el número a la Cloud API desde Meta Business → Cuentas de WhatsApp, o usa un número secundario para el bot

Meta dice "Business Account locked" (error 131031)

Causa: La URL del sitio web en Business Manager Profile no carga o está vacía

Solución: Pon tu URL de Menubot (mimenubot.com/<tu-slug>) en Business Info → Website y haz "Request review". Suele resolverse en 24-72 h.

Configura tu servicio de domicilios

Menubot puede despachar domicilios automáticamente desde tu panel. Sigue los pasos de tu servicio preferido para obtener las credenciales API y luego pégalas en Ajustes → Servicios de domicilios.

DiDi Express
  1. Busca "DiDi Express empresas Colombia" en Google y entra al sitio oficial de DiDi Business.
  2. Regístrate como empresa seleccionando la opción de entregas / delivery.
  3. Completa el formulario con el nombre del restaurante, NIT y correo empresarial.
  4. Una vez aprobada la cuenta (1-3 días hábiles), escríbele al equipo de soporte empresarial para solicitar acceso API.
  5. Te enviarán por correo un API Key y un API Secret.
  6. Pégalos en Ajustes → Servicios de domicilios → DiDi Express y guarda.
Lalamove
  1. Ve a lalamove.com y crea una cuenta Business con el correo del restaurante.
  2. Desde el portal, entra a Perfil → API Access (o busca "Developer" en el menú).
  3. Genera un nuevo par de credenciales: API Key y API Secret.
  4. Pégalas en Ajustes → Servicios de domicilios → Lalamove y guarda.
Consejo: Lalamove ofrece cotización previa al despacho — cuando integremos la API real, verás el precio antes de confirmar.
Mensajeros Urbanos
  1. Ve a mensajerosurbanos.com y regístrate como empresa (sección "Corporativo" o "Empresas").
  2. Completa el formulario con los datos del restaurante.
  3. Contacta al equipo comercial y solicita acceso a la API Enterprise — no es autoservicio.
  4. Te enviarán las credenciales por correo en 2-5 días hábiles.
  5. Pégalas en Ajustes → Servicios de domicilios → Mensajeros Urbanos y guarda.
Picap
  1. Ve a picap.co y crea una cuenta en la sección de empresas.
  2. Contacta a ventas o soporte para solicitar acceso API empresarial.
  3. Una vez aprobado, te enviarán un API Key y API Secret.
  4. Pégalos en Ajustes → Servicios de domicilios → Picap y guarda.

Mientras esperas las credenciales: puedes activar el servicio sin credenciales para probarlo en modo prueba — el despacho simula una respuesta real y te muestra cómo se verá el seguimiento en el panel.