Volver a configuración

Guía: Conectar WhatsApp a Turnero

Al terminar, tus clientes podrán pedir por WhatsApp y el bot (con o sin IA) los atenderá automáticamente. La conexión usa la API oficial de WhatsApp Business de Meta — es gratis para empezar y toma unos 30 minutos.

Antes de empezar

  • Una cuenta de Facebook para entrar a Meta for Developers.
  • Un número de teléfono para el bot que no esté ya registrado en la app normal de WhatsApp o WhatsApp Business (o que estés dispuesto a migrar). Puede ser un chip nuevo — solo necesita recibir un SMS de verificación una vez.
  • Tu cuenta de Turnero abierta en Configuración → WhatsApp (ahí está tu URL de webhook).

Paso 1 — Crea la app en Meta for Developers

  1. Entra a developers.facebook.com e inicia sesión con tu Facebook.
  2. Ve a My Apps → Create App, elige el tipo Business y ponle nombre (ej. "Mi Restaurante Bot").
  3. En el panel de la app, busca el producto WhatsApp y presiona Set up. Meta creará (o te pedirá elegir) una cuenta de WhatsApp Business (WABA).

Paso 2 — Registra tu número

  1. En WhatsApp → API Setup agrega tu número de teléfono con Add phone number y verifícalo por SMS.
  2. Copia el Phone number ID que aparece bajo el número (es un número largo, NO es tu teléfono). Lo pegarás en Turnero como ID del número de teléfono.

Meta te da también un número de prueba ("Test number"). Sirve para probar, pero solo puede escribir a 5 números registrados — para clientes reales usa tu propio número.

Paso 3 — Crea un token de acceso permanente

El token temporal de la página API Setup caduca en 24 horas. Para producción crea uno permanente:

  1. Entra a business.facebook.com → Configuración del negocio → Usuarios → Usuarios del sistema y crea un usuario del sistema (rol: administrador).
  2. En ese usuario: Agregar activos → tu app (control total) y Generar token → selecciona tu app y los permisos whatsapp_business_messaging y whatsapp_business_management.
  3. Copia el token generado — es el Token de acceso que pegarás en Turnero. Guárdalo bien: Meta no lo vuelve a mostrar.

Paso 4 — Copia la clave secreta de la app (App Secret)

  1. En el panel de tu app: Configuración de la app → Básica.
  2. En Clave secreta de la app presiona Mostrar y cópiala. Turnero la usa para comprobar que cada mensaje viene realmente de WhatsApp (nadie puede inyectar pedidos falsos).

Paso 5 — Configura Turnero y el webhook

  1. En Turnero (Configuración → WhatsApp) pega: el ID del número (Paso 2), un token de verificación (un texto secreto que tú inventas, ej. una frase sin espacios), el token de acceso (Paso 3) y el App Secret (Paso 4). Activa la recepción de pedidos y guarda.
  2. De vuelta en Meta: WhatsApp → Configuration → Webhook → Edit. Pega la URL de webhook que muestra Turnero y tu token de verificación, y presiona Verify and save. Si Turnero ya guardó tu configuración, la verificación pasa al instante.
  3. En la misma pantalla, en Webhook fields, suscríbete al campo messages.

Paso 6 — Pruébalo

  1. Desde otro teléfono, escribe "hola" a tu número del bot.
  2. Debes recibir el aviso del asistente y, al escribir menu, tu menú como lista interactiva.
  3. Agrega un platillo, escribe confirmar y verifica que el pedido aparezca en Pedidos y en la pantalla de cocina.

¿Quieres que el bot entienda lenguaje natural ("mándame 3 tacos de pastor")? Activa la IA en Configuración → Bot.

Solución de problemas

La verificación del webhook fallaEl token de verificación en Meta debe ser idéntico al guardado en Turnero, y la configuración debe estar guardada y activa ANTES de verificar.
El bot no contestaRevisa que estés suscrito al campo 'messages' del webhook, que la configuración esté activa y que el App Secret sea el correcto (si es incorrecto, Turnero rechaza los mensajes por seguridad).
El bot contesta solo a algunos númerosEstás usando el número de prueba de Meta — solo escribe a 5 destinatarios registrados. Registra tu propio número (Paso 2).
Dejó de funcionar después de unas horasUsaste el token temporal de API Setup (caduca en 24 h). Genera el token permanente del Paso 3 y actualízalo en Turnero.
Meta pide 'Business verification'Para volumen alto Meta puede pedir verificar tu negocio en business.facebook.com → Centro de seguridad. Con volumen bajo normalmente no es necesario para empezar.

Costos de Meta

WhatsApp cobra por conversación iniciada por la empresa; las conversaciones que inician tus clientes (el caso normal de un pedido: el cliente te escribe y el bot responde dentro de 24 h) tienen una capa gratuita generosa. Para un restaurante típico el costo de Meta es cero o de unos cuantos pesos al mes. Revisa las tarifas vigentes en la documentación de Meta.